公開日:
更新日:
ACFの使い方 第8章:主要フィールドタイプの整理(選び方・返り値・コードの型)
Text、Image、Relationship、RepeaterなどACFの主要フィールドタイプを用途別に確認できます。get_fieldで返る型、single.php等での取得・表示の目安を辞書形式で掲載します。
ACFには多くのフィールドタイプがありますが、すべてを覚えてから作り始める必要はありません。保存したい情報が電話番号ならText、改行を含む住所ならTextarea、メディアライブラリから写真を選ぶならImageというように、投稿する人がどのように入力するかから選びます。
まず、よく使う値とフィールドタイプの対応を確認します。
| 入力したい情報 | 選ぶフィールド | PHPへ返る値 |
|---|---|---|
| 電話・1行テキスト | Text | 文字列 |
| 住所・複数行(装飾なし) | Textarea | 文字列 |
| 写真1枚 | Image | Image ID(第5章) |
| 公式URL | URL | 文字列 |
| 同じ形の行(FAQなど) | Repeater(PRO) | have_rows(第6章) |
| 型の違うセクション(LP) | Flexible(PRO) | get_row_layout(第7章) |
Text、Textarea、URL、Imageで足りないときに、選択肢を用意するChoice系、別の投稿を選ぶRelational系、複数行を扱うRepeaterへ進むと探しやすくなります。値の表示方法は第4章、画像は第5章でコードを確認できます。
入力欄を作る前に返り値も確認する
同じImageフィールドでも、設定によってPHPへ返る値は画像ID、URL、配列のいずれかになります。Post ObjectやLinkにも返り値の設定があるため、投稿画面での入力しやすさだけで選ばず、テーマのPHPで何を受け取るかまで確認します。公開後に返り値だけを変えると既存コードと合わなくなるので、フィールドの作成時に決めておく方が安全です。
電話番号とFAX番号を別々の場所へ表示するなら、両方を一つのTextへ入力させず、それぞれのフィールドを作ります。入力欄を分ける基準は、公開ページで別々に取り出す必要があるかどうかです。

