WooCommerce Hook: woocommerce_cart_item_name

In WooCommerce, there are a variety of hooks that allow developers to customize the behavior of WooCommerce without modifying the core code. One of the most useful hooks is the woocommerce_cart_item_name, which is used to change or customize the name of a product in the cart.

In this blog post, I will show you how to use the WooCommerce hook woocommerce_cart_item_name and provide you with some practical PHP examples.

What is the woocommerce_cart_item_name hook?

The woocommerce_cart_item_name hook allows you to change the name of a product in the cart view. This can be useful if you want to add additional information such as product variants, custom fields, or even HTML elements to enhance the display for the user.

Hook Syntax

The basic syntax of the hook looks like this:

add_filter( 'woocommerce_cart_item_name', 'my_function_name_adjust', 10, 3 );

function my_function_name_adjust( $product_name, $cart_item, $cart_item_key ) {
    // Here you can adjust the product name.
    return $product_name;
}

Parameters:

1. $product_name (string): The current product name.
2. $cart_item (array): Information about the product in the cart, e.g., quantity, ID, etc.
3. $cart_item_key (string): A unique key for the product in the cart.

Example 1: Extend product name with additional text

In the first example, we extend the product name with custom text. This is useful if you want to add a note like "Special Offer" to the product name.

add_filter( 'woocommerce_cart_item_name', 'add_special_offer_text', 10, 3 );

function add_special_offer_text( $product_name, $cart_item, $cart_item_key ) {
    $new_name = $product_name . ' - Special Offer!';
    return $new_name;
}

In this example, the text "Special Offer!" is added to each product name in the cart, formatted with red text. This draws more attention to special products.

Example 2: Adjust product name based on category

In the next example, I adjust the product name based on the product's category. Suppose you want to change the name only for products in the "Sale" category.

add_filter( 'woocommerce_cart_item_name', 'adjust_product_name_by_category', 10, 3 );

function adjust_product_name_by_category( $product_name, $cart_item, $cart_item_key ) {
    $product_id = $cart_item['product_id'];
    $categories = wp_get_post_terms( $product_id, 'product_cat' );

    foreach ( $categories as $category ) {
        if ( $category->slug == 'sale' ) {
            $product_name .= ' - On Sale!';
        }
    }

    return $product_name;
}

In this example, the product name is adjusted only for products in the "Sale" category. If the product is in this category, a note "On Sale!" is added.

Example 3: Add custom fields to product name

Another useful example is adding custom fields to the product name. Suppose you have a custom field called "Product Code" that you want to display in the cart.

add_filter( 'woocommerce_cart_item_name', 'add_custom_fields', 10, 3 );

function add_custom_fields( $product_name, $cart_item, $cart_item_key ) {
    $product_id = $cart_item['product_id'];
    $product_code = get_post_meta( $product_id, '_product_code', true );

    if ( ! empty( $product_code ) ) {
        $product_name .= '
Product Code: ' . esc_html( $product_code ) . '';
    }

    return $product_name;
}

Here, the custom field "_product_code" is retrieved and added to the product name if it has a value. This can be useful for specialized shops where additional information about the product should be visible directly in the cart.

Conclusion

The woocommerce_cart_item_name hook is extremely flexible and can be used to enhance the user experience in the cart. With the PHP examples shown, you can adjust the product name, add additional information, or even change the display style.

Use this hook to further customize your WooCommerce store and provide your customers with a personalized shopping experience.

Good luck implementing it!