
プラグイン【Advanced Custom Fields】でカスタムフィールドを出力するときによく使うメモ
WordPressでサイトを構築していると、要件によってはカスタムフィールドを使うケースも多々あります。カスタムフィールドではスクラッチで実装することも可能ですが、現在では無料で使える優秀なプラグインも揃っていますので、手間などを考えるとプラグインを選択するケースになるのではないでしょうか。
その中でも、今回は評価も高く最もメジャーなカスタムフィールドのプラグインである「Advanced Custom Fields」を採用する場合に、カスタムフィールドを扱う時によく使うTipsを備忘録として残しておきたいと思います。
【Advanced Custom Fields - WordPress】
https://ja.wordpress.org/plugins/advanced-custom-fields/
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ではこれ以外にもいろんな使い方ができます。カスタムフィールドによってサイトの運用がかなり捗るので、ぜひ積極的に使っていきたいですね。
categories
- WordPress(61)
- JavaScript(49)
- Vue.js(48)
- CSS(46)
- jQuery(34)
- Nuxt.js(22)
- Sass(21)
- Gulp(17)
- webpack(16)
- PHP(14)
- HTML(14)
- GSAP(11)
- React(10)
- Vite(9)
- Pug(9)
- Laravel(8)
- Cordova(8)
- Linux(7)
- Next.js(6)
- Apache(5)
- Shopify(4)
- REST API(4)
- Node.js(4)
- Smarty(3)
- Git(3)
- JSON(3)
- その他プログラミング(3)
- Google Apps API(3)
- Bootstrap(3)
- 環境構築・システム(3)
- TypeScript(2)
- EJS(2)
- RMS(2)
- Docker(2)
- Instagram API(2)
- Excel VBA(2)
- SVG(1)
- Dart(1)
- ECカートASP(1)
- Markdown(1)
- AMP(1)
- Nginx(1)
- XML(1)
- shellscript(1)
- Ruby(1)
- MySQL(1)