WooCommerce 3.3.5升级后短码查询产品属性失效问题咨询

我之前也踩过WooCommerce升级后短码参数的坑，咱们一步步来排查解决：

• 先确认属性和术语的Slug是否正确
  WooCommerce短码里的attribute和terms参数必须用属性/术语的slug，而不是显示名称。你得去后台「产品 > 属性」里核对：

  • 你的属性「collezione_chakra」的slug是不是完全匹配？注意slug一般是小写、用连字符（比如collezione-chakra）而非下划线，很多人在这里搞混。
  • 术语「stella」的slug是不是确实是stella？有没有大写字母或者特殊字符？

• 直接测试纯短码（排除PHP输出的问题）
  先把PHP代码放一边，直接在WordPress页面编辑器里插入纯短码：

  [products attribute="collezione_chakra" terms="stella" limit="-1"]
  

  预览页面看能不能显示产品。如果这样可行，那问题可能出在PHP代码的执行环境（比如主题文件里的位置不对、有转义字符干扰）；如果还是不行，继续往下排查。

• 检查目标产品的属性配置
  确认你要查询的产品：

  • 已经正确勾选了「collezione_chakra」属性下的「stella」术语
  • 产品状态是「发布」（不是草稿、私密状态）
  • 没有被设置为隐藏，库存状态符合店铺的显示规则（比如没有开启缺货隐藏）

• 排查兼容性问题
  暂时禁用所有非WooCommerce的插件，切换到WooCommerce官方默认主题「Storefront」，再测试短码。有时候其他插件或主题的自定义代码会干扰WooCommerce短码的查询逻辑。

如果排查后发现是slug的问题，修正后的PHP代码示例（假设属性slug是collezione-chakra）：

<?php echo do_shortcode('[products attribute="collezione-chakra" terms="stella" limit="-1"]'); ?>

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