フォームでエントリーなどのカスタムフィールドやグローバル変数を渡すカスタマイズ
フォームの自由度の高さは a-blog cms の特長のひとつです。このエントリーでは、そのカスタマイズの一例として、ユーザーがフォームに入力したフィールド以外の変数の渡し方を解説します。エントリーフィールド、カテゴリーフィールド、ブログフィールドなどのカスタムフィールド、クエリ変数やグローバル変数をフォームの変数として扱えるようにします。
変数を追加するテンプレートの場所
フォームを入力するテンプレートに追加します。公式テーマの site や beginner では /contact/form/input.html になります。初期の入力画面と step#reapply に共通でインクルードされ、追加した変数を途中のステップで表示することもできるようになります。
エントリーフィールドをフォームの変数として追加する
エントリーにフォームがあり、そのエントリーのカスタムフィールドを渡したい場合には、下記のようにコードを追加します。
<!-- BEGIN_MODULE Entry_Field -->
<input type="hidden" name="area" value="{area}">
<input type="hidden" name="field[]" value="area">
<input type="hidden" name="price" value="{price}">
<input type="hidden" name="field[]" value="price">
<!-- END_MODULE Entry_Field -->area 及び price というエントリーカスタムフィールドがフォームに渡されます。
カテゴリー、ブログ、ユーザーのカスタムフィールドをフォームの変数として追加する
カテゴリー、ブログのカスタムフィールドの場合も、エントリーの場合と同様、フォームに渡すことができます。また、ログインしているユーザーに関しては、ユーザーのカスタムフィールドを渡すこともできます。その場合 ctx="uid/%{SESSION_USER_ID}" を User_Field モジュールに追加します。
<!-- BEGIN_MODULE User_Field ctx="uid/%{SESSION_USER_ID}" -->
<input type="hidden" name="gender" value="{gender}">
<input type="hidden" name="field[]" value="gender">
<!-- END_MODULE User_Field -->gender というユーザーカスタムフィールドがフォームに渡されます。もちろん {name} や {mail} などのフィールドも渡せるので、ログインしたユーザーであればフォームの項目にいちいち入力させないといったカスタマイズも可能です。
グローバル変数をフォームの変数として追加する
グローバル変数はそのままでメールの返信テンプレートに使用できます。公式テーマでも %{BLOG_NAME} などのグローバル変数が使われています。拡張したグローバル変数の場合も同様です。しかし、グローバル変数もフォームの変数として追加する必要があるケースがあります。
- クエリストリングから作成されたグローバル変数の場合
- Google スプレッドシートと連携する場合
フォームへのリンクにクエリストリングを持たせておけば、どの媒体、どのページからの遷移であるかを確認するなどの使い方ができます。また、Google スプレッドシートとの連携はフォームの件数や項目が多い場合の管理に便利です。
グローバル変数をフォームの変数として追加する書き方は次のとおりです。
<input type="hidden" name="global_var" value="%{GLOBAL_VAR}">
<input type="hidden" name="field[]" value="global_var">以上、今回は type="hidden" で変数を渡すケースを解説しましたが、もちろん type="text" 等でフォームの項目の初期値として様々な変数を扱い、ユーザー側で変更可能にするカスタマイズも可能です。ぜひ、取り入れてみてください。
