ブログ一覧に戻る

公開日:

更新日:

ACF Clone(PRO)の使いどころ:フィールド定義を使い回す設計

ACF PROのCloneフィールドで同じフィールド定義を複数グループに使い回す方法を、SeamlessとGroup、Prefix設定、複製との違いまで実務目線で解説します。

同じフィールド定義を複数箇所で使い回す

ACF Clone(PRO)は、同じフィールド定義を複数の場所で使い回したいときに向いています。 たとえば「ボタン設定」「背景設定」「表示オプション」「監修者情報」のように、複数のフィールドグループや Flexible Content の各レイアウトで同じ入力項目を使う場合です。

ただし、Cloneは「フィールドをコピーして増やす機能」ではありません。ACF公式ドキュメントでは、Cloneは既存フィールドを実行時に読み込んで表示するもので、データベース上でフィールド定義を複製するものではないと説明されています。つまり、設計を共通化するための機能です。

やりたいこと向いている手段
同じ入力項目を別グループでも使いたいClone(PRO)
1回だけ似た項目を作りたいフィールドグループの複製
いくつかの値を1つのまとまりとして保存したいGroupフィールド
Flexible Content内の各レイアウトで共通設定を持ちたいClone(PRO)

Cloneでできること

Cloneは、既存のフィールドやフィールドグループを、別のフィールドグループ内に読み込むPRO機能です。たとえば「ボタン設定」というフィールドグループを1つ作っておき、ヒーロー、CTA、カード、LPセクションなどで同じボタン設定を使い回せます。

よくある使いどころは次のとおりです。

共通化したい項目例
ボタン設定ボタン文言、URL、別タブで開くか
背景設定背景色、背景画像、余白
表示オプションPCのみ表示、SPのみ表示、上部余白
CTA設定見出し、本文、ボタン、補足テキスト
監修者情報名前、肩書き、プロフィールURL

同じ項目をコピーして複数箇所に作ると、あとから項目名や選択肢を変えたくなったときに全箇所を直す必要があります。Cloneで共通化しておくと、フィールド定義の変更箇所を減らせます。

Cloneフィールドを開くと、読み込むフィールドグループ、表示方法、ラベルとフィールド名の接頭辞を同じ設定欄で指定できます。ここでは、共通の連絡先フィールドをGroup表示で読み込んでいます。

ACF Cloneで共通の連絡先フィールドをGroup表示する設定画面

実際によくあるケース

LPをFlexible Contentで作ると、ヒーロー、特徴、料金、FAQ、CTAなど複数のレイアウトを作ります。このとき、各レイアウトに「ボタン文言」「ボタンURL」「ボタン色」を毎回作ると、途中で「ボタンにアイコン有無を追加したい」となったときに、すべてのレイアウトを修正することになります。

このような場合、先に「Button」という共通フィールドグループを作り、各レイアウトからCloneで読み込む設計にします。変更が発生しても、ボタン定義の見直し箇所を減らせるため、保守しやすくなります。

一方で、1回しか使わない項目までCloneにすると、どこから読み込まれているか分かりにくくなります。Cloneは「本当に複数箇所で同じ意味の項目を使う」場合に絞るのが扱いやすいです。

Clone、Group、複製の違い

手段向いているケース注意点
フィールドグループの複製1回だけ似た入力欄を作りたい複製後は別定義なので、後から変更が分散する
Groupフィールド1つの画面内で関連する値をまとめたい複数グループへの定義使い回しにはならない
Clone(Seamless)既存フィールドをその場に展開して見せたいフィールド名の衝突に注意する
Clone(Group)共通部品を1つのまとまりとして扱いたい取得方法とPrefix設定を決めておく必要がある

Cloneは「入力UIを整理する」だけでなく、フィールド定義の保守範囲を小さくするための機能です。

SeamlessとGroupの違い

Cloneには主に2つの表示方法があります。

表示方法管理画面での見え方テンプレートでの考え方
SeamlessCloneフィールド自体が見えず、読み込んだフィールドがその場に並ぶ通常のフィールド名で取得する
GroupCloneフィールドがグループのように見え、その中に読み込んだフィールドが入るCloneフィールド名を起点に配列として扱える

Seamlessは、編集画面を自然に見せたいときに向いています。Groupは、「これは共通ボタン設定です」のようにまとまりとして見せたいときに向いています。

Seamlessの取得例

Button フィールドグループに button_text と button_url があり、それをSeamlessでCloneした場合、通常のフィールドと同じように取得します。

<?php
$button_text = (string) get_field( 'button_text' );
$button_url  = (string) get_field( 'button_url' );

