为何Elementor自定义插件报‘Widget_Base类未找到’致命错误？

错误根源 #

出现Fatal error: Uncaught Error: Class "Elementor\Widget_Base" not found的核心原因是：你的自定义插件在Elementor核心类还未加载完成时，就尝试继承并使用Elementor的类。WordPress插件按加载顺序执行，你的自定义插件可能比Elementor更早加载，导致全局作用域里的My_Custom_Widget类找不到父类。

而wp_config.php能运行只是特殊场景（该文件加载时机极早，你的环境中Elementor可能被意外提前初始化），但这属于违规用法，绝不能将业务代码放在wp_config.php中。

修复后的完整代码 #

修改插件代码结构，确保所有依赖Elementor的逻辑都在Elementor初始化后执行：

/**
 * Plugin Name: My Custom Widget
 * Plugin URI:  https://www.website.com/
 * Description: Custom Elementor Widget for displaying events.
 * Version:     1.0.0
 * Author:      Ryan 
 * Author URI:  https://www.website.com/
 * Text Domain: my-custom-widget
 */

// 禁止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

// 仅在Elementor加载完成后执行注册逻辑
add_action( 'elementor/init', function() {
    // 检查Elementor核心类是否存在
    if ( ! class_exists( 'Elementor\Widget_Base' ) ) {
        return;
    }

    class My_Custom_Widget extends \Elementor\Widget_Base {

        public function get_name() {
            return 'my_custom_widget';
        }

        public function get_title() {
            return 'Custom Events Widget';
        }

        public function get_icon() {
            return 'eicon-post-list';
        }

        public function get_categories() {
            return [ 'general' ];
        }

        protected function _register_controls() {
            $this->start_controls_section(
                'section_content',
                [
                    'label' => 'Settings',
                ]
            );

            $this->add_control(
                'custom_post_type',
                [
                    'label' => 'Custom Post Type',
                    'type' => \Elementor\Controls_Manager::SELECT,
                    'options' => $this->get_custom_post_types(),
                    'default' => 'your_custom_post_type', // 替换为你的默认CPT别名
                ]
            );

            $this->end_controls_section();
        }

        protected function render() {
            $settings = $this->get_settings();

            $today = date('Y-m-d');
            $future_date = date('Y-m-d', strtotime('+30 days'));

            $args = array(
                'post_type' => $settings['custom_post_type'],
                'posts_per_page' => -1,
                'meta_key' => 'date_of_event', // 替换为你的ACF日期字段键
                'orderby' => 'meta_value',
                'order' => 'ASC',
                'meta_query' => array(
                    array(
                        'key' => 'date_of_event', // 替换为你的ACF日期字段键
                        'value' => array($today, $future_date),
                        'compare' => 'BETWEEN',
                        'type' => 'DATE',
                    ),
                ),
            );

            $events = new WP_Query($args);

            if ($events->have_posts()) :
                while ($events->have_posts()) : $events->the_post();
                    // 获取额外ACF字段并自定义布局
                    $event_title = get_the_title();
                    $event_permalink = get_permalink();
                    $event_date = get_field('date_of_event'); // 替换为你的ACF字段名
                    $event_description = get_field('event_description'); // 替换为你的ACF字段名
                    ?>
                    <div class="event">
                        <h4><?php echo $event_date; ?></h4>
                        <h3 style="padding-bottom:10px;"><a href="<?php echo $event_permalink; ?>"><?php echo $event_title; ?></a></h3>
                        <div class="event-description"><?php echo $event_description; ?></div>
                    </div>
                    <?php
                endwhile;
            else :
                echo 'No events found.';
            endif;
            wp_reset_postdata();
        }

        // 获取可用自定义文章类型的辅助方法
        private function get_custom_post_types() {
            $post_types = get_post_types(['public' => true], 'objects');
            $options = [];

            foreach ($post_types as $post_type) {
                $options[$post_type->name] = $post_type->label;
            }

            return $options;
        }
    }

    // 注册自定义Widget
    function register_custom_widget() {
        \Elementor\Plugin::instance()->widgets_manager->register_widget_type(new My_Custom_Widget());
    }
    add_action('elementor/widgets/widgets_registered', 'register_custom_widget');
});

关键修改说明 #

1. 绑定Elementor初始化钩子：使用elementor/init钩子，确保Elementor所有核心类加载完成后再执行代码。
2. 增加类存在检查：添加class_exists('Elementor\Widget_Base')判断，避免Elementor未安装/启用时触发错误。
3. 安全防护：增加ABSPATH判断，防止恶意直接访问插件文件。

关于functions.php失效的问题 #

若要将代码放在主题functions.php中，同样需要遵循上述逻辑——把所有依赖Elementor的代码包裹在elementor/init钩子内，确保加载时机正确。

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