プラグインElementorのelementor/admin/localize_settingsフィルタの使用方法・解説

概要

elementor/admin/localize_settings フィルタは、Elementor プラグインにおいて、管理画面で使用される設定情報をローカライズ（翻訳）する際に活用されます。このフィルタを使用することで、JavaScript で使用される設定値を変更したり、追加のデータを提供したりすることが可能です。以下はこのフィルタがよく使われる場面です：

管理画面のカスタマイズ
プラグインのインターフェイスの翻訳
メッセージや通知のカスタマイズ
ユーザー設定に基づく動的データの提供
特定の条件に応じて設定値を調整
プラグインの相互運用性の向上

構文

add_filter('elementor/admin/localize_settings', 'your_function_name');

パラメータ

$settings: 設定値の配列。この配列を変更することで、画面表示に反映されます。

戻り値

設定値が変更された配列。

使用可能なプラグイン版

Elementor: 2.0以上
WordPress: 4.5以上

この関数のアクションでの使用可能性

アクション	使用可能性
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

サンプルコード

サンプルコード 1: 言語設定の追加

このサンプルは、Elementor の管理画面にエクストラの言語設定を追加します。

add_filter('elementor/admin/localize_settings', function($settings) {
    $settings['extraLanguage'] = 'Japanese';
    return $settings;
});

サンプルコード 2: カスタム通知メッセージの設定

管理画面に特定の条件で表示するカスタムメッセージを追加します。

add_filter('elementor/admin/localize_settings', function($settings) {
    if (current_user_can('administrator')) {
        $settings['customMessage'] = __('Welcome, Admin!', 'elementor');
    }
    return $settings;
});

サンプルコード 3: アイテムの追加

設定にアイテムを追加するサンプルです。

add_filter('elementor/admin/localize_settings', function($settings) {
    $settings['customItems'][] = 'New Item';
    return $settings;
});

サンプルコード 4: 動的データの提供

ユーザーロールに応じて設定値を変更するサンプルです。

add_filter('elementor/admin/localize_settings', function($settings) {
    if (is_user_logged_in()) {
        $settings['userRole'] = wp_get_current_user()->roles[0];
    }
    return $settings;
});

サンプルコード 5: デフォルト設定の変更

デフォルトの設定値を変更してカスタマイズします。

add_filter('elementor/admin/localize_settings', function($settings) {
    $settings['defaultSetting'] = 'Custom Value';
    return $settings;
});

概要

構文