アンケートフォームの作成

※ この機能はレガシーなプラグインによって提供されており、後方互換性のためにのみ同梱されております

拡張フィールドと組み合わせて、ユーザーからのフィードバックを受けるためのフォームを簡単に作成することができます。拡張テンプレートにはあらかじめフォームを生成するためのテンプレートが組み込まれており、また確認画面の表示や投稿されたデータを保存するための CGI プログラムが同梱されています。

フォームを作成する

フォームの作成は記事/ウェブページ (記事またはウェブページ) 単位で行います。フォームを作成する手順は、拡張フィールドで入力項目を指定して、テンプレート選択ドロップダウンメニューから「フォーム(記事)」または「フォーム(ウェブページ)」を選択して保存するだけです。フォームの生成に対応しているコントロールは「添付ファイル」「日付」以外のすべてのフィールドです。

例えば上記の図のような項目フィールドを追加して記事/ウェブページを保存すると、下の図のようなフォームが自動的に生成されます。

フォームに項目を入力して投稿すると、以下のような確認画面を表示した後、「送信する」ボタンをクリックすると投稿されます。処理を行うプログラムは mt-form.cgi です (この CGI スクリプトを管理画面CGIと同じ場所に設置して実行パーミッションを付与する必要があります)。

投稿後の処理とフォーム設定のカスタマイズ

1. 投稿後の処理と保存データ

デフォルトの設定では投稿された内容は、データベースに保存され記事/ウェブページの投稿者及びフォームからの投稿者にメールで通知されます (プラグイン設定で送信する/しないを切り替えられます)。投稿されたデータの一覧は、システムまたはブログのメニュー [フィードバック] 内 [フォームデータ]を選択することで表示されます。

投稿されたフォームデータは、投稿された記事/ウェブページ単位、メールアドレス単位、日付単位、IP アドレス単位、ステータスによって絞り込むことができます。フォームデータ (概要が表示されます) をクリックすると各データの詳細を見ることができ、項目を選択して CSV ファイルをダウンロードすることも出来ます。

2. 必須項目の指定条件

デフォルトのテンプレートでは、ラベルに「必須」の文字列を含む項目を必須項目として扱いますが、これはテンプレートで定義されています。

拡張フィールドをフォームのコントロールとして出力し、ラベルに「必須」を含む項目を必須項目として扱うためのテンプレートは以下のようなものです。<MTIf name="label" like="必須"> の部分を変更することで、必須項目の指定条件をカスタマイズすることができます (名前が required である hidden フィールドを指定することで必須項目チェックが行うことができます)。

<MTIfExtFieldType type="text">
  <MTSetVarBlock name="label"><$MTExtFieldLabel$></MTSetVarBlock>
  <dl>
    <dt><$MTVar name="label" escape="html"$></dt>
    <dd>
      <input type="text" name="<$MTExtFieldName escape="html"$>" style="width:95%" value="<$MTExtFieldText escape="1"$>" />
      <input type="hidden" name="item_array" value="<$MTExtFieldName escape="html"$>" />        <MTIf name="label" like="必須"><input type="hidden" name="required" value="<$MTExtFieldName escape="html"$>" /></MTIf>
    </dd>
  </dl>
</MTIfExtFieldType>

3. メール送信先/送信後に表示されるページの指定

送信後に表示するページのアドレスやメールを送信するユーザーの設定については form の hidden 項目として指定します。

テンプレートは既定で以下のようになっています。

<input type="hidden" name="blog_id" value="<$MTBlogID$>" />
<input type="hidden" name="entry_id" value="<$MTEntryID$>" />
<input type="hidden" name="template_id" value="<$MTBuildTemplateID$>" />
<input type="hidden" name="entry_author" value="<$MTEntryAuthorID$>" />
<input type="hidden" name="return_uri" value="<$MTEntryPermalink escape="html"$>" />
<input type="hidden" name="__mode" value="confirm" />

各パラメータの意味は次の通りです。

4. 確認画面のカスタマイズ

確認画面の表示には、template_id で指定したテンプレートが使われます。また、入力内容を表示する部分のテンプレートは以下のテンプレートが使われます。

$MT_DIR/plugins/ExtraForm/extraform_confirm.tmpl

確認画面は次の流れで生成されます。

1. CGI プログラムが受け取った値を「フォーム投稿確認画面テンプレート」に渡し、確認内容を反映したテーブルをビルドします。
2. templateid で指定したテンプレートに対し、entryid で指定した記事/ウェブページを指定してビルドします。但し、entry_text( <$MTEntryBody$>)を 1 でビルドしたテーブルに置き換えます。

2 でページをビルドするときに、確認画面を表示しているかどうかを MTIfEntryIsDynamic タグで分岐させることができます。つまり、確認画面のカスタマイズは、記事/ウェブページ (記事またはウェブページ) のテンプレートで MTIfEntryIsDynamic タグを利用して分岐させること及び「フォーム投稿確認画面」の内容を変更することで行うことができます。

また、フォームのパラメータ「key」によって確認画面上の処理を分岐させることができます。渡された「key」の値は「フォーム投稿確認画面」テンプレート の中でのみ利用できるタグ <mt:var name="key"> で取り出すことができます。例えば key に値が入っているかどうかでテンプレートを分岐させるタグは以下のようになります。

<mt:if name="key">
  <$MTTemplateNote value="キーが指定されているときの表示"$>
<mt:else>
  <$MTTemplateNote value="キーが指定されていないときの表示"$>
</mt:if>

key と同様に渡されるパラメータに error があります。これは、必須項目として指定された内容が空だった場合に指定されるパラメータです。

<mt:if name="error">
  入力されていない必須項目があります。入力内容を確認してください。
<mt:else>
  以下の内容でよろしければ送信してください。
</mt:if>

5. 通知メールのカスタマイズ

投稿後に送信される通知メールのテンプレートは以下のファイルになります。

• フォーム作成者宛メール(件名): $MT_DIR/plugins/ExtraForm/extraform_author_mail_subject.tmpl
• フォーム作成者宛メール(本文): $MT_DIR/plugins/ExtraForm/extraform_author_mail.tmpl
• フォーム投稿者宛メール(件名): $MT_DIR/plugins/ExtraForm/extraform_user_mail_subject.tmpl
• フォーム投稿者宛メール(本文): $MT_DIR/plugins/ExtraForm/extraform_user_mail.tmpl

プラグイン設定

「システムメニュー」→「プラグイン設定」→「ExtraForm」の設定で以下の項目が設定出来ます。

テンプレートタグ

ブロックタグ

MTIfEntryIsDynamic

テンプレートが確認画面表示処理から呼び出されている時にタグの内容を処理します。

「フォーム投稿確認画面」内で利用できるテンプレート変数

error

必須項目が空欄だったときに渡されます。

key

form の key パラメータに指定された値です。

環境変数

指定可能な環境変数の一覧です。