WooCommerce Hook: woocommerce_cart_collaterals

Woo­Com­mer­ce bie­tet eine Viel­zahl von Hooks und Fil­tern, um die Funk­tio­na­li­tät eines Online-Shops zu erwei­tern. Einer die­ser Hooks ist der woocommerce_cart_collaterals. Die­ser Hook ist nütz­lich, wenn du zusätz­li­che Inhal­te oder Funk­tio­nen in der Nähe der soge­nann­ten “Cart Col­la­te­rals” ein­fü­gen möch­test, die typi­scher­wei­se Din­ge wie den “Zwischensumme”-Abschnitt, Gut­schein­feld oder Ver­sand­in­for­ma­tio­nen ent­hal­ten.

In die­sem Blog-Bei­­trag wer­den wir uns anschau­en, wie die­ser Hook funk­tio­niert, und eini­ge prak­ti­sche PHP-Bei­­spie­­le durch­ge­hen, die zei­gen, wie man ihn ver­wen­den kann.

Was ist der woocommerce_cart_collaterals Hook? #

Der Hook woocommerce_cart_collaterals wird im Stan­­dard-Woo­­Com­­mer­ce-Tem­p­la­­te cart/cart.php auf­ge­ru­fen. Er wird ver­wen­det, um Inhal­te inner­halb des Kol­la­te­r­al­be­reichs des Waren­korbs ein­zu­fü­gen, der nor­ma­ler­wei­se den Gesamt­sum­men­be­reich und Ver­sand­op­tio­nen ent­hält.

Position des Hooks im Template:

/**
 * Cart collaterals hook.
 *
 * @hooked woocommerce_cross_sell_display
 * @hooked woocommerce_cart_totals - 10
 */
do_action( 'woocommerce_cart_collaterals' );

Einsatzmöglichkeiten #

Mit die­sem Hook kannst du:

• Benut­zer­de­fi­nier­te Hin­wei­se oder Infor­ma­tio­nen hin­zu­fü­gen.
• Wer­be­ban­ner oder Pro­mo­ti­ons anzei­gen.
• Wei­­ter­­ver­­­kauf- oder Cross-Sel­­ling-Stra­­te­­gien imple­men­tie­ren.
• Zusätz­li­che Waren­­­korb-Emp­­feh­­lun­­gen anzei­gen.

Beispiel 1: Benutzerdefinierte Nachricht in den Collaterals einfügen

Stel­len wir uns vor, du möch­test eine benut­zer­de­fi­nier­te Nach­richt hin­zu­fü­gen, um den Kun­den auf beson­de­re Aktio­nen auf­merk­sam zu machen. Dies kannst du mit fol­gen­dem Code errei­chen

add_action( 'woocommerce_cart_collaterals', 'custom_cart_collaterals_message' );

function custom_cart_collaterals_message() {
    echo '<div class="custom-cart-message">';
    echo '<p><strong>Jetzt kaufen und 10% Rabatt auf die nächste Bestellung erhalten!</strong></p>';
    echo '</div>';
}

Die­ser Code fügt eine ein­fa­che benut­zer­de­fi­nier­te Nach­richt in den Kol­la­te­r­al­be­reich des Waren­korbs ein.

Erklärung:

Der Hook woocommerce_cart_collaterals wird ver­wen­det, um die benut­zer­de­fi­nier­te Funk­ti­on custom_cart_collaterals_message hin­zu­zu­fü­gen. Inner­halb der Funk­ti­on wird eine HTML-Struk­­tur aus­ge­ge­ben, die die Nach­richt ent­hält.

Beispiel 2: Cross-Selling Produkte anzeigen

Woo­Com­mer­ce hat eine ein­ge­bau­te Funk­ti­on, um Cross-Sel­­ling-Pro­­duk­­te im Waren­korb anzu­zei­gen. Du kannst die Anzei­ge der Cross-Sel­­ling-Pro­­duk­­te anpas­sen oder ergän­zen, indem du den woocommerce_cart_collaterals Hook nutzt.

remove_action( 'woocommerce_cart_collaterals', 'woocommerce_cross_sell_display' ); // Entfernt die standardmäßige Anzeige

add_action( 'woocommerce_cart_collaterals', 'custom_cross_sell_display' );

function custom_cross_sell_display() {
    // Zeige maximal 4 Cross-Sell-Produkte an, 2 pro Reihe
    woocommerce_cross_sell_display( 4, 2 );
}

Erklärung

Zuerst wird die stan­dard­mä­ßi­ge Cross-Sell-Anzei­­ge mit remove_action ent­fernt. Dann wird die benut­zer­de­fi­nier­te Funk­ti­on custom_cross_sell_display hin­zu­ge­fügt, um bis zu 4 Cross-Sel­­ling-Pro­­duk­­te in zwei Rei­hen anzu­zei­gen.

Beispiel 3: Werbebanner für eine Sonderaktion hinzufügen

Falls du eine Son­der­ak­ti­on oder einen Rabatt­code im Waren­korb bewer­ben möch­test, kannst du mit dem Hook ein Ban­ner ein­fü­gen.

add_action( 'woocommerce_cart_collaterals', 'custom_promo_banner' );

function custom_promo_banner() {
    echo '<div class="promo-banner">';
    echo '<img src="https://yourwebsite.com/promo-banner.jpg" alt="Sonderaktion" />';
    echo '<p>Verwenden Sie den Code <strong>SALE20</strong> und sparen Sie 20%!</p>';
    echo '</div>';
}

Erklärung:

Die Funk­ti­on custom_promo_banner fügt ein Bild sowie einen Hin­weis auf eine Son­der­ak­ti­on mit einem Rabatt­code in den Kol­la­te­r­al­be­reich ein. Dies kann nütz­lich sein, um die Auf­merk­sam­keit auf aktu­el­le Aktio­nen zu len­ken.

Fazit #

Der woocommerce_cart_collaterals Hook bie­tet eine fle­xi­ble Mög­lich­keit, zusätz­li­che Inhal­te oder Funk­tio­nen in den Waren­korb­be­reich dei­nes Woo­­Com­­mer­ce-Shops zu inte­grie­ren. Ob du Infor­ma­tio­nen hin­zu­fü­gen, Cross-Sel­­ling-Pro­­duk­­te anzei­gen oder Aktio­nen bewer­ben möch­test – die­ser Hook hilft dir, den Check­out-Pro­­zess wei­ter zu per­so­na­li­sie­ren und zu opti­mie­ren.

Durch die ein­fa­che Hand­ha­bung mit PHP kön­nen die­se Anpas­sun­gen schnell und effi­zi­ent umge­setzt wer­den, um das Ein­kaufs­er­leb­nis für dei­ne Kun­den zu ver­bes­sern.