WooCommerce 产品详情页可以用代码自定义吗?完整入门指南

WooCommerce 是 WordPress 最好用的电商插件,可以轻松搭建产品页、购物车和支付系统。但默认的产品页面可能不符合你的需求?别担心,其实用简单的代码就能自定义产品详情页,让它更符合你的店铺风格。下面介绍怎样动手修改。

20250621123035220-image

一、WooCommerce 产品详情页的结构简介

默认情况下,WooCommerce 会使用内置模板展示产品页面,打开路径为:

/wp-content/plugins/woocommerce/templates/single-product/

常见的结构包括:

  • 产品标题(woocommerce_template_single_title
  • 产品价格(woocommerce_template_single_price
  • 产品图片(woocommerce_show_product_images
  • 产品简短描述(woocommerce_template_single_excerpt
  • 添加到购物车按钮(woocommerce_template_single_add_to_cart
  • 产品标签与分类(woocommerce_template_single_meta
  • 产品详情(描述、评论 Tab)(woocommerce_output_product_data_tabs

这些部分通过 WordPress 的钩子系统(actions 和 filters)被加载和控制。

二、如何用代码自定义产品详情页?

WooCommerce 的可定制性非常强,只需要几行代码,就可以添加、删除、重新排序产品页面的元素。

打开路径为: WordPress- Appearance – Theme File Editor

1. 移除默认模块(如删除产品标签)

remove_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_meta', 40 );

把这段代码添加到当前主题的 functions.php 文件中就可以。

20250623143510947-image

2. 添加自定义内容(如在价格下方插入一句话)

add_action( 'woocommerce_single_product_summary', 'custom_text_after_price', 11 );
function custom_text_after_price() {
    echo '<p class="custom-message"> 本商品支持7天无理由退换货</p>';
}

这里的数字 11 是优先级,确保它在价格(默认优先级为 10)之后加载。

20250623145536264-image

3. 更改模块位置(如将短描述移动到“添加到购物车”按钮下)

remove_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_excerpt', 20 );
add_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_excerpt', 35 );

只需要调整钩子的加载顺序,就可以实现位置的灵活变动。

20250623151640140-image

三、替换产品详情页模板文件

如果需要更彻底地更改结构,可以通过下面的方式覆盖 WooCommerce 默认模板:

  • 在当前主题或子主题中创建目录 /your-theme/woocommerce/single-product/
  • 从插件的模板目录中复制所需文件(如 price.php, title.php 等)到上述路径
  • 修改这些模板,就可以实现结构自定义,不影响后续 WooCommerce 更新

四、实用自定义建议

20250623150631251-image
  • 在产品图片下添加产品编号或库存状态
  • 根据用户是否登录显示不同信息
  • 搭配 ACF 插件显示品牌、产地等自定义字段
  • 只对某类产品启用不同的布局逻辑

五、开发者调试技巧

启用 WooCommerce 的模板调试功能,可以快速查看模板来源和钩子位置:

add_filter( 'woocommerce_developer_mode', '__return_true' );

配合 Query Monitor 插件使用,查看加载的钩子、模板路径和执行优先级。

六、总结

WooCommerce 产品详情页完全可以通过代码灵活自定义。只需要掌握基本的钩子机制与模板覆盖方法,就可以根据实际业务自由调整展示内容和顺序,让产品页更专业、更有品牌特色。


了解 宝藏号 的更多信息

订阅后即可通过电子邮件收到最新文章。

© 版权声明

相关文章

暂无评论

none
暂无评论...

了解 宝藏号 的更多信息

立即订阅以继续阅读并访问完整档案。

继续阅读