プラグインElementorのelementor/finder/registerアクションの使用方法・解説

概要

elementor/finder/register アクションは、Elementor の「Finder」機能にカスタムアイテムを追加するために使用されます。以下のような機能を実装する際によく使われます。

カスタムポストタイプのアイテム登録
特定の種別のウィジェットやテンプレートへのクイックアクセスを提供
特定の条件に基づいたエレメンターのカスタムメニューの実装
プラグインの設定ページへのショートカットを作成
ユーザー特定のアイテムやリンクの追加
ユーザーがよく使う機能へのアクセスをシンプルにする

構文

add_action( 'elementor/finder/register', 'your_callback_function' );

パラメータ

finder: Elementor Finder に関するオブジェクトや情報。

戻り値

このアクションは特に戻り値を持ちませんが、適切に設計されたコールバック関数が呼び出されます。

使用可能なバージョン

Elementor バージョン: 3.0 以降
WordPress バージョン: 5.0 以降

サンプルコード

サンプル1: カスタムアイテムの追加

このコードは、Elementor Finder にカスタムポストタイプのリンクを追加します。

add_action( 'elementor/finder/register', function( $finder ) {
    $finder->add_item( [
        'title' => 'カスタムポストタイプ',
        'url' => admin_url( 'edit.php?post_type=custom_post_type' ),
        'icon' => 'custom-icon-class',
    ] );
} );

サンプル2: プラグイン設定ページへのショートカット追加

このコードでは、Elementor Finder にプラグインの設定ページへのショートカットを追加します。

add_action( 'elementor/finder/register', function( $finder ) {
    $finder->add_item( [
        'title' => 'プラグイン設定',
        'url' => admin_url( 'options-general.php?page=plugin-settings' ),
        'icon' => 'settings',
    ] );
} );

サンプル3: 特定ユーザー向け機能の追加

特定のユーザーのためにカスタムリンクを追加するコードです。

add_action( 'elementor/finder/register', function( $finder ) {
    if ( current_user_can( 'administrator' ) ) {
        $finder->add_item( [
            'title' => '管理者用リンク',
            'url' => admin_url( 'admin.php?page=admin_dashboard' ),
            'icon' => 'admin-site',
        ] );
    }
} );

サンプル4: テンプレートへのリンク追加

Elementor のテンプレートセクションへのショートカットを追加します。

add_action( 'elementor/finder/register', function( $finder ) {
    $finder->add_item( [
        'title' => 'テンプレート管理',
        'url' => admin_url( 'edit.php?post_type=elementor_library' ),
        'icon' => 'template',
    ] );
} );

サンプル5: カスタムウィジェットへのリンク

特定のカスタムウィジェットへのショートカットを作成します。

add_action( 'elementor/finder/register', function( $finder ) {
    $finder->add_item( [
        'title' => 'カスタムウィジェット',
        'url' => admin_url( 'admin.php?page=custom_widget_page' ),
        'icon' => 'widget',
    ] );
} );

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

アクション	使用例
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

概要

構文