Salva i campi di checkout personalizzati utilizzando woocommerce_checkout_update_order_meta

Pubblicato: 2025-07-01

Personalizzare il tuo checkout WooCommerce è un'esigenza comune, soprattutto quando si desidera raccogliere dettagli extra dai tuoi clienti. Che si tratti di una nota speciale o di un input personalizzato come un'istruzione di consegna, WooCommerce consente di salvare questi campi nell'ordine. In questa guida, imparerai come aggiungere due nuovi campi e archiviare i loro valori usando l'azione woocommerce_checkout_update_order_meta . Inoltre, mostreremo come un plug -in come Flexible Checkout Fields Pro può rendere tutto più semplice.

Camminiamo passo dopo passo come conservare la meta ordini personalizzati in WooCommerce.

Che cos'è la personalizzazione del checkout in WooCommerce e come vengono elaborati i dati dell'ordine?

Il processo di checkout WooCommerce prevede diversi passaggi chiave. Quando un cliente compila il modulo e colpisce "Place Order", WooCommerce convalida i dati, memorizza le informazioni di fatturazione/spedizione e innesca i ganci che gli sviluppatori possono utilizzare per archiviare dati aggiuntivi.

Per impostazione predefinita, vengono salvati solo campi standard come nome, e -mail e indirizzo.

Ma puoi estenderlo utilizzando il filtro woocommerce_checkout_fields per aggiungere campi personalizzati al modulo.

Quindi, con l'azione woocommerce_checkout_update_order_meta , è possibile salvare i loro valori come meta .

Ciò è particolarmente utile quando si desidera includere cose come messaggi regalo, preferenze di consegna o istruzioni personalizzate.

Puoi anche visualizzare questi dati più avanti nel pannello di amministrazione, e-mail o pagine di ringraziamento.

Come aggiungere e salvare i campi personalizzati utilizzando il codice in WooCommerce?

Supponiamo che tu voglia raccogliere due informazioni aggiuntive:

  • Un input di testo personalizzato ("testo personalizzato")
  • Un messaggio textrea ("messaggio personalizzato")

Ecco come farlo.

Il codice seguente con woocommerce_checkout_fields e woocommerce_checkout_update_order_meta le azioni devono essere aggiunte alle funzioni del tema.php per mostrare nuovi campi di checkout e salvare i dati come meta.

1. Aggiungi i campi personalizzati al modulo di pagamento

 add_filter('woocommerce_checkout_fields', 'add_custom_checkout_fields'); function add_custom_checkout_fields($fields) { $fields['billing']['custom_text_field'] = array( 'type' => 'text', 'label' => __('Custom Text', 'woocommerce'), 'required' => false, 'priority' => 110, ); $fields['billing']['custom_message_field'] = array( 'type' => 'textarea', 'label' => __('Custom Message', 'woocommerce'), 'required' => false, 'priority' => 120, ); return $fields; }
Aggiunta di campi personalizzati all'esempio del modulo di pagamento di WooCommerce
Aggiunta di campi personalizzati all'esempio del modulo di pagamento di WooCommerce

2. Salva i valori del campo sul meta dell'ordine

 add_action('woocommerce_checkout_update_order_meta', 'save_custom_checkout_fields'); function save_custom_checkout_fields($order_id) { if (!empty($_POST['custom_text_field'])) { update_post_meta($order_id, '_custom_text_field', sanitize_text_field($_POST['custom_text_field'])); } if (!empty($_POST['custom_message_field'])) { update_post_meta($order_id, '_custom_message_field', sanitize_textarea_field($_POST['custom_message_field'])); } }

Ora, entrambi i campi appariranno nel pannello di amministrazione sotto i campi personalizzati dell'ordine.

Esempio di testo personalizzato e textArea nei dettagli dell'ordine
Esempio di testo personalizzato e textArea nei dettagli dell'ordine
È inoltre possibile personalizzare il codice per convalidare i dati o consentire la sua modifica con woocommerce_wp_text_input e woocommerce_wp_textarea_input Funzioni nei dettagli dell'ordine all'interno del div con class = "edit_address" in modo che sia nascosto prima della modifica.

Questo approccio funziona bene, ma richiede alcune conoscenze di codifica.

Ha anche limitazioni quando si tratta di convalida, tipi di campo o visualizzare i dati condizionalmente.

È qui che entra in gioco campi di checkout flessibili.

