acf_shortcode()


WordPressのacf_shortcode()関数は、Advanced Custom Fields（ACF）プラグインを使用してカスタムフィールドデータをショートコード形式で取得または表示するために利用されます。

構文

acf_shortcode( array $atts = array() );

引数の説明:

  • $atts (array) — ショートコードで使用する属性の配列。
  • $atts['field'] (string) — 取得したいフィールドの名前。
  • $atts['post_id'] (int|string) — カスタムフィールドを取得する投稿のID。

例 1: 特定の投稿フィールドを表示

以下のコードは、特定の投稿からカスタムフィールド「my_field」の値を取得して表示します。

<?php echo do_shortcode('[acf field="my_field" post_id="get_the_ID()"]'); ?>

例 2: 現在の投稿のフィールドを取得

現在の投稿のカスタムフィールドを取得するコードです。

<?php echo do_shortcode('[acf field="current_field"]'); ?>

例 3: ユーザーごとのカスタムフィールドを表示

特定のユーザーIDに関連付けられたフィールドを表示する例です。

<?php echo do_shortcode('[acf field="user_field" post_id="user_'.get_current_user_id().'"]'); ?>

例 4: 条件付きで値を表示

指定された条件でカスタムフィールドの値を表示します。

<?php
if ( get_field( 'condition_field' ) ) {
    echo do_shortcode('[acf field="conditional_field"]');
}
?>

例 5: 複数のフィールドを組み合わせて表示

複数のカスタムフィールドを一緒に表示する方法です。

<?php
echo do_shortcode('[acf field="field_one"]') . ' - ' . do_shortcode('[acf field="field_two"]');
?>

注意事項

acf_shortcode()を使用する際は、対象フィールドが正しく設定されていることを確認してください。
フィールド名や投稿IDが正確でない場合、結果が表示されない可能性があります。

関連機能：