cfFormMailerマニュアル

v1.3

■ 設置＆使用方法

【インストール】

  1. /assets/snippets/ フォルダ内に cfFormMailer というフォルダを作成し、そのフォルダ内に以下のファイルを配置（アップロード）します。
    ※v1.0以降、class.cfFormMailerMODx.inc.phpは不要となります。
  2. （ファイルアップロードを使用する場合） class.upload.phpを/assets/snippets/cfFormMailer/フォルダにアップロードします。（任意）
    ※「ユーザーがアップロードしたファイルの添付送信」参照
    class.upload.phpはColin Verot氏作の画像アップロードライブラリです。
    ダウンロード先： http://www.verot.net/php_class_upload_download.htm
  3. （ファイルアップロードを使用する場合） プラグインcfFileViewをインストールします。
    「ユーザーがアップロードしたファイルの添付送信」を参照してください。
  4. （送信内容を記録する場合） cfFormDBモジュールをインストールします。
    詳細はcfFormDBのマニュアルを参照してください。
  5. modxの管理画面にログインし、以下の情報で新規スニペットを作成します。
    ■スニペット名： cfFormMailer
    ■スニペットコード欄： ファイル snippet.cfFormMailer.php の内容をコピー＆ペースト
  6. 「環境設定」として利用するチャンクを作成します。
    ■チャンク名： 任意 ※スニペットコール時に、ここで作成したチャンク名を指定します。
    ■チャンクコード： chunk_sample フォルダ内のファイル tmpl.chunk_config.txt の内容をすべてコピー＆ペースト
  7. 各設定項目の値をご利用の環境に合わせて書き換え、保存してください。
    # で始まる行はコメントです。

【環境設定項目】

上記インストール手順5で作成する”環境設定チャンク”には、以下の設定項目が用意されています。

管理者宛メール関連

管理者メール送信先 [admin_mail]
フォームの送信先メールアドレスを指定します。半角コンマ区切りで複数のメールアドレスを指定することができます。
[デフォルト] modxシステムの「送信者メールアドレス」
[設定例] admin_mail = info@example.com,conact@example.com
送信者名 [admin_name]
上記”管理者メール送信先”へ送信されるメールの送信者名を指定します。
[設定例] admin_name = フォーム送信者
管理者宛メール件名 [admin_subject]
管理者宛に送信されるメールの件名を指定します。
[デフォルト] サイトから送信されたメール
[設定例] admin_subject = メールフォームから送信されたメール
管理者宛メール HTMLメールフラグ [admin_ishtml]
管理者宛に送信されるメールがHTMLメールかどうかを指定します。
[設定値] 0・・・テキストメール / 1・・・HTMLメール
[デフォルト] 0
管理者宛CCメール送信先 [admin_cc] NEW in v1.3
管理者宛メールと同時にCCで送るアドレスを指定します。半角コンマ区切りで複数のアドレスを指定できます。
[設定例] admin_cc = test@example.com,info@example.jp
管理者宛BCCメール送信先 [admin_bcc] NEW in v1.3
管理者宛メールと同時にBCCで送るアドレスを指定します。半角コンマ区切りで複数のアドレスを指定できます。
[設定例] admin_bcc = test@example.com,info@example.jp
管理者アドレスの動的変更 [dynamic_send_to_field] NEW in v1.3
フォーム中の特定項目の選択肢によって管理者メールアドレスを動的に変更する場合に、その項目名を指定します。
「管理者アドレスの動的変更」参照。

自動返信メール関連

