WooCommerce: adăugarea textului de gravat în pagina produsului

Pașii, pe rând

1. 1Hotărăște regulile textuluiLungime maximă, caractere permise (litere, cifre, diacritice), obligatoriu sau opțional și dacă se plătește separat. Regulile trebuie să corespundă cu ce poate grava atelierul.
2. 2Varianta cu extensieInstalezi Product Add-Ons. Pe produs: Product data → Add-ons → Add field → Short Text (sau Long Text). Bifezi „Require input” și „Limit character length”. Pentru mai multe produse, creezi un grup global din Products → Add-Ons.
3. 3Alege restricția câmpuluiLa Short Text poți restricționa la „Only Letters”, „Only Numbers”, „Only Letters and numbers” sau „Only Email Address”. Pentru nume cu spații și diacritice, lasă „Any text” și limitează lungimea.
4. 4Varianta cu codFolosești patru cârlige: afișarea câmpului (woocommerce_before_add_to_cart_button), validarea (woocommerce_add_to_cart_validation), datele din coș (woocommerce_add_cart_item_data) și linia comenzii (woocommerce_checkout_create_order_line_item). Fragmentul de mai jos le leagă.
5. 5Afișează textul în coșTextul trebuie să apară și în coș și la finalizare, ca clientul să-l poată verifica înainte de plată. Cu extensia se întâmplă automat.
6. 6Verifică comanda și emailurileDeschide o comandă de test în administrare: textul trebuie să apară sub linia produsului, iar emailurile de confirmare să îl listeze.
7. 7Testează cazurile limităText gol la un câmp obligatoriu, text prea lung, caractere speciale, același produs adăugat de două ori cu texte diferite (trebuie să rămână două linii separate).

// 1) câmpul pe pagina produsului
add_action('woocommerce_before_add_to_cart_button', function () {
    echo '<p><label>Text de gravat<br><input type="text" name="text_gravat" maxlength="20" required></label></p>';
});

// 2) validare la adăugarea în coș
add_filter('woocommerce_add_to_cart_validation', function ($ok, $product_id) {
    $t = isset($_POST['text_gravat']) ? trim(wp_unslash($_POST['text_gravat'])) : '';
    if ($t === '' || mb_strlen($t) > 20) {
        wc_add_notice('Introdu un text de gravat de maximum 20 de caractere.', 'error');
        return false;
    }
    return $ok;
}, 10, 2);

// 3) păstrează textul în articolul din coș (linii separate pentru texte diferite)
add_filter('woocommerce_add_cart_item_data', function ($data) {
    if (!empty($_POST['text_gravat'])) {
        $data['text_gravat'] = sanitize_text_field(wp_unslash($_POST['text_gravat']));
    }
    return $data;
});

// 4) copiază textul în linia comenzii
add_action('woocommerce_checkout_create_order_line_item', function ($item, $key, $values) {
    if (!empty($values['text_gravat'])) {
        $item->add_meta_data('Text de gravat', $values['text_gravat']);
    }
}, 10, 3);

Cârligele woocommerce_add_cart_item_data și woocommerce_checkout_create_order_line_item sunt verificate în codul sursă WooCommerce. Câmpurile de pe pagina produsului nu apar în coșul cu blocuri fără integrare dedicată, deci testează pe tema ta.