Create
フィールドグループを新規作成
- WordPress管理画面で「設定 → atshift Fields」を開きます。
- 「新規追加」を押し、用途が分かるグループ名を入力します。
- 「新規フィールドを追加」から最初のフィールドを作成します。
命名例: 「商品情報」「会社概要」「イベント詳細」のように、配置先や用途が分かる名前がおすすめです。
Overview
設定画面の全体像
フィールドグループには、入力欄を定義する「フィールド」と、どの編集画面へ表示するかを決める「配置ルール」があります。両方を設定して公開すると、条件に一致する投稿編集画面へ入力欄が表示されます。
Configure fields
ラベル・名前・タイプを設定
- ラベル
- 投稿編集画面で入力者に表示する名称です。
- 名前
CFS()->get( 'field_name' )で取得するときに使う識別名です。半角英数字とアンダースコアで、重複しない名前にします。- フィールドタイプ
- テキスト、日付、ファイル、選択肢、ループなど、保存する内容に合う種類を選びます。
- 説明
- 入力者へ補足したい内容を記載します。
タイプごとの追加設定
フィールドタイプを選ぶと、その種類に応じた設定が表示されます。必須入力、デフォルト値、プレースホルダー、選択肢、返り値などを必要に応じて指定してください。
デフォルト値とプレースホルダー
デフォルト値は最初から保存候補として入る値です。プレースホルダーは入力例やヒントで、値が入力されると表示されません。
Order
ドラッグ&ドロップで並べ替え
フィールドの見出し部分をドラッグすると、投稿編集画面に表示する順番を変更できます。「この下に新規フィールドを追加」ボタンを使うと、目的の位置へ直接フィールドを追加できます。
- 入力の流れに沿って上から下へ並べます。
- 関連する項目は近くにまとめます。
- フィールドタイプを変更した後は、追加設定を再確認します。
Structure
入力欄を構造化
ループ（複製フィールド）
同じ組み合わせを複数行入力するときに使います。子フィールドをループの内側へドラッグし、行ラベル、追加ボタン名、最小・最大行数を設定できます。
横並びグループ
関連する2〜4項目を横へ並べます。列数と均等配置／左寄せを選択でき、狭い画面では縦並びになります。
アコーディオン
子フィールドを開閉できるまとまりにします。初期状態で開いておくかを設定できます。
タブ
多数の入力欄をタブで区切ります。タブ自体は値を保存しません。
条件分岐グループ
選択肢に応じて子フィールドを表示・非表示にします。表示形式をラジオボタンまたはドロップダウンから選び、選択肢を設定した後、子フィールドを内側へドラッグします。各子フィールドの「条件分岐の表示指定」で、表示する選択肢を割り当ててください。
初期表示
ラジオボタンはデフォルト値に対応するフィールドを最初から表示します。ドロップダウンは「選択してください...」から始まり、選択後に対応するフィールドを表示します。非表示になったフィールドの保存値は保持されます。
重要: ループ、横並び、アコーディオン、タブは管理画面の構造を作るフィールドです。条件分岐グループは選択値も保存します。内側の値は各子フィールド名で取得してください。
Placement rules
表示する編集画面を指定
配置ルールで、フィールドグループを表示する条件を設定します。一般的には「投稿タイプ = 投稿」「投稿タイプ = 固定ページ」のように指定します。
投稿タイプ投稿フォーマットユーザー権限特定の投稿カテゴリー・タームページテンプレート
配置ルールが空の場合
すべての編集可能な投稿画面に表示されます。意図した動作でない限り、投稿タイプなどの条件を最低1つ設定してください。
Publish and enter
公開して投稿へ入力
- 設定内容を確認してフィールドグループを公開・更新します。
- 配置ルールに一致する投稿または固定ページを開きます。
- 表示された入力欄へ値を入力し、投稿を更新します。
- テーマでは各フィールド名を使って値を取得します。
Replacing upstream CFS
元版から置き換える場合
主要なデータ構造とAPI互換性を維持していますが、本番サイトへ導入する前にデータベースと元版プラグインをバックアップし、ステージング環境で確認してください。
- 元版とatshift Fieldsを同時に有効化しないでください。
- 既存のフィールドグループ、投稿入力、テーマ出力を確認します。
- atshift Fieldsで追加したフィールドは元版では利用できません。
- Add-onをご利用中の場合は、機能が重複していないか確認してください。
Add-onをご利用中の場合
atshift Fieldsで追加したラジオボタンやチェックボックスなどと機能が重複するAdd-onでは、保存値の形式やラベルの取得方法が異なり、テーマなどの出力側で書き換えが必要になる場合があります。該当するAdd-onを停止したうえで、既存の値が引き継がれているか、入力・保存・出力に問題がないかをステージング環境で確認してください。