通常、cfFormMailerのテンプレートとして使用できるのはチャンクだけですが、
MODXフォーラムでもおなじみのyama氏が、リソースも使えるように改造してくれました。


↑このように、環境設定チャンク内でのテンプレートの指定で、チャンク名またはリソースIDで指定できるようになります。

yama氏のGitHubリポジトリを元に、うちでもリポジトリを立ち上げて変更をマージしました。
（フォークせず手作業でマージしたため、若干更新ミスの残るコミットとなっていますがご了承ください。。。m(_ _)m　gitにも慣れなくては。）

テンプレートとしてリソースを使いたい方は、下記リポジトリからダウンロードしてご利用ください。
なお、cfFormMailerの今後のバージョンは、この仕様を取り入れたものとなります。

リポジトリはこちら
https://github.com/clefarray/cfFormMailer

元のyama氏のリポジトリはこちら
https://github.com/yama/cfFormMailer

MODX用メールフォームスニペット cfFormMailer の最新版 v1.2を公開します。
今回は cfFormMailer だけでなく、これを連携してフォーム送信内容をデータベースに保存する cfFormDB も同時に公開です。
（相変わらずネーミングはアレですけど、、、）

【ダウンロード】

• cfFormMailer v1.2
• cfFormDB v1.0

なお、cfFormMailer の動作にはcfFormDBは必須ではありません。
必要な方のみ、ダウンロードしてご利用ください。

このブログ以上に放置状態だった cfFormMailerデモサイトですが、
MODXもcfFormMailerも、両方最新のものに更新しました。（3月10日現在）
http://modx.clefarray-web.net/

MODx公式サイトのフォーラム（→記事）で寄せられた情報を元に検証したところ、
どうやら送信者名が長い場合に、rnといった文字が挿入されてしまうことが判明しました。

新しいバージョンの開発も進んでいますが、取り急ぎこの不具合への対処に加え、
「[バグ]cfFormMailerでファイルアップロードができない場合の対処」への対策も加えたものを
v1.1r2（リリース2）として公開しようと思います。

v1.1からの変更点は以下のとおりです。
------------------------------------------------------------
[FIX] メール送信者名やメール件名が長い場合に不要な文字が挿入されてしまう不具合に対処
（ただしWindows版PHPからmail関数でメール送信する設定の場合は正常動作しない可能性があります。）
[FIX] ユーザーからのファイルアップロードの際、サーバー環境によって保存がうまくいかない場合に対処 （環境設定 upload_tmp_path 追加）
------------------------------------------------------------

【ダウンロード：　cfFormMailer v1.1r2】

機能追加などは行っていませんので（若干ソースの編集はありますが。。。）、
上記不具合が起こっていない場合は、バージョンアップする必要はありません。

なお、Windows版PHPを使用しており、mail関数でメール送信する設定になっている場合は
正常に動作しない場合があります。
（少なくとも、私のローカル環境ではmail関数でエラーが発生し、対処方法が分かりません。。。）
対処方法がわかり次第対応しますが、Windows環境では不具合がおこる可能性をご承知おきください。

現在公開されている MODx Evolution 1.0.4Jで、以下の状況で使用する場合に不具合があることが確認されています。
対象はcfFormMailerすべてのバージョンです。

【環境】

