自定义主题中WooCommerce模板调用异常及商品不显示求助

• 确认主题是否声明支持WooCommerce
  自定义主题必须明确声明支持WooCommerce，否则插件不会按默认规则加载模板。在主题functions.php中添加以下代码：

  add_action( 'after_setup_theme', 'mytheme_enable_woocommerce_support' );
  function mytheme_enable_woocommerce_support() {
      add_theme_support( 'woocommerce' );
      // 可选：启用商品图库的缩放/灯箱/滑动功能
      add_theme_support( 'wc-product-gallery-zoom' );
      add_theme_support( 'wc-product-gallery-lightbox' );
      add_theme_support( 'wc-product-gallery-slider' );
  }
  

• 检查模板文件路径与命名
  确保mytheme/woocommerce/下的文件完全匹配官方命名：

  • 商店归档页：archive-product.php（注意是product单数，不是复数）
  • 单个商品页：single-product.php
    Linux服务器下文件名区分大小写，务必保证拼写完全一致。

• 排查主题对模板加载的干扰
  部分自定义主题会通过template_include或woocommerce_template_loader钩子修改模板逻辑，导致默认层级失效。在主题functions.php中搜索这两个钩子，若存在自定义代码，先注释掉再测试。

• 验证Shop页面的设置
  后台进入「WooCommerce > 设置 > 产品 > 显示」，确认「商店页面」已选择正确页面，且该页面未手动指定自定义模板（页面编辑页的「模板」选项保持默认）。

• 修正强制调用模板的代码
  若之前的强制代码导致商品不显示，大概率是破坏了WooCommerce的查询上下文。替换为保留查询逻辑的代码：

  add_filter('template_include', 'custom_load_woocommerce_templates');
  function custom_load_woocommerce_templates($template) {
      // 匹配商店、产品分类、标签页
      if (is_shop() || is_product_category() || is_product_tag()) {
          $custom_template = locate_template(['woocommerce/archive-product.php']);
          return $custom_template ?: $template;
      }
      // 匹配单个商品页
      if (is_product()) {
          $custom_template = locate_template(['woocommerce/single-product.php']);
          return $custom_template ?: $template;
      }
      return $template;
  }
  

  同时确保自定义的archive-product.php中包含WooCommerce的商品循环代码，不要直接复制普通page.php的内容。

• 刷新固定链接规则
  进入后台「设置 > 固定链接」，临时切换为其他规则（如「简单」）保存，再切换回原规则保存，刷新前端页面测试。

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