タグの使い方

This page is also available in English.

Contact Form 7 ではさまざまな「タグ」を使ってコンタクトフォームとメール (ヘッダーと本文) のテンプレートを編集することが可能です。タグとは Contact Form 7 の用語で角カッコ ([ ]) で囲んだ短い文字列を指します。

フォームに用いられるタグとメールに用いられるタグはそれぞれ異なっていて、例えばフォームには [text* your-name] を使いますが、メールには [your-name] を使います。これらはそれぞれ異なった構文を持ちます。

フォームタグの構文

フォームテンプレートで用いられるタグ (「フォームタグ」) は、実際のフォームに表示される際に入力項目をあらわす HTML 要素に変換されます。フォームタグはタイプ、名前、オプション、値の4つの構成要素に分けることができます。

form tag example

タイプは最も重要な要素であり、どのような HTML 要素がこのタグ自身を置き換えることになり、そしてどのような入力値が求められるかを定義します。

名前は入力項目を識別するために使われます。大半のフォームタグが1個の名前を持ちますが、例外もあります。

フォームタグの名前は英字 ([A-Za-z]) で始まり、任意の数の数字 ([0-9])、ハイフン (-)、アンダーバー (_) が続くものである必要があります。コロン (:) とピリオド (.) をフォームタグの名前の中で使うことも認められていますが推奨されません。加えて、フォームタグの名前として使うのは避けるべき予約語があることにも注意してください。

オプションは挙動と外観についての詳細を指定するものです。オプションは任意設定です。

多くの場合、値はデフォルト値を指定するために使われます。タグのタイプによっては値を違う用途に使うこともあります。値は任意設定です。

これら構成要素の順序は重要です。オプションが名前より前に来ることはありませんし、値がオプションの前に来ることもありません。

フォームタグタイプの一覧

メールタグの構文

メールテンプレートで用いられるタグ (「メールタグ」) はずっとシンプルです。メールタグは1個の単語だけで構成されます。ほとんどの場合、この単語はフォームタグの名前と対応づけられていて、その入力項目の入力値によって置き換えられます。

mail tag example

WordPress のお問い合わせフォームプラグイン。シンプル、でも柔軟。