get_field()


WordPressの関数get_field()は、カスタムフィールドの値を取得するために使用されます。

構文

get_field( string $field_name, mixed $post_id = false );

引数の説明:

  • $field_name (string) — 取得するカスタムフィールドの名前。
  • $post_id (mixed) — フィールドを取得する投稿のID（省略可能）。省略時は現在の投稿IDが使用されます。

例 1: 現在の投稿のカスタムフィールドを取得

現在の投稿のカスタムフィールド'field_name'の値を取得する基本的な例です。

<?php echo get_field('field_name'); ?>

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

特定の投稿（例えば、投稿IDがget_the_ID()で返されるもの）のフィールド値を取得します。

<?php echo get_field('field_name', get_the_ID()); ?>

例 3: 条件付きでフィールド値を表示

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

<?php
$field_value = get_field('field_name');
if( $field_value ) {
    echo $field_value;
}
?>

例 4: 配列フィールドの値をループで表示

カスタムフィールドが配列である場合、各要素をループして表示します。

<?php
$items = get_field('field_name');
if( is_array($items) ) {
    foreach( $items as $item ) {
        echo $item;
    }
}
?>

例 5: カスタムフィールドのデフォルト値を設定

値が存在しない場合にデフォルト値を設定します。

<?php
$field_value = get_field('field_name');
echo $field_value ? $field_value : 'デフォルト値';
?>

注意事項:

  • get_field()は、Advanced Custom Fields (ACF)プラグインがインストールされている必要があります。
  • 投稿IDを指定しない場合、現在の投稿またはページに基づいて動作します。

関連機能：