woocommerce_before_shop_loop
WooCommerce voert de action woocommerce_before_shop_loop uit vóór het productraster in een klassiek winkel- of productcategorieoverzicht. De action heeft geen argumenten en wordt alleen uitgevoerd wanneer het archief een productlus bevat. De standaardcallbacks tonen WooCommerce-meldingen met prioriteit 10, het aantal resultaten met 20 en de sorteeropties met 30.
| Type | Actionhook |
|---|---|
| Locatie | Klassieke winkel- en productoverzichten, vóór de productlus |
| Argumenten | Geen |
| Bron | WooCommerce-archiefsjabloon |
Een melding boven het productraster plaatsen
add_action( 'woocommerce_before_shop_loop', function () {
if ( ! is_shop() ) {
return;
}
echo '<p class="shop-note">' .
esc_html( 'Browse our latest products below.' ) .
'</p>';
}, 25 );
Hiermee verschijnt de melding na het aantal resultaten en vóór de sorteeropties op de hoofdwinkelpagina. De controle met is_shop() sluit productcategorieën uit. Laat die controle weg als de melding ook in andere geschikte archieven moet verschijnen. Plaats de callback in een sitespecifieke plug-in of een child-thema en controleer de ruimte rond de sorteeropties op grote en kleine schermen.
Bij een leeg winkeloverzicht wordt deze action in het klassieke sjabloon niet uitgevoerd. Gebruik voor een melding bij lege resultaten de hook woocommerce_no_products_found. Thema's en plug-ins kunnen ook de standaardcallbacks verplaatsen of verwijderen, waardoor de zichtbare positie van prioriteit 25 verandert.
Compatibiliteit met blokarchieven
WooCommerce heeft een compatibiliteitslaag voor archiefsjablonen die klassieke hooks in sommige productoverzichten met blokken kan uitvoeren. De positie en omliggende bedieningselementen kunnen verschillen van het PHP-sjabloon. Controleer daarom het weergegeven archief. De WooCommerce-compatibiliteitscode geeft meer details.