Come tradurre Ninja Forms in WordPress: moduli multipasso, azioni email e azioni di integrazione

Prima di iniziare

Installa e attiva questi plugin:

Ninja Forms.
WPML e WPML Traduzione stringhe.
Ninja Forms Multilingual (il componente aggiuntivo trattato in questa pagina).

Crea il modulo in Ninja Forms nella lingua di origine del tuo sito, includendo l’eventuale struttura in più passaggi, la logica condizionale, il testo di convalida e le azioni di cui hai bisogno (messaggio di successo, reindirizzamento dell’invio, email, azioni di integrazione). Invia il modulo per la traduzione dopo che è funzionalmente completo.

Traduci tutto automaticamente gestisce questo processo per te

Se il tuo sito ha l’opzione Traduci tutto automaticamente attivata, non hai bisogno di inviare il modulo per la traduzione manualmente. WPML rileva i moduli nuovi e aggiornati insieme al resto dei tuoi contenuti e li traduce in background. Il passaggio di inserimento nella pagina descritto di seguito si applica comunque, ma il passaggio di invio del modulo per la traduzione è automatico. Il resto di questa pagina descrive il percorso manuale per i siti che utilizzano Traduci in parte: scegli tu cosa tradurre (o per i moduli che vuoi tradurre prima della coda automatica).

Invia il modulo per la traduzione

Apri WPML > Traduzioni > Bacheca.
Espandi la sezione Ninja Forms.
Seleziona il modulo che vuoi tradurre.
Scegli un metodo di traduzione: PTC (consigliato), il tuo traduttore o Traduco io.
Fai clic su Traduci.

I campi, le opzioni, le azioni (messaggio di successo, email, reindirizzamento dell’invio, integrazioni) e i messaggi di convalida per singolo campo vengono tutti inseriti nello stesso lavoro di traduzione.

Inserisci il modulo nelle tue pagine tradotte

Ninja Forms si trova all’interno di una pagina o di un articolo, di solito tramite il blocco Ninja Forms o lo shortcode [ninja_form id="X"]. La regola di inserimento multilingue:

Usa lo stesso blocco o shortcode in ogni versione linguistica della pagina. Non creare un modulo separato per ogni lingua.

Il flusso:

Crea il modulo una volta sola nella tua lingua di origine.
Invia il modulo per la traduzione (o lascia che Traduci tutto automaticamente lo rilevi).
Inserisci il modulo nella pagina nella lingua di origine usando il blocco Ninja Forms o lo shortcode [ninja_form].
Traduci la pagina tramite WPML > Traduzioni > Bacheca nello stesso modo in cui tradurresti qualsiasi altra pagina. L’incorporamento del modulo viene mantenuto nella pagina tradotta.
Quando un visitatore apre la pagina tradotta, Ninja Forms Multilingual fornisce automaticamente il modulo nella lingua del visitatore: stesso ID del modulo, stesso shortcode, contenuto tradotto.

Non hai bisogno di un ID del modulo diverso per ogni lingua. La traduzione è collegata al modulo di origine; Ninja Forms Multilingual risolve la versione nella lingua corretta al momento del rendering.

L’eccezione: quando desideri davvero moduli diversi per ogni lingua. Se hai bisogno di moduli strutturalmente diversi per ogni lingua (campi diversi, azioni diverse, logica diversa), crea moduli Ninja Forms separati (uno per lingua) e inserisci il rispettivo shortcode nella versione linguistica corrispondente della pagina usando l’editor di WordPress per quella traduzione. Questa è l’unica situazione in cui gli shortcode differiscono tra le lingue.

Attenzione ai page builder

Se la tua pagina è creata in Divi, Elementor o in un altro page builder che racchiude gli shortcode nel proprio modulo di testo, lo shortcode potrebbe non sopravvivere sempre in modo pulito alla traduzione. Se la pagina tradotta mostra il modulo nella lingua di origine, apri la pagina tradotta nel page builder e reinserisci lì il blocco o lo shortcode del modulo. L’editor a blocchi nativo di WordPress e l’editor classico non presentano questo problema.

Etichette e tipi di campo

Ogni etichetta, segnaposto e opzione di campo di Ninja Forms appare nel lavoro di traduzione. L’intero catalogo dei campi viene tradotto: testo, paragrafo, nome, email, indirizzo, telefono, elenco (selezione, radio, casella di controllo, selezione multipla), numero, data/ora, caricamento file, invio.

I campi ripetitore si traducono a livello di riga: l’etichetta del pulsante per aggiungere una riga e ogni etichetta di campo per riga si trovano nel lavoro di traduzione. I traduttori vedono la struttura del ripetitore intatta con l’etichetta di ogni sottocampo come riga traducibile.

Campi di selezione immagine

I campi di selezione immagine abbinano una miniatura a un’etichetta di testo. Ninja Forms Multilingual traduce l’etichetta per ogni lingua, mentre l’immagine rimane condivisa. I selettori basati su immagini funzionano in modo identico in ogni lingua; si traducono solo le didascalie.

Moduli in più passaggi

Per i moduli in più passaggi, ogni intestazione di passaggio e i pulsanti di navigazione per passaggio (Precedente, Successivo, Invia) si traducono come righe a sé stanti. La logica condizionale per passaggio sopravvive alla traduzione. La mappa dei valori mantiene i valori di scelta sottostanti allineati tra le lingue.

Dopo la traduzione, percorri il flusso in più passaggi in ogni lingua per confermare che la navigazione risulti naturale e che le ramificazioni condizionali si attivino ancora nei passaggi corretti.

Layout e stili

Gli output del designer di layout e stili di Ninja si traducono senza perdere il layout. La griglia, le colonne e lo stile visivo rimangono; cambia solo il contenuto delle stringhe per ogni lingua. Nessun passaggio speciale: traduci il modulo e il layout lo seguirà.

Salva i progressi

Per i moduli con l’opzione per salvare i progressi abilitata, i messaggi lato visitatore si traducono:

Etichetta del pulsante Salva i progressi.
Oggetto e corpo dell’email con il link di ripresa.
Il messaggio di successo dopo il salvataggio.

Tutti e tre si trovano nel lavoro di traduzione. Dopo la traduzione, fai un test salvando a metà di un modulo in ogni lingua e confermando che l’email di ripresa arrivi nella lingua corretta.

Messaggi di convalida per singolo campo

Ogni campo porta con sé il proprio testo di convalida: errore di campo obbligatorio, errore di formato, messaggio di convalida personalizzato. Ognuno di essi appare nel lavoro di traduzione. Il testo antispam e honeypot si traduce tramite WPML Traduzione stringhe (non nel lavoro di traduzione del modulo).

Azione del messaggio di successo e azione di reindirizzamento dell’invio

Il testo di ringraziamento in linea dell’azione del messaggio di successo si traduce per ogni lingua. Anche l’URL dell’azione di reindirizzamento dell’invio è traducibile. Imposta un URL di ringraziamento diverso per ogni lingua, in modo che i visitatori atterrino su una pagina nella lingua corrispondente dopo l’invio.

Azione email

Ogni azione email sul modulo si traduce in modo indipendente. A, Nome mittente, Oggetto e Messaggio email appaiono tutti nel lavoro di traduzione. I moduli con più azioni email (notifica all’amministratore + conferma al visitatore, ad esempio) traducono ogni azione separatamente, in modo che il testo per ogni lingua sia indipendente.

Un limite noto

I tag di unione all’interno dei template dell’azione email non si traducono per ogni lingua. L’inserimento del tag di unione usa il template della lingua di origine, quindi i dati del modulo vengono sostituiti ma le frasi circostanti rimangono nella lingua di origine. Tracciato sulla pagina degli errata. Soluzione alternativa: crea le frasi circostanti senza tag di unione ovunque la differenza di lingua sia importante, oppure accetta il limite per i testi meno rilevanti.

Azioni di integrazione

L’architettura delle azioni di Ninja Forms fa sì che ogni integrazione sia un passaggio del flusso di lavoro per modulo. Il testo rivolto ai visitatori di ogni azione si traduce:

Azioni webhook. Il corpo della richiesta e tutte le etichette rivolte ai visitatori si traducono; i valori dei campi rimangono canonici in modo che gli endpoint riceventi non si interrompano.
Mailchimp / AWeber / Constant Contact / ActiveCampaign / Campaign Monitor / CleverReach / Drip / EmailOctopus / Emma / Kit / MailerLite / MailPoet. Le etichette di elenchi / segmenti / tag si traducono se esistono come stringhe a livello di modulo.
HubSpot / Salesforce / ZohoCRM. Le etichette di pipeline / fase / modulo si traducono.
Zapier / Slack / Trello. Le stringhe di canale, etichetta e nome modulo webhook si traducono.

Per le integrazioni di pagamento (Stripe, Authorize.net, Elavon, PayPal), le descrizioni degli acquisti e le etichette dei pulsanti rivolte ai visitatori si traducono. Esegui una transazione di prova in ogni lingua usando la modalità di test del processore di pagamento e conferma che il testo della ricevuta arrivi correttamente.

Un limite noto: invio di moduli in PDF

Il componente aggiuntivo PDF Form Submission di Ninja Forms non genera PDF quando Ninja Forms Multilingual è attivo su moduli con traduzioni configurate. Questo problema è tracciato in una discussione sul forum. Soluzione alternativa: disabilita il componente aggiuntivo PDF per i moduli tradotti finché non viene risolta la compatibilità.

Insidie comuni

Il corpo dell’azione email presenta parti non tradotte attorno ai tag di unione. Limite noto (vedi sopra). Ristruttura il corpo dell’email per inserire il testo tradotto all’esterno degli inserimenti dei tag di unione, oppure accetta il limite.
Le email di notifica per l’amministratore arrivano nella lingua di origine. Conferma che l’azione email che stai testando sia stata inviata nuovamente per la traduzione dopo la tua ultima modifica. Se il problema persiste, controlla la discussione ricorrente sul forum per aggiornamenti sullo stato.
La logica condizionale smette di attivarsi nei moduli tradotti. Un’etichetta di scelta è stata modificata nella lingua di origine dopo la traduzione. Invia nuovamente il modulo per la traduzione per aggiornare la mappa dei valori.
L’invio di moduli in PDF smette di funzionare. Disabilita il componente aggiuntivo o rimuovi la traduzione in attesa della risoluzione della compatibilità.