• MODx 1.0.4J-r2からr4を使用している
• フレンドリーURLをOFFにしている
• トップページ以外にcfFormMailerを設置している
• <form>の送信先（action属性）を[~[*id*]~]にしている(※同梱しているサンプルチャンクではこのようになっています。）
  

【症状】
確認画面に遷移しない

【原因】
[~[*id*]~]が正常に展開されないため


本件は、yama氏とのTwitterでのやりとりで原因および対策が判明していますので、
次回のリビジョン(r5)で修正されるそうです。

おそらくフレンドリーURLを使用する場合が多く（※根拠なし･･･。）、本件に該当する方は少ないと思いますので、
MODxコアの修正が必要ということもあり、ここでは対処法は記しません。
上記環境でcfFormMailerをご利用の方は、次回のリビジョンをお待ちください。

現バージョンでどうしても使用するという場合は、入力画面チャンクformタグのaction属性 [~[*id*]~] を index.php?id=○ （※○はcfFormMailerを設置しているページID）に書き換えてください。

MODx公式フォーラムにて「cfFormMailerの確認画面へ進めません」という投稿がありましたので、調べてみたところ、
サンプルとして同梱している入力画面チャンク、および環境設定チャンクをそのままの設定で使用した場合に
メールアドレスの検証がうまく行われず、必ず検証エラーとなってしまうことを確認しました。

これは、環境設定の「自動返信メールの宛先として使用するフィールド名」が email であるのに対し、
入力画面サンプル（form.html）のメールアドレスフィールド名が email1 であるため、
「自動返信メールフラグ」が 1 の場合に行う自動返信先メールアドレスのチェックに必ず引っかかってしまうことが原因です。

サンプルをそのまま使用する場合は、以下のいずれかの方法で設定値を変更してからご利用ください。

A．入力画面の属性値を変える
入力画面チャンクのメールアドレス入力のためのinputタグのname属性を、 email に変更します。

<input name="email" size="30" id="f_email" type="text" />

Ｂ．環境設定値を変える
環境設定チャンクの「自動返信メールの宛先として使用するフィールド名」をemail1に変更します。

reply_to = email1

cfFormMailer v1.0以上でユーザーからのファイルアップロード機能を利用する際、
サーバー環境に依ってはSAFE MODE Restriction in effect というメッセージを含んだエラーが発生する場合があります。

これはPHPのセーフモードが有効であることにより、ある特定のフォルダに対し"アップロードされたファイルを新しいファイル名で保存し直す処理"が拒否されてしまうことが原因です。

この症状が発生してしまう方は、お手数ですが以下の対応を応急処置として行うことで回避できますのでお試し下さい。
なお、この問題については今後のバージョンアップで対応する予定です。

1. サーバーの assets/snippets/cfFormMailer/ フォルダ内に tmp というフォルダを作成し、その他のユーザーが書き込みできるパーミッション（707など）にしてください。

2. assets/snippets/cfFormMailer/class.cfFormMailer.inc.php を書き換えます。
class.cfFormMailer.inc.php 161行目（※v1.1の場合）
【書き換え前のコード】

$new_filepath = dirname($_FILES[$field]['tmp_name']) . DIRECTORY_SEPARATOR . urlencode($_FILES[$field]['name']);

↓

【書き換え後のコード】

$new_filepath = $this->modx->config['base_path'] . "assets/snippets/cfFormMailer/tmp/" . urlencode($_FILES[$field]['name']);

3. 書き換えたファイルをアップロードし、サーバー上にあるファイルと差し替えます。

MODx用メールフォームスニペットcfFormMailerの新バージョンv1.1を公開しました。

このバージョンは若干のバグフィックスと修正のみですので、
現在ご利用頂いている方は必要に応じてダウンロードしてください。

【ダウンロード： cfFormMailer v1.1】

v1.0からの変更点は以下のとおりです。
------------------------------------------------------------
[FIX] 開始タグと閉じタグの間にテキストの無い偶数個目のタグ（<textarea>タグなど）について値の復元が正しく行われない不具合を修正(thanks to trickstarさん）
[CHANGE] 同梱のサンプルテンプレートの名称を変更（thanks to yamaさん / 公式フォーラムより）
[CHANGE] cfFileViewプラグインを MODx v1.0.3でのプラグインインストール半自動化に対応
------------------------------------------------------------

【修正内容】
class.cfFormMailer.inc の1167行目、末尾のセミコロン（；）が全角になっていますので、これを半角に変更してください。

ご利用頂いている方々には、本当に 申し訳ございませんでした。
また、ご報告をくださった trickstar 様、本当にありがとうございました。

他のブログでは告知していましたが、実は、cfFormMailerの新バージョンを作成中です。

2年近くも放置してまいりましたが(汗)、やはり不具合には対応しなければ！ということで
cfFormMailer の既知のバグに対応しました。
情報をいただきました kz様、kazuike様、dainiti様、ありがとうございました。

【ダウンロード: cfFormMailer v0.0.7.2】

v0.0.7.1からの変更点は以下の通りです。
[FIX] 独自検証メソッド、フィルターメソッド追加に関する不具合を修正
[FIX] フォームの各属性の値が大文字で記述されていた場合に、エラー画面で入力値が反映しない不具合を修正
[FIX] 空のvalue属性があった場合にタグが崩れる不具合を修正
[FIX] 入力画面サンプルチャンクの<form>タグにaction属性を追加

MODx用メールフォームスニペット「cfFormMailer」の新バージョン 0.0.7.1 を公開しました。
今回のものはバグフィックスのみです。
情報提供ありがとうございました。 > roi さん

【ダウンロード： cfFormMailer v0.0.7.1】

v0.0.7 からの変更点は

• [FIX] 前後にタブを含む<option>タグを正常に処理できない不具合を修正
• [FIX] 初期選択値（selected="selected")が指定されている場合は削除

です。

上記アーカイブ内にはファイル一式入っていますが、v0.0.7 から変更されているのは assets/snippets/cfFormMailer/class.cfFormMailer.inc.php （と ReadMe.txt ）のみですので、v0.0.7 からアップする場合は、この PHP ファイルを置き換えるだけでＯＫです。

MODx用メールフォームスニペット「cfFormMailer」の新バージョン 0.0.7 を公開しました。

【ダウンロード: cfFormMailer v0.0.7】

v0.0.4 と比べて変更箇所が多数ありますので、添付の ReadMe.txt またはマニュアルをご確認ください。
システム的な変更以外にも、サンプルデータを一新しています。
HTML メール送信対応記念ということで、自動返信メールのサンプルは HTML で書いてみました。

動作サンプルのページを作りました。
配布アーカイブ内にあるサンプルデータ（chunk_sample）と同じです。
【→ MODxサンプルサイト】
なお、サンプルサイトは MODx 0.9.6、文字コードは EUC-JP で稼働させています。

基本的には UTF-8 文字コードでの使用を想定している cfFormMailer ですが、ようやく EUC-JP を使用している場合の動作を検証してみました。

[環境]
MODx 0.9.6 Japanese(EUC)
cfFormMailer v0.0.4
PHP 5.2.4

その結果、送信されるメールのタイトルやシステムエラーメッセージの一部が文字化けすることがわかりました。
ですので、恐れ入りますが v0.0.3 と v0.0.4　は　EUC-JP 未対応とさせていただきます。

なお、近日公開予定の最新バージョン（v0.0.7）では UTF-8 だけでなく EUC-JP 下での動作も考慮して制作を進めていますので、EUC-JP 版をご希望の方はもう少しお待ち下さい。

・・・えーっと、今更ながら、自分の勘違い、というか間違いに気付きました。

「プレースフォルダ」ではなく「プレースホルダ」ですね･･･。Placeholder。

当ブログ内の記述はこっそり直しました。
配布物に関しては、次リリースの際に直します。

MODx用メールフォームスニペット「cfFormMailer」の新バージョン 0.0.4 を公開しました。 ダウンロードはこちらから → cfFormMailer v0.0.4

稼働サンプルはこちらから → cfFormMailer サンプル （アーカイブ内のサンプルファイル chunk_sample と同じものです。）

v0.0.3 からの変更点：

[新機能]

• <label>タグに対応
  <input>タグや<select>タグに対して適切に<label>タグを使用することで、エラーのあるフィールド名が<label>タグで囲まれた表記で表示されます。
  [例] <label for="name">お名前</label><input type="text" name="name" valid="1" id="name" />
  → [お名前]入力必須項目です
• 入力必須項目のエラーメッセージで、ラジオボタンやリストのときは「選択必須項目です」と表示（他は「入力必須項目です」）

[バグフィクス]

• [+errors+]が効かない不具合を修正
• システムが付加するフィールドはアンダースコア(_)から始まる名称に変更

ついでに、ReadMe.txt も書き直しました(^^;

MODx には標準で eForm という多機能なスニペットが付属しており、たいていのことはこのスニペットが大活躍します。
ですが、文字コードの問題云々を差し引いても、何となく日本人向けでは無いような気がしています。

そこで、何となく作ってみました。
”日本語のことしか考えていない”MODx 用メールフォームスニペット、「cfFormMailer」です。

概要としては、
・”日本人が日本のサーバで使用する”という前提で設計。何の躊躇もなく mbstring関数使っています(^^;
　（つまり、mbstring必須です）
・eFormのようにスニペット呼び出し文が非常に長くなるのは好きではないので、独立した設定チャンクを読むようにする。（MODx の作法からは外れるとは思いますが。）
　ドキュメントにはこんな感じで記述。　→ [!cfFormMailer?config=`config_chunk`!]
・いろいろな検証メソッドを装備。入力された値を検査できます。
・いろいろな出力フィルタを装備。確認画面やメール本文などに出力する際、値の整形が可能です。
・上記検証メソッドと出力フィルタは、ユーザ側で追加することも可能。
・今のところ UTF-8 のみ動作確認。

気が向いた方は是非お試し下さい。
なお、ライセンスは　GPL とさせていただきます。
バグ報告大歓迎です。

【ダウンロード： cfFormMailer_MODx_0.0.3.zip】

大まかな設置方法、使い方は書庫内 ReadMe.txt に（簡単に）書いてありますので、ご参照ください。
当ブログでも、以後数回にわたって解説してまいります。

ちなみに、この cfFormMailer というスクリプトは、1つの基幹クラスを中心に作られています。
ということで、今回の MODx 版以外にも、スタンドアロン版とも言えるものもあり、通常のサイトや Movable Type で構築されたサイトなどにも（たぶん）使用可能です。
そのサンプルは こちら 。
こちらも近日中に公開します。