ブログ一覧に戻る

公開日:

更新日:

ACFの使い方 第8章:主要フィールドタイプの整理(選び方・返り値・コードの型)

Text、Image、Relationship、RepeaterなどACFの主要フィールドタイプを用途別に確認できます。get_fieldで返る型、single.php等での取得・表示の目安を辞書形式で掲載します。

ACFには多くのフィールドタイプがありますが、すべてを覚えてから作り始める必要はありません。保存したい情報が電話番号ならText、改行を含む住所ならTextarea、メディアライブラリから写真を選ぶならImageというように、投稿する人がどのように入力するかから選びます。

まず、よく使う値とフィールドタイプの対応を確認します。

入力したい情報選ぶフィールドPHPへ返る値
電話・1行テキストText文字列
住所・複数行(装飾なし)Textarea文字列
写真1枚ImageImage ID(第5章)
公式URLURL文字列
同じ形の行(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へ入力させず、それぞれのフィールドを作ります。入力欄を分ける基準は、公開ページで別々に取り出す必要があるかどうかです。

ACFフィールドタイプの用途別分類図

文字や数値を入力するフィールド

single.php など テーマのPHPテンプレートに書くときの目安です。値の取得は 第4章 の get_field( 'フィールド名' ) が基本で、表示前に WordPress のエスケープ関数を通します。下表の ... はフィールド名のプレースホルダです。

タイプ入力イメージ返り値の目安使いどころテーマファイルでの取得・表示(例)
Text1行文字列文字列電話番号、キャッチコピー、価格ラベルesc_html( (string) get_field( '...' ) )
Textarea複数行(装飾なし)文字列住所、短い説明、FAQ回答(装飾不要)nl2br( esc_html( (string) get_field( '...' ) ) )
Number数値数値または文字列としての数値席数、面積、ソート用の数値$n = get_field( '...' ); → 比較・計算前に (int) または (float)
Emailメール形式文字列問い合わせ先get_field( '...' ) → 表示は esc_html / mailto: の href は esc_url
URLURL文字列公式サイト、SNSesc_url( (string) get_field( '...' ) )(リンク組み立ては 第4章)
Passwordマスク入力文字列公開ページに出さない運用前提の内部値テーマファイルでは原則表示しない(get_field も避ける)

文章・画像・ファイルを入力するフィールド

タイプ投稿画面の入力PHPへ返る値主な用途表示時に確認すること
Wysiwyg EditorリッチテキストHTML文字列長文本文、装飾付きブロック出力は wp_kses_post 等で方針固定
Imageメディア1枚配列 / URL / ID(設定による)店舗写真、サムネ第5章
File添付1件配列 / URL / IDPDF資料、ダウンロード公開範囲・直リンク方針を決める
oEmbedYouTube等のURL埋め込み用HTML文字列動画埋め込み出力方針・プライバシー方針はサイト全体で
Gallery(PRO)複数画像配列(画像の配列)施工事例写真など枚数が多いときは画像用CPT + Relationshipも検討

選択肢から値を選ぶフィールド

タイプ入力イメージ返り値の目安使いどころ
Select単一または複数選択文字列または配列(複数選択時)カテゴリ的な分類、Flexible の無料代替の「種別」
Checkbox複数チェック配列(値の配列)設備タグ、対応サービス一覧
Radio Button単一選択文字列排他的なステータス(例: 在庫あり/なし)
Button Groupボタン型単一選択文字列視認性重視の少数選択肢
True / FalseON/OFFtrue / 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コードが合っていないときは、表示結果から次の場所を確認します。

フィールド起きていること確認する設定やコード
ImageURL返り値のまま alt 空ID または Array + wp_get_attachment_image(第5章)
Post Objectオブジェクト想定で ID が来る返り値設定を確認し、is_object / (int) で分岐
Select(複数)文字列前提で esc_htmlis_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章クライアントが迷わない設計、命名、保守性

※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。

この記事を書いた人

uehiro
uehiroWebアプリケーションエンジニア

2019年よりWeb制作・システム開発に従事。WordPress・PowerCMS・Movable TypeのCMS構築・運用支援のほか、Next.js・Astro・Nuxt.jsを活用したヘッドレスCMS・モダンWeb開発に携わる。約150件の制作・運用支援実績を持ち、現在はWordPress監視サービス「NexraOne」の開発・運営を担当。

WordPress Monitoring Service

WordPressサイトの異常に、
早く気づける体制を作りませんか?

死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。

ブログ一覧に戻る

合わせてこんな記事も読まれています

最新記事はこちら

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

2026-11-13

wp-maintenance

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。

WordPressのサーバー移転を業者に頼む費用|1万円台から10万円近くまで、料金に入る作業と見積もりで確かめること

2026-11-11

wp-maintenance

WordPressのサーバー移転を業者に頼む費用|1万円台から10万円近くまで、料金に入る作業と見積もりで確かめること

WordPressのサーバー移転を頼むと、移転先のサーバー会社の代行は1サイト1万円台(税込)、移転作業を受けている専門業者や制作会社は3万円前後から、プランや容量によって10万円近くまでが公開価格です。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、サーバー会社の移行ツールで足りるサイトの見分け方をまとめました。

WordPressのテーマ変更の費用相場|業者に頼むと3万円台から、金額が変わる作業と見積もりで確かめること

2026-11-09

wp-maintenance

WordPressのテーマ変更の費用相場|業者に頼むと3万円台から、金額が変わる作業と見積もりで確かめること

公開中のWordPressサイトのテーマ変更を業者に頼むと、公開価格は3万円台(税別)から、デザインを作り直すと10万円を超えます。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、自社で切り替えてよいサイトの見分け方をまとめました。