acf_get_loop()

WordPressの関数acf_get_loop()は、Advanced Custom Fieldsプラグインでカスタムフィールドの値をループ内で取得するために使用されます。この関数を使用すると、特定のフィールドの値を簡単に処理できます。

シンタックス

acf_get_loop( array $args );

引数の説明:

• $args (array) — カスタムループを定義するための引数。以下のキーを含む配列を指定できます:
  • 'field' — 取得したいフィールド名。
  • 'post_id' — 特定の投稿ID（デフォルトは現在の投稿ID）。
  • 'key' — フィールドキー（省略可能）。

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

以下のコードは、現在の投稿から特定のカスタムフィールド値を取得します。

<?php
$values = acf_get_loop( array( 'field' => 'custom_field_name' ) );
?>

例2: 投稿IDを指定してフィールド値を取得する

特定の投稿IDを指定してフィールド値を取得する方法です。

<?php
$values = acf_get_loop( array( 'field' => 'custom_field_name', 'post_id' => get_the_ID() ) );
?>

例3: フィールドキーを使用して値を取得する

フィールド名の代わりにフィールドキーを指定することも可能です。

<?php
$values = acf_get_loop( array( 'key' => 'field_key_here' ) );
?>

例4: フィールド値をループ内で使用する

取得したフィールド値をループ内で処理する例です。

<?php
$values = acf_get_loop( array( 'field' => 'custom_field_name' ) );
if ( $values ) {
    foreach ( $values as $value ) {
        echo $value;
    }
}
?>

例5: 条件付きで値を表示する

特定の条件を満たした場合にのみ値を表示する方法です。

<?php
$values = acf_get_loop( array( 'field' => 'custom_field_name' ) );
if ( ! empty( $values ) && is_single() ) {
    echo implode( ', ', $values );
}
?>

注意事項

• 引数を適切に設定しないと、期待した結果が得られない可能性があります。
• 取得した値を安全に処理するため、エスケープ関数を使用することを推奨します。