チェックアウトフィールドマネージャー（CFM）の目的は、顧客から収集したいデータを柔軟に設定できるようにすることです。CFMは22種類のフィールドタイプを提供しており、最適な方法でデータを収集できます。
一般的なフィールド要素
すべてのフィールドに共通するフィールドオプションはごくわずかですが、ほとんどのフィールドに共通するものもあります。以下に例を示します。
フロントエンドのチェックアウトフィールドにフィールドを表示する
このオプションを使用すると、フィールドを管理画面のみ、または管理画面とサイトのフロントエンドの両方に表示できます。以下は、バックエンドにのみ表示するように設定されたフィールドビルダーの例です。
こちらは、支払いレコードページ（ダウンロード → 支払い履歴）に表示される同じフィールドです。
このフィールドは管理者が使用できますが、顧客がその存在を知る必要はありません。
エクスポートされたCSVに表示する
このフィールドをエクスポートされたCSVに含めるかどうかを選択できます。
このメタデータをどこに保存しますか
このメタデータを支払いメタ（特定のユーザーによるすべての注文に対する異なる値）またはユーザーメタ（特定のユーザーによるすべての注文に対する同じ値）に保存するかどうかを選択できます。
注意：設定で「ログイン必須」が有効になっていない場合、ユーザーメタにデータを保存するオプションは表示されません。これは、ユーザーアカウントがないユーザーのメタデータを保存できないためです。この設定は、ダウンロード → 設定 → その他 → チェックアウト に移動することで確認できます。
メタキー
これは、このデータを保存したいメタフィールドの名前です。フィールド作成時に空白のままにした場合、フィールドラベルに基づいて自動的に作成されます。
注意：メタキーは作成後に変更しないでください。変更すると、以前のメタキーで作成されたデータは失われます。
注意：メタキーにスペースを含めることはできません。慣例としてスペースはアンダースコアに置き換えられますが、ハイフンも使用できます。
CSSクラス名
これにより、このフィールド専用のカスタムCSSクラス名を設定できます。
サイズ
すべてのテキストタイプのフィールドには、サイズ（幅）のオプションがあります。結果は使用されているテーマによって異なる場合があります。
ユーザーメタにデータを保存する
前述のように、フィールドを支払いメタまたはユーザーメタのいずれかに保存するオプションがあります。ユーザーメタに保存されたデータは、購入を行ったログイン中のユーザーに紐付けられ、そのユーザーが将来使用できるようになります。
例としては、顧客の電話番号が挙げられます。トランザクション中にユーザーメタに保存されると、その顧客がログインして別のトランザクションを行った際に、電話番号が自動的に入力されます。
顧客は、[edd_profile_editor]ショートコードによって作成されたプロファイルエディターで、ユーザーに紐付けられたカスタムフィールドにアクセスすることもできます。
注意: ユーザーメタにデータを保存するオプションは、“ログイン必須”オプションが ダウンロード → 設定 → その他 → チェックアウト で有効になっている場合にのみ利用可能です。
フィールドタイプオプション
選択できるフィールドタイプは22種類あります：
アクションフック
これは開発者が動的な要素を好きなように追加するためのものです。これにより、このフォームに追加したいあらゆる入力タイプを追加する機会が得られます。下の画像は、フック名「hookname」を使用したコード例でこのフィールドを示しています。
コード例:
add_action('{hookname}', 'my_function_name}', 10, 4 );
// first param: Form Object
// second param: Save ID of payment if in scope, else -2
// third param: Save ID of user if in scope, else -2
// fourth param: Field Object
function my_function_name( $form, $payment_id, $user_id, $field ) {
// Do whatever you want here
}
注意: Easy Digital Downloads はカスタムコーディング/開発のサポートを提供していません。必要に応じて、Codeable を通じて開発者を雇い、必要なカスタム変更を行うことをお勧めします。
チェックボックス
標準的な汎用チェックボックスセットを作成します。
国
このフィールドでは、国の一覧をユーザーに提示できます。フィールドオプションにはすべての現在の国が含まれており、必要に応じてカスタムリストを作成するために追加または削除するオプションがあります。
日付
このフィールドでは、エンドユーザーが日付を入力でき、オプションで時刻も入力できます。時刻を入力できるかどうか、および開始ビューを日、月、または年のいずれにするかを選択できます。
メール
このフィールドは通常のテキストフィールドのように見えますが、有効なメールアドレスを要求するように検証します。
ファイルアップロード
このフィールドはファイルアップロードメカニズムを作成し、最大ファイルサイズ、最大ファイル数、および次のファイルタイプに制限するオプションを設定できます：
- 画像 (jpg, jpeg, gif, png, bmp)
- 音声 (mp3, wav, ogg, wma, mka, m4a, ra, mid, midi)
- 動画 (avi, divx, flv, mov, ogv, mkv, mp4, m4v, divx, mpg, mpeg, mpe)
- PDF (pdf)
- Officeドキュメント (doc, ppt, pps, xls, mdb, docx, xlsx, pptx, odt, odp, ods, odg, odc, odb, odf, rtf, txt)
- Zipアーカイブ (zip, gz, gzip, rar, 7z)
- 実行可能ファイル (exe)
- CSV (csv)
名
このフィールドは、デフォルトサイズ40のテキストフィールドを作成し、meta_keyまたはインポート/エクスポート機能のオプションは含まれていません。また、フォームに姓フィールドを複数作成することはできません。
非表示
このフィールドは標準の非表示フォームフィールドを作成します。meta_key、meta_value、およびフロントエンドのみにするか、フロントエンドとバックエンドの両方にするかのオプションのみがあります。
ハニーポット
このフィールドは、ボットのみが見ることができ、ボットが入力する空のフィールドを作成します。 入力された場合、フォーム送信は拒否されます。ハニーポットフィールドに関する詳細情報。
HTML
このフィールドでは、タイトルと任意のHTMLを提供できます。
姓
このフィールドは、姓用のプレーンテキストフィールドです。
注意: フォームには削除できない姓フィールドが付属しており、2番目の姓フィールドを追加することはできません。つまり、このオプションを使用することはほとんどないでしょう。まれに姓フィールドが誤って削除されることがあります。このオプションを使用すると、それを復元できます。
複数選択
このフィールドは標準の複数選択ボックスを作成します。デフォルトの選択テキストを指定し、好きなだけオプションを作成できます。
ラジオ
このフィールドは標準のラジオボタンセットを作成します。好きなだけ作成できます。
reCAPTCHA
このフィールドは、reCAPTCHA v3ツールを作成します。 reCAPTCHAを機能させるには、EDD設定パネルにサイトキーとシークレットキーを挿入する必要があります。Downloads > Settings > Extensions > Checkout Fields Managerページに移動し、APIキーをそこに追加してください。
reCAPTCHAキーをお持ちでない場合は、こちらから取得できます。APIキーを作成する際は、リストからreCAPTCHA V3を選択してください。
reCAPTCHA v3はサイレントで動作するため、チェックアウトフォームにはこのフィールドは表示されません。reCAPTCHAは、PayPalなどのオフサイト支払いでは自動的に無効になります。
繰り返し
このフィールドはテキストフィールドを作成し、顧客が希望するだけ追加できるオプションを提供します。以下はフロントエンドビューの例です。
セクションブレーク
このフィールドは、フォームにセクション区切りを作成します。タイトルと説明を含めることができます。
選択
このフィールドは標準のドロップダウン選択フィールドを作成します。上記のマルチセレクトとまったく同じように機能しますが、顧客は1つのオプションしか選択できません。
利用規約
このフィールドを使用すると、利用規約を含むHTMLブロックを印刷でき、顧客が同意するためにクリックするチェックボックスとラベルも提供されます。
テキスト
このフィールドは標準のHTMLテキスト入力フィールドを作成します。
テキストエリア
このフィールドは標準のHTMLテキストエリアを作成します。列数と行数、プレースホルダーテキスト、デフォルト値を設定でき、プレーンテキストエリア、リッチテキストエリア、またはティーニーリッチテキストエリアを選択できます。
URL
このフィールドは標準のテキスト入力フィールドを作成しますが、URLの検証を行います。
ユーザーメール
このフィールドは標準のテキスト入力フィールドを作成しますが、メールアドレスの検証を行います。WordPressユーザーのメールアドレスを取得することを目的としています。
注意:姓と同様に、このフィールドはすでにフォームに存在している必要があり、2つ目のフィールドを追加することはできません。このオプションは、メールフィールドが誤って削除された場合に置き換えることができるようにのみ存在します。
一般的な使用方法
フィールドタイプをクリックすると、画面中央のメイン列に追加され、フィールドのいくつかのオプションが表示されます。正確なオプションはフィールドタイプによって異なりますが、すべてのフィールドに共通のオプションがいくつかあります。
- 必須: 顧客にフィールドへの入力を必須にする場合は「はい」、任意にする場合は「いいえ」を選択してください
- フィールドラベル: これは、チェックアウト時にフィールドのプライマリラベルとして表示されるテキストです
- ヘルプテキスト: これは、顧客が入力すべき内容の説明として、チェックアウト時にフィールドの下に追加されるテキストです
必要なすべてのフィールドを追加したら、画面右上にある「保存」ボタンをクリックするだけです。保存すると、フィールドがチェックアウトに表示されます。
重要な注意点:
この拡張機能では変更できないチェックアウトフィールドがいくつかあります:
1.請求先住所フィールド。これらはクレジットカード決済ゲートウェイおよびEDD税システムによって必要とされるため、変更は許可されていません。
2. クレジットカードを処理する決済ゲートウェイで使用されるクレジットカードフォーム。これらのフィールドはEDDが期待する通りに正確に表示されることが不可欠であるため、これらのフィールドは変更できません。
