acf_get_user_setting()


WordPressのacf_get_user_setting()関数は、Advanced Custom Fields (ACF) プラグインで使用される関数で、現在のユーザーに関連付けられた設定値を取得します。

構文

acf_get_user_setting( string $name, mixed $default = false );

引数の説明:

  • $name (string) — 取得したい設定のキー名。
  • $default (mixed) — 指定されたキーが見つからない場合に返されるデフォルト値。

例 1: ユーザー設定を取得する

特定のキーのユーザー設定を取得します。

<?php
$value = acf_get_user_setting( 'custom_setting_key' );
?>

例 2: デフォルト値を設定して取得

キーが見つからない場合、デフォルト値を返します。

<?php
$value = acf_get_user_setting( 'non_existing_key', 'default_value' );
?>

例 3: 設定値を条件に基づいて処理する

取得した設定値に基づいて特定の処理を行います。

<?php
$theme_color = acf_get_user_setting( 'theme_color', 'blue' );
if ( $theme_color === 'dark' ) {
    echo 'ダークモードが有効です。';
}
?>

例 4: ACF設定の動的取得

複数のキーから動的に設定を取得します。

<?php
$keys = [ 'key1', 'key2', 'key3' ];
foreach ( $keys as $key ) {
    $value = acf_get_user_setting( $key, 'default' );
    echo $key . ': ' . $value . '<br>';
}
?>

例 5: 設定を取得してACFフォームに適用

取得したユーザー設定をカスタムフォームに適用します。

<?php
$form_setting = acf_get_user_setting( 'form_display', 'basic' );
if ( $form_setting === 'advanced' ) {
    acf_form( array( 'post_id' => 'new' ) );
}
?>

注意事項

  • この関数はACFプラグインがインストールされている場合にのみ使用可能です。
  • 正確なキー名を指定しない場合、デフォルト値が返されることに注意してください。

関連機能：