0%

Programmingプログラミングナレッジ

Posted:2019.01.14

プラグイン【Advanced Custom Fields】でカスタムフィールドを出力するときによく使うメモ

WordPressでサイトを構築していると、要件によってはカスタムフィールドを使うケースも多々あります。カスタムフィールドではスクラッチで実装することも可能ですが、現在では無料で使える優秀なプラグインも揃っていますので、手間などを考えるとプラグインを選択するケースになるのではないでしょうか。

 

その中でも、今回は評価も高く最もメジャーなカスタムフィールドのプラグインである「Advanced Custom Fields」を採用する場合に、カスタムフィールドを扱う時によく使うTipsを備忘録として残しておきたいと思います。

【Advanced Custom Fields – WordPress】
https://ja.wordpress.org/plugins/advanced-custom-fields/

 

1. カスタムフィールドの値を出力する
<?php the_field('FIELDS_NAME'); ?>

 

登録したカスタムフィールドの値をそのまま出力する時に使います。最もよく使う基本的なケースになります。引数には設定したフィールド名を指定します。

 

2. カスタムフィールドの値を取得する
<?php get_field('FIELDS_NAME'); ?>

 

登録したカスタムフィールドの値を取得する場合に使います。このままではHTML上では出力できません。同じく引数には設定したフィールド名を指定します。

 

3. カスタムフィールドの値が入っている時だけ出力する
<?php 
  $arg = get_field('FIELDS_NAME');
  if (!empty($arg)) :
?>
  <?php the_field('FIELDS_NAME'); ?>
<?php endif; ?>

 

カスタムフィールドの値が入っている時のみ出力するケースです。カスタムフィールドの値が空の場合は項目ごと表示しないなどに使えますね。カスタムフィールドの値を取得して、中身があるかどうかで分岐させます。

 

4. リピーターフィールドで繰り返しカスタムフィールドの値を出力する
<?php if(have_rows('FIELDS_NAME')): ?>
  <?php while(have_rows('FIELDS_NAME')): the_row(); ?> 
    <?php the_sub_field('SUB_FIELDS_NAME'); ?>
  <?php endwhile; ?>
<?php endif; ?>

 

Advanced Custom Fieldsの拡張プラグインである「Repeater Field」で使える機能です。または有料版の「Advanced Custom Fields Pro」でも使えます。このリピーターフィールドでは、投稿ごとにカスタムフィールドを繰り返しで増やすことが可能になります。

【ACF | Pro】
https://www.advancedcustomfields.com/pro/
【Add-ons The Repeater Field】
https://www.advancedcustomfields.com/add-ons/repeater-field/

 

まずはhave_rows()でカスタムフィールドに繰り返されるサブカスタムフィールドが含まれているかで条件分岐させて、サブカスタムフィールドの数だけ繰り返して出力する形になります。それぞれの引数にカスタムフィールド名とサブカスタムフィールド名を指定しますが、間違えないように注意しましょう。

 


 

Advanced Custom Fieldsではこれ以外にもいろんな使い方ができます。カスタムフィールドによってサイトの運用がかなり捗るので、ぜひ積極的に使っていきたいですね。

author
この記事を書いた人オガワ シンヤ
FacebookTwitter

DesignSupply.代表 / ディレクター・ウェブデザイナー・フロントエンドエンジニアをやっています。「ウェブとデザインでヒト・モノ・サービスを繋げ新しい価値を生み出す」をコンセプトに日々奮闘中!制作中はチョコレートが欠かせない三十路Webクリエイター。

制作のご依頼やお問い合わせ・パートナー業務提携のご相談はこちら

デザインやウェブ制作についてのご依頼やご相談、その他お問い合わせなどもお気軽にご連絡ください。フットワークの軽さやレスポンスの早さ、また豊富な経験や知識、技術を活かした対応力といったフリーランスクリエイターの強みでクライアント様、パートナー企業様のお力になります。デザインからコーディングやWordPress実装といったウェブサイト構築はもちろん、写真撮影や動画編集、コンテンツ制作からサイト運用サポートまで一括してお任せください。

ホームページ制作のご検討やウェブ運用でお悩みの経営者様や企業のウェブ担当者様をはじめ、個人で店舗を営んでいらっしゃるオーナー様、フリーで活動されているビジネスオーナー様はもちろんのこと、リソース不足でお困りの制作会社様、またクリエイターをお探しの代理店様も大歓迎です。

コンタクトをご希望の方はお手数ですが、下記よりお問い合わせフォームのページへアクセスしていただき、必要事項を入力の上メッセージを送信してください。確認でき次第すぐに折り返しご連絡致します。

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

コメントもお気軽にどうぞ

記事に関するご質問やご意見などありましたら下記のコメントフォームよりお気軽に投稿ください。なおメールアドレスは公開されませんのでご安心ください。また、* が付いている欄は必須項目となります。

内容に問題なければ、下記の「コメントを送信する」ボタンを押してください。

CAPTCHA


ページトップへ