woocommerce_order_status_changed
WooCommerce voert woocommerce_order_status_changed uit wanneer een bestaande bestelling van status verandert. De action geeft de bestel-ID, beide statusslugs en het bestelobject door. Registreer vier geaccepteerde argumenten als je callback ze allemaal nodig heeft:
$order_id | Bestel-ID (integer) |
|---|---|
$old_status | Vorige status (string) |
$new_status | Nieuwe status (string) |
$order | WC_Order-object |
| Bron | WooCommerce-verwerking van bestelstatussen |
Een overgang naar voltooid vastleggen
add_action( 'woocommerce_order_status_changed', function ( $order_id, $old_status, $new_status, $order ) {
if ( 'completed' === $new_status ) {
$order->add_order_note( 'Order reached completed status.' );
}
}, 10, 4 );
Dit voegt een privébestelnotitie toe wanneer de bestelling de status completed krijgt. De argumenten bevatten slugs zoals processing en completed, zonder het voorvoegsel wc-. Verlaat een bestelling die status en krijgt ze die later opnieuw, dan wordt nog een notitie toegevoegd. Controleer statusovergangen op een testwinkel voordat je andere handelingen dan notities toevoegt.
Kies een geschikte gebeurtenis
Dit is geen algemene hook voor het aanmaken van bestellingen. WooCommerce voert hem alleen uit als er een vorige status bestaat. De wijziging kan afkomstig zijn van een beheerder of code, zonder dat een klant de afrekenpagina bekijkt. De status completed bewijst bovendien niet op zichzelf dat een bepaalde betaling is geïnd. Externe meldingen en fulfilmenttaken vereisen bescherming tegen dubbele verwerking en een gebeurtenis die bij het doel past.
Gebruik voor bestelmetadata $order->get_meta() en $order->update_meta_data(), en sla de bestelling zo nodig op. Schrijf niet rechtstreeks naar WordPress-postmeta. De bestel-API's van WooCommerce ondersteunen High-Performance Order Storage (HPOS).