プラグインElementorのelementor/experiments/feature-registeredアクションの使用方法・解説

概要

elementor/experiments/feature-registered アクションは、Elementorプラグイン内で新しい機能を登録する際に使用されるフックです。このアクションは、Elementorの実験的な機能や新しいウィジェット、テンプレート、スタイルなどを容易に追加するために利用されます。具体的には、以下のような機能を実装する際によく使用されます。

新しいウィジェットの追加
カスタムスタイルの適用
テンプレート機能の拡張
モジュールの選択肢の提供
デフォルト設定の変更
ユーザーインターフェイスの改善

このアクションは、ElementorのバージョンやWordPressのバージョンに依存し、特定のバージョン以降でのみ動作する場合があります。

構文

do_action( 'elementor/experiments/feature-registered', $feature_name, $args );

パラメータ

$feature_name (string): 登録する機能の名前。
$args (array): 機能に関連する追加情報を含む配列。

戻り値

戻り値は特になく、フックに影響を与える他の関数やアクションが実行されることによって、機能の登録が行われます。

プラグインおよびソフトウェアのバージョン

Elementor: 3.1.0 以降で利用可能
WordPress: 5.0 以降が推奨

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

アクション名	使用例
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_action( 'elementor/experiments/feature-registered', function( $feature_name ) {
    if ( 'my_custom_widget' === $feature_name ) {
        // ウィジェットの登録
    }
} );

（URL: https://elementor.com/help/creating-an-elementor-widget/）

サンプルコード2: カスタムスタイルの追加

カスタムスタイルを追加するためのサンプルコードです。

add_action( 'elementor/experiments/feature-registered', function( $feature_name ) {
    if ( 'custom_style' === $feature_name ) {
        // スタイルの追加
    }
} );

（URL: https://developers.elementor.com/docs/elementor-frontend/）

サンプルコード3: 機能の条件付き登録

特定の条件下で機能を登録するサンプルです。

add_action( 'elementor/experiments/feature-registered', function( $feature_name ) {
    if ( is_user_logged_in() && 'user_experiment' === $feature_name ) {
        // ユーザー実験機能の登録
    }
} );

（URL: https://developers.elementor.com/docs/elementor-experiments/）

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

デフォルト設定を変更する際のサンプルコードです。

add_action( 'elementor/experiments/feature-registered', function( $feature_name ) {
    if ( 'default_settings' === $feature_name ) {
        // デフォルト設定を変更
    }
} );

（URL: https://elementor.com/blog/elementor-advanced-settings/）

サンプルコード5: ユーザーインターフェイスの改善

ユーザーインターフェイスのカスタマイズに関するサンプルです。

add_action( 'elementor/experiments/feature-registered', function( $feature_name ) {
    if ( 'ui_improvement' === $feature_name ) {
        // UIの改善処理
    }
} );

（URL: https://developers.elementor.com/docs/customizing-elementor-ui/）

概要

構文