文字や数値を入力するフィールド
single.php など テーマのPHPテンプレートに書くときの目安です。値の取得は 第4章 の get_field( 'フィールド名' ) が基本で、表示前に WordPress のエスケープ関数を通します。下表の ... はフィールド名のプレースホルダです。
| タイプ | 入力イメージ | 返り値の目安 | 使いどころ | テーマファイルでの取得・表示(例) |
|---|---|---|---|---|
| Text | 1行文字列 | 文字列 | 電話番号、キャッチコピー、価格ラベル | esc_html( (string) get_field( '...' ) ) |
| Textarea | 複数行(装飾なし) | 文字列 | 住所、短い説明、FAQ回答(装飾不要) | nl2br( esc_html( (string) get_field( '...' ) ) ) |
| Number | 数値 | 数値または文字列としての数値 | 席数、面積、ソート用の数値 | $n = get_field( '...' ); → 比較・計算前に (int) または (float) |
| メール形式 | 文字列 | 問い合わせ先 | get_field( '...' ) → 表示は esc_html / mailto: の href は esc_url | |
| URL | URL | 文字列 | 公式サイト、SNS | esc_url( (string) get_field( '...' ) )(リンク組み立ては 第4章) |
| Password | マスク入力 | 文字列 | 公開ページに出さない運用前提の内部値 | テーマファイルでは原則表示しない(get_field も避ける) |
文章・画像・ファイルを入力するフィールド
| タイプ | 投稿画面の入力 | PHPへ返る値 | 主な用途 | 表示時に確認すること |
|---|---|---|---|---|
| Wysiwyg Editor | リッチテキスト | HTML文字列 | 長文本文、装飾付きブロック | 出力は wp_kses_post 等で方針固定 |
| Image | メディア1枚 | 配列 / URL / ID(設定による) | 店舗写真、サムネ | 第5章 |
| File | 添付1件 | 配列 / URL / ID | PDF資料、ダウンロード | 公開範囲・直リンク方針を決める |
| oEmbed | YouTube等のURL | 埋め込み用HTML文字列 | 動画埋め込み | 出力方針・プライバシー方針はサイト全体で |
| Gallery(PRO) | 複数画像 | 配列(画像の配列) | 施工事例写真など | 枚数が多いときは画像用CPT + Relationshipも検討 |
選択肢から値を選ぶフィールド
| タイプ | 入力イメージ | 返り値の目安 | 使いどころ |
|---|---|---|---|
| Select | 単一または複数選択 | 文字列または配列(複数選択時) | カテゴリ的な分類、Flexible の無料代替の「種別」 |
| Checkbox | 複数チェック | 配列(値の配列) | 設備タグ、対応サービス一覧 |
| Radio Button | 単一選択 | 文字列 | 排他的なステータス(例: 在庫あり/なし) |
| Button Group | ボタン型単一選択 | 文字列 | 視認性重視の少数選択肢 |
| True / False | ON/OFF | true / false(DB上は1/0) | おすすめフラグ、表示/非表示 |
<?php
// おすすめプラン(Repeater内の plan_featured など)
$is_featured = (bool) get_sub_field( 'plan_featured' );
if ( $is_featured ) {
echo '<span class="badge">おすすめ</span>';
}
投稿・分類・ユーザーを選ぶフィールド
投稿・ターム・ユーザーを選ぶタイプです。Post Object、Page Link、Taxonomyなどは、設定した返り値によってID、オブジェクト、配列のどれを受け取るかが変わるため、コードを書く前に管理画面の設定と型を揃えます。
| タイプ | 主な用途 | PHPへ返る値 | 設計時に確認すること |
|---|---|---|---|
| Post Object | 関連記事・親子の関連付け | 投稿オブジェクト / ID / 配列 | 無料版で「1件だけ関連付け」する代表。複数行は Relationship |
| Relationship | 複数投稿の選択・並べ替え | 投稿オブジェクトの配列など | 一覧表示は foreach + setup_postdata または ID から get_post |
| Taxonomy | タームの選択 | タームオブジェクト / ID | 標準のタクソノミーUIと役割が重なる場合は標準側を優先検討。タームに 直接フィールドを持たせる方法は 第13章 |
| User | 担当者・監修者 | ユーザーオブジェクト / ID | プロフィール側のフィールド設計や 'user_' . $id の取得は 第14章 |
| Link | ラベル+URL+ターゲット | 連想配列(title, url, target) | 配列キーを決め打ちでテンプレに書く |
<?php
$link = get_field( 'cta_link' );
if ( is_array( $link ) && ! empty( $link['url'] ) ) {
$url = esc_url( $link['url'] );
$title = isset( $link['title'] ) ? esc_html( (string) $link['title'] ) : $url;
$target = ( ! empty( $link['target'] ) && $link['target'] === '_blank' ) ? ' target="_blank" rel="noopener noreferrer"' : '';
printf( '<a href="%s"%s>%s</a>', $url, $target, $title );
}
日付・地図・色を入力するフィールド
| タイプ | 主な用途 | PHPへ返る値 | 設定時に確認すること |
|---|---|---|---|
| Date Picker / Date Time Picker / Time Picker | イベント日、営業時間 | 設定により Ymd 形式文字列など | 表示フォーマットは date_i18n で整形 |
| Color Picker | ブランド色(限定的) | 色コード文字列 | デザインシステムと役割が重複しやすい |
| Google Map | 地図・座標 | 配列(lat/lng/address 等) | APIキー・プライバシー・表示方式は別設計 |
| Icon Picker | アイコン選択 | 設定次第 | テーマのSVGセットと整合させる |
入力画面をまとめるフィールド
| タイプ | 役割 | テーマファイルでの表示 |
|---|---|---|
| Tab / Accordion | 管理画面の見た目を分割 | 値は保存しない(表示整理のみ) |
| Group | サブフィールドを1つの配列にまとめる | get_field('group')['sub'] のように配列アクセス |
| Repeater(PRO) | 同型の行の繰り返し | 第6章 |
| Flexible Content(PRO) | 異型レイアウトの繰り返し | 第7章 |
| Clone(PRO) | 既存フィールドやフィールドグループの再利用 | 表示方法(Seamless / Group)で取得形が変わるため、設定とテンプレートをセットで確認 |
Group は「電話・FAX・メールを contact にまとめる」ようなときに使います。テーマでは次のように扱います。
<?php
$contact = get_field( 'contact' );
if ( is_array( $contact ) && ! empty( $contact['phone'] ) ) {
echo '<p>' . esc_html( (string) $contact['phone'] ) . '</p>';
}
PRO版で使える主なフィールド
| PRO版の機能 | できること | 無料版で近い作り方 |
|---|---|---|
| Repeater | 同型の行 | CPT + Post Object、または faq_1_q のような固定枚数 |
| Flexible Content | 異型セクション | Select + テンプレ分岐(第7章) |
| Gallery | 複数画像 | 画像CPT / 固定枚数Image |
| Options Page | サイト共通値 | 固定ページ1枚 + get_field( 'key', $page_id )(PRO版の使い方は 第15章) |
| Clone | 定義の再利用 | JSON同期・グループ複製 |
| ACF Blocks | ブロックエディタの自前部品 | ネイティブブロック・ブロックパターン(PRO版の使い方は 第12章) |
PROを購入するか迷う場合は、第10章:無料版とPROの比較と購入判断で、必要な編集操作から判断できます。
値が想定した形で返らないとき
返り値の設定とPHPコードが合っていないときは、表示結果から次の場所を確認します。
| フィールド | 起きていること | 確認する設定やコード |
|---|---|---|
| Image | URL返り値のまま alt 空 | ID または Array + wp_get_attachment_image(第5章) |
| Post Object | オブジェクト想定で ID が来る | 返り値設定を確認し、is_object / (int) で分岐 |
| Select(複数) | 文字列前提で esc_html | is_array で分岐してループ |
| Wysiwyg | 無エスケープ出力 | wp_kses_post 等 |
| Repeater | 親名とサブ名の取り違え | have_rows('親') の内側で get_sub_field('子') |
表示されない・false になるときは、フィールド名の typo、ロケーション、返り値設定の3点を先に確認します(詳細は 第11章)。
実際のページへ当てはめる
一つの投稿に電話番号を一つ保存するならText、写真を一枚選ぶならImageのように、まず通常のフィールドから考えます。同じ形のFAQを増減するならRepeater、メインビジュアルやCTAなど入力欄の違うセクションを並べるならFlexible Contentです。別の投稿を選ぶ場合はPost ObjectやRelationship、会社の電話番号のようにサイト全体で一つだけ使う値にはOptions Pageが合います。
フィールドタイプを増やすほど便利になるわけではありません。通常のフィールドで表せる情報へRepeaterやFlexible Contentを使うと、投稿画面もPHPも複雑になります。まず、保存する値が一つか複数か、別の投稿を選ぶのかを確認すると、必要なタイプを絞れます。
フィールドタイプは、管理画面の入力しやすさだけでなく、get_field() から何が返るかまで含めて選びます。自分のサイトへ組み合わせるときは、第9章の店舗、不動産、コーポレートの例から近いものを見ると、辞書の各項目を実際の設計へ当てはめやすくなります。
このシリーズの移動
ACF記事一覧
第1章〜第18章は下表のリンクから各記事へ進めます。
| 章 | 主なトピック |
|---|---|
| 第1章 | ACFとは/カスタムフィールドの役割/標準との違い/実例(店舗・FAQ・実績など) |
| 第2章 | インストール、無料版とPROの違い、管理画面の見方 |
| 第3章 | フィールドグループ、名前・ラベル、タイプ、表示条件、店舗情報の例 |
| 第4章 | get_field()中心の取得・エスケープ、the_field()の位置づけ、single.php 等への書き方 |
| 第5章 | 画像フィールド、返り値、alt、サイズ指定 |
| 第6章 | Repeater(PRO)、ループ、FAQ・料金表など |
| 第7章 | Flexible Content(PRO)でLPを作る方法、ブロックエディタとの違い |
| 第8章 | 主要フィールドタイプの整理 |
| 第9章 | 業種別の設計例(店舗・不動産・コーポレート等) |
| 第10章 | 無料版とPROの比較、購入判断 |
| 第11章 | 表示されない、get_field が false、条件・キャッシュ・JSON などのハマりどころ |
| 第12章 | ACF Blocks(PRO)、ブロックテーマ・サイトエディタとの関係 |
| 第13章 | タクソノミーにフィールドを付ける('term_' . $term_id と get_queried_object()) |
| 第14章 | ユーザー(著者)にフィールド('user_' . $user_id とプロフィール拡張) |
| 第15章 | Options Page(PRO)、サイト共通値の置き場('option' 第2引数) |
| 第16章 | ACFとCPT UIの組み合わせ、カスタム投稿・タクソノミー連携 |
| 第17章 | 構造化データや監修者情報など、メタデータをSEO補助に使う文脈 |
| 第18章 | クライアントが迷わない設計、命名、保守性 |
※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。
この記事を書いた人
WordPress Monitoring Service
WordPressサイトの異常に、
早く気づける体制を作りませんか?
死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。
合わせてこんな記事も読まれています
2026-11-02
wp-guide
Secure Custom Fields(SCF)の使い方|入力欄の作り方から繰り返しフィールドの表示まで
WordPress.orgが配布するSecure Custom Fields(SCF)で、フィールドグループを作って投稿画面に入力欄を足し、テーマで表示するまでの手順を説明します。ACFでは有料のPRO版にあるRepeater(繰り返しフィールド)やオプションページが、SCFでは追加料金なしで使えることも確認します。
2026-10-30
wp-guide
WordPressバックアッププラグインの選び方|UpdraftPlus・BackWPup・WPvivid・All-in-One WP Migrationの違い
WordPressのバックアッププラグイン4つを、無料版でできること(定期バックアップ、クラウド保存、復元、移行)と有料版が必要になる場面で比べます。制作会社が顧客サイトに入れるときの選び方と、入れたあとに確かめることも説明します。
2026-10-26
wp-guide
エックスサーバーのWordPress自動更新はどこまで任せてよい?WPパネルと管理画面の設定の違い
エックスサーバーでWordPressを自動更新するときに、どこで何を設定するのかを、通常のレンタルサーバーとXServer for WordPress(WPパネル)に分けて説明します。本体・プラグイン・テーマのどこまでを自動に任せるかの目安と、自動バックアップ14日分で戻せる範囲もまとめました。
最新記事はこちら
2026-11-13
wp-maintenance
WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること
WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。
2026-11-11
wp-maintenance
WordPressのサーバー移転を業者に頼む費用|1万円台から10万円近くまで、料金に入る作業と見積もりで確かめること
WordPressのサーバー移転を頼むと、移転先のサーバー会社の代行は1サイト1万円台(税込)、移転作業を受けている専門業者や制作会社は3万円前後から、プランや容量によって10万円近くまでが公開価格です。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、サーバー会社の移行ツールで足りるサイトの見分け方をまとめました。
2026-11-09
wp-maintenance
WordPressのテーマ変更の費用相場|業者に頼むと3万円台から、金額が変わる作業と見積もりで確かめること
公開中のWordPressサイトのテーマ変更を業者に頼むと、公開価格は3万円台(税別)から、デザインを作り直すと10万円を超えます。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、自社で切り替えてよいサイトの見分け方をまとめました。
