如何在WordPress子主题中注册多个自定义Elementor小工具？

问题根本原因 #

你遇到的覆盖问题核心原因是两个自定义小工具类里的get_name()方法返回了相同的字符串值。Elementor底层通过这个返回值作为小工具的唯一标识符，只要标识符重复，后注册的小工具就会直接覆盖先注册的，和类名是否不同无关。

修正步骤 #

1. 分别打开rpp_contact_bar.php和rpp_newsletter_sign_up_bar.php两个小工具文件，找到继承Widget_Base后必须实现的get_name()方法，确保两个方法返回的字符串完全唯一，示例如下：

// My_Widget_1 类中的对应方法
public function get_name() {
    return 'rpp_contact_bar'; // 唯一标识，不要和另一个小工具重复
}

// My_Widget_2 类中的对应方法
public function get_name() {
    return 'rpp_newsletter_sign_up_bar'; // 和上面的标识区分开即可
}

2. 同时建议将两个小工具的get_title()方法返回值也设置为不同内容，方便后续在Elementor编辑器中快速区分。
3. 如果修改get_name()后问题依旧，检查两个小工具文件的类名是否确实不同，且文件引入路径没有写错，避免出现路径错误导致重复引入同一个文件的问题。

子主题注册多个Elementor小工具的标准写法 #

你现有的注册逻辑结构本身没有问题，补充上述唯一标识配置即可正常运行，更规范的完整流程参考如下：

• 第一步：在子主题functions.php中绑定Elementor加载钩子，引入自定义小工具统一注册文件

// 放在functions.php末尾即可
add_action( 'elementor/loaded', 'rpp_init_custom_widgets' );
function rpp_init_custom_widgets() {
    // 用get_stylesheet_directory()确保路径正确指向子主题目录
    require_once get_stylesheet_directory() . '/my-widgets.php';
}

• 第二步：my-widgets.php的规范写法

<?php
add_action( 'elementor/widgets/widgets_registered', 'rpp_register_multiple_widgets' );
function rpp_register_multiple_widgets() {
    // 先加载所有自定义小工具的类文件
    require_once get_stylesheet_directory() . '/rpp_contact_bar.php';
    require_once get_stylesheet_directory() . '/rpp_newsletter_sign_up_bar.php';
    
    $widgets_manager = \Elementor\Plugin::instance()->widgets_manager;
    // 逐个注册小工具即可
    $widgets_manager->register_widget_type( new My_Widget_1() );
    $widgets_manager->register_widget_type( new My_Widget_2() );
}

额外提示：不建议把自定义小工具的类放在\Elementor命名空间下，避免和Elementor官方类冲突，如果你的自定义小工具类没有设置自定义命名空间，直接写类名实例化即可，不需要加\Elementor\前缀。

内容的提问来源于stack exchange，提问作者Yvan Gagnon