自動返信メールフラグ [auto_reply]
フォーム送信者に対して自動返信メールを送信するかどうかを指定します。
[設定値] 0・・・送信しない / 1・・・送信する
[デフォルト] 0
自動返信メールの送信先として使用するフィールド名 [reply_to]
自動返信メールの送信先として使用するフィールド名を指定します。
単一のフィールド、または複数のフィールドを組み合わせたものを指定できます。
複数のフィールドを指定する場合は、半角プラス記号でフィールド名をつないで指定します。また、半角アットマークはそのまま記述します。
[デフォルト] email
[設定例] reply_to = email1+@+email2
（この例の場合、email1フィールドの値が info で、email2フィールドの値がdocomo2.ne.jp だった場合、送信先アドレスは info@docomo2.ne.jp になります。）
自動返信メールの送信者メールアドレス [reply_from]
自動返信メールの送信者メールアドレスを指定します。
[デフォルト] 管理者メールアドレス（admin_mail） 。admin_mailに複数のアドレスが指定されている場合は先頭のアドレス。
[設定例] reply_from = info2@example.com
自動返信メールの送信者名 [reply_fromname]
自動返信メールの送信者名を指定します。
[デフォルト] modxサイト名 （[(site_name)])
[設定例] reply_fromname = 株式会社○×
自動返信メールの件名 [reply_subject]
自動返信メールの件名を指定します。
[デフォルト] 自動返信メール
[設定例] reply_subject = お問い合わせありがとうございます
自動返信メールのHTMLメールフラグ [reply_ishtml]
自動返信されるメールがHTMLメールかどうかを指定します。
[設定値] 0・・・テキストメール / 1・・・HTMLメール
[デフォルト] 0
添付するファイル [attach_file] NEW in v1.0
自動返信メールに添付するファイルを絶対パスで指定します。
半角コンマ区切りで、複数のファイルを指定することができます。
なお、ファイル名は必ず半角英数字で指定し、漢字・ひらがな・カタカナ・全角記号等は使わないでください。
[設定例] attach_file = /var/sample/pdf/guidebook.pdf,/var/sample/word/entrysheet.doc
添付するファイルの名称 [attach_file_name] NEW in v1.0
前項で指定するファイル名に漢字・ひらがな等が使用出来ないため、添付送信するファイルにこれらの文字を使用したい場合に指定します。
複数のファイルを指定する場合は、attach_fileでの指定順に合わせて、半角コンマで区切って指定します。
[設定例] attach_file_name = 募集要項.pdf,エントリーシート.doc

テンプレート関連 UPDATE in v1.3

