Advanced Custom FieldsのアドオンThe Gallery Field(ギャラリーフィールド)の使い方と出力方法

2023.10.27

※当ブログのリンクには一部広告が含まれています。

Advanced Custom Fieldsの有料アドオン「The Gallery Field（ギャラリーフィールド）」の使い方について説明します。 The Gallery Fieldは単独でも購入できますが、ACF ProというACFの最新バージョン（Ver.5）とアドオンがセットになったプラグインにも含まれています。単独で購入する場合は今後のアップデートには対応しないようなので要注意です。

参考記事Advanced Custom Fieldsを更に使いやすく！ACF Proを選ぶ理由と機能紹介

アドオンおよびプラグインの購入方法、インストール方法については、以下のページで解説しています。

参考記事無料版Advanced Custom Fieldsから有料版ACF Proへアップグレード/インストールする方法

The Gallery Field（ギャラリーフィールド）で何ができるの？
The Gallery Fieldの作成方法
- カスタムフィールド作成ページでギャラリーフィールドを設定する
The Gallery Fieldの出力方法

The Gallery Field（ギャラリーフィールド）で何ができるの？

「ギャラリーフィールド」を使うと、投稿画面で直感的に複数の画像を管理したり並べ替えたりできます。通常のカスタムフィールドでは、投稿画面上での画像の順序の入れ替えやalt、キャプションなどの変更は面倒になりがちですが、ギャラリーフィールドを使えば画像のドラッグによる表示順序の変更や、「メディアを追加」ボタンを押してメディア管理画面を開かずに情報の修正ができます。※画像をクリックするとポップアップで拡大画像が表示されます。

The Gallery Field（公式ページ）

カスタムフィールド入力画面

The Gallery Fieldの作成方法

今回は、上の図のようにカスタムフィールドでアップロードしたサムネール画像をタイトルと共に表示させます。このタイトルは、画像の管理画面で入力したテキストが反映されます。

The Gallery Fieldのデモページ
すみません、諸事情でレイアウト崩れてます…

カスタムフィールド作成ページでギャラリーフィールドを設定する

まずカスタムフィールドを表示させる固定ページを作成し、カスタムフィールド作成画面で「photo-gallery」というフィールド名のカスタムフィールドを作成します。今回は特定の固定ページに表示させるようにしましたが、他のページでもOKです。

「フィールドタイプ」は「ギャラリー」を選択します。（下図①）「ライブラリ」では、アップロードする画像を投稿記事のみに限定するか、別の記事でも使えるようにするかを選ぶことができます。（下図②）今回の例では「投稿にアップロードされる」を撰択しました。

アップロードする画像のサイズやファイルの種類を制限することも可能です。

余談ですが、カスタムフィールドを表示させる投稿ページ（今回はデモ用の固定ページ）での編集アイテムの非表示/非表示を設定することができます。不要なアイテムを非表示にしておけばカスタムフィールドだけ表示させることができるので、投稿画面がスッキリして見やすくなります。

カスタムフィールドで画像をアップロードする

投稿画面では、先程作成した画像アップロード用のカスタムフィールドが表示されています。下の画像は既に何枚かアップロードされている状態ですが、左下の「ギャラリーを追加」ボタンをクリックすると、毎度おなじみのメディア管理画面がポップアップで表示されます。

左上のタブが「ファイルをアップロード」になっているのを確認して、通常通り画像をアップロードします。

画像が追加されたら、ページで表示したい画像を選択して、右下の「Select」ボタンをクリックします。

投稿画面に戻ると、撰択した画像のサムネールが並んでいます。サムネールをクリックすると右側にパネルが開き、メディア管理画面を開かずにタイトルやキャプション、Altなどを編集できます。今回の例では、ここで入力したタイトルがサムネール画像の下に表示されます。

画像の表示順序はサムネール画像をドラッグするか、もしくは右下のプルダウンから日付順などで変更可能です。サムネールをマウスオーバーすると出現する×ボタンをクリックすれば画像を削除できます。

The Gallery Fieldの出力方法

サムネール画像の下に画像のタイトルを表示させる例です。

<?php
$images = get_field('photo_gallery'); 
if( $images ): 
?>
<ul class="photo-gallery">
  <?php foreach( $images as $image ): ?>
    <li>
      <a href="<?php echo $image['url']; ?>" class="fancybox">
        <img src="<?php echo $image['sizes']['thumbnail']; ?>" alt="<?php echo $image['alt']; ?>" />
      </a>
      <p class="caption"><?php echo $image['title']; ?></p>
    </li>
  <?php endforeach; ?>
</ul>
<?php endif; ?>

wp_get_attachment_imageを使用する場合

<?php 
$images = get_field('photo_gallery');
$size = 'thumbnail'; // (thumbnail/medium/large/full/カスタムのサイズ)
if( $images ): 
?>
    <ul>
        <?php foreach( $images as $image ): ?>
            <li>
            	<?php echo wp_get_attachment_image( $image['ID'], $size ); ?>
            </li>
        <?php endforeach; ?>
    </ul>
<?php endif; ?>

get_fieldでギャラリーフィールドの内容を取得すると、以下のような様々な画像データが返ってきます。['url']や['sizes']もその中のデータのひとつで、画像は複数あるため配列で返ってきます。[0]は1枚目の画像、[1]は2枚目の画像です。（データ内容はサンプル用に変更しています。）画像サイズは、カスタムでサイズを登録しているとそのデータも出てきます。

カスタムフィールドの画像出力については、下記のページをご覧ください。

参考記事Advanced Custom Fieldsによるカスタムフィールドの出力【画像編】