acf_maybe_get_sub_field()

WordPressの関数acf_maybe_get_sub_field()は、Advanced Custom Fields（ACF）プラグインの一部として提供されるもので、サブフィールドの値を安全に取得するために使用されます。この関数は、サブフィールドが存在する場合にその値を返し、存在しない場合にはnullを返します。

構文

acf_maybe_get_sub_field( string $field_name );

• $field_name (string) — サブフィールドの名前

例1: サブフィールドの値を取得

以下のコードは、”sub_field_name”というサブフィールドの値を取得する基本的な例です。

<?php $value = acf_maybe_get_sub_field( 'sub_field_name' ); ?>

例2: サブフィールドが存在する場合にのみ値を表示

サブフィールドの値が存在する場合に、その値を表示するコードです。

<?php
$value = acf_maybe_get_sub_field( 'sub_field_name' );
if ( $value ) {
    echo $value;
}
?>

例3: サブフィールドの値を条件付きで取得

サブフィールドが存在しない場合に、デフォルトの値を設定する方法です。

<?php
$value = acf_maybe_get_sub_field( 'sub_field_name' ) ?: 'デフォルトの値';
echo $value;
?>

例4: 複数のサブフィールドをチェック

複数のサブフィールドの値を取得し、それぞれの存在を確認する方法です。

<?php
$value1 = acf_maybe_get_sub_field( 'sub_field_1' );
$value2 = acf_maybe_get_sub_field( 'sub_field_2' );
if ( $value1 ) {
    echo $value1;
}
if ( $value2 ) {
    echo $value2;
}
?>

例5: サブフィールドがない場合にメッセージを表示

サブフィールドが存在しない場合にメッセージを表示するコードです。

<?php
$value = acf_maybe_get_sub_field( 'sub_field_name' );
if ( !$value ) {
    echo 'サブフィールドが見つかりません';
}
?>