在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 name
echo apply_filters( 'woocommerce_cart_item_name', $_product->get_name(), $cart_item, $cart_item_key ) . ' ';
// ... 在这里插入品牌代码 ...
// Product quantity
if ( $_product->is_sold_individually() ) {
// ...
}
// ...在产品名称输出之后，您可以插入以下代码来显示品牌：
<?php
// 获取产品ID
$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 '<p class="product-brand">';
// 如果有多个品牌，用逗号分隔显示
echo implode(', ', $brands);
echo '</p>';
}
?>完整修改后的cart.php片段示例：
<tr class="<?php echo esc_attr( apply_filters( 'woocommerce_cart_item_class', 'cart_item', $cart_item, $cart_item_key ) ); ?>">
<td class="product-thumbnail">
<?php
$thumbnail = apply_filters( 'woocommerce_cart_item_thumbnail', $_product->get_image(), $cart_item, $cart_item_key );
if ( ! $product_permalink ) {
echo $thumbnail; // PHPCS: XSS ok.
} else {
printf( '<a href="%s">%s</a>', esc_url( $product_permalink ), $thumbnail ); // PHPCS: XSS ok.
}
?>
</td>
<td class="product-name" data-title="<?php esc_attr_e( 'Product', 'woocommerce' ); ?>">
<?php
if ( ! $product_permalink ) {
echo wp_kses_post( apply_filters( 'woocommerce_cart_item_name', $_product->get_name(), $cart_item, $cart_item_key ) . ' ' );
} else {
echo wp_kses_post( apply_filters( 'woocommerce_cart_item_name', sprintf( '<a href="%s">%s</a>', 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 '<p class="product-brand">' . implode(', ', $brands) . '</p>';
}
// --- 品牌显示代码结束 ---
do_action( 'woocommerce_after_cart_item_name', $cart_item, $cart_item_key );
// ... 其他信息，如元数据、可售性等 ...
?>
</td>
<!-- ... 其他表格列 ... -->
</tr>注意事项与最佳实践
-
使用钩子（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 '<p class="product-brand">' . implode(', ', $brands) . '</p>'; } } 错误处理： 始终检查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钩子，您都可以将品牌信息集成到购物车中。遵循最佳实践，如使用钩子和进行错误处理，将确保您的定制化功能稳定、可维护且兼容性良好。
