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

概要

elementor/elements/categories_registered アクションは、Elementorプラグインでカスタムウィジェットのカテゴリを登録する際に使用されます。このフックを利用することで、ユーザーは自身のウィジェットを特定のカテゴリに分類し、Elementorのウィジェットリストを整理することができます。以下は、このアクションを使用している典型的な機能です。

新しいウィジェットのカテゴリを追加する
既存のウィジェットカテゴリを修正する
ウィジェットをカテゴライズして閲覧を容易にする
管理画面でのユーザー体験を向上させる
多数のウィジェットをグループ化する
テーマやプラグインの独自性を強調するための分類管理

構文

add_action('elementor/elements/categories_registered', 'your_callback_function');

パラメータ

CategoriesManager: カテゴリを管理するためのオブジェクト。

戻り値

このアクションは戻り値を持ちません。

使用可能なプラグイン・バージョン

Elementor: 2.0 以降
WordPress: 4.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

add_action('elementor/elements/categories_registered', function($elements_manager) {
    $elements_manager->add_category('my-custom-category', [
        'title' => __('My Custom Category', 'plugin-name'),
        'slug' => 'my-custom-category',
    ]);
});

このコードは「My Custom Category」という新しいカテゴリをElementorに追加します。これにより、カスタムウィジェットがこのカテゴリーに分類されます。

サンプル2

add_action('elementor/elements/categories_registered', 'register_custom_widget_category');
function register_custom_widget_category($elements_manager) {
    $elements_manager->add_category('advanced-widgets', [
        'title' => __('Advanced Widgets', 'plugin-name'),
        'slug' => 'advanced-widgets',
    ]);
}

このサンプルでは、「Advanced Widgets」というカテゴリを作成し、特定のウィジェットを管理するための場所を提供します。

サンプル3

add_action('elementor/elements/categories_registered', 'add_category_for_special_widgets');
function add_category_for_special_widgets($elements_manager) {
    $elements_manager->add_category('special-category', [
        'title' => __('Special Category', 'plugin-name'),
        'slug' => 'special-category',
    ]);
}

このコードは、「Special Category」というカテゴリを追加し、特定のカスタムウィジェットがこのカテゴリに入るようにします。

サンプル4

add_action('elementor/elements/categories_registered', 'custom_elements_categories');
function custom_elements_categories($elements_manager) {
    $elements_manager->add_category('new-category', [
        'title' => __('New Category', 'plugin-name'),
        'slug' => 'new-category',
    ]);
}

このサンプルでは「New Category」という新しいカテゴリを設け、カスタムウィジェットの整理を行います。

サンプル5

add_action('elementor/elements/categories_registered', 'register_my_own_category');
function register_my_own_category($elements_manager) {
    $elements_manager->add_category('unique-category', [
        'title' => __('Unique Category', 'plugin-name'),
        'slug' => 'unique-category',
    ]);
}

このコードは「Unique Category」を追加し、他のウィジェットと差別化を図るためにユニークな分類が可能です。

概要

構文