WooCommerce 11.2 ergänzt Mengenprüfung für den Block-Warenkorb
Ein neuer Filter in WooCommerce 11.2 ermöglicht eigene Mengenprüfungen im Block-Warenkorb; bestehende Anpassungen müssen dafür ergänzt werden.
Mit WooCommerce 11.2 erhält die Store API einen zusätzlichen Filter, mit dem Erweiterungen Änderungen an Artikelmengen im Warenkorb ablehnen können. Die Store API ist die Schnittstelle, die unter anderem die Warenkorb- und Kassenblöcke nutzen. Für den klassischen Warenkorb auf Shortcode-Basis gab es bereits eine entsprechende Prüfmöglichkeit.
Betroffen sind Shops mit eigenen Mengenregeln, die bislang über woocommerce_update_cart_validation umgesetzt werden. Dieser bestehende Filter erfasst weiterhin nur den Shortcode-Warenkorb. Damit dieselben Regeln auch im Block-Warenkorb und bei anderen Anwendungen der Store API greifen, muss die zuständige Erweiterung oder individuelle Anpassung ergänzt werden. Ohne eine solche Ergänzung verändert der neue Filter das Verhalten nicht.
Welche Anpassung erforderlich ist
Der neue Filter heißt woocommerce_store_api_cart_item_quantity_validation. Er wird ausgeführt, wenn Kunden eine Artikelmenge ändern oder ein bereits im Warenkorb liegendes Produkt erneut hinzufügen. Beim erstmaligen Hinzufügen greift er nicht; dafür steht die separate Aktion woocommerce_store_api_validate_add_to_cart zur Verfügung.
Zum Ablehnen einer Menge muss die Prüffunktion ein WP_Error-Fehlerobjekt zurückgeben. Dessen Meldung wird im Block-Warenkorb angezeigt. Ein einfaches false verhindert die Mengenänderung dagegen nicht. Auch Hinweise über wc_add_notice() werden nicht ausgewertet. Bestehender Prüfcode lässt sich deshalb nicht unverändert übernehmen.
Die neue Prüfung folgt auf die eingebauten Kontrollen für Mindestmengen, Höchstmengen und Mengenschritte. Diese Grenzen kann sie nicht lockern. Der bisherige Filter bleibt für den Shortcode-Warenkorb erforderlich.
Was das für Ihren Shop bedeutet
Wenn Sie etwa im B2B-Shop eigene Regeln zur Ablehnung von Mengenänderungen einsetzen, sollten Sie prüfen lassen, ob diese nur den klassischen Warenkorb abdecken. Nutzen Sie Warenkorbblöcke oder eine andere Anbindung über die Store API, lassen Sie die betreffende Erweiterung um den neuen Filter ergänzen. Behalten Sie die bisherige Prüfung bei, wenn Sie auch den Shortcode-Warenkorb verwenden. Testen Sie anschließend im Block-Warenkorb eine Mengenänderung, die Ihre Regel verletzt, und kontrollieren Sie die angezeigte Fehlermeldung.