在 WooCommerce 购物车页面显示产品品牌信息是提升用户体验的常见需求。然而，在尝试使用 wp_get_post_terms 函数获取品牌时，开发者常会遇到 invalid_taxonomy 错误。本文将深入解析此错误的原因，并提供两种有效方法来定位正确的产品品牌分类法（taxonomy）名称，最终指导您如何在购物车页面成功集成并展示产品品牌。
引言：在 WooCommerce 购物车页面显示产品品牌的需求
在电子商务网站中，品牌信息对于消费者而言具有重要的参考价值。在 WooCommerce 购物车页面清晰地展示产品品牌，不仅能增强用户对商品的信任感，也能帮助用户在结算前再次确认所选商品的具体信息。然而，直接在购物车模板中添加品牌信息时，许多开发者会遇到 wp_get_post_terms 函数返回 invalid_taxonomy 错误，导致品牌无法正常显示。
理解 invalid_taxonomy 错误
当您尝试使用 wp_get_post_terms() 函数来获取某个文章（或产品）的分类法（taxonomy）术语时，如果传入的分类法名称不正确或不存在，WordPress 就会返回一个 WP_Error 对象，其中包含 invalid_taxonomy 错误信息。
wp_get_post_terms($product_id, 'your_taxonomy_name', ['fields' => 'names'])
这个函数的核心在于第二个参数 'your_taxonomy_name'。它必须精确匹配您的品牌插件或主题所注册的自定义分类法名称。如果名称不匹配，WordPress 将无法识别该分类法，从而引发 invalid_taxonomy 错误。常见的错误尝试包括使用 pwb-brand 或 product_brand，但这些名称并非通用，它们取决于您使用的具体插件或主题。
定位正确的产品品牌分类法（Taxonomy）名称
解决 invalid_taxonomy 错误的关键在于找到您系统中实际使用的产品品牌分类法名称。以下是两种有效的方法：
方法一：通过 WordPress 后台 URL 查找（推荐）
这是最直接且通常最简单的方法。WordPress 在后台管理界面中，会将其分类法名称显示在编辑页面的 URL 中。
- 登录 WordPress 后台：使用管理员账户登录您的网站。
-
导航至品牌管理页面：
- 如果您的品牌是由插件（如 Perfect WooCommerce Brands）提供的，通常会在 WooCommerce 或产品菜单下找到“品牌”或“Brands”选项。
- 点击进入该品牌管理页面，您会看到所有已创建的品牌列表。
- 检查浏览器地址栏 URL：在品牌管理页面的 URL 中，查找 taxonomy= 参数。该参数后面的值就是您要找的分类法名称。
示例 URL 解析：
假设您在浏览器地址栏中看到类似以下 URL：
https://yourwebsite.com/wp-admin/edit-tags.php?taxonomy=ourbrandname&post_type=product
在这个 URL 中，taxonomy=ourbrandname 部分明确指出了您的品牌分类法名称是 ourbrandname。
方法二：检查插件或主题代码（适用于开发者）
如果通过 URL 查找不便，或者您是开发者，可以直接检查您的品牌插件或主题的源代码：
- 查看品牌插件的 functions.php 或主文件：许多品牌插件会在其主文件或 includes 文件夹中的某个文件中注册自定义分类法。搜索 register_taxonomy 函数的调用，其第一个参数通常就是分类法名称。
- 查看主题的 functions.php 文件：如果品牌功能是由主题提供的，那么相关代码可能位于主题的 functions.php 文件中。
在购物车页面集成品牌信息
一旦您确定了正确的品牌分类法名称，就可以将其应用到 wp_get_post_terms 函数中，并在购物车页面显示品牌信息。
核心逻辑：
- 获取购物车项的产品 ID。
- 使用正确的分类法名称调用 wp_get_post_terms 获取品牌。
- 遍历品牌并显示其名称。
示例代码：在 cart.php 中添加品牌显示
为了在 WooCommerce 购物车页面显示品牌，您通常需要修改 wp-content/plugins/woocommerce/templates/cart/cart.php 模板文件，或者更推荐的做法是使用主题的 functions.php 文件通过钩子进行修改。以下示例展示了如何在 cart.php 中（在产品标题下方）添加品牌信息。
'names'] );
// 检查是否成功获取品牌且没有错误
if ( ! is_wp_error( $brands ) && ! empty( $brands ) ) {
echo '';
echo '品牌: ' . implode(', ', $brands); // 如果有多个品牌，用逗号分隔
echo '
';
}
// 以下是购物车页面原有的其他产品信息显示代码，例如：
// echo apply_filters( 'woocommerce_cart_item_name', $_product->get_name(), $cart_item, $cart_item_key ) . ' ';
// ... 其他购物车项信息 ...
?>代码解释：
- $_product = apply_filters(...) 和 $product_id = apply_filters(...)：这些行用于安全地获取当前购物车项的产品对象和产品 ID。
- $brand_taxonomy = 'ourbrandname';：这是最关键的一行，您需要将 'ourbrandname' 替换为您通过上述方法找到的实际分类法名称。
- $brands = wp_get_post_terms(...)：使用产品 ID 和正确的分类法名称来获取品牌术语。['fields' => 'names'] 参数确保只返回品牌的名称数组。
- if ( ! is_wp_error( $brands ) && ! empty( $brands ) )：这是一个重要的错误处理步骤。它检查 wp_get_post_terms 是否返回了 WP_Error 对象（表示失败）以及品牌数组是否为空。只有在成功获取到品牌时才进行显示。
- echo '
';：将品牌名称包裹在
标签中，并添加一个 CSS 类 product-brand-name，方便后续进行样式定制。
- implode(', ', $brands)：如果一个产品有多个品牌（虽然不常见，但有可能），此函数会将所有品牌名称用逗号和空格连接起来。
注意事项与最佳实践
-
避免直接修改核心模板文件：直接修改 wp-content/plugins/woocommerce/templates/cart/cart.php 是不推荐的。因为当 WooCommerce 插件更新时，您的修改会被覆盖。
- 推荐做法：将 cart.php 文件复制到您的主题（或子主题）的 woocommerce/cart/ 目录下，然后在该复制的文件中进行修改。
-
更佳实践：使用 WooCommerce 提供的钩子（Action Hooks 和 Filter Hooks）在 functions.php 文件中添加品牌信息，而不是直接修改模板文件。例如，可以使用 woocommerce_after_cart_item_name 钩子。
// 在 functions.php 中添加此代码 add_action( 'woocommerce_after_cart_item_name', 'display_product_brand_in_cart', 10, 3 );
function display_product_brand_in_cart( $cart_item, $cart_item_key ) { $_product = apply_filters( 'woocommerce_cart_item_product', $cart_item['data'], $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' 为您实际找到的品牌分类法名称 $brand_taxonomy = 'ourbrandname'; $brands = wp_get_post_terms( $product_id, $brand_taxonomy, ['fields' => 'names'] ); if ( ! is_wp_error( $brands ) && ! empty( $brands ) ) { echo ''; echo '品牌: ' . implode(', ', $brands); echo '
'; }}
错误处理：始终使用 is_wp_error() 检查 wp_get_post_terms 的返回值，以避免在分类法不存在时抛出 PHP 错误。
性能考量：对于大型网站，频繁调用 wp_get_post_terms 可能会有轻微的性能影响。如果品牌信息不经常变化，可以考虑对结果进行缓存。
样式定制：为品牌信息添加一个特定的 CSS 类（如 product-brand-name），方便您通过 CSS 文件对其进行样式定制，使其与您的网站设计保持一致。
总结
在 WooCommerce 购物车页面显示产品品牌是一个实用的功能，但正确识别品牌分类法名称是实现这一功能的先决条件。通过检查 WordPress 后台 URL 或审查插件/主题代码，您可以轻松找到正确的分类法名称，并将其集成到您的购物车模板中。遵循最佳实践，使用钩子而非直接修改核心文件，将确保您的改动在网站更新时保持稳定和兼容性。