入力画面テンプレート [tmpl_input]
入力画面のテンプレートとして使用するチャンク名またはリソースIDを指定します。
[設定例] tmpl_input = tmpl_input (※チャンクを指定する場合）
 　　　  tmpl_comp = 11 (※リソースを指定する場合）
確認画面テンプレート [tmpl_conf]
送信内容確認画面テンプレートとして使用するチャンク名またはリソースIDを指定します。
[設定例] tmpl_conf = tmpl_conf (※チャンクを指定する場合）
 　　　  tmpl_comp = 12 (※リソースを指定する場合）
完了画面テンプレート [tmpl_comp]
送信完了画面テンプレートとして使用するチャンク名またはリソースIDを指定します。
[設定例] tmpl_comp = tmpl_comp (※チャンクを指定する場合）
 　　　  tmpl_comp = 13 (※リソースを指定する場合）
管理者宛メールテンプレート [tmpl_mail_admin]
管理者宛メールのテンプレートとして使用するチャンク名またはリソースIDを指定します。
[設定例] tmpl_mail_admin = tmpl_mail_admin (※チャンクを指定する場合）
 　　　  tmpl_comp = 14 (※リソースを指定する場合）
自動返信メールテンプレート [tmpl_mail_reply]
自動返信メールのテンプレートとして使用するチャンク名を指定します。
[設定例] tmpl_mail_reply = tmpl_mail_reply (※チャンクを指定する場合）
 　　　  tmpl_comp = 15 (※リソースを指定する場合）
自動返信メールテンプレート（モバイル用） [tmpl_mail_reply_mobile]
モバイル宛自動返信メールのテンプレートとして使用するチャンク名を指定します。
モバイル宛テンプレートを使用しない場合は空欄にしてください。
[設定例] tmpl_mail_reply_mobile = tmpl_mail_reply_mobile (※チャンクを指定する場合）
 　　　  tmpl_comp = 16 (※リソースを指定する場合）
送信後遷移する完了画面リソースIDまたはURL [complete_redirect] NEW in v1.3
送信完了と同時に完了画面（入力・確認画面とは違うURL）へ遷移するようにします。「完了画面テンプレート(tmpl_comp)」の指定より優先されます。
リソースIDまたはURLを指定してください。
[設定例] complete_redirect = 17 (※リソースIDで指定する場合）
 　　　  complete_redirect = http://www.example.com/thanks.html （※URLで指定する場合）

その他の設定

CAPTCHAによる認証 [vericode] NEW in v0.0.5
CAPTCHAによる画像認証の仕様有無を指定します。
[設定値] 0・・・使用しない / 1・・・使用する
[デフォルト] 0
エラーフィールドに挿入されるクラス名 [invalid_class]
検証エラーのあるフィールド（input,textarea,selectタグ）に付加されるクラスセレクタ名を指定します。
使用しない場合は空欄にしてください。
[設定例] invalid_class = invalid
メール内HTMLタグ使用許可 [allow_html]
管理者宛や自動返信をHTMLメールとして送信する場合、フォーム送信者が記入したHTMLタグを有効にするかどうかを指定します。
[設定値] 0・・・HTMLタグ使用不可（タグは無効化されます） / 1・・・使用する
[デフォルト] 0
ファイルアップロード時に使用するディレクトリの設定[upload_tmp_path] NEW in v1.1r2
※このオプションは「[バグ]cfFormMailerでファイルアップロードができない場合の対処」への対応です。
フォーム送信者によるファイルアップロード送信機能を使用する場合に、アップロードされたファイルの一時保管方法を指定します。
通常は0（デフォルト）で大丈夫ですが、XREAなど、SAFE Modeがonの環境でファイルアップロード送信がうまくいかない場合は1にしてください。
（1の場合、asset/snippets/cfFormMailer/tmpディレクトリに書き込みができるようパーミッション設定を行ってください。）
[設定値] 0･･･サーバデフォルトのテンポラリエリア / 1･･･スニペットディレクトリ内のtmpディレクトリ
[デフォルト] 0
改行スタイル[lf_style] NEW in v1.1r2
送信するメールのヘッダに使われる改行コード。通常は変更しなくても大丈夫だと思います。
[設定値] 0･･･\n (linuxスタイル) / 1･･･\r\n (windowsスタイル)
[デフォルト] 0
送信内容をデータベースに記録する[use_store_db] NEW in v1.2
フォームの送信内容をデータベースに記録します。
この機能を使用するには、あらかじめcfFormDBモジュールをインストールし、記録用テーブルを作成しておく必要があります。
[設定値] 0･･･記録しない / 1･･･記録する
[デフォルト] 0
メール送信フラグ[send_mail] NEW in v1.2
メールを送信するかどうかを指定します。0を指定すると、管理者宛、自動送信宛ともに送信しなくなります。
[設定値] 0･･･送信しない / 1･･･送信する
[デフォルト] 1
送信するメールの文字コード [mail_charset] NEW in v1.3
送信されるメールの文字コードを指定します。
v1.2までは日本語メール送信における一般的な設定値である「ISO-2022-JP」に固定していましたが、unicodeの文字をそのまま送信したい場合（例：機種依存文字など）のために指定できるようにしました。
設定値は、一般的には iso-2022-jp または utf-8 を指定します。
[設定例] mail_charset = utf-8
[デフォルト] iso-2022-jp

【テンプレートの作成 】

入力・確認・完了の各画面や、送信されるメールのテンプレートは、チャンクまたはリソースによって管理されます。
各画面のテンプレートとなるチャンク名はあらかじめ設定されていますが、これらは環境設定チャンク内で変更できます。
パッケージのchunk_sampleフォルダ内に各チャンクのサンプルコードがありますので、参考にしてみて下さい。

  1. 「入力画面」テンプレートの作成
    任意の名称（デフォルト：tmpl_input）で新規チャンクを作成し、入力画面のHTMLを記述します。
    サンプル： form.html
  2. 「確認画面」テンプレートの作成
    任意の名称（デフォルト：tmpl_conf）で新規チャンクを作成し、確認画面のHTMLを記述します。
    サンプル： confirm.html
  3. 「完了画面」テンプレートの作成
    任意の名称（デフォルト：tmpl_comp）で新規チャンクを作成し、完了画面のHTMLを記述します。
    サンプル： thanks.html
  4. 「管理者宛メール」テンプレートの作成
    任意の名称（デフォルト：tmpl_mail_admin）で新規チャンクを作成し、管理者宛メールの本文テンプレートを記述します。
    サンプル： mail.txt
  5. 「自動返信メール」テンプレートの作成
    任意の名称（デフォルト：tmpl_mail_reply）で新規チャンクを作成し、自動返信メールの本文テンプレートを記述します。
    サンプル： reply_mail.txt
  6. 「自動返信メール（モバイル用）」テンプレートの作成　※PCメール宛と携帯メール宛でテンプレートを変えたい場合　NEW in v1.0　
    任意の名称で新規チャンクを作成し、モバイル端末用の自動返信メール本文テンプレートを記述します。
    ここで作成したチャンクの名称を、環境設定チャンク内の tmpl_mail_reply_mobile 項目に記述します。
    サンプル： mobile_reply_mail.txt

【旧バージョンからのバージョンアップ】

【v1.2からのバージョンアップ】
assets/snippets/cfFormMailer/class.cfFormMailer.inc.phpのみ差し替えます。
必要に応じて、v1.3以降新たに追加された環境設定項目を環境設定チャンクに追加、設定します。

【v1.0/v1.1からのバージョンアップ】
assets/snippets/cfFormMailer/フォルダ 内のすべてのファイルを置き換えます。
必要に応じて、新たに追加された環境設定項目を環境設定チャンクに追加、設定します。

【v1.0以前からのバージョンアップの場合】
スニペット内に独自検証メソッド、独自フィルターを定義している場合は、スニペット内からadditionalMethods.inc.phpファイル内に転記します。
その後、assets/snippets/cfFormMailer/フォルダ 内のすべてのファイルを置き換え、MODx 内スニペットの内容をsnippet.cfFormMailer.phpと置き換えます。
※ 各テンプレートはそのまま利用できます。
※ 環境設定チャンクも従来のものがそのまま使用できますが、設定項目が増えていますので、上記インストール手順5 で最新のものに変更し再定義することをお勧めします。

【スニペットコール書式】

[!cfFormMailer?&config=`環境設定チャンク名`!]

config パラメータは必須で、【インストール】手順5で作成した「環境設定チャンク」の名称を指定します。

■ 機能解説

【入力値の検証】

フォーム内の各フィールドに対して、入力値の検証を行うことができます。

[書式]

<input type="text" name="field_name" value="" valid="required:method:label" />

required
入力必須項目（1-yes / NULL-no)
method
検証項目。コンマ区切りで複数指定可。以下の標準装備の方式以外にも、独自の方式も指定可能。（下記「検証メソッドの追加」参照。）
email
メールアドレスチェック（半角に強制変換）
num
数値チェック（半角に強制変換）
len(n-m)
文字数チェック（m文字以下 | n～m文字 | n文字以上）
range(n~m) NEW in v0.0.5
数値の値範囲チェック（m以下 | n～m | n以上）
※n,mで指定した数値は範囲に含まれます
sameas(フィールド名) NEW in v0.0.6
「フィールド名」で指定したフィールドと同値かをチェック。
tel NEW in v0.0.7
正しい電話番号形式かどうかをチェック（半角に強制変換）
vericode NEW in v0.0.5
画像認証
allowtype(形式名) NEW in v1.0
アップロードを許可する形式名。「|」 記号で区切って複数指定可。
[形式名の選択肢]
allowsize(数値) NEW in v1.0
アップロードを許可する最大ファイルサイズ。キロバイト単位で指定。
convert(変換オプション) NEW in v1.2
「変換オプション」に従って入力値を変換します。
変換オプションはPHP関数mb_convert_kana()と同じものとなり、未指定の場合は「K」（半角カタカナを全角カタカナに変換）となります。
※このメソッドのみ”検証”ではなく”変換”となります。検証エラーが発生する事はありません。
url NEW in v1.2
入力値がURIかどうかを簡易的にチェックします。
label NEW in v1.0
エラー表示用（[+errors+]プレースホルダ利用時）に使用する項目名。
<label>を使用したラベルよりも優先されます。
未指定の場合はname属性の値が使用されます。

[例]

以上で挙げた検証の他に、「自動返信」を使用する場合は”自動返信先”（reply_to）がメールアドレスとして正しいかどうかを必ずチェックします。（※v0.0.7以降）
また、これにより自動的にフィールド reply_to が作成されますので、エラーメッセージ表示の際のフィールド名として利用できます。

【追加タグ】

主にエラーメッセージ表示用に、以下の独自タグをサポートしています。

<iferror></iferror>
エラーが存在する場合にタグ内を表示
<iferror.フィールド名></iferror>
指定したフィールドにエラーが存在する場合にタグ内を表示
（例： <iferror.name><p class="error">氏名を入力してください</p></iferror> ）
<iferror.(f1,f2[,f3...])></iferror>
f1またはf2（またはf3...。すべてフィールド名）項目にエラーが存在する場合にタグ内を表示
（例： <iferror.(name,kana)><p class="error">氏名とふりがなを入力してください</p></iferror> )

【プレースホルダ】

各テンプレート内で使用可能。

[+フィールド名+]
フィールド名に対応する値
[+error.フィールド名+]
指定したフィールドに割り当てられているエラーメッセージ
（エラーメッセージが複数割り当てられている場合、<br />タグで区切って表示。下記「表示フィルタ」を使用して変更することも可能。）

-- システムで予約済みのもの --

[+errors+]
全てのエラーを表示（初期値は<br />区切り。下記「表示フィルタ」で変更可能。）
<input>タグや<select>タグに対して適切に<label>タグを使用することで、エラーのあるフィールド名が<label>タグで囲まれた表記で表示されます。
[例]

<label for="name">お名前</label><input type="text" name="name" valid="1" id="name" />
→ [お名前] 入力必須項目です

※v1.0以降、valid属性で指定するlabelのほうが優先されます。
<label for="name">お名前</label><input type="text" name="name" valid="1::氏名" id="name" />
→[氏名] 入力必須項目です

 

[+verimageurl+]
画像認証コードとして使用する画像の URI

メールテンプレート用（「管理者宛メール」「自動返信メール」テンプレートチャンク内でのみ使用できます）

[+adminmail+]
管理者メールアドレス（環境設定の admin_mail と同値）
[+reply_to+]
自動返信の宛先メールアドレス
[+senddate+]
送信日時（デフォルト書式： Y-m-d H:i:s。下記「表示フィルタ」の dateformat を利用して変更可能。）
[+sender_ip+]
送信者のIPアドレス
[+sender_host+]
送信者のホスト名（逆引きできない場合は IPアドレス）
[+sender_ua+]
送信者のユーザーエージェント

【表示フィルタ】

上記プレースホルダの出力に対して任意のフィルターをかけることが可能。

[書式]

[+フィールド名|フィルタ名（パラメータ）+]

フィールド名
フォームのフィールド名（name="xxx")
フィルタ名、パラメータ
適応させるフィルタ名とパラメータ（任意）。標準では以下のフィルタを備えています。
implode(string)
string で区切って表示 ※該当フィールドが配列の場合のみ有効。
implodetag(string)
値を<string></string>タグで囲んで表示 ※該当フィールドが配列の場合のみ有効。
dateformat(format)
format に従い日付書式を変換 ※PHP関数 strftime() と同様。
num
数字をフォーマット ※PHP関数 number_format() と同様。ただし第2引数以降は未対応。
sprintf(format)
整形して表示　※PHP関数 sprintf() と同様。

[例]

【検証メソッドの追加】

以下の仕様に則った関数を使用して、任意の検証メソッドを追加することができるます。

[関数仕様]

  1. 名前が 「_validate_検証名」 となる関数を作成する
  2. 引数として 2つの値を受け取るようにする。1つ目はユーザが入力した値、2つ目は検証メソッドのパラメータ（カッコ内の数値）
  3. これらの引数を基に検証する
  4. 正しい値の場合は TRUE を、それ以外の場合はエラーメッセージを返値として指定する

[登録のやり方]

スニペット内の「↓こここら↓」と「↑ここまで↑」の間に以下の構文と上記仕様の関数を追加する。
$mf->addValidateMethod('検証名');
※ここで指定する検証名には _validate_ を付けない
v1.0以降では、従来の方法以外に、「関数仕様」に則った関数を/assets/snippets/cfFormMailer/additionalMethods.inc.php 内に作成するだけで定義できます。

[例]

/* 正しい郵便番号かどうかを検証 */
function _validate_postcode($data, $param) {
  return preg_match("/\d{3}\-\d{4}/", $data) ? TRUE : '郵便番号が正しくありません';
}
$mf->addValidateMethod('postcode');

【フィルターの追加】

任意の出力整形フィルタを加えることができます。（Smarty みたいな?!）
大まかな流れは、上記「検証メソッドの追加」と同様。

[関数仕様]

  1. 名前が「_filter_フィルタ名」 となる関数を作成する
  2. 引数として 2つの値を受け取るようにする。1つめは整形対象となるテキスト、2つめはフィルタメソッドのパラメータ（カッコ内の数値）
  3. これらの引数を基に整形する
  4. 返値として、整形後の値を返す

[登録のやり方]

スニペット内の「↓こここら↓」と「↑ここまで↑」の間に以下の構文と上記仕様の関数を追加する。

$mf->addFilterMethod('フィルタ名');
※ここで指定するフィルタ名には _filter_ を付けない
v1.0以降では、従来の方法以外に、「関数仕様」に則った関数を/assets/snippets/cfFormMailer/additionalMethods.inc.php 内に作成するだけで定義できます。

【自動返信】

環境設定チャンク内の auto_reply を 1 、reply_to にメールアドレスとして使用するフィールド名を指定することで、”管理者”宛のメールのほかにフォーム送信者に対して自動返信を行うことができます。
※1 reply_to で指定したフィールドは正しいメールアドレス形式かどうかをチェックされます。
※2 reply_to は、1つのフィールド名、または複数のフィールド名を + 記号で繋げて指定します。

[例]

reply_to = email //name="email" のフィールド値を宛先として使用
reply_to = email1+@+email2 //name="email1"のフィールド値＋アットマーク＋name="email2"のフィールド値を宛先として使用

【画像認証コード（CAPTCHA)の使用】 NEW in v0.0.5

v0.0.5 から画像認証コードが利用できるようになっています。
環境設定チャンク内で CAPTCHA 使用を宣言し（vericode = 1）、以下の例のような、src 属性に [+verimageurl+] プレースホルダを指定した<img>タグと、検証項目に vericode を指定した<input> タグを、入力画面チャンク内に作成します。

[例]

<img src="[+verimageurl+]" alt="認証コード" />
<input type="text" name="veri" valid="1:vericode" />

※modx 本体と同じクラスを利用するため、画像として表示される文字列は [ツール]>[グローバル設定]>[詳細設定]タブの「CAPTCHA用ワード」と同様になります。

【自動返信メールテンプレートの切り替え】 NEW in v1.0

自動返信メールの宛先がモバイル端末(*1)の場合に、使用するテンプレートを変更することができます。
使用するテンプレートをチャンクとして作成し、そのチャンク名を環境設定チャンクの「tmpl_mail_reply_mobile」項目に指定します。

*1: ”モバイル端末”と判別されるメールアドレスは、末尾が以下の場合です。
docomo.ne.jp / ezweb.ne.jp / softbank.ne.jp / vodafone.ne.jp / disney.ne.jp / pdx.ne.jp / willcom.ne.jp / emnet.ne.jp

【指定したファイルの添付送信】 NEW in v1.0

フォーム送信者への自動返信メール送信の際に、任意のファイルを添付して送信することが出来ます。
環境設定チャンク内の以下の項目を設定してください。

attach_file
送信するファイルの絶対パス（例： /var/www/path/to/file/sample.pdf )。半角コンマ区切りで複数のファイルを指定することが出来ます。
必ず半角英数字で指定してください。
attach_file_name
送信するファイルに付けるファイル名（拡張子まで含む）。省略の場合は「attach_file」のファイル名と同様。
attach_fileは半角英数字に限定されるため、日本語名で送信したい場合に使用してください。（例： 資料.pdf など。）

【ユーザーがアップロードしたファイルの添付送信】 NEW in v1.0

<input type="file" />でアップロードされたファイルを、管理者宛メールと自動返信メールに添付して送信することができます。
検証メソッドallowtypeとallowsizeで、アップロードできるファイルを限定することをお勧めします。
[注意] "SAFE MODE Restriction in effect"というエラーが発生する場合は、環境設定チャンクのupload_tmp_pathを1にしてみてください。

[プラグインの追加]

！送信内容確認画面でアップロードされたファイルを表示するには、プラグインの追加が必要です！

アップロードされたファイルは、送信完了するまでブラウザからはアクセスできない一時ディレクトリに保管されるため、送信内容確認画面で表示するために追加処理が必要となります。
以下の手順に従って、プラグインcfFileViewをインストールしてください。
※確認画面でアップロードされたファイルを表示させない場合は、インストールする必要はありません。

  1. 以下の情報で新規プラグインを作成します。
    ■プラグイン名： cfFileView
    ■プラグインコード： ダウンロードしたcfFormMailerパッケージ内のplugin.cfFileView.phpファイルの内容をコピー＆ペースト
  2. システムイベントタブをクリックし、OnPageNotFoundにチェックを入れます。

以上でインストール完了です。

[ファイルの追加]

！画像アップロードライブラリclass.upload.phpの追加を推奨します！

アップロードされたファイルのMIMEタイプ判別（と、将来の拡張）のために、Colin Verot氏作の画像アップロードライブラリであるclass.upload.phpを使用することを推奨します。
一応無くても動作するようにはなっていますが、画像以外のファイルのアップロードを許可する場合は、最適なPHPの動作環境（Fileinfo関数が利用できること）とともに、このclass.upload.phpを使用するようにしてください。

書庫ファイル内には格納しておりませんので、class.upload.phpのページからダウンロードし、/assets/snippets/cfFormMailer/フォルダ内にアップロードしてください。

[確認画面でのファイル指定]

アップロードされたファイルは、プラグインcfFileViewを利用して表示させますので、<img>タグや<a>タグのURLとして、以下のように記述します。

cfFileView?field=フィールド名

画像なら<img>タグのsrc属性、それ以外なら<a>タグのhref属性に指定して別画面で表示させるという方法が良いと思います。
「テンプレートでの記述例」を参考にしてください。

[追加されるプレースホルダ]

以下のプレースホルダが追加され、「確認画面テンプレート」で使用できます。

アップロードされたファイルが画像の場合
[+フィールド名.imagewidth+]
アップロードされた画像の幅
[+フィールド名.imageheight+]
アップロードされた画像の高さ
[+フィールド名.imagename+]
ファイル名
[+フィールド名.imagetype+]
ファイルの形式。以下の何れかとなります。
GIF / JPG / PNG / PDF / TXT / HTML / WORD
アップロードされたファイルが画像以外の場合
[+フィールド名.filename+]
ファイル名
[+フィールド名.filetype+]
ファイルの形式。以下の何れかとなります。
GIF / JPG / PNG / PDF / TXT / HTML / WORD

[テンプレートでの記述例]

画像の場合(1)
入力画面：　<p>写真<input type="file" name="pic" valid=":allowsize(1024)" /></p>
確認画面：　<p>写真： <img src="cfFileView?field=pic" width="[+pic.imagewidth+]" height="[+pic.imageheight+]" alt="[+pic.imagename+]" /></p>
表示例：　　<p>写真： <img src="cfFileView?field=pic" width="240" height="320" alt="画像です.jpg" /></p>
画像の場合(2)
入力画面：　<p>写真<input type="file" name="photo" valid=":allowtype(gif|jpg)" /></p>
確認画面：　<p>写真： <img src="cfFileView?field=photo" alt="" width="100" /></p>
表示例：　　<p>写真： <img src="cfFileView?field=photo" alt="" width="100" /></p>
画像以外のファイルの場合
入力画面：　<p><input type="file" name="profile" valid="1:allowtype(pdf|txt)" /> PDFまたはテキスト形式のプロフィールをアップロードしてください</p>
確認画面：　<p><a href="cfFileView?field=profile" target="_blank">[+profile.filename+]</a> 【[+profile.filetype+]形式】</p>
表示例：　　<p><a href="cfFileView?field=profile" target="_blank">○○のプロフィール.pdf</a> 【PDF形式】</p>

[その他仕様]

※アップロードされたファイルは、アップロード時のファイル名（クライアントマシンの元のファイル名）で添付されます。
※アップロードされたファイルは、メール送信時と、確認画面から入力画面に戻った場合に削除されます。

【管理者アドレスの動的変更】 NEW in v1.3

フォーム中の特定項目の選択内容によって、管理者メールアドレスとなるメールアドレスを変化させることができます。
例えば「問い合わせ内容」として「1. 製品について」「2. サイトについて」「3. 求人について」「4. その他」という項目を設置した場合に、「1. 製品について」を選択した場合はproduct@example.com宛、「3. 求人について」を選択した場合はrecruit@example.com宛に送信する、といった設定を行うことができます。

例）問い合わせ内容：

[設定ファイルでの指定方法]

dynamic_send_to_field = 選択によってメール送信先を変更するフィールド名
例） dynamic_send_to_field = type

対象となるフィールドは<select>または<input type="radio"〜 />である必要があります。

[テンプレートでの記述例]

入力画面テンプレート内の、「dynamic_send_to_field」で指定したフィールドの各選択肢に「sendto」属性を追加します。

例）　dynamic_send_to_field = type と設定した場合のセレクトリストの場合：
<p>お問い合わせ内容
<select name="type">
  <option value="1. 製品について" sendto="product@example.com">1. 製品について</option>
  <option value="2. サイトについて" sendto="info@example.com">2. サイトについて</option>
  <option value="3. 求人について" sendto="recruit@example.com">3. 求人について</option>
  <option value="4. その他" sendto="info@example.com">4. その他</option>
</select>
</p>

例）　dynamic_send_to_field = type と設定した場合のラジオボタンの例：
<p>お問い合わせ内容
  <input type="radio" name="type" value="1. 製品について" sendto="product@example.com" />1. 製品について
  <input type="radio" name="type" value="2. サイトについて" sendto="info@example.com" />2. サイトについて
  <input type="radio" name="type" value="3. 求人について" sendto="recruit@example.com" />3. 求人について
  <input type="radio" name="type" value="4. その他" sendto="info@example.com" />4. その他
</p>

■ eFormとの差異

標準で添付されるスニペット eForm と比べて、主に以下の点に対応していません。

などなど。

■ バグレポート、お問い合わせ、サポート

ブログ「網的脚本実験室」まで
http://www.clefarray-web.net/blog/

または、MODxの公式日本語フォーラムでも受け付けています。

■ ご注意、免責事項

※本スクリプトは MODx と同様、GPL ライセンスの元で配布されています。
※本スクリプトに関してのメール等での個別のお問い合わせはご遠慮ください。
※本スクリプトの使用によって生じた損害等について、作者は一切の責務を負わない事とさせていただきます。ご了承ください。
※バージョン1.0以降、動作検証は MODx Evolution 1.0.x 日本語版にて行っています。また文字コードは UTF-8 に限定しております。

■ 更新履歴

2013-05-23 v1.3
[NEW] 管理者メールのCC, BCC送信　（admin_mail_cc, admin_mail_bcc)
[NEW] メール送信文字コードの指定 (mail_charset)
[NEW] 送信後遷移する完了画面を指定可能に（complete_redirect)
[NEW] 選択肢による管理者メール送信先の動的変更 (dynamic_send_to_field )
[CHANGE] 設定チャンクサンプルconfig_chunk.txtでの「reply_to」「use_store_db」「vericode」の初期値変更
2011-04-04 v1.2
[NEW] cfFormDBとの連携機能追加
[NEW] 検証メソッド”url”, ”convert”追加
[NEW] 環境設定 use_store_db, send_mail 追加
[CHANGE] tel検証メソッドを使用した項目は全角英字・ハイフンも半角に変換（従来は全角数字のみ）
[FIX] 長い件名への対応強化
2010-11-10 v1.1r2
[FIX] メール送信者名やメール件名が長い場合に不要な文字が挿入されてしまう不具合に対処
（ただしWindows版PHPからmail関数でメール送信する設定の場合は正常動作しない可能性があります。）
[FIX] ユーザーからのファイルアップロードの際、サーバー環境によって保存がうまくいかない場合に対処 （環境設定 upload_tmp_path 追加）
2010-05-12 v1.1
[FIX] 開始タグと閉じタグの間にテキストの無い偶数個目のタグ（<textarea>タグなど）について値の復元が正しく行われない不具合を修正(thanks to trickstarさん）
[CHANGE] 同梱のサンプルテンプレートの名称を変更（thanks to yamaさん / 公式フォーラムより）
[CHANGE] cfFileViewプラグインを MODx v1.0.3でのプラグインインストール半自動化に対応
2010-03-06 v1.0
[NEW] ファイルを添付しての送信に対応。（環境設定 attach_file, attach_file_name追加）
[NEW] ユーザーからの画像ファイルアップロードと送信に対応
[NEW] 携帯端末宛自動返信メールのテンプレートをPC宛とは独立して設定可能に。（環境設定 tmpl_mail_reply_mobile追加）
[NEW] valid属性の3番目のパラメータを[+errors+]表示時の項目名として利用
[CHANGE] 独自検証メソッド、独自フィルターメソッドの追加方法を変更（※従来の方法もひとまず使用可能ですが、非推奨）
[CHANGE] 環境設定admin_nameの初期値を、「サイト名」から未定義に変更
[CHANGE] class.cfFormMailerMODx.inc.phpを廃し、メインクラス内に統合
[FIX] メールの件名と送信者名が文字化けする場合がある不具合に対処
[FIX] selectタグ、textareaタグへINVALID_CLASSを付加する際に余分なスラッシュを付加してしまう問題を修正
[FIX] サンプルテンプレートでのID重複を削除
2009-09-12 v0.0.7.2
[FIX] 独自検証メソッド、フィルターメソッド追加に関する不具合を修正
[FIX] フォームの各属性の値が大文字で記述されていた場合に、エラー画面で入力値が反映しない不具合を修正
[FIX] 空のvalue属性があった場合にタグが崩れる不具合を修正
[FIX] 入力画面サンプルチャンクの<form>タグにaction属性を追加
2007-11-13 v0.0.7.1
[FIX] 前後にタブを含む<option>タグを正常に処理できない不具合を修正
[FIX] 初期選択値（selected="selected")が指定されている場合は削除
2007-11-04 v0.0.7
[NEW] HTML メール送信に対応
[NEW] 検証メソッド”tel”追加
[NEW] 自動返信先となるメールアドレスを任意指定可能に
[NEW] [+reply_to+]プレースホルダ追加
[CHANGE] 自動返信先として指定したフィールドは必ず、メールアドレス形式として正しいかを検証（→検証メソッド email は付けなくて良いです）
[FIX] EUC-JP 環境化でのメール文字化け解消
2007-10-23（未公開） v0.0.6
[NEW] [+sender_ip+][+sender_host+][+sender_ua+]プレースホルダ追加
[NEW] 管理者宛メールアドレス（admin_mail）に複数のメールアドレスを指定可能に
[NEW] 検証メソッド”sameas”追加
[NEW] エラーのあるフィールドに任意のクラスセレクタを付加
[NEW] admin_ishtml, reply_ishtml, reply_fromname, invalid_class 設定項目を追加
[CHANGE] mb_send_mail()関数ではなく MODx 付属の PHPMailer クラスを使用するように変更。送信メールの文字コードは iso-2022-jp。
[FIX] 一部の設定項目省略値が反映されない不具合を修正
2007-10-16（未公開）v0.0.5
[NEW] CAPTCHA 認証コードに対応
[NEW] 検証メソッド”range”追加
[FIX] 入力値が空(NULL）の場合は確認画面表示時に &nbsp; に変換
2007-10-09 v0.0.4
[FIX] [+errors+]が効かない不具合を修正
[FIX] システムが付加するフィールドはアンダースコア(_)から始まる名称に変更
[NEW] <label>タグに対応
[NEW] 入力必須項目のエラーメッセージで、ラジオボタンやリストのときは「選択必須項目です」と表示（他は「入力必須項目です」）
2007-04-29 v0.0.3（公開初版）