====== SPForm ======
MODx Revolutionで問い合わせページ、メールフォームなど作るためのAdd On。 

個人的には使い方は[[web:modx:revolution:addons:formit|FormIt]]のほうが素直で好きなんですが、動きがどうも怪しいので、こっちを使ってみました。


===== 設定 =====

各種設定値は、managerのスニペット->SPForm->SPForm を選択して、プロパティタブを選びます。
「Add Property Set」ボタンを押して、新しいプロパティセットを作成します。
呼び出す場合には、以下のように呼び出します。

  [[!SPForm@NewPropertySetName]]

===== よく使うプロパティ =====

^名前^内容^初期値^
| recipientArray | 送信先メールアドレス | Webmaster: |
|errorsTo|エラー送信先メールアドレス|you@yourdomain.com|
|spfDebug|Debugスイッチ|No(0)|
|spformTpl|formテンプレートchunk名|spformTpl|
|spfcaptchaTpl|CAPTCHAテンプレートchunk名|spfcaptchaTpl|
|formProcAllowedRefers|メール送信を許可されるRefer|インストールサイト|
|spfSMTP_Port|SMTPポート|587|
|spTextRows|テキストエリアの行数|10|
|spTextCols|テキストエリアのカラム数|50|
|incluseResetButton|リセットボタンの有無|No(0)|
|requireVerify|CAPTCHAを使用する|No(0)|
|useMathString|CAPTCHAに式を使用する|Yes(1)|
||||
||||
||||

===== Formテンプレート =====

^プレースホルダー^内容^
|%%[[+spf-recipient]]%%| <- recipientArray 受取人のコンボボックスを表示(一人の場合は非表示)|
|%%[[+spf-use-hidden-field]]%%|SPAMよけの隠しフィールド|
|%%[[+spf-name-prompt]]%%| <- $_lang['your-name']|
|%%[[+spf-email-prompt]]%%| <- $_lang['email-address']|
|%%[[+spf-subject-prompt]]%%| <- $_lang['subject'] |
|%%[[+spf-comments-prompt]]%%| <- $_lang['enter-comments']|
|%%[[+spf-text-rows]]%%| <- spTextRows|
|%%[[+spf-text-cols]]%%| <- spTextCols|
|%%[[+spf-submit]]%%| <- $_lang['submit']|
|%%[[+spf-reset]]%%|リセットボタン((incluseResetButtonで決定))|
|%%[[+spf-captcha-stuff]]%%|CAPTCHAの表示((requireVerifyで決定))((captchaプラグイン必須))|
|%%[[+spf-cookie-message]]%%|要cookieのメッセージ((requireVerifyで決定))((cookieのOnOffは判別していません))|
^SPFormResponce用^^
|%%[[+spf-thank-you]]%%| <- $_lang['thank-you']|
|%%[[+spf-came-from]]%%| <- $_lang['came-from']|
|%%[[+spf-back]]%%| 戻るlink生成(referから) 文字列は -> $_lang['back']|
|%%%%||
|%%%%||
|%%%%||

===== 日本語化 =====
手順は[[web:modx:revolution:lexicon|]]を参考にしてください。

===== 日本語ファイル =====
へっぽこですが{{:web:modx:revolution:addons:spform_lexicon_ja.zip|ここ}}に置いておきます。((全部は訳していません。ごめんね :!:))

===== 使用例 =====
こちらの[[http://www.rookie-inc.com/contact/|株式会社ルーキー／お問い合わせ]]ページで使用しています。

===== 参考 =====
[[http://bobsguides.com/spform-tutorial.html|SPForm Tutorial]]((evolutionの記述も多いので注意。))