WooCommerce显示产品品牌方法教程

本教程详细指导您如何在WooCommerce购物车页面准确显示产品品牌名称，解决常见的`invalid_taxonomy`错误。核心在于**识别正确的品牌分类(taxonomy)名称**，这是通过插件或主题实现的，比如Perfect WooCommerce Brands或YITH WooCommerce Brands Add-on。文章提供了两种有效方法查找taxonomy名称：**通过WordPress后台URL直接查找**，或**查阅插件/主题官方文档**。找到正确的分类名称后，教程将指导您如何通过修改子主题的`cart.php`模板文件，或者**更推荐使用WooCommerce钩子(Action Hooks)**，将品牌信息集成到购物车中。遵循最佳实践，例如使用钩子和进行错误处理，能确保您的定制化功能稳定、可维护且兼容性良好，最终提升用户购物体验。

在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查找（推荐）

这是最直接且通常最有效的方法：

1. 登录您的WordPress后台。

2. 导航到“产品”菜单下的“品牌”或类似的品牌管理页面。通常，这会是您管理产品品牌的地方。

3. 观察浏览器地址栏中的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 ) . '&nbsp;' );
        } 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>

注意事项与最佳实践

1. 使用钩子（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>';
       }
   }

2. 错误处理： 始终检查wp_get_post_terms()的返回值。如果返回WP_Error对象，说明分类名称不正确或存在其他问题。在上面的代码中，我们使用了! is_wp_error( $brands )来确保只有在成功获取品牌信息时才尝试显示。

3. 多品牌处理：wp_get_post_terms()会返回一个数组，即使只有一个品牌。使用implode(', ', $brands)可以优雅地处理产品关联多个品牌的情况，用逗号分隔显示。

4. 样式定制： 我们为品牌信息添加了一个CSS类product-brand。您可以在主题的样式表（style.css）中添加CSS规则，以自定义品牌名称的显示样式，例如字体大小、颜色或位置。

总结

在WooCommerce购物车页面显示产品品牌名称是一个常见的需求，其核心在于正确识别您的品牌插件或主题所使用的自定义分类（taxonomy）名称。通过检查WordPress后台URL或查阅文档，您可以轻松找到这个名称。随后，无论是直接修改子主题的cart.php模板文件，还是更推荐地使用WooCommerce钩子，您都可以将品牌信息集成到购物车中。遵循最佳实践，如使用钩子和进行错误处理，将确保您的定制化功能稳定、可维护且兼容性良好。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~