acf_checkbox_input()

WordPress関数acf_checkbox_input()は、Advanced Custom Fields（ACF）プラグインを使用してチェックボックスフィールドの入力値を操作または取得するために使用されます。

構文

acf_checkbox_input( array $args = [] );

• $args (array) — チェックボックスの入力フィールドを設定するオプション配列。

例 1. シンプルなチェックボックスフィールドの出力

このコードは投稿IDに基づいてチェックボックスフィールドを表示します。

<?php acf_checkbox_input( array( 'post_id' => get_the_ID() ) ); ?>

例 2. チェックボックスの選択値を取得する

このコードは投稿のチェックボックスで選択された値を取得します。

<?php
$values = get_field( 'checkbox_field', get_the_ID() );
if ( $values ) {
    foreach ( $values as $value ) {
        echo '<p>' . esc_html( $value ) . '</p>';
    }
}
?>

例 3. 条件に応じたチェックボックスの初期化

投稿タイプが「product」の場合のみ、チェックボックスフィールドを表示します。

<?php
if ( get_post_type( get_the_ID() ) === 'product' ) {
    acf_checkbox_input( array( 'post_id' => get_the_ID() ) );
}
?>

例 4. チェックボックスの値を保存する

投稿のカスタムフィールドにチェックボックスの選択値を保存します。

<?php
update_field( 'checkbox_field', array( 'option1', 'option2' ), get_the_ID() );
?>

例 5. 選択されているオプションを条件付きで出力する

選択された値が特定の値に一致する場合にテキストを表示します。

<?php
$values = get_field( 'checkbox_field', get_the_ID() );
if ( in_array( 'specific_option', $values, true ) ) {
    echo '<p>特定のオプションが選択されています。</p>';
}
?>

注意事項

関数acf_checkbox_input()を使用する前に、Advanced Custom Fieldsプラグインがインストールされていることを確認してください。また、チェックボックスフィールドが正しく設定されていない場合、エラーが発生する可能性があります。