woocommerce_thankyou

Met de action woocommerce_thankyou kun je inhoud op een WooCommerce-orderbevestiging tonen. De action ontvangt één argument, $order_id (integer), en geeft geen waarde terug. Het klassieke sjabloon checkout/thankyou.php voert de action uit zodra er een bestelling beschikbaar is, ook op het scherm voor een mislukte bestelling.

Een bericht bij een geldige bestelling tonen

add_action( 'woocommerce_thankyou', function ( $order_id ) {
    $order = wc_get_order( $order_id );

    if ( ! $order || $order->has_status( 'failed' ) ) {
        return;
    }

    echo '<p class="order-note">' .
        esc_html( 'Please save your order number for your records.' ) .
        '</p>';
}, 20 );

De callback haalt de bestelling op en slaat het bericht over als deze ontbreekt of de status failed heeft. Plaats de code in een sitespecifieke plug-in of functions.php van een child-thema en controleer geslaagde en mislukte betalingen op een testsite.

Dit is een hook voor de paginawaargave, geen bewijs van een nieuwe betaling of een eenmalige aankoopgebeurtenis. Het verversen of opnieuw bezoeken van een bevestigingspagina kan de callback opnieuw uitvoeren. Gebruik de hook niet rechtstreeks voor eenmalige e-mails, voorraadvermindering of het markeren van betaalde bestellingen. Zulke handelingen horen bij passende gebeurtenissen in het bestelproces, met bescherming tegen dubbele verwerking. De action woocommerce_order_status_changed beschrijft statusovergangen; de juiste keuze hangt af van de gewenste gebeurtenis.

Ook het Order Confirmation Additional Information-blok van WooCommerce roept de action aan als de bezoeker de bestelling mag bekijken. De standaardinhoud wordt daar afzonderlijk verwerkt, waardoor de positie van het bericht kan afwijken van het klassieke sjabloon.