acf_localize_data()

関数WordPressacf_localize_data()は、Advanced Custom FieldsプラグインのJavaScriptデータをローカライズするために使用される。

シンタックス

acf_localize_data();

例1: ACFフォームのデータをローカライズ

次のコードは、ACFフォームのJavaScriptデータをローカライズする。

<?php add_action( 'acf/input/admin_enqueue_scripts', 'acf_localize_data' ); ?>

例2: JavaScriptデータにカスタムデータを追加

カスタムデータを追加してローカライズする。

<?php
add_filter( 'acf/localize_data', function( $data ) {
    $data['custom_key'] = 'カスタムデータ';
    return $data;
});
?>

例3: 特定のフィールドグループのデータを変更

特定のフィールドグループの値をカスタマイズする。

<?php
add_filter( 'acf/localize_data', function( $data ) {
    if ( isset( $data['field_groups'] ) ) {
        foreach ( $data['field_groups'] as &$group ) {
            $group['title'] = 'カスタムタイトル';
        }
    }
    return $data;
});
?>

例4: ACFローカライズデータに条件を追加

特定の条件下でローカライズデータを変更する。

<?php
add_filter( 'acf/localize_data', function( $data ) {
    if ( is_admin() ) {
        $data['admin_mode'] = true;
    }
    return $data;
});
?>

例5: ローカライズデータをデバッグ

ローカライズデータの内容をデバッグする。

<?php
add_action( 'acf/input/admin_footer', function() {
    echo '<script>console.log(acf.data);</script>';
});
?>

注意事項

• acf_localize_data()は管理画面でのみ動作する。
• フィルターacf/localize_dataを使用してデータを変更できる。
• データを変更する場合は必ずreturn $data;を忘れないこと。