woocommerce_get_price_html

Het filter woocommerce_get_price_html past de opgemaakte HTML van een zichtbare productprijs aan. Het ontvangt de bestaande prijsopmaak en het productobject. De callback moet een HTML-string teruggeven. Dit filter verandert alleen de weergave, niet de prijs waarmee WooCommerce winkelwagentotalen of betalingen berekent.

TypeFilterhook
Argumenten$price (HTML-string), $product (WC_Product)
RetourwaardeHTML-string voor de zichtbare prijs
BronWooCommerce-methode voor productprijzen

Een eenheidslabel toevoegen

add_filter( 'woocommerce_get_price_html', function ( $price, $product ) {
    if ( $product->is_type( 'simple' ) && '' !== $price ) {
        $price .= ' <small class="unit-note">' .
            esc_html( 'per item' ) . '</small>';
    }

    return $price;
}, 10, 2 );

Dit voegt “per item” alleen toe aan een niet-lege prijsweergave voor eenvoudige producten. De bestaande HTML, inclusief eventuele aanbiedingsopmaak, blijft behouden. Variabele en andere producttypen veranderen niet. Plaats de code in een sitespecifieke plug-in of in functions.php van een child-thema en controleer zowel productkaarten als afzonderlijke productpagina's.

Prijsweergave en beperkingen

WooCommerce bouwt de prijs-HTML op voordat het filter wordt toegepast. $price kan daarom al een valutateken, aanbiedingsopmaak of prijsbereik bevatten. Het filter kan worden uitgevoerd telkens wanneer code get_price_html() van een product aanroept, niet alleen op productpagina's. Gebruik het niet om opgeslagen prijzen, belastingen of afrekentotalen te wijzigen, en escape dynamische tekst die je aan de HTML toevoegt.

Klassieke sjablonen gebruiken de gefilterde prijs-HTML. Ook het Product Price-blok van WooCommerce roept get_price_html() aan tijdens het renderen, maar interactieve blokupdates kunnen prijzen afzonderlijk vernieuwen. Controleer het label in de gebruikte indeling in plaats van aan te nemen dat elke prijsweergave dit filter gebruikt.