acf()

WordPressのacf()関数は、Advanced Custom Fieldsプラグインを使用してカスタムフィールドのデータを取得するための主要な関数です。

構文

acf( string $field_name, int|WP_Post $post_id = null );

引数の説明:

• $field_name (string) — カスタムフィールドの名前。
• $post_id (int|WP_Post|null) — データを取得する投稿のID。省略すると現在の投稿から取得。

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

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

<?php echo acf('custom_field_name'); ?>

例2: 投稿IDを指定して値を取得

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

<?php echo acf('custom_field_name', get_the_ID()); ?>

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

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

<?php
if ( $value = acf('custom_field_name') ) {
    echo $value;
}
?>

例4: ループ内でのカスタムフィールド値の取得

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

<?php
if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        echo acf('custom_field_name');
    }
}
?>

例5: 配列型のフィールド値を取得

配列型のフィールドデータを取得して処理します。

<?php
$values = acf('custom_array_field');
if ( is_array($values) ) {
    foreach ( $values as $value ) {
        echo $value;
    }
}
?>

注意事項

• acf()関数はAdvanced Custom Fieldsプラグインがインストールされている場合のみ使用可能です。
• カスタムフィールドが存在しない場合、nullが返される可能性があります。