Eduma子主题登录注册小部件定制无效果求助

使用Eduma主题（搭配Eduma-child子主题）及Thimpress、LearnPress插件，需修改注册相关字段。按WordPress子主题定制逻辑，将父主题以下路径文件复制到子主题对应路径修改后无效果：

• /eduma/inc/widgets/login-popup
• /eduma/inc/widgets/login-form
• /eduma/inc/widgets/form-login-register.php

做加载测试：

1. 父主题login-popup/base.php输出"This is parent theme"，子主题同路径文件输出"This is child theme"
2. 父主题form-login-register.php输出"Parent theme"，子主题同路径文件输出"Child theme"

测试结果：仅显示父主题内容，子主题文件未被加载。

原因分析 #

WordPress子主题的默认模板覆盖机制仅针对标准主题模板文件（如page.php、single.php等根目录/标准模板目录下的文件）。而主题inc/目录下的自定义组件（比如这类小部件文件），父主题通常是通过PHP原生的require/include直接加载，未使用WordPress的locate_template()函数（该函数会优先查找子主题文件），因此子主题同路径文件不会被自动触发加载。

解决方案 #

方法1：利用主题/插件钩子（优先推荐） #

Eduma和LearnPress作为成熟教育类产品，通常提供修改注册表单的动作（Action）或过滤器（Filter）钩子，无需直接修改核心文件：

• 可查找的常用钩子：learn_press_register_form（添加字段）、learn_press_register_errors（验证字段）、learn_press_user_registered（保存字段）
• 示例代码（添加自定义注册字段，需放入子主题functions.php）：

// 添加自定义注册字段
add_action('learn_press_register_form', 'add_custom_register_field');
function add_custom_register_field() {
    ?>
    <p class="form-row form-row-wide">
        <label for="custom_field"><?php _e('自定义字段', 'eduma-child'); ?><span class="required">*</span></label>
        <input type="text" class="input-text" name="custom_field" id="custom_field" value="<?php if ( ! empty( $_POST['custom_field'] ) ) echo esc_attr( $_POST['custom_field'] ); ?>" />
    </p>
    <?php
}

// 验证自定义字段
add_filter('learn_press_register_errors', 'validate_custom_register_field', 10, 3);
function validate_custom_register_field($errors, $username, $email) {
    if ( empty( $_POST['custom_field'] ) ) {
        $errors->add('custom_field_error', __('请填写自定义字段', 'eduma-child'));
    }
    return $errors;
}

// 保存自定义字段到用户元数据
add_action('learn_press_user_registered', 'save_custom_register_field', 10, 1);
function save_custom_register_field($user_id) {
    if ( ! empty( $_POST['custom_field'] ) ) {
        update_user_meta($user_id, 'custom_field', sanitize_text_field($_POST['custom_field']));
    }
}

方法2：重写小部件加载逻辑 #

若找不到合适钩子，可通过子主题functions.php强制优先加载子主题小部件文件：

1. 取消父主题对应小部件的注册
2. 重新注册小部件并加载子主题文件
   示例代码：

// 移除父主题登录弹窗小部件（需替换为实际类名）
add_action('widgets_init', 'remove_parent_login_popup_widget', 11);
function remove_parent_login_popup_widget() {
    unregister_widget('Thim_Widget_Login_Popup');
}

// 注册子主题登录弹窗小部件
add_action('widgets_init', 'register_child_login_popup_widget');
function register_child_login_popup_widget() {
    require get_stylesheet_directory() . '/inc/widgets/login-popup/base.php';
    register_widget('Thim_Widget_Login_Popup');
}

注：需查看父主题小部件文件中的类定义（如class Thim_Widget_Login_Popup extends WP_Widget），确保类名一致。

方法3：拦截模板加载（兜底方案） #

若上述方法无效，可通过template_include过滤器拦截父主题文件加载，强制替换为子主题文件：

add_filter('template_include', 'override_eduma_widget_template', 10, 1);
function override_eduma_widget_template($template) {
    $target_files = array(
        'inc/widgets/form-login-register.php',
        'inc/widgets/login-popup/base.php',
        'inc/widgets/login-form/base.php'
    );
    foreach ($target_files as $file) {
        if (strpos($template, $file) !== false) {
            $child_template = get_stylesheet_directory() . '/' . $file;
            if (file_exists($child_template)) {
                return $child_template;
            }
        }
    }
    return $template;
}

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