ブログ一覧に戻る

公開日:

更新日:

ACF Gallery(PRO)の使いどころ:固定Image・子CPTとの違い

ACF PROのGalleryフィールドを使うべきケース、無料版の固定Imageフィールドで足りるケース、画像を子CPTに分けるケースを実案件の判断基準で比較します。

写真の枚数と並び順が変わるならGalleryを使う

ACF Gallery(PRO)は、1つの投稿の中で、写真の枚数が読めず、編集者が並べ替えまでしたい場合に向いています。 物件、店舗、施工事例、宿泊施設、イベントレポートのように「写真が5枚のことも30枚のこともある」案件では、固定の Image フィールドを増やすより管理しやすくなります。

一方で、写真が最大3枚や最大8枚で確定しているなら、無料版の Image フィールドを image_1、image_2 のように固定で用意する方法でも十分です。写真ごとにタイトル、説明文、公開状態、カテゴリ、表示期間などを持たせたい場合は、Galleryではなく画像用の子CPTに分ける方が後から扱いやすいことがあります。

要件向いている手段
写真点数が固定で少ない無料版の Image フィールドを固定数で作る
写真点数が読めず、1投稿内で並べ替えたいGallery(PRO)
写真1枚ごとに詳細情報や公開制御が必要画像用の子CPT + Relationship など

Galleryでできること

Galleryは、複数画像を1つのフィールドにまとめるPRO機能です。編集画面では画像を追加し、並べ替え、削除できます。画像の一覧を見ながら順番を調整できるので、物件写真や施工事例のように「見せる順番」が重要なページで使いやすいです。

特に向いているのは次のようなケースです。

ケースGalleryが合う理由
物件詳細の写真一覧外観、内観、設備写真など、枚数が物件ごとに変わる
店舗ページの店内写真店舗ごとに写真点数が違い、編集者が順番を変えたい
施工事例のビフォーアフター以外の写真事例ごとに写真の補足枚数が変わる
イベントレポート開催ごとに写真数が読めず、時系列や見せ方を後から調整したい

Galleryは「写真を投稿本文の中に自由に貼る」のではなく、テーマ側で決めたHTMLに沿って写真一覧を出すためのフィールドです。表示の型をテーマ側で固定しつつ、画像の枚数と順番だけ編集者に任せたいときに合います。

Galleryフィールドでは、返り値だけでなく、プレビューサイズや追加できる画像の条件も設定できます。これらを先に決めておくと、投稿者が画像を追加した後でテンプレートとの不一致が起きにくくなります。

ACF Galleryの返り値とプレビューサイズを指定するフィールド設定画面

実際によくあるケース

不動産サイトや施工事例サイトでは、最初の設計時に「写真は多くても8枚くらい」と聞いて固定Imageで作り始めることがあります。ところが運用が始まると、角部屋だけ写真が多い、リフォーム後の写真を追加したい、外観と内観の順番を変えたい、といった要望が出ます。

この場合、image_1 から image_8 までの固定フィールドでは、次のような問題が出やすくなります。

  • 9枚目を追加するたびにフィールドとテンプレート修正が必要になる
  • image_3 と image_4 の順番を入れ替えるだけでも画像を選び直す必要がある
  • 空欄が増えると、テンプレート側で毎回存在確認が必要になる
  • 編集者が「どこに何枚入れればよいか」を覚えないといけない

このように、枚数が読めない・順番を頻繁に変えることが分かった時点で、Galleryを検討します。逆に、会社概要の代表画像3枚のように枚数が増えないものは固定Imageで十分です。

固定Image、Gallery、子CPTの違い

手段向いているケース注意点
固定Imageフィールド最大枚数が決まっていて、並べ替えがほぼない枚数追加のたびにフィールドとテンプレート修正が必要
Gallery(PRO)枚数が読めず、1投稿内で画像を並べ替えたい写真1枚ごとの独自項目は持たせにくい
画像用の子CPT写真ごとに説明文、公開状態、カテゴリ、担当者などを持たせたい投稿が増えるため、管理画面とクエリ設計が少し重くなる
本文ブロックに画像を挿入編集者が記事本文の流れに合わせて自由に画像を置きたいテーマ側で画像一覧のHTMLを完全固定しにくい

「Galleryは画像をたくさん入れられるから便利」ではなく、1投稿内で画像をまとめて管理し、並べ替えたいかで判断します。

Galleryの返り値はIDを基本にする

Galleryの返り値は Array、URL、ID から選べます。テーマで画像サイズ、alt、srcset をWordPress標準に任せるなら、ID を基本にすると扱いやすいです。

<?php
$image_ids = get_field( 'property_gallery' );

if ( is_array( $image_ids ) && $image_ids ) : ?>
	<ul class="property-gallery">
		<?php foreach ( $image_ids as $image_id ) : ?>
			<?php $image_id = (int) $image_id; ?>
			<?php if ( $image_id ) : ?>
				<li class="property-gallery__item">
					<?php echo wp_get_attachment_image( $image_id, 'large' ); ?>
				</li>
			<?php endif; ?>
		<?php endforeach; ?>
	</ul>
<?php endif; ?>

wp_get_attachment_image() を使うと、WordPressが登録済みの画像サイズや srcset を組み立てます。altはメディアライブラリ側の代替テキストを使うため、編集者には画像追加時にaltも確認してもらう運用にします。

Array返り値を使う場合

画像のキャプションや説明文をその場で使いたい場合は、Array返り値も候補です。ただし、テンプレート側で配列キーを直接扱うため、出力時のエスケープを忘れないようにします。

<?php
$images = get_field( 'case_gallery' );

if ( is_array( $images ) && $images ) : ?>
	<div class="case-gallery">
		<?php foreach ( $images as $image ) : ?>
			<?php
			$url     = isset( $image['sizes']['large'] ) ? $image['sizes']['large'] : '';
			$alt     = isset( $image['alt'] ) ? $image['alt'] : '';
			$caption = isset( $image['caption'] ) ? $image['caption'] : '';
			?>
			<figure class="case-gallery__item">
				<img src="<?php echo esc_url( $url ); ?>" alt="<?php echo esc_attr( $alt ); ?>">
				<?php if ( $caption !== '' ) : ?>
					<figcaption><?php echo esc_html( $caption ); ?></figcaption>
				<?php endif; ?>
			</figure>
		<?php endforeach; ?>
	</div>
<?php endif; ?>

画像の表示だけならID、キャプションもテンプレートで使うならArray、という線引きにすると迷いにくいです。

表示速度で確認すること

Galleryは便利ですが、画像を多く入れるほどページは重くなります。運用開始前に次を決めておきます。

  • 一覧ページでは何枚まで表示するか
  • 詳細ページでは最初から全画像を読み込むか
  • サムネイルと拡大画像のサイズを分けるか
  • 画像の最大横幅やファイルサイズを管理画面で制限するか
  • alt未入力の画像を公開前に確認するか

公式ドキュメントでも、Galleryには最小・最大選択数、画像の幅・高さ・ファイルサイズ、許可ファイルタイプなどの設定があります。保守しやすいサイトにするなら、編集者の自由度を残しつつ、ファイルサイズや枚数には上限を置く方が安全です。

公式情報

ACF記事一覧

写真ごとの情報量で保存方法を決める

写真の枚数が決まらず、編集者が表示順も変えるならGalleryが扱いやすいです。会社概要に載せる三枚の写真のように数が固定されているならImageフィールドを分けたほうが単純で、写真ごとに説明文や公開状態を持たせる案件では子CPTに分けたほうが後から管理しやすくなります。

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

この記事を書いた人

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社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。