WooCommerce 短代码全指南：如何在任意页面插入商店 / 产品 /购物流程

引言

作为一名 WooCommerce 的开发者 / 商店运营者，灵活地控制页面布局和功能非常重要。尽管现在许多站点使用可视化编辑器（如 Gutenberg
块或第三方构建插件），但短代码（shortcodes）仍然是一个非常实用、灵活且轻量的方式，能够快速将商店、产品、结账流程、购物车等功能插入任意页面或文章中。
通过短代码，你无需写复杂的 PHP 模板，也可以在任意页面展示产品列表、特色产品、分类产品、用户账户、订单跟踪等功能。
本文将整合官方文档与插件文档经验（如来自 WooCommerce 官方文档与 WooLentor 插件文档内容）来全面介绍 WooCommerce 短代码的使用方式、参数、注意事项与扩展建议。

1. 什么是 WooCommerce 短代码

短代码（shortcode）是一种 WordPress 的机制，可以通过方括号语法（例如 【products】、【woocommerce_cart】】 等）将动态内容嵌入到页面 /
博客 /文章 /小工具 /自定义内容中。
WooCommerce 在其核心插件中提供了很多预定义短代码，用于显示商店相关的动态模块，例如产品列表、购物车、结账、用户账户、订单跟踪等。(【WooCommerce】)
即使使用了 Gutenberg 编辑器（块编辑器），这些短代码仍然可以在 “Shortcode 块” 中使用。(【WooCommerce】)

2. 常见核心短代码一览

下面是一些常用的核心短代码及其用途概要：

3. 产品 / 分类展示短代码详解与参数说明

以下是一些常用产品展示或分类展示的短代码，以及常用参数 / 属性（attributes）说明，方便你在页面中灵活布局。

多产品展示 / 产品集合

• 【products】：最常用的短代码之一，可用于展示多个产品并支持各种筛选。(【WooCommerce】)
• 常用参数包括：
  • limit：控制展示多少个产品（例如 limit="6" 表示展示 6 个产品）。(【WooLentor】)
  • columns：每行产品的列数 (grid 布局列数)，例如 columns="3"。(【WooLentor】)
  • orderby：排序依据 (如 date, title, popularity,
    rating, rand 随机等) 。(【WooLentor】)
  • order：排序方向 (ASC / DESC)。(【WooLentor】)
  • paginate：是否启用分页 (例如 paginate="true" 可分多页显示产品)。(【WooLentor】)
  • category / tag / attribute / terms：可根据产品分类
    (category slug) / 标签 /属性 (如颜色 /尺寸等属性 /术语)
    进行过滤。例：【products category="t-shirts" attribute="color" terms="red"】。(【WooLentor】)
  • visibility：控制产品的可见性 (仅展示 catalog / search / both 等可见状态)。(【WooLentor】)
  • class：可添加自定义 CSS class，以便通过 CSS 进行样式定制。(【WooLentor】)

分类 / 类别展示

• 【product_category category="slug"】：展示某个分类 (slug) 下的产品。(【WooCommerce】)
• 【product_categories】：展示多个产品分类的缩略或分类列表 (支持参数如 number, columns,
  orderby, order 等)。例如 number="8" 表示展示 8 个分类，columns="3"
  表示每行 3 列，并且可按 name 排序 (ASC / DESC)。(【WooLentor】)

特定用途展示产品

• 【featured_products per_page="6" columns="3"】：展示标记为 “特色 / featured” 的产品
  (如首页专题或促销推荐区)。(【WooLentor】)
• 【sale_products per_page="6" columns="3"】：展示目前打折 / 特价的产品。(【WooLentor】)
• 【recent_products per_page="4" columns="4"】：展示最近上架的产品。(【WooLentor】)
• 【best_selling_products per_page="5" columns="3"】：展示销量最高的产品 (畅销产品)。(【WooLentor】)
• 【top_rated_products per_page="4" columns="4"】：展示评价最高 (顾客评分) 的产品。(【WooLentor】)
• 【related_products per_page="3" columns="3"】：在某个产品页面下显示推荐 / 相关产品 (交叉销售 / upsell /
  cross-sell)。(【WooLentor】)

4. 页面流程相关短代码（购物流程 / 用户账户 /订单跟踪）

为了完整构建商店的用户流程 (购物 -> 结账 -> 用户管理 ->订单跟踪)，以下短代码非常有用：

这些短代码可以嵌入任意页面 (例如你自定义的 “我的账户” 页面 / “订单查询” 页面)，非常适合构建用户友好的购物流程。(【WooLentor】)

5. 常见问题 / 排查技巧

使用短代码时，有些常见问题可能会导致短代码无法正常显示或效果异常，这里总结一些经验与排查建议：

• 确认语法是否正确（方括号完整 /属性名拼写正确）。缺少或拼写错误会导致短代码无法解析。(【WooLentor】)
• 确保 WooCommerce 插件及其他相关插件 /主题是最新版本，以避免版本兼容问题。(【WooLentor】)
• 尝试禁用其他插件 /切换回默认主题（如 Storefront 或官方模板）以排查冲突。(【WooLentor】)
• 在 Gutenberg 编辑器中使用 Shortcode 块插入短代码 (而不是把短代码放在文本 /HTML 模块之外)。(【WooCommerce】)
• 如果短代码嵌入在小工具 (widget) 或某些页面模板中，也要确保这些位置支持短代码解析。否则可能需要通过 do_shortcode() 函数或者自定义模板调用。

6. 高级自定义 & 使用构建插件 / 块的替代方式

虽然短代码功能强大且灵活，但现在很多页面 /布局习惯转向使用块编辑或构建插件，因为更加可视化 /所见即所得 (WYSIWYG)：

• WooCommerce 官方文档也指出，随着 WordPress 编辑器向块 (block) 发展，短代码正在被更交互、可视化的块所替代。(【WooCommerce】)
• 例如使用构建插件 ShopLentor（以前称为 WooLentor），提供许多 Gutenberg 块 / Elementor
  模块，用户可以拖拽布局产品展示、购物流程、用户账户页面等，而不需要记忆复杂的短代码参数。(【WooLentor】)
• 这些构建块还支持属性过滤、多货币、弹窗 /促销计时器 /高级筛选功能，使得商店的外观和功能更加丰富且易于维护。(【WooLentor】)

如果你是开发者，也可以结合短代码 + 自定义 PHP 模板 /自定义短代码 (shortcode + add_shortcode) 来增强灵活性。例如你可以注册一个短代码
【woocommerce-shop】，并在后台通过 PHP 输出 【products paginate="true" columns="4"】
等短代码内容，从而在任意页面还原商店页面效果。

7. 总结与下一步扩展方向

• 短代码是 WooCommerce 中一个轻量、灵活且易于使用的机制，可以在任意页面 /文章 /小组件中调用各种功能（产品展示 /购物流程 /账户页面 /订单跟踪等）。
• 你可以通过参数 (limit / columns / orderby / filters 等) 来控制产品展示效果，实现定制布局。
• 如果你想更可视化 /减少记忆参数，也可以使用构建插件 /块 (例如 ShopLentor /Gutenberg 块) 来替代短代码。
• 作为博客 /教程内容，也可以进一步扩展到短代码实例 + 自定义短代码 +与你自己的 WordPress 主题或插件 (例如你开发的 SEO 插件 /主题) 的集成教程。