本教程旨在指导用户如何在WooCommerce购物车页面正确显示产品品牌名称。核心在于识别不同品牌插件或主题所使用的正确分类（taxonomy）名称，并通过wp_get_post_terms函数将其集成到购物车模板中，从而避免常见的invalid_taxonomy错误，实现品牌信息的准确展示。
在WooCommerce的购物车页面中，默认情况下并不会显示产品的品牌信息。当尝试通过自定义代码添加品牌显示时，开发者常会遇到invalid_taxonomy的错误，这通常是由于使用了错误的品牌分类（taxonomy）名称导致的。本文将详细介绍如何定位正确的品牌分类名称，并将其集成到您的购物车页面中。
理解invalid_taxonomy错误
当您尝试使用wp_get_post_terms()函数获取某个产品的品牌信息，但返回一个WP_Error对象，其中包含invalid_taxonomy错误时，这意味着WordPress无法找到您指定的分类（taxonomy）。例如，尝试使用pwb-brand或product_brand等名称时，如果您的品牌插件或主题并未注册这些分类，就会出现此错误。品牌分类的实际名称取决于您所使用的具体插件（如Perfect WooCommerce Brands、YITH WooCommerce Brands Add-on等）或主题的实现方式。
核心解决方案：识别正确的品牌分类（Taxonomy）
解决invalid_taxonomy问题的关键是找出您的WordPress安装中实际注册的品牌分类名称。有几种方法可以实现这一点：
方法一：通过WordPress后台URL查找（推荐）
这是最直接且通常最有效的方法：
登录您的WordPress后台。
导航到“产品”菜单下的“品牌”或类似的品牌管理页面。通常，这会是您管理产品品牌的地方。
观察浏览器地址栏中的URL。您会看到类似以下结构的URL：
/wp-admin/edit-tags.php?taxonomy=your_brand_taxonomy_name&post_type=product
请注意taxonomy=后面的值，例如ourbrandname。这个值（your_brand_taxonomy_name）就是您需要使用的正确品牌分类名称。
示例： 如果URL是 wp-admin/edit-tags.php?taxonomy=pwb-brand&post_type=product，那么正确的分类名称就是 pwb-brand。如果URL是 wp-admin/edit-tags.php?taxonomy=product_brand&post_type=product，那么分类名称就是 product_brand。关键在于提取taxonomy=后面的部分。
方法二：查阅插件或主题文档
如果您不确定如何通过URL查找，或者希望获得更官方的名称，可以查阅您所使用的品牌插件或主题的官方文档。这些文档通常会明确指出它们所使用的分类名称。
在WooCommerce购物车页面集成品牌显示
一旦您确定了正确的品牌分类名称（我们假设为your_brand_taxonomy_name），就可以将其集成到WooCommerce的购物车页面中。
修改购物车模板文件
WooCommerce的购物车页面模板文件通常位于wp-content/plugins/woocommerce/templates/cart/cart.php。强烈建议不要直接修改此文件，因为插件更新会覆盖您的更改。最佳实践是将其复制到您的子主题目录下的woocommerce/cart/cart.php路径中进行修改。
在cart.php文件中，您需要找到循环遍历购物车商品的部分。通常，您会在显示产品标题的附近添加品牌信息。
示例代码：
找到类似以下代码的区域（通常在产品名称或链接之后）：
// ... 其他购物车商品信息 ...// Product nameecho apply_filters( 'woocommerce_cart_item_name', $_product->get_name(), $cart_item, $cart_item_key ) . ' ';// ... 在这里插入品牌代码 ...// Product quantityif ( $_product->is_sold_individually() ) { // ...}// ...
在产品名称输出之后，您可以插入以下代码来显示品牌：
'names'] );// 检查是否有品牌，并且没有错误if ( ! is_wp_error( $brands ) && ! empty( $brands ) ) { echo ''; // 如果有多个品牌，用逗号分隔显示 echo implode(', ', $brands); echo '
';}?>
完整修改后的cart.php片段示例：
<tr class="">get_image(), $cart_item, $cart_item_key ); if ( ! $product_permalink ) { echo $thumbnail; // PHPCS: XSS ok. } else { printf( '%s', esc_url( $product_permalink ), $thumbnail ); // PHPCS: XSS ok. } ?> <td class="product-name" data-title=""> get_name(), $cart_item, $cart_item_key ) . ' ' ); } else { echo wp_kses_post( apply_filters( 'woocommerce_cart_item_name', sprintf( '%s', esc_url( $product_permalink ), $_product->get_name() ), $cart_item, $cart_item_key ) ); } // --- 在此处插入品牌显示代码 --- $product_id = apply_filters( 'woocommerce_cart_item_product_id', $cart_item['product_id'], $cart_item, $cart_item_key ); $brands = wp_get_post_terms( $product_id, 'your_brand_taxonomy_name', ['fields' => 'names'] ); // 替换为你的品牌分类名 if ( ! is_wp_error( $brands ) && ! empty( $brands ) ) { echo '' . implode(', ', $brands) . '
'; } // --- 品牌显示代码结束 --- do_action( 'woocommerce_after_cart_item_name', $cart_item, $cart_item_key ); // ... 其他信息，如元数据、可售性等 ... ?>
注意事项与最佳实践
使用钩子（Hooks）而非直接修改模板文件：虽然直接修改cart.php可以实现功能，但更推荐的做法是利用WooCommerce提供的动作钩子（Action Hooks）。例如，您可以使用woocommerce_after_cart_item_name钩子在产品名称后添加品牌信息，这样可以避免直接修改模板文件，提高代码的兼容性和可维护性。
在您的子主题的functions.php文件中添加如下代码：
add_action( 'woocommerce_after_cart_item_name', 'display_product_brand_in_cart', 10, 2 );function display_product_brand_in_cart( $cart_item, $cart_item_key ) { $product_id = apply_filters( 'woocommerce_cart_item_product_id', $cart_item['product_id'], $cart_item, $cart_item_key ); // 替换 'your_brand_taxonomy_name' 为你的实际品牌分类名 $brands = wp_get_post_terms( $product_id, 'your_brand_taxonomy_name', ['fields' => 'names'] ); if ( ! is_wp_error( $brands ) && ! empty( $brands ) ) { echo '' . implode(', ', $brands) . '
'; }}
错误处理：始终检查wp_get_post_terms()的返回值。如果返回WP_Error对象，说明分类名称不正确或存在其他问题。在上面的代码中，我们使用了! is_wp_error( $brands )来确保只有在成功获取品牌信息时才尝试显示。
多品牌处理：wp_get_post_terms()会返回一个数组，即使只有一个品牌。使用implode(‘, ‘, $brands)可以优雅地处理产品关联多个品牌的情况，用逗号分隔显示。
样式定制：我们为品牌信息添加了一个CSS类product-brand。您可以在主题的样式表（style.css）中添加CSS规则，以自定义品牌名称的显示样式，例如字体大小、颜色或位置。
总结
在WooCommerce购物车页面显示产品品牌名称是一个常见的需求，其核心在于正确识别您的品牌插件或主题所使用的自定义分类（taxonomy）名称。通过检查WordPress后台URL或查阅文档，您可以轻松找到这个名称。随后，无论是直接修改子主题的cart.php模板文件，还是更推荐地使用WooCommerce钩子，您都可以将品牌信息集成到购物车中。遵循最佳实践，如使用钩子和进行错误处理，将确保您的定制化功能稳定、可维护且兼容性良好。
以上就是WooCommerce购物车页面显示产品品牌名称教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/64714.html
微信扫一扫 
支付宝扫一扫 
