the_field()


WordPressのthe_field()関数は、Advanced Custom Fields（ACF）プラグインを使用してカスタムフィールドの値を取得し、表示するために使用されます。この関数は、投稿やページの編集画面で設定されたカスタムフィールドの値を簡単に出力できます。

構文

the_field( $field_name, $post_id );

引数の説明:

  • $field_name(string) — 表示するカスタムフィールドの名前。
  • $post_id(mixed) — カスタムフィールドを取得する投稿ID。デフォルトは現在の投稿。

例1: 基本的なカスタムフィールドの表示

この例では、カスタムフィールド「my_custom_field」の値を表示します。

<?php the_field('my_custom_field'); ?>

例2: 特定の投稿IDからカスタムフィールドを取得

この例では、投稿IDが123の投稿からカスタムフィールド「my_custom_field」の値を取得します。

<?php the_field('my_custom_field', 123); ?>

例3: カスタムフィールドが存在するか確認して表示

カスタムフィールドが存在する場合のみ値を表示します。

<?php if(get_field('my_custom_field')) { the_field('my_custom_field'); } ?>

例4: カスタムフィールドを変数に格納

カスタムフィールドの値を変数に格納して後で使用します。

<?php $my_value = get_field('my_custom_field'); echo $my_value; ?>

例5: カスタムフィールドを配列として取得

カスタムフィールドが配列の場合、その値を取得して表示します。

<?php $my_array = get_field('my_custom_field'); print_r($my_array); ?>

例6: カスタムフィールドをループ内で使用

ループ内でカスタムフィールドを表示します。

<?php if(have_posts()) : while(have_posts()) : the_post(); the_field('my_custom_field'); endwhile; endif; ?>

例7: カスタムフィールドを条件付きで表示

カスタムフィールドの値が特定の条件を満たす場合に表示します。

<?php if(get_field('my_custom_field') == '特定の値') { the_field('my_custom_field'); } ?>

例8: カスタムフィールドをJSON形式で出力

カスタムフィールドの値をJSON形式で出力します。

<?php echo json_encode(get_field('my_custom_field')); ?>

注意点

  • カスタムフィールドが存在しない場合、何も出力されません。
  • 投稿IDを指定しない場合、現在の投稿のカスタムフィールドが取得されます。

関連機能：