WooCommerce Hook: woocommerce_cart_item_name

In WooCommerce gibt es eine Vielzahl von Hooks, die Entwicklern ermöglichen, das Verhalten von WooCommerce ohne Änderungen am Core-Code anzupassen. Einer der nützlichsten Hooks ist der woocommerce_cart_item_name, der verwendet wird, um den Namen eines Produkts im Warenkorb zu ändern oder anzupassen.

In diesem Blogbeitrag zeige ich dir, wie du den WooCommerce Hook woocommerce_cart_item_name verwendest und gebe dir einige praktische PHP-Beispiele.

Was ist der woocommerce_cart_item_name Hook? #

Der woocommerce_cart_item_name Hook erlaubt es dir, den Namen eines Produkts in der Warenkorbansicht zu verändern. Dies kann nützlich sein, wenn du zusätzliche Informationen wie Produktvarianten, benutzerdefinierte Felder oder sogar HTML-Elemente hinzufügen möchtest, um die Anzeige für den Nutzer zu verbessern.

Hook-Syntax #

Die Basis-Syntax des Hooks sieht wie folgt aus:

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

function meine_funktion_name_anpassen( $produkt_name, $warenkorb_item, $warenkorb_item_key ) {
    // Hier kannst du den Produktnamen anpassen.
    return $produkt_name;
}

Parameter: #

1. $produkt_name (string): Der aktuelle Produktname.
2. $warenkorb_item (array): Informationen über das Produkt im Warenkorb, z. B. Menge, ID, etc.
3. $warenkorb_item_key (string): Ein eindeutiger Schlüssel für das Produkt im Warenkorb.

Beispiel 1: Produktnamen mit zusätzlichem Text erweitern #

Im ersten Beispiel erweitern wir den Produktnamen um einen benutzerdefinierten Text. Dies ist nützlich, wenn du z. B. dem Produktnamen einen Hinweis wie „Sonderangebot“ hinzufügen möchtest.

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

function sonderangebot_text_hinzufuegen( $produkt_name, $warenkorb_item, $warenkorb_item_key ) {
    $neuer_name = $produkt_name . ' - <span style="color: red;">Sonderangebot!</span>';
    return $neuer_name;
}

In diesem Beispiel wird jedem Produktnamen im Warenkorb der Text „Sonderangebot!“ hinzugefügt, formatiert mit einem roten Text. Dies sorgt für mehr Aufmerksamkeit auf spezielle Produkte.

Beispiel 2: Produktname basierend auf Kategorie anpassen #

Im nächsten Beispiel passe ich den Produktnamen basierend auf der Kategorie des Produkts an. Angenommen, du möchtest den Namen nur für Produkte in der Kategorie „Sale“ ändern.

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

function produkt_name_nach_kategorie_anpassen( $produkt_name, $warenkorb_item, $warenkorb_item_key ) {
    $produkt_id = $warenkorb_item['product_id'];
    $kategorien = wp_get_post_terms( $produkt_id, 'product_cat' );

    foreach ( $kategorien as $kategorie ) {
        if ( $kategorie->slug == 'sale' ) {
            $produkt_name .= ' - <span class="sale-hinweis">Im Sale!</span>';
        }
    }

    return $produkt_name;
}

In diesem Beispiel wird der Produktname nur für Produkte in der Kategorie „Sale“ angepasst. Falls das Produkt in dieser Kategorie ist, wird ein Hinweis „Im Sale!“ hinzugefügt.

Beispiel 3: Benutzerdefinierte Felder zum Produktnamen hinzufügen #

Ein weiteres nützliches Beispiel ist das Hinzufügen von benutzerdefinierten Feldern zum Produktnamen. Angenommen, du hast ein benutzerdefiniertes Feld namens „Produkt-Code“, das du im Warenkorb anzeigen möchtest.

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

function benutzerdefinierte_felder_hinzufuegen( $produkt_name, $warenkorb_item, $warenkorb_item_key ) {
    $produkt_id = $warenkorb_item['product_id'];
    $produkt_code = get_post_meta( $produkt_id, '_produkt_code', true );

    if ( ! empty( $produkt_code ) ) {
        $produkt_name .= '<br><small>Produkt-Code: ' . esc_html( $produkt_code ) . '</small>';
    }

    return $produkt_name;
}

Hier wird das benutzerdefinierte Feld „_produkt_code“ abgerufen und zum Produktnamen hinzugefügt, falls es einen Wert enthält. Dies kann für spezialisierte Shops nützlich sein, in denen zusätzliche Informationen zum Produkt direkt im Warenkorb sichtbar sein sollen.

Fazit #

Der woocommerce_cart_item_name Hook ist äußerst flexibel und kann verwendet werden, um die Benutzererfahrung im Warenkorb zu verbessern. Mit den gezeigten PHP-Beispielen kannst du den Produktnamen anpassen, zusätzliche Informationen hinzufügen oder sogar den Stil der Anzeige verändern.

Nutze diesen Hook, um deinen WooCommerce-Shop weiter anzupassen und deinen Kunden eine personalisierte Shopping-Erfahrung zu bieten.

Viel Erfolg beim Umsetzen!