acf_get_metaref()

WordPress関数acf_get_metaref()は、特定のフィールドメタデータにアクセスするために使用されます。この関数は、カスタムフィールドデータを取得する際に役立ちます。

シンタックス

acf_get_metaref( string $meta_key, int $post_id );

引数の説明:

• $meta_key (string) — 取得するメタデータのキーを指定します。
• $post_id (int) — メタデータが関連付けられている投稿またはページのID。

使用例

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

特定の投稿のカスタムフィールド値を取得します。

<?php
$meta_value = acf_get_metaref( 'custom_field_key', get_the_ID() );
echo $meta_value;
?>

例2: 特定の投稿タイプでフィールド値を取得する

投稿タイプproductでメタデータを取得します。

<?php
if ( get_post_type( get_the_ID() ) === 'product' ) {
    $price = acf_get_metaref( 'product_price', get_the_ID() );
    echo $price;
}
?>

例3: デフォルト値を設定する

カスタムフィールド値が存在しない場合、デフォルト値を設定します。

<?php
$meta_value = acf_get_metaref( 'field_key', get_the_ID() ) ?: 'デフォルト値';
echo $meta_value;
?>

例4: 条件付き表示

特定のカスタムフィールドが設定されている場合のみ内容を表示します。

<?php
$meta_value = acf_get_metaref( 'display_condition', get_the_ID() );
if ( $meta_value ) {
    echo '表示する内容';
}
?>

例5: 複数のフィールドを同時に取得する

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

<?php
$fields = [ 'field_one', 'field_two', 'field_three' ];
foreach ( $fields as $field ) {
    echo acf_get_metaref( $field, get_the_ID() ) . '<br>';
}
?>

注意事項

この関数を使用する場合、正確な$meta_keyと$post_idを指定してください。不正な値を渡すと、意図しない結果が生じる可能性があります。