Come importare contenuti multilingue in WordPress: WooCommerce, CSV e XML

Esportazione e importazione di WPML funziona insieme al plugin di importazione per WordPress che già utilizzi. Il plugin di importazione sposta i tuoi dati. Esportazione e importazione di WPML aggiunge le informazioni sulla lingua alla fine, in modo che ogni riga finisca nella lingua corretta e ogni traduzione si colleghi alla sua lingua di origine.

Prima di iniziare

Installa e attiva questi plugin sul sito in cui stai effettuando l’importazione:

Un plugin di importazione: WP All Import Pro, WP All Export Pro, l’importatore CSV nativo di WooCommerce o l’importatore standard di WordPress.
WPML e WPML Traduzione stringhe.
Esportazione e importazione di WPML (il componente aggiuntivo trattato in questa pagina).
WPML Multilingual & Multicurrency for WooCommerce se stai importando prodotti WooCommerce.

Sul sito di importazione, configura WPML con ogni lingua che prevedi di importare. Le lingue di destinazione devono già esistere in WPML > Impostazioni > Lingue prima di eseguire l’importazione.

Due percorsi – scegli quello che corrisponde alla tua origine

Ci sono due percorsi di importazione, a seconda della provenienza dei dati multilingue:

Plugin di importazione supportato. Se stai spostando i contenuti da un sito WordPress esistente con WP All Export Pro (o un altro strumento di esportazione supportato), Esportazione e importazione di WPML è già nel file di esportazione: le informazioni sulla lingua vengono incluse automaticamente. Passa al passaggio Esegui l’importazione di WPML qui sotto.
CSV o XML personalizzato. Se gestisci i dati multilingue in un foglio di calcolo o se la tua origine è un sistema non WordPress (PIM, MLS, ERP, piattaforma di prenotazione), aggiungerai manualmente tre colonne per la lingua al tuo file. Continua con Prepara il tuo CSV o XML qui sotto.

Prepara il tuo CSV o XML con tre colonne per la lingua

Per le importazioni personalizzate, aggiungi tre colonne a ogni riga del tuo foglio di calcolo. In questo modo WPML accoppia le traduzioni e contrassegna ogni riga con la lingua corretta:

_wpml_import_translation_group. Un valore univoco condiviso da tutte le versioni linguistiche di un singolo contenuto. Per i prodotti, usa lo SKU. Per tutto il resto, genera il tuo ID e riutilizzalo per la riga di origine e per ogni sua traduzione.
_wpml_import_language_code. Il codice lingua ISO per la riga (en per l’inglese, es per lo spagnolo, fr per il francese, pt-pt per il portoghese europeo e così via).
_wpml_import_source_language_code. Solo sulle righe di traduzione; il codice lingua dell’originale. Lascialo vuoto per le righe nella lingua di origine.

Per WP All Import Pro e strumenti simili, prepara due fogli di calcolo: uno per le tassonomie (categorie, tag, categorie di prodotti) e uno per gli articoli e i prodotti. L’importatore CSV nativo di WooCommerce accetta un singolo foglio di calcolo, poiché le categorie di prodotti si trovano all’interno delle righe dei prodotti.

Attributi WooCommerce personalizzati per i prodotti variabili

Se hai prodotti variabili con attributi personalizzati, aggiungi una quarta colonna alle righe dei prodotti tradotti: _wpml_import_wc_local_attribute_labels. Il valore è un oggetto JSON di coppie slug:translation. Per un prodotto variabile in francese con gli attributi Size e Color:

{"size":"Taille","color":"Couleur"}

Lo slug è il nome dell’attributo in minuscolo, con gli spazi sostituiti da trattini.

Ordine di importazione

Importa sempre prima le tassonomie quando hai un file separato per esse. Le categorie, i tag e qualsiasi altra tassonomia devono esistere prima che gli articoli e i prodotti possano farvi riferimento. Quindi importa articoli, pagine, prodotti e altri tipi di contenuto.

Se dividi i tuoi dati in un file per lingua, importa ogni file di lingua prima di eseguire il passaggio di collegamento di WPML.

Mappa le colonne della lingua nel tuo plugin di importazione

Ogni plugin di importazione gestisce le colonne personalizzate a modo suo. Il passaggio fondamentale è mappare le tre colonne di WPML ai campi personalizzati (o ai meta termine, per le tassonomie). In WP All Import Pro, questo avviene nel Passaggio 3 della procedura guidata di importazione:

Per articoli e prodotti. Apri Campi personalizzati, aggiungi tre campi, trascina le colonne della lingua nelle caselle Value e usa i nomi delle colonne senza parentesi nelle caselle Name.
Per le tassonomie. Apri Meta termine, aggiungi tre campi meta termine e mappa le colonne della lingua allo stesso modo.

Se le colonne non sono mappate, WPML non ha nulla da leggere quando esegui il passaggio di collegamento.

Cosa vedrai tra l’importazione e il passaggio di collegamento

Finché non esegui Esportazione e importazione di WPML, tutti i contenuti importati si trovano nella tua lingua predefinita e WPML mantiene automaticamente gli articoli e i prodotti nello stato Bozza per evitare che contenuti in lingue miste vengano visualizzati sul front-end. Questo è lo stato intermedio previsto, non un segno di un’importazione non riuscita.

Per i plugin di importazione non supportati, dovrai pubblicare gli articoli manualmente dopo aver completato il passaggio di collegamento.

Esegui l’importazione di WPML

Una volta che il plugin di importazione ha terminato:

Apri WPML > Esportazione e importazione nell’area di amministrazione di WordPress.
Fai clic su Esegui l’importazione di WPML.