if ( $button_text !== '' && $button_url !== '' ) : ?>
	<a class="button" href="<?php echo esc_url( $button_url ); ?>">
		<?php echo esc_html( $button_text ); ?>
	</a>
<?php endif; ?>

画面上は自然ですが、同じフィールド名が同じ編集画面内に複数出ると衝突します。複数回読み込む可能性があるなら、Prefix Field Namesを使うか、Group表示に寄せます。

Groupの取得例

Cloneフィールド名を main_button にして、Group表示で使う場合は、Cloneフィールド自体を配列として取得できます。

<?php
$button = get_field( 'main_button' );

if ( is_array( $button ) ) {
	$text = isset( $button['button_text'] ) ? (string) $button['button_text'] : '';
	$url  = isset( $button['button_url'] ) ? (string) $button['button_url'] : '';
} else {
	$text = '';
	$url  = '';
}

if ( $text !== '' && $url !== '' ) : ?>
	<a class="button" href="<?php echo esc_url( $url ); ?>">
		<?php echo esc_html( $text ); ?>
	</a>
<?php endif; ?>

Group表示は、テンプレート側で「このまとまりはボタン設定」と読めるため、共通部品として扱いやすくなります。

Prefix Field Namesを使う場面

Cloneで一番事故が起きやすいのは、同じフィールド名が同じ編集画面に複数出るケースです。たとえば、HeroにもCTAにも同じ button_text があると、どちらの値なのか分かりにくくなります。

この場合は、Prefix Field Namesを使って保存名を分けます。

Cloneの場所Prefix後の例
Heroのボタンhero_button_text、hero_button_url
CTAのボタンcta_button_text、cta_button_url
Cardのボタンcard_button_text、card_button_url

公式ドキュメントでも、Group表示ではPrefix Field Namesを使う判断が紹介されています。保守現場でも、同じ画面で同じCloneを複数回使うなら、名前衝突を避ける設計を優先します。

RepeaterやFlexible Content内で使うとき

CloneはRepeaterやFlexible Content内でも使えます。LPの各レイアウトで「共通余白設定」「共通ボタン設定」を持たせるような使い方です。

ただし、入れ子が深くなるほど、編集画面もテンプレートも読みにくくなります。公式ドキュメントでも、CloneをRepeaterやFlexible Content内で使う場合の制限が説明されています。特に、同じClone sub fieldを複数並べるケースや、Group表示と have_rows() の組み合わせでは注意が必要です。

実務では、次のように線を引くと扱いやすいです。

  • 各レイアウトで1回だけ使う共通設定ならCloneを検討する
  • 同じレイアウト内で同じCloneを複数回使うならPrefixを必ず検討する
  • 2階層以上の入れ子Cloneは、管理画面の理解コストを確認してから使う
  • 編集者に説明できない構造なら、多少重複しても単純なフィールドに戻す

公式情報

ACF記事一覧

共通部品が二つ以上あるときに使う

Cloneは、ボタンや背景設定のような同じ項目を複数のフィールドグループで保守するときに役立ちます。一度しか使わない項目まで共通化すると定義元を探す手間が増えるので、同じ変更を何度も繰り返していると分かってから導入するくらいで十分です。

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

この記事を書いた人

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監視を始められます。

ブログ一覧に戻る

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

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

2026-11-20

wp-guide

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。

Secure Custom Fields(SCF)の使い方|入力欄の作り方から繰り返しフィールドの表示まで

2026-11-02

wp-guide

Secure Custom Fields(SCF)の使い方|入力欄の作り方から繰り返しフィールドの表示まで

WordPress.orgが配布するSecure Custom Fields(SCF)で、フィールドグループを作って投稿画面に入力欄を足し、テーマで表示するまでの手順を説明します。ACFでは有料のPRO版にあるRepeater(繰り返しフィールド)やオプションページが、SCFでは追加料金なしで使えることも確認します。

WordPressバックアッププラグインの選び方|UpdraftPlus・BackWPup・WPvivid・All-in-One WP Migrationの違い

2026-10-30

wp-guide

WordPressバックアッププラグインの選び方|UpdraftPlus・BackWPup・WPvivid・All-in-One WP Migrationの違い

WordPressのバックアッププラグイン4つを、無料版でできること(定期バックアップ、クラウド保存、復元、移行)と有料版が必要になる場面で比べます。制作会社が顧客サイトに入れるときの選び方と、入れたあとに確かめることも説明します。

最新記事はこちら

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

2026-11-20

wp-guide

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。