WordPress子主题如何替换listings_recently.php并正确调用？

看来你在子主题替换父主题widget文件时遇到了坑，咱们先从你写错的get_template_part用法说起，再解决核心的widget加载问题：

首先纠正你的get_template_part错误用法 #

你写的两行代码都有语法问题——把get_stylesheet_directory()放在了引号里，PHP会把它当成普通字符串，而不是执行这个函数获取子主题路径。

正确的get_template_part用法是不需要手动拼接路径的，它会自动优先查找子主题文件，再找父主题。针对你的文件路径core/widgets/listings_recently.php，正确的调用应该是：

get_template_part('core/widgets/listings_recently');

如果父主题原本是用连字符命名文件（比如listings-recently.php），才需要拆成slug和name：

get_template_part('core/widgets/listings', 'recently');

不过这可能不是你问题的核心——很多主题的自定义widget是直接在注册时硬编码加载父主题文件的，这时候子主题同名文件不会自动生效，得用钩子来替换。

方案一：替换父主题的Widget注册（最可靠） #

大部分主题的自定义widget会通过register_widget注册，并且直接include父主题路径下的文件。咱们可以通过钩子先取消父主题的widget注册，再加载子主题的文件重新注册：

1. 找到父主题Widget的类名：打开父主题的listingeasy/core/widgets/listings_recently.php，找到类似这样的代码行：

   class Listingeasy_Recent_Listings_Widget extends WP_Widget {
   

   把这个类名（比如Listingeasy_Recent_Listings_Widget）记下来。

2. 在子主题functions.php中添加代码：

   // 用比父主题更高的优先级（11）执行，确保能覆盖父主题的注册
   add_action('widgets_init', 'child_replace_recent_listings_widget', 11);
   
   function child_replace_recent_listings_widget() {
       // 取消父主题的Widget注册
       unregister_widget('Listingeasy_Recent_Listings_Widget');
       
       // 加载子主题的Widget文件
       require_once(get_stylesheet_directory() . '/core/widgets/listings_recently.php');
       
       // 重新注册Widget（使用子主题文件中的类）
       register_widget('Listingeasy_Recent_Listings_Widget');
   }
   

   注意：把代码中的类名替换成你刚才找到的实际类名。

方案二：用template_include钩子强制拦截文件加载 #

如果父主题是通过get_template_part或include加载widget模板的，你可以用这个钩子强制让WordPress优先加载子主题的文件：

add_filter('template_include', 'child_load_recent_listings_widget_template', 99);

function child_load_recent_listings_widget_template($template) {
    $target_file = 'core/widgets/listings_recently.php';
    
    // 检查当前要加载的是否是父主题的目标文件
    if (strpos($template, $target_file) !== false && strpos($template, get_template_directory()) !== false) {
        // 替换为子主题的文件路径
        $child_template = get_stylesheet_directory() . '/' . $target_file;
        if (file_exists($child_template)) {
            return $child_template;
        }
    }
    
    return $template;
}

最后检查这几点 #

• 确认子主题文件夹结构完全和父主题对应：listingeasy-child/core/widgets/listings_recently.php（你已经做到了）
• 清除WordPress缓存（如果用了缓存插件），缓存会导致修改不及时生效
• 子主题已经正确激活（你的single.php生效，这点没问题）

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