acf_get_meta()

WordPressのacf_get_meta()関数は、Advanced Custom Fields（ACF）プラグインを使用して保存されたカスタムフィールドのメタデータを取得するために使用されます。

構文

acf_get_meta( int $post_id, string $name, bool $format_value = true );

引数の説明:

• $post_id(int) — メタデータを取得する投稿のID。
• $name(string) — 取得するカスタムフィールドの名前。
• $format_value(bool) — 値をフォーマットするかどうか。デフォルトはtrue。

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

現在の投稿のカスタムフィールド「price」の値を取得します。

<?php $price = acf_get_meta( get_the_ID(), 'price' ); echo $price; ?>

例2: フォーマットなしで値を取得

フォーマットなしでカスタムフィールド「price」の値を取得します。

<?php $price = acf_get_meta( get_the_ID(), 'price', false ); echo $price; ?>

例3: 特定の投稿のカスタムフィールドを取得

IDが123の投稿のカスタムフィールド「location」の値を取得します。

<?php $location = acf_get_meta( 123, 'location' ); echo $location; ?>

例4: カスタムフィールドが存在するか確認

カスタムフィールド「color」が存在するか確認し、存在する場合はその値を表示します。

<?php $color = acf_get_meta( get_the_ID(), 'color' ); if ( $color ) { echo $color; } ?>

例5: 複数のカスタムフィールドを取得

複数のカスタムフィールドを取得し、それらの値を表示します。

<?php $price = acf_get_meta( get_the_ID(), 'price' ); $location = acf_get_meta( get_the_ID(), 'location' ); echo 'Price: ' . $price . ', Location: ' . $location; ?>

注意点

• カスタムフィールドが存在しない場合、関数は空の値を返します。
• フォーマット値を無効にすると、生のデータが返されます。