本教程旨在指导用户如何在 WooCommerce 单个产品页面上，将产品分类名称转换为可点击的链接，从而方便用户直接访问该产品所属的分类页面。通过使用 wc_get_product_category_list() 函数，我们可以轻松地生成包含链接的分类列表，并将其添加到产品摘要的合适位置。
目标
我们的目标是修改 WooCommerce 产品页面，使得产品分类名称不再是静态文本，而是可以点击的链接，用户点击后可以跳转到该分类的页面。
实现方法
WooCommerce 提供了 wc_get_product_category_list() 函数，它可以生成包含链接的分类列表。我们需要使用这个函数来替换原有的静态分类名称显示方式。
具体步骤
- 移除原有的分类显示代码
首先，我们需要移除之前用于显示产品分类名称的代码。在您提供的代码中，这段代码位于 add_brand_category() 函数内：
/** Output Product (Brand) Category on single product page **/
function add_brand_category(){
$product_cats = wp_get_post_terms( get_the_ID(), 'product_cat' );
if ( $product_cats && ! is_wp_error ( $product_cats ) ){
$single_cat = array_shift( $product_cats ); ?>
<h3 itemprop="name" class="product_category_title"><span><?php echo $single_cat->name; ?></span></h3>
<?php }
}
add_action( 'woocommerce_single_product_summary', 'add_brand_category', 2 );我们需要移除或者注释掉 add_brand_category() 函数，并取消 add_action 的绑定，避免重复输出。
- 添加新的分类显示代码
接下来，我们添加新的代码，使用 wc_get_product_category_list() 函数生成带链接的分类列表。将以下代码添加到您的 functions.php 文件或自定义插件中：
function action_woocommerce_single_product_summary() {
global $product;
// 检查是否为 WooCommerce 产品
if ( is_a( $product, 'WC_Product' ) ) {
echo '<h3 itemprop="name" class="product_category_title">';
echo wc_get_product_category_list( $product->get_id(), ', ', '<span>' . _n( 'Category:', 'Categories:', count( $product->get_category_ids() ), 'woocommerce' ) . ' ', '</span>' );
echo '</h3>';
}
}
add_action( 'woocommerce_single_product_summary', 'action_woocommerce_single_product_summary', 2 );代码解释
- action_woocommerce_single_product_summary(): 这是一个自定义函数，用于在 WooCommerce 产品摘要中添加内容。
- global $product;: 获取全局的 $product 对象，包含了当前产品的信息。
- is_a( $product, 'WC_Product' ): 检查 $product 是否为 WooCommerce 产品对象。
- wc_get_product_category_list( $product->get_id(), ', ', '<span>' . _n( 'Category:', 'Categories:', count( $product->get_category_ids() ), 'woocommerce' ) . ' ', '</span>' ): 这是核心函数，用于生成带链接的分类列表。
- $product->get_id(): 获取当前产品的 ID。
- ', ': 设置分类之间的分隔符为逗号加空格。
- '<span>' . _n( 'Category:', 'Categories:', count( $product->get_category_ids() ), 'woocommerce' ) . ' ', '</span>': 设置分类列表的前缀，并使用 _n() 函数进行单复数形式的本地化处理。
- 代码放置位置
建议将上述代码添加到主题的 functions.php 文件中，或者创建一个自定义插件来存放这些代码。 直接修改主题文件存在升级时被覆盖的风险，使用子主题或者自定义插件是更佳实践。
注意事项
- 确保您的 WooCommerce 版本支持 wc_get_product_category_list() 函数。
- 您可以根据需要修改分隔符和前缀，以适应您的主题风格。
- 如果您的主题已经对 woocommerce_single_product_summary 这个 action 进行了自定义，您可能需要调整代码的优先级 (第三个参数 2)，以确保它在正确的位置显示。
总结
通过使用 wc_get_product_category_list() 函数，我们可以轻松地为 WooCommerce 产品页面添加产品分类链接，提升用户体验，方便用户浏览相关产品。 请务必在修改代码前备份您的网站，并在测试环境中进行验证，确保代码的正确性和兼容性。