Perché utilizzare Flexible Checkout Fields Pro invece di scrivere codice personalizzato?

Durante la codifica dei tuoi campi e lo salvando con l'azione woocommerce_checkout_update_order_meta ti dà il pieno controllo, non è sempre la soluzione più efficiente o sicura, specialmente per i non sviluppatori.

Ecco dove il plug -in Flexible Checkout Fields diventa un'opzione più semplice e più veloce.

Aggiunta di campi personalizzati al modulo di checkout di WooCommerce con campi di pagamento flessibile pro.
Aggiunta di campi personalizzati al modulo di checkout di WooCommerce con campi di pagamento flessibile pro.
C'è una versione gratuita disponibile su WordPress.org: campi di checkout flessibili - GRATUITA, che è perfetto per la gestione del campo di base. Tuttavia, la versione Pro ti offre molta più flessibilità.
Visualizza campi su pagine specifiche - Impostazioni del plug -in in campi di checkout flessibili WooCommerce
Visualizza campi su pagine specifiche - Impostazioni del plug -in in campi di checkout flessibili WooCommerce

Ecco 5 funzionalità straordinarie che rendono i campi di pagamento flessibili pro per l'utilizzo:

  • Drag & Drop Field Manager - Non è necessario scrivere funzioni PHP. Basta trascinare e riordinare i campi direttamente nell'amministratore di WordPress.
  • Varietà dei tipi di campo : Aggiungi testo, TextArea, Select, Radio, Casella di controllo, Date Picker, Time e altro.
  • Visualizza regole : mostra o nascondi i campi in base al metodo di spedizione/pagamento selezionato o alle condizioni del carrello.
    Condizioni per campi di modulo personalizzati in campi di checkout flessibili pro wooCommerce
    Condizioni per campi di modulo personalizzati in campi di checkout flessibili pro wooCommerce
  • Convalida predefinita : impostare facilmente i campi richiesti e utilizzare opzioni di convalida integrate senza funzioni personalizzate.
  • Prezzi - Prezzo aggiuntivo per campi di pagamento.
    Prezzi aggiuntivi per forma di campo Esempio in campi di checkout flessibili pro wooCommerce
    Prezzi aggiuntivi per forma di campo Esempio in campi di checkout flessibili pro wooCommerce

Invece di registrare manualmente i campi e salvare Meta Data con woocommerce_checkout_update_order_meta , si ottiene un'interfaccia completa.

Inoltre, tutti i valori di campo salvati appaiono in modo ordinato nel riepilogo dell'ordine e nelle e -mail.

Se stai cercando una soluzione scalabile a lungo termine per gestire i campi di checkout personalizzati e salvare i dati per ordinare la meta , questo plugin risparmia ore di codifica e manutenzione.

Flexible Checkout Fields Pro WooCommerce £ 59

Modifica, aggiungi nuovi campi o nascondi campi non necessari dal modulo di checkout WooCommerce. Aggiungi i prezzi ai campi e usa la logica condizionale. Si tratta di conversioni e una migliore esperienza dell'utente. NUOVO: Ora puoi impostare più condizioni (o) in uno o più gruppi di condizioni (e).

Installazioni attive: 90.000+ | Valutazione WordPress:

Aggiungi al carrello o visualizzare i dettagli
Oltre 90.000 installazioni attive
Ultimo aggiornamento: 2025-06-23
Lavora con WooCommerce 9.6 - 9.9

woocommerce_checkout_update_order_meta vs plugin: quale metodo dovresti scegliere?

Se stai costruendo un'integrazione personalizzata o hai requisiti molto specifici, allora woocommerce_checkout_update_order_meta combinato con woocommerce_checkout_fields è un modo potente e affidabile.

Tuttavia, se si desidera un modo più semplice per personalizzare il checkout ed evitare del tutto il codice, il plug-in Flexible Checkout Fields è un must.

Accelera il flusso di lavoro e rimuove le congetture dalla modifica del tuo checkout WooCommerce.

Riepilogo

  • Utilizzare woocommerce_checkout_fields per aggiungere nuovi campi di checkout.
  • Usa woocommerce_checkout_update_order_meta per salvare quei campi per ordinare la meta.
  • Il codice personalizzato fornisce flessibilità ma richiede supporto e test continui.
  • Flexible Checkout Fields Pro consente di gestire visivamente i campi con opzioni avanzate.
  • C'è anche una versione gratuita se hai solo bisogno di modifica del campo di base.