acf_parse_args()

WordPressのacf_parse_args()関数は、特定の配列にデフォルト値を適用するために使用されます。

シンタックス

acf_parse_args( array $args, array $defaults, string $filter = '' );

引数の説明:

• $args (array) — 上書きしたい引数の配列。
• $defaults (array) — デフォルトの値を含む配列。
• $filter (string) — 引数をフィルタリングするための文字列。省略可能。

例 1: 基本的な引数のマージ

引数とデフォルト値をマージします。

<?php
$args = acf_parse_args(
    array( 'key1' => 'value1' ),
    array( 'key1' => 'default1', 'key2' => 'default2' )
);
print_r( $args );
?>

例 2: フィルターを使用した引数の処理

$filter引数を使用してカスタムフィルタを適用します。

<?php
add_filter( 'custom_filter', function( $args ) {
    $args['key3'] = 'filtered_value';
    return $args;
} );

$args = acf_parse_args(
    array( 'key1' => 'value1' ),
    array( 'key1' => 'default1', 'key2' => 'default2' ),
    'custom_filter'
);
print_r( $args );
?>

例 3: デフォルト値のみの適用

空の引数を渡す場合、デフォルト値がそのまま適用されます。

<?php
$args = acf_parse_args(
    array(),
    array( 'key1' => 'default1', 'key2' => 'default2' )
);
print_r( $args );
?>

例 4: 関数を使用したデフォルト値の動的設定

デフォルト値を関数から動的に取得します。

<?php
$defaults = get_option( 'default_settings', array( 'key1' => 'default1', 'key2' => 'default2' ) );
$args = acf_parse_args(
    array( 'key1' => 'custom_value1' ),
    $defaults
);
print_r( $args );
?>

例 5: 高度な条件付き処理

条件付きで異なるデフォルト値を適用します。

<?php
$defaults = is_admin() 
    ? array( 'key1' => 'admin_default', 'key2' => 'admin_default2' )
    : array( 'key1' => 'default1', 'key2' => 'default2' );

$args = acf_parse_args(
    array( 'key2' => 'custom_value2' ),
    $defaults
);
print_r( $args );
?>

注意点:

• フィルター名を指定する場合、適切に登録されていることを確認してください。
• 関数が返す配列が意図した値を含むよう、$argsと$defaultsを正確に指定してください。