WPML legge le colonne della lingua di ogni riga, assegna la lingua a quella riga e collega le traduzioni alla loro lingua di origine. Su cataloghi di grandi dimensioni, questa operazione può richiedere diversi minuti. Al termine, i tuoi contenuti importati vengono pubblicati nella lingua corretta, con ogni traduzione collegata alla sua lingua di origine.

Fai un controllo a campione sul back-end e sul front-end:

Apri l’elenco dei tipi di post o dei prodotti: verifica che ogni riga venga visualizzata sotto la bandiera della lingua corretta.
Visita il front-end e cambia lingua: ogni pagina tradotta dovrebbe caricare la sua versione tradotta, senza ripiegare sulla lingua di origine.

Se una traduzione della tassonomia non si è collegata, apri il termine nell’area di amministrazione di WordPress e usa il riquadro Lingue del termine per collegarlo al termine nella lingua predefinita.

Automatizza il processo – esegui l’importazione di WPML dopo ogni importazione pianificata

Per le sincronizzazioni notturne, i feed dei fornitori o qualsiasi importazione pianificata, il passaggio di collegamento di WPML può essere eseguito automaticamente subito dopo il termine del plugin di importazione. Ci sono tre modi per configurarlo:

Opzione 1 – endpoint POST (per importazioni basate su cron come le azioni pianificate di WP All Import)

Questo è il metodo consigliato. Aggiungi una chiave segreta complessa a wp-config.php:

define( 'WPML_IMPORT_KEY', 'your-strong-secret-key-here' );

Quindi aggiungi un secondo comando alla tua configurazione di importazione pianificata. Questo invia una richiesta POST al tuo sito e passa la chiave nel corpo della richiesta:

curl -X POST https://yoursite.com/ \
  -d 'wpml_import_trigger=your-strong-secret-key-here'

La stessa chiamata con wget:

wget -q -O - \
  --post-data='wpml_import_trigger=your-strong-secret-key-here' \
  https://yoursite.com/

Per la pianificazione manuale di WP All Import Pro, aggiungi uno dei due comandi subito dopo il comando di importazione.

Quando viene eseguito il passaggio di collegamento, il tuo sito risponde con lo stato 200 e questo messaggio:

Import process completed

Altre due risposte ti indicano cosa è successo: 401 significa che la chiave non corrisponde e 204 significa che non c’era più nulla da elaborare.

Opzione 2 – endpoint URL (deprecato)

Prima della versione 1.2.0 di Esportazione e importazione di WPML, passavi la chiave nell’URL:

https://yoursite.com/?wpml_import_trigger=your-strong-secret-key-here

Questo URL funziona ancora, quindi i tuoi attuali processi cron continuano a essere eseguiti. È deprecato e WPML lo rimuoverà nella prossima versione principale.

Il motivo è la chiave. Un URL viaggia attraverso i log del server, la cronologia del browser e gli strumenti di analisi, e la tua chiave viaggia con esso. Una richiesta POST mantiene la chiave nel corpo della richiesta. Sposta le tue importazioni pianificate alla chiamata POST nell’Opzione 1.

Opzione 3 – action hook (per importazioni pianificate in PHP)

Se stai pianificando le importazioni da PHP con Action Scheduler o wp_schedule_single_event, avvia il passaggio di WPML con una chiamata di azione:

do_action( 'wpml_import_process' );

Per eseguirlo come attività in background una tantum subito dopo l’azione di importazione:

wp_schedule_single_event( time(), 'wpml_import_process' );

Se qualcosa non va a buon fine in uno di questi percorsi, attiva WP_DEBUG_LOG in wp-config.php per acquisire l’errore nel log degli errori di PHP.

Esegui l’importazione di WPML dalla riga di comando

Per gli script di distribuzione, le build di container o qualsiasi pipeline in cui l’interfaccia utente di amministrazione non è disponibile, esegui il passaggio di collegamento da WP-CLI:

wp wpml import process

Il comando segnala quante traduzioni sono state collegate. È un sostituto diretto del pulsante Esegui l’importazione di WPML.

Insidie comuni

Nel file di importazione mancano le tre colonne della lingua. Il contenuto viene importato ma finisce come righe nella lingua di origine senza tag; Esegui l’importazione di WPML non ha nulla da collegare. Soluzione: aggiungi le colonne ai tuoi dati di origine, riesporta e reimporta.
La mappatura di Campi personalizzati / Meta termine di WP All Import è stata saltata. Stessa situazione delle colonne mancanti. I dati sono nel file, ma il plugin di importazione non li ha memorizzati nell’articolo. Esegui nuovamente l’importazione con i campi mappati.
Le lingue di destinazione non sono configurate sul sito di importazione. Le righe importate per una lingua non configurata finiscono nella lingua predefinita. Aggiungi prima le lingue mancanti in WPML > Impostazioni > Lingue, quindi esegui di nuovo.
Plugin di importazione non supportato. Gli articoli importati rimangono in Bozza dopo il passaggio di collegamento. Pubblicali manualmente o passa a un plugin supportato.
Script di importazione personalizzati che non trasmettono i dati della lingua. La soluzione è a livello di script. Le tre colonne della lingua (e la colonna degli attributi di WooCommerce, se applicabile) devono raggiungere la riga.

Se le importazioni continuano a bloccarsi sullo stesso problema, il team di supporto di WPML risponde alle domande sull’importazione 24 ore su 24, 7 giorni su 7.

Se stavi cercando il plugin WPML All Import

WPML All Import è il plugin legacy che precede Esportazione e importazione di WPML. Non è più supportato o consigliato. La procedura descritta sopra è il modo aggiornato per importare contenuti multilingue in un sito WordPress: usala al posto di qualsiasi flusso di lavoro descritto nella documentazione del vecchio plugin.