WPML

Questa guida è per i negozi il cui catalogo risiede all’esterno di WordPress: in un foglio di calcolo, un PIM, un ERP o un feed di fornitori. I prodotti arrivano su WooCommerce tramite un importatore, l’API REST o un processo pianificato e raramente apri l’editor dei prodotti.

Hai bisogno di WPML, WPML Multilingual & Multicurrency for WooCommerce e, per le importazioni con traduzioni, di Esportazione e importazione di WPML.

Parte 1. Come funziona un negozio multilingue gestito dall’esterno

Un prodotto per lingua, collegato da un gruppo di traduzione

Ogni lingua ha il proprio prodotto WooCommerce, con il proprio ID. WPML collega le lingue in un gruppo di traduzione. L’originale è il prodotto nella lingua predefinita del tuo negozio; le altre lingue sono le sue traduzioni.

Nel nostro negozio di esempio, la felpa con cappuccio (Zip-Up Hoodie) è il prodotto 14 in inglese, 121 in tedesco e 122 in francese. Ogni risposta dell’API REST per uno qualsiasi di essi contiene la stessa mappa: "translations": {"de":"121","en":"14","fr":"122"}.

  • Lo SKU è lo stesso in ogni lingua. Anche le variazioni di un prodotto variabile mantengono gli stessi SKU di variazione.
  • Lo SKU è la chiave per il tuo sistema esterno. La ricerca di WooCommerce, wc_get_product_id_by_sku(), restituisce il prodotto originale, non una traduzione.
  • Gli elenchi restituiscono una lingua alla volta. GET /wc/v3/products?sku=HP-HD-ZIP restituisce solo la lingua predefinita. Aggiungi &lang=de per una sola lingua o &lang=all per tutte le lingue.

Cosa copia WPML in ogni lingua e cosa traduce

Quando il prodotto originale cambia, tramite l’editor dei prodotti, un’importazione CSV o l’API REST, WPML copia questi valori in ogni traduzione:

  • Prezzo di listino e prezzo in offerta
  • Quantità in magazzino e stato del magazzino
  • SKU, peso e dimensioni
  • Immagine del prodotto e galleria (ogni lingua ottiene la propria copia dell’immagine)
  • Categorie e tag (come categoria o tag tradotto)
  • Upsell e cross-sell (che puntano al prodotto nella stessa lingua)
  • Stato di pubblicazione
  • Per i prodotti variabili: il prezzo e il magazzino di ogni variazione, l’intervallo di prezzo, un nuovo termine di attributo globale (come sua traduzione, ad esempio Schwarz e Noir per Black) e una nuova variazione

Questi rimangono diversi in ogni lingua, perché vengono tradotti:

  • Nome, descrizione e descrizione breve
  • Slug (l’indirizzo del prodotto, ad esempio /de/produkt/kapuzenjacke-mit-reissverschluss/)
  • Termini degli attributi, come Blue, Blau e Bleu
  • Valori degli attributi specifici del prodotto, come un “Material” impostato solo su questo prodotto

Il magazzino è condiviso da tutte le lingue.

Scrivi i prezzi e gli attributi nell’originale. Se il tuo sistema scrive un prezzo o degli attributi in una traduzione, la traduzione mantiene i valori dell’originale. Il magazzino scritto in qualsiasi lingua diventa il magazzino di tutte le lingue, perché è condiviso.

Anche i prezzi in una seconda valuta seguono l’originale (vedi multivaluta per WooCommerce). Impostali sull’originale, con custom_prices nell’API REST ("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}}) o con le colonne CSV Meta: _wcml_custom_prices_status, Meta: _regular_price_USD, Meta: _sale_price_USD e Meta: _price_USD. Ogni lingua mostrerà quindi quei prezzi in quella valuta.

custom_prices viene memorizzato quando la funzione multivaluta è attiva e la valuta è una delle valute del tuo negozio. Invialo come segue:

  1. Attiva prima la funzione multivaluta. Vai su WPMLImpostazioniMultivaluta, spunta Abilita la modalità multivaluta e fai clic su Salva le modifiche. Sotto Mostra le valute in base a, scegli un’opzione (ad esempio Lingua del sito) e fai clic su Salva le modifiche. Quindi aggiungi ogni valuta con Aggiungi valuta. Con la funzione multivaluta disattivata, WPML non memorizza nulla da custom_prices.
  2. Usa i codici valuta del tuo negozio. WPML memorizza solo i prezzi delle valute del negozio. Un prezzo in qualsiasi altro codice non viene memorizzato.
  3. Per un prodotto variabile, invia custom_prices su ogni variazione, non sul genitore. WPML lo memorizza sulla variazione originale e ogni lingua lo mostra. Se inviato sul genitore, non viene memorizzato.
  4. Leggi i prezzi memorizzati da meta_data (_regular_price_USD, _sale_price_USD, _price_USD). Le risposte alle chiamate REST non includono un campo custom_prices.

Duplicati o traduzioni indipendenti

WPML ha due tipi di prodotti tradotti. Il tipo che hai determina cosa succede al testo che importi.

DuplicatoTraduzione indipendente
Cos’èUna copia gestita da WPMLUna traduzione con il proprio testo
Testo dopo il successivo salvataggio dell’originaleSostituito dal testo dell’originaleMantenuto solo con Traduci tutto disattivato o con Prodotti impostato su Nessuno
Prezzo e magazzinoSeguono l’originaleSeguono l’originale
  • Dove lo vedi: il riquadro Lingua di un duplicato riporta “Questo documento è un duplicato di ... ed è gestito da WPML.” con il pulsante Traduci indipendentemente.
  • Trasformare i duplicati in traduzioni indipendenti: fai clic su Traduci indipendentemente nel riquadro Lingua del duplicato oppure, per molti prodotti, vai su ProdottiTutti i prodotti, passa alla lingua della traduzione, spunta i prodotti e scegli Azioni di gruppoTraduci indipendentemente.
  • Cosa creano i processi della Parte 2: il Processo A crea traduzioni con Traduci tutto. Il Processo B importa traduzioni indipendenti. Nessuno dei due ha bisogno di duplicati.

Configura il negozio prima dell’arrivo del primo prodotto

  1. Esegui il Setup Wizard di WooCommerce Multilingual. Si apre quando attivi WPML Multilingual & Multicurrency for WooCommerce. Le sue schermate sono Pagine del negozio, Attributi globali e Valute multiple. La prima crea Negozio, Carrello, Checkout e Il mio account in ogni lingua.
  2. Rendi traducibili i tuoi attributi globali. Nella schermata del wizard “Quali attributi dei prodotti dovrebbero essere traducibili?”, spunta ogni attributo, ad esempio Colore e Taglia. In seguito, la stessa impostazione è la casella di controllo Traducibile? in ProdottiAttributiModifica.
  3. Traduci i termini degli attributi prima dei prodotti. Vai su WPMLTraduzioni, apri la scheda Tassonomia, scegli l’attributo in “Seleziona la tassonomia da tradurre” e traduci ogni termine. Con Traduci tutto attivo (Processo A), WPML traduce i nuovi termini per te.

Parte 2. Costruiscilo senza codice

Scegli il tuo processo: una lingua o tutte le lingue

Processo A: WPML traduceProcesso B: importi tutte le lingue
Cosa contiene il tuo sistemaSolo la lingua predefinita del negozioTutte le lingue
Cosa importiProdotti originaliOriginali e le loro traduzioni, collegati tramite SKU
Chi traduceTraduci tutto, con Private Translation Cloud (PTC) (si apre in una nuova scheda)I tuoi traduttori, prima dell’importazione
Quando il testo di un originale cambiaTraduci tutto traduce la modificaWPML contrassegna la traduzione come da aggiornare; il tuo file successivo porterà il nuovo testo
Prezzi e scorteSeguono l’originaleSeguono l’originale

Il Processo A è adatto a un negozio che mantiene una lingua e vuole tutte le altre lingue senza file di traduzione. Il Processo B è adatto a un negozio il cui PIM o i cui traduttori possiedono già i testi in ogni lingua.

Processo A con l’importatore CSV di WooCommerce o WP All Import

Attiva Traduci tutto una volta:

  1. Vai su WPMLTraduzioni e fai clic su Configura Traduci tutto.
  2. Scegli il contenuto. Sotto “Contenuto da tradurre”, mantieni Tutti i prodotti e fai clic su Continua.
  3. Scegli come pubblicare le traduzioni. Sotto “Metodo di pubblicazione”, mantieni Pubblica senza revisione.
  4. Fai clic su Abilita Traduci tutto automaticamente.

Importa i tuoi prodotti solo nella lingua predefinita del negozio. Usa ProdottiImporta (l’importatore CSV di WooCommerce) o All ImportNuova importazione (WP All Import con il suo componente aggiuntivo WooCommerce). Il tuo file non ha bisogno di colonne WPML.

L’importazione stessa mette in coda le traduzioni. WPML traduce quindi ogni prodotto, variazione, categoria e nuovo termine di attributo in ciascuna lingua e li pubblica. Non avvii nulla manualmente e nessuna pagina dell’area di amministrazione di WPML deve essere aperta. Puoi seguire i progressi in WPMLTraduzioni.

Quando modifichi un originale, Traduci tutto traduce solo ciò che è cambiato. Il resto della traduzione rimane invariato parola per parola.

Traduci tutto traduce i prodotti pubblicati, inclusi i prodotti esterni. Non traduce i prodotti privati. Anche le bozze attendono: Traduci automaticamente le bozze (in WPMLImpostazioniTraduzione IA, nel riquadro Editor di traduzione avanzato) è disattivato per impostazione predefinita e, quando lo attivi, WPML traduce una bozza solo quando la salvi di nuovo. Per tradurre le bozze e i prodotti privati, inviali da WPMLTraduzioni (vedi Risoluzione dei problemi).

Se vuoi modificare una traduzione, aprila dal riquadro Lingua del prodotto (Modifica la traduzione in ...), modificala nell’Editor di traduzione avanzato e fai clic su Salva e completa. Quando in seguito l’originale cambia, la tua modifica delle frasi non modificate rimane.

Processo B con l’importatore CSV di WooCommerce

Nel Processo B, il tuo file contiene tutte le lingue.

Imposta Traduci tutto per le traduzioni importate prima della prima importazione:

  1. Vai su WPMLTraduzioni. Se Traduci tutto è disattivato, lascialo disattivato e passa al file.
  2. Se vuoi che WPML traduca automaticamente le tue pagine, i tuoi articoli e le tue stringhe, fai clic su Configura Traduci tutto. Sotto “Contenuto da tradurre”, imposta Prodotti su Nessuno. Fai clic su Continua, mantieni Pubblica senza revisione e fai clic su Abilita Traduci tutto automaticamente.
  3. Se Traduci tutto è già attivo, fai clic sul menu a tre puntini nel riquadro “Traduci tutto automaticamente è abilitato”, scegli Regola i limiti dei contenuti, imposta Prodotti su Nessuno e fai clic su Salva le modifiche. Le traduzioni già in corso verranno comunque completate.

Con Prodotti impostato su Nessuno, WPML mantiene le traduzioni dei tuoi prodotti importati parola per parola. Quando un originale cambia, WPML contrassegna le sue traduzioni come da aggiornare, e il tuo file successivo porterà il nuovo testo.

Prepara un unico file con tutte le lingue. Usa le normali colonne di WooCommerce e aggiungi quattro colonne WPML:

ColonnaCosa contieneEsempio
Meta: _wpml_import_translation_groupIl valore che collega le lingue. Usa lo SKU.HP-JK-SHELL
Meta: _wpml_import_language_codeLa lingua della rigade
Meta: _wpml_import_source_language_codeLa lingua dell’originale, che è la lingua predefinita del negozio. Vuota nelle righe degli originali.en
Meta: _wpml_import_after_process_post_statusLo stato dopo che WPML ha collegato i prodottipublish
  • Ordina le righe per lingua, prima gli originali. In ogni lingua, i prodotti vengono prima delle loro variazioni.
  • Importa i prodotti come bozze: Published = -1 sui prodotti, 1 sulle variazioni.
  • Assegna a ogni lingua i propri testi: nomi, descrizioni, categorie (Kleidung > Jacken) e valori degli attributi (Blau, Grün).
  • Mantieni i nomi degli attributi del negozio (Color, Size) in ogni lingua. Traduci le etichette degli attributi in WPMLTraduzioniTassonomia.
  • Indica i prodotti correlati e i genitori tramite SKU, lo stesso SKU in ogni lingua.

Una riga in tedesco di un prodotto variabile dal nostro file di esempio:

Type,SKU,Name,Published,...,Categories,...,Parent,Attribute 1 name,Attribute 1 value(s),...,Meta: _wpml_import_translation_group,Meta: _wpml_import_language_code,Meta: _wpml_import_source_language_code,Meta: _wpml_import_after_process_post_status
variable,HP-JK-SHELL,Verstaubare Regenjacke,-1,...,Kleidung > Jacken,...,,Color,"Blau, Grün",...,HP-JK-SHELL,de,en,publish
variation,HP-JK-SHELL-BLU-S,,1,...,,...,HP-JK-SHELL,Color,Blau,...,HP-JK-SHELL-BLU-S,de,en,publish

Importalo:

  1. Vai su ProdottiImporta e scegli il file in “Scegli un file CSV dal tuo computer:”. Lascia deselezionata l’opzione Aggiorna i prodotti esistenti. Fai clic su Continua.
  2. Controlla la mappatura. Le quattro colonne Meta: sono mappate su Importa come metadati. Fai clic su Esegui l’importatore.
  3. Vai su WPMLEsportazione e importazione di WPML. La schermata indica “Good job. We see 33 posts that are imported and need language information.” (Ottimo lavoro. Vediamo 33 articoli importati che necessitano di informazioni sulla lingua). Fai clic su Esegui importazione WPML.
  4. Attendi il messaggio “Multilingual Import Complete” (Importazione multilingue completata).

Fino al passaggio 3, ogni prodotto è una bozza in inglese e ogni variazione è una variazione in inglese, nessuna delle quali è collegata al suo originale. Dopo questo passaggio:

  • Ogni prodotto e ogni variazione sono collegati tra le rispettive lingue.
  • Tutto è pubblicato.
  • Le traduzioni sono traduzioni indipendenti.
  • Le categorie e i termini degli attributi sono collegati tra le lingue e le variazioni di ciascuna lingua utilizzano i propri termini.
  • I prodotti consigliati (upsell) puntano al prodotto nella stessa lingua e ogni lingua ha la propria copia delle immagini.

Le categorie e i termini degli attributi viaggiano all’interno delle righe dei prodotti, quindi questo importatore non ha bisogno di un’importazione separata delle tassonomie. Se nel negozio esistono già termini degli attributi tradotti, l’importatore li utilizza e Esegui importazione WPML li collega ai loro originali.

Per fare in modo che WPML traduca automaticamente i prodotti scelti mentre la traduzione dei prodotti è impostata su Nessuno:

  1. Mantieni attivo Traduci tutto.
  2. Aggiungi la colonna Meta: _wpml_import_tea al file, con il valore 1 su ogni prodotto da tradurre.
  3. Mantieni Meta: _wpml_import_translation_group nello stesso file.
  4. Importa il file, quindi vai su WPMLEsportazione e importazione di WPML e fai clic su Esegui importazione WPML. L’elenco di avanzamento mostra “Sending Posts for Automatic Translation” (Invio articoli per la traduzione automatica) e WPML traduce e pubblica quei prodotti.

Processo B con WP All Import

Hai bisogno di WP All Import Pro e del suo componente aggiuntivo per WooCommerce. L’edizione gratuita non importa i campi personalizzati e le colonne di WPML sono campi personalizzati.

L’ordine di lavoro è: prima i termini degli attributi, con le loro traduzioni collegate, poi i prodotti. Le pagine dei prodotti tradotti offrono quindi ogni valore dell’attributo nella propria lingua, ad esempio Bleu marine e non Navy.

  1. Collega i termini tradotti che il negozio possiede già. Per ogni termine dell’attributo tradotto che esiste già nel negozio, vai su ProdottiAttributi, fai clic su Configura termini per l’attributo, cambia la barra di amministrazione nella lingua del termine e fai clic sul nome del termine. Nel riquadro Lingua, scegli il suo originale sotto Questa è una traduzione di e fai clic su Aggiorna. Ogni termine collegato mostrerà quindi una matita sotto la sua lingua in WPMLTraduzioniTassonomia.
  2. Imposta la lingua dell’area di amministrazione sulla lingua predefinita del negozio nel selettore di lingua della barra di amministrazione prima di eseguire le importazioni.
  3. Importa le categorie. All ImportNuova importazioneCarica un file, scegli TassonomieCategorie di prodotto. Sotto Meta termine, aggiungi tre righe: _wpml_import_language_code, _wpml_import_source_language_code e _wpml_import_translation_group, ciascuna mappata alla colonna del file con lo stesso nome. Imposta il genitore in Altre opzioni categoriaTermine genitore.
  4. Importa i termini degli attributi nello stesso modo, ad esempio TassonomieColore prodotto, con le stesse tre righe Meta termine.
  5. Collega i termini. Vai su WPMLEsportazione e importazione di WPML e fai clic su Esegui importazione WPML. Controlla in WPMLTraduzioniTassonomia (scegli la tassonomia in “Seleziona la tassonomia da tradurre”) che ogni termine abbia una riga con una matita sotto la bandiera di ciascuna lingua. Passa il mouse su una matita per vedere il nome tradotto. Un “+” significa che quella lingua non ha alcuna traduzione. Un termine tradotto elencato nella propria riga non è collegato.
  6. Importa i prodotti. Scegli Prodotti WooCommerce. Nella sezione Componente aggiuntivo WooCommerce, mappa SKU, prezzi, scorte e attributi. Sotto Campi personalizzati, aggiungi le tre righe _wpml_import_*.
  7. Esegui importazione WPML di nuovo e attendi il messaggio Multilingual Import Complete (Importazione multilingue completata).

Il nostro file dei termini di esempio:

name,_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group
Navy,en,,color-navy
Marineblau,de,en,color-navy

Due impostazioni per un file di prodotto che contiene tutte le lingue:

  • Le righe delle variazioni portano il tipo variable, lo stesso del loro genitore, nella colonna che mappi su Imposta tipo di prodotto con XPath.
  • Collega le variazioni al loro genitore con una chiave per lingua. Sotto Variazioni, scegli Tutti i miei prodotti variabili hanno SKU o qualche altro identificatore univoco... e mappa Elemento SKU per il genitore ed Elemento SKU genitore per la variazione a una chiave come HP-OW-RAIN-de. Mappa il vero SKU, uguale in ogni lingua, su GeneraleSKU e al gruppo di traduzione. L’altro metodo prevede un’importazione per ogni file di lingua.

Questo ordine funziona sia che tu avvii le importazioni di WP All Import da wp-admin, da WP-CLI o in modo programmato.

Aggiornare le scorte e i prezzi in modo programmato

Aggiorna i prodotti originali. WPML copia immediatamente le scorte e i prezzi in ogni lingua.

Con l’importatore CSV di WooCommerce:

  1. Invia solo le colonne che modifichi. Una colonna con una cella vuota scrive un valore vuoto. Il nostro file di esempio:
    SKU,Stock,Regular price,Meta: _wpml_import_language_code
    HP-JK-FIELD,11,95,en
    HP-JK-SHELL-BLU-S,5,72,en
  2. Aggiungi Meta: _wpml_import_language_code con la lingua dell’originale su ogni riga. In questo modo ogni riga aggiorna il prodotto in quella lingua, ovvero l’originale. Senza questa colonna, una riga aggiorna il prodotto nella lingua corrente dell’area di amministrazione, quindi il risultato dipende dal selettore di lingua dell’area di amministrazione.
  3. Imposta la lingua dell’area di amministrazione sulla lingua predefinita del negozio nel selettore di lingua della barra di amministrazione.
  4. Vai su ProdottiImporta, scegli il file, spunta Aggiorna i prodotti esistenti, fai clic su Continua ed Esegui l’importatore.

Subito dopo l'importazione, ogni lingua mostra le nuove scorte, i prezzi e la fascia di prezzo.

Con WP All Import, su base programmata:

  1. All ImportNew ImportDownload a fileFrom URL, con l'URL del feed del tuo fornitore. Scegli WooCommerce Products.
  2. Mappa SKU, Regular Price e Stock Qty nella sezione WooCommerce Add-On.
  3. In Import Settings, spunta Attempt to match to existing WooCommerce products before creating new ones e fai corrispondere tramite campo personalizzato _sku. Disattiva Create new WooCommerce products from records newly present in this import file. Attiva Update existing WooCommerce products with the data in this import file.
  4. In Choose which data to update, disattiva tutto tranne Campi personalizzati, e scegli Update only these Custom Fields, leave the rest alone: _regular_price, _price, _stock, _manage_stock.
  5. Programmala. In All ImportManage ImportsScheduling Options, Manual Scheduling mostra un Trigger URL e un Processing URL per il cron job del tuo server.

Ogni esecuzione associa le righe ai prodotti originali e ogni lingua ottiene i nuovi prezzi e le nuove scorte di ogni prodotto e variazione.

Se un file completo del Processo B viene importato di nuovo come aggiornamento, imposta Published su 1 in ogni riga. Altrimenti i prodotti attivi passano in Bozza fino a Run WPML Import. Spunta Aggiorna i prodotti esistenti, quindi fai clic su Run WPML Import. I prodotti rimangono in stato Pubblicato e i testi nel file sostituiscono immediatamente le traduzioni.

Aggiungi una lingua a un catalogo che hai già

Processo A:

  1. Vai su WPMLLingue, fai clic su Gestisci e nascondi le lingue del sito, usa Cerca e aggiungi una lingua… e scegli la lingua.
  2. Fai clic su Calcola i costi. La finestra di dialogo “Costo per tradurre il tuo contenuto in...” elenca gli elementi e le parole. Fai clic su Salva.

Traduci tutto avvia la nuova lingua da solo, la volta successiva che viene caricata una pagina dell'area di amministrazione di WPML. WPML traduce e pubblica ogni prodotto e variazione nella nuova lingua. Le tue lingue esistenti non vengono toccate.

Processo B:

  1. Prepara un file solo con le righe della nuova lingua. Usa lo SKU come gruppo di traduzione, la lingua dell'originale come lingua di origine, Published = -1 e publish come stato finale.
  2. Vai su ProdottiImporta. Lascia deselezionato Aggiorna i prodotti esistenti. Esegui l'importatore.
  3. Vai su WPMLEsportazione e importazione di WPML e fai clic su Run WPML Import.

Ogni nuovo prodotto e variazione si unisce al gruppo di traduzione del suo originale, associato tramite SKU. Questo funziona su qualsiasi catalogo, anche uno che non è mai stato importato. La nuova lingua ottiene le proprie categorie e i termini degli attributi dal file.

Aggiorna i prodotti esistenti non aggiunge una lingua: l'importatore salta quelle righe. Elenca ogni prodotto nella nuova lingua con “Non esiste alcun prodotto corrispondente da aggiornare.” e ogni variazione nella nuova lingua con “Non è possibile creare una nuova variazione senza un prodotto genitore.”

Importa cataloghi di grandi dimensioni

  • Importa un file per lingua, prima gli originali.
  • Esegui Run WPML Import una volta, dopo l'ultimo file.
  • Per esecuzioni lunghe, usa WP-CLI: wp wpml import process esegue lo stesso passaggio del pulsante e mostra il conteggio di ogni fase.

Quanto tempo ci vuole, dal nostro laboratorio, con l'importatore di WooCommerce e un Run WPML Import per un catalogo in tre lingue:

Prodotti per linguaIntera importazioneDi cui, Run WPML Import
500circa mezz'orapochi minuti
1.000circa un'oracirca 10 minuti
2.000circa due orecirca mezz'ora

Ogni dimensione è stata completata in un'unica sessione, con ogni prodotto e variazione presente e collegato in ogni lingua. Ogni cifra rappresenta un'esecuzione su un server di laboratorio condiviso. La maggior parte del tempo è dovuta all'importatore di WooCommerce e dipende dal tuo server. Leggi questi numeri come un ordine di grandezza.

Esporta i prodotti con le loro lingue (WP All Export)

WP All Export aggiunge le colonne di WPML _wpml_import_language_code, _wpml_import_source_language_code e _wpml_import_translation_group a un'esportazione di Prodotti WooCommerce per impostazione predefinita. La sua sezione WPML esporta tutte le lingue o una sola. Le esportazioni eseguite manualmente e su base programmata riempiono entrambe le colonne. Leggi di più in Esportare siti web multilingue usando WP All Export.

Sincronizza da un ERP o PIM

Un ERP (sistema di pianificazione delle risorse aziendali) è il software in cui un'azienda conserva le scorte, i prezzi e gli ordini. Un PIM (sistema di gestione delle informazioni sui prodotti) è dove conserva i testi e i dati dei prodotti.

Un connettore tra un sistema di questo tipo e WooCommerce in genere:

  • Mantiene il catalogo indicizzato per SKU, in una sola lingua
  • Trova ogni prodotto tramite SKU (GET /wc/v3/products?sku=...)
  • Aggiorna le scorte e i prezzi dei prodotti esistenti e crea nuovi prodotti tramite l’API REST di WooCommerce
  • Viene eseguito a intervalli programmati

Questo è il flusso che funziona con WPML:

  1. Il connettore scrive solo nella lingua predefinita del negozio.
  2. WPML copia le scorte e i prezzi in tutte le lingue nella stessa richiesta.
  3. Traduci tutto traduce i nuovi prodotti in tutte le lingue (Processo A).
  4. Un prodotto che il connettore imposta come bozza passa in bozza in tutte le lingue.
  5. Un prodotto eliminato dal connettore segue le impostazioni in WPMLImpostazioniEliminazione dei contenuti, riga Prodotti. Nessuno riceve richieste di conferma durante una sincronizzazione, quindi imposta Eliminazione di un originale sul comportamento che desideri: Elimina tutte le lingue rimuove anche le traduzioni; Solo quello le mantiene pubblicate.

Poni tre domande al fornitore del tuo connettore:

  1. Scrive tramite WooCommerce o direttamente nel database? Le modifiche scritte direttamente nel database raggiungono solo l’originale. Le traduzioni mantengono le scorte e i prezzi vecchi.
  2. In quale lingua scrive? Deve scrivere nell’originale. Un prezzo scritto in una traduzione non viene memorizzato: la traduzione mantiene il prezzo dell’originale.
  3. Crea un prodotto per lingua? WooCommerce rifiuta un secondo prodotto con lo stesso SKU. Senza lo SKU, le copie sono prodotti separati che non ricevono aggiornamenti di scorte o prezzi. Lascia che il connettore crei solo l’originale e lascia che WPML lo traduca.

Parte 3. Costruire flussi personalizzati (sviluppatori)

Creare un prodotto e le sue traduzioni con l’API REST di WooCommerce

Crea prima i termini, poi l’originale, quindi ogni traduzione con lang e translation_of.

  1. Traduci la categoria (e gli eventuali termini degli attributi): POST /wp-json/wc/v3/products/categories
    JSON
    {
      "name": "Wohnen und Geschenke",
      "slug": "wohnen-und-geschenke",
      "lang": "de",
      "translation_of": 32
    }

    Per i termini degli attributi, usa POST /wc/v3/products/attributes/<id>/terms/batch con gli stessi due campi su ogni termine.

  2. Crea l’originale: POST /wp-json/wc/v3/products
    JSON
    {
      "name": "Stoneware Coffee Mug",
      "type": "simple",
      "status": "publish",
      "sku": "HP-HG-MUG",
      "regular_price": "16.00",
      "manage_stock": true,
      "stock_quantity": 60,
      "categories": [ { "id": 32 } ],
      "lang": "en"
    }
  3. Crea ogni traduzione: POST /wp-json/wc/v3/products, con i testi tradotti, la categoria tradotta, lang e translation_of (l’ID dell’originale). Non inviare SKU, prezzo o scorte: WPML li copia dall’originale.
    JSON
    {
      "name": "Steingut-Kaffeebecher",
      "slug": "steingut-kaffeebecher",
      "status": "publish",
      "categories": [ { "id": 38 } ],
      "lang": "de",
      "translation_of": 120
    }
  4. Leggi il risultato con una GET. La risposta alla chiamata di creazione mostra SKU, prezzo e scorte vuoti, perché WPML li copia dopo che la risposta è stata generata. GET /wc/v3/products/121 subito dopo li mostrerà.

Per un prodotto variabile, crea le variazioni dell’originale solo sull’originale (POST /wc/v3/products/<id>/variations/batch). Poi crea ogni genitore tradotto con lang e translation_of. WPML crea da solo le variazioni tradotte, collega ciascuna alla sua variazione originale e copia SKU, prezzo, scorte e i termini degli attributi in quella lingua. Non inviare variazioni su una traduzione.

Leggi le variazioni di una traduzione con ?lang=: GET /wc/v3/products/137/variations?lang=fr. Ogni variazione contiene lang, la sua mappa translations e i nomi delle opzioni in quella lingua.

Una traduzione di prodotto per lingua. Una seconda traduzione di prodotto in una lingua che ne ha già una viene rifiutata con HTTP 400 wcml_translation_exists e non viene creato nulla. Il messaggio indica l’ID della traduzione esistente. Aggiorna invece la traduzione esistente.

Riferimento completo ai campi: API REST di WooCommerce Multilingual.

Aggiornare i prodotti con l’API REST di WooCommerce

Aggiorna l’originale. WPML copia la modifica in tutte le lingue nella stessa richiesta.

  • PUT /wc/v3/products/123/variations/124 con {"regular_price": "59.00", "stock_quantity": 3} modifica il prezzo e le scorte di quella variazione in tutte le lingue, e l’intervallo di prezzo si adegua di conseguenza.
  • PUT /wc/v3/products/120 con un nuovo prezzo di listino, prezzo in saldo o scorte li modifica in tutte le lingue.
  • I nuovi termini degli attributi vengono creati sull’attributo originale e tradotti con lang e translation_of, come nel passaggio 1 precedente.
  • Una nuova variazione aggiunta all’originale (POST /wc/v3/products/123/variations o .../variations/batch) raggiunge tutte le lingue nella stessa richiesta, collegata, con il suo prezzo e le sue scorte. La risposta alla chiamata elenca solo la lingua originale; GET /wc/v3/products/130/variations?lang=de subito dopo elenca la nuova variazione tradotta.
  • Un prezzo o degli attributi inviati a una traduzione non vengono memorizzati: la traduzione mantiene i valori dell’originale. Un valore delle scorte inviato a qualsiasi lingua diventa la scorta di tutte le lingue.

Eliminare tramite l’API: DELETE /wc/v3/products/<id> segue le impostazioni in WPMLImpostazioniEliminazione dei contenuti, riga Prodotti. L’API non chiede mai conferme: con Chiedimi elimina solo l’originale. Imposta Eliminazione di un originale sul comportamento desiderato per il tuo negozio. Con Elimina tutte le lingue, un’eliminazione sposta tutte le lingue nel Cestino e ?force=true elimina tutte le lingue.

Scrivere il proprio importatore o connettore

Usa le funzioni dei prodotti di WooCommerce. WPML vede la modifica e la copia in tutte le lingue.

PHP
$id      = wc_get_product_id_by_sku( 'HP-HG-MUG' ); // returns the original
$product = wc_get_product( $id );
$product->set_regular_price( '19.00' );
$product->set_stock_quantity( 33 );
$product->save();

Dopo save(), le traduzioni mostrano il nuovo prezzo e le nuove scorte.

Non scrivere mai i dati dei prodotti direttamente nel database (update_post_meta() o SQL). L’originale cambia, e le traduzioni mantengono i vecchi valori.

Esegui il passaggio di importazione di WPML dal codice dopo un’importazione con le colonne WPML: wp wpml import process. Esegue gli stessi passaggi del pulsante Esegui importazione WPML e stampa ciascuno di essi con il rispettivo conteggio.

Lavori pianificati

Un lavoro pianificato (WP-Cron) che modifica l’originale con le funzioni dei prodotti di WooCommerce applica queste modifiche a ogni lingua nella richiesta stessa del lavoro:

  • Prezzo di listino, prezzo in saldo e scorte, con lo stato del magazzino che ne consegue
  • Una categoria aggiunta al prodotto (come categoria tradotta)
  • Un nuovo termine di attributo su un prodotto variabile (come sua traduzione)
  • L’intervallo di prezzo del prodotto variabile

Parte 4. Risoluzione dei problemi

Le traduzioni importate vengono visualizzate come prodotti separati e non collegati

Cosa vedi: le righe tradotte mancano, oppure si trovano come prodotti in inglese (lingua predefinita), spesso privati, senza alcun collegamento all’originale.

Perché succede:

  • Il file non ha colonne WPML. WooCommerce quindi salta ogni riga il cui codice SKU esiste già: “A product with this SKU already exists.”
  • Il file ha le colonne WPML, ma non è stato eseguito Esegui importazione WPML. Fino a quel momento ogni riga è un prodotto nella lingua predefinita senza alcun collegamento al suo originale, con lo stato che la colonna Published del file gli assegna (Privato per 0, Bozza per -1). WPMLEsportazione e importazione mostra “Good job. We see 12 posts that are imported and need language information.”

Come risolverlo ora:

  • Nessun passaggio di importazione di WPML eseguito: vai su WPMLEsportazione e importazione e fai clic su Esegui importazione WPML.
  • Nessuna colonna WPML: aggiungi le quattro colonne WPML alle righe di traduzione e importale di nuovo come una nuova importazione, con Aggiorna i prodotti esistenti deselezionato. Poi fai clic su Esegui importazione WPML. Ogni traduzione si unisce al suo originale tramite SKU.

Come evitarlo: includi sempre le colonne WPML ed esegui Esegui importazione WPML dopo ogni importazione.

Le traduzioni importate vengono sostituite dal testo dell’originale

Cosa vedi: hai importato nomi e descrizioni tradotti e, dopo il successivo salvataggio dell’originale, sono tornati nella lingua originale.

Perché succede: le traduzioni erano duplicati. WPML riscrive un duplicato a ogni salvataggio del suo originale.

Come risolverlo ora:

  1. Rendile indipendenti. Vai su ProdottiTutti i prodotti, passa alla lingua della traduzione, spunta i prodotti e scegli Azioni di gruppoTraduci indipendentemente.
  2. Se Traduci tutto è attivo, imposta Prodotti su Nessuno. Su WPMLTraduzioni, fai clic sul menu a tre puntini nel riquadro “Traduci tutto automaticamente è abilitato”, scegli Regola i limiti dei contenuti, imposta Prodotti su Nessuno e fai clic su Salva le modifiche.
  3. Importa di nuovo le tue traduzioni.

Dopodiché, salvando l’originale si mantiene il testo importato.

Come evitarlo: prima di importare il testo in traduzioni esistenti, impostale su Traduci indipendentemente. Oppure importa le traduzioni come nuovi prodotti con le colonne WPML (Processo B).

I prodotti tradotti mostrano i valori degli attributi nella lingua originale

Cosa vedi: la pagina del prodotto tradotto offre “Blue”, “Green” invece dei termini tradotti.

Perché succede: i prodotti sono stati tradotti prima che venissero tradotti i termini dei loro attributi.

Come risolverlo ora:

  1. Vai su WPMLTraduzioni e apri la scheda Tassonomia.
  2. Alla voce “Seleziona la tassonomia da tradurre”, scegli l’attributo, ad esempio Colore prodotto.
  3. Traduci ogni termine in ciascuna lingua e fai clic su Salva. Traduci l’etichetta dell’attributo nella stessa schermata.

I prodotti tradotti esistenti acquisiscono ogni termine man mano che lo salvi. Nessun prodotto deve essere salvato di nuovo. Se un termine è stato creato inizialmente come copia con il nome dell’originale, il suo slug mantiene il testo dell’originale; modificalo nella stessa finestra di dialogo.

Come evitarlo: traduci i termini degli attributi prima di tradurre o importare i prodotti.

Le categorie o i termini tradotti mantengono i nomi dell’originale dopo un’importazione

Cosa vedi: un prodotto tradotto si trova in una categoria chiamata “Sunglasses” o offre “Blue” nel negozio tradotto.

Perché succede: le righe di traduzione sono state copiate dall’esportazione dell’originale e hanno mantenuto i nomi della categoria, dei tag e dei termini degli attributi. WPML crea i termini tradotti con quei nomi e li collega correttamente, ma non li rinomina. I cross-sell, gli upsell, le immagini, le gallerie e i genitori delle variazioni forniti dagli ID dell’originale vengono rimappati nella lingua corretta.

Come risolverlo ora: rinomina i termini in WPMLTraduzioniTassonomia, come nella sezione precedente. I breadcrumb, i link ai termini, le intestazioni degli archivi e le opzioni degli attributi mostrano subito i nuovi nomi e nessun prodotto deve essere salvato di nuovo. Gli slug mantengono il testo dell’originale a meno che non li modifichi nella stessa finestra di dialogo.

Come evitarlo: nelle righe di traduzione, scrivi i nomi tradotti di categorie, tag e termini degli attributi, nello stesso ordine dell’originale. Indica i prodotti correlati e i genitori tramite SKU.

Le scorte o i prezzi in altre lingue sono indietro rispetto all’originale

Cosa vedi: l’originale mostra le nuove scorte o il nuovo prezzo, mentre le traduzioni mostrano quelli vecchi.

Perché succede: la modifica ha bypassato WooCommerce o WPML:

  • Un connettore ha scritto direttamente nel database.
  • È stata eseguita un’importazione mentre WPML era disattivato.

Come capirlo: apri l’originale nell’editor del prodotto. Sotto l’editor della descrizione c'è scritto “Ultima modifica il” con data e ora. Se quell’ora è precedente al nuovo prezzo o alle nuove scorte nel riquadro Dati del prodotto, o se la modifica è stata apportata mentre WPML era inattivo, l’aggiornamento ha bypassato la sincronizzazione.

Come risolverlo ora:

Per i prodotti variabili:

  1. Vai su WPMLSupportoCorreggi le traduzioni di WCML. Correggi le traduzioni di WCML fa parte di WPML Troubleshooting, un plugin separato.
  2. Spunta Sincronizza le variazioni dei prodotti e fai clic su Esegui gli strumenti selezionati.

Ogni lingua mostra quindi i prezzi e le scorte delle variazioni dell’originale, oltre alla fascia di prezzo del prodotto.

Per i prodotti semplici, usa uno di questi metodi. Ognuno di essi trasferisce il prezzo e le scorte dell’originale a tutte le lingue:

  • Un prodotto alla volta: apri ogni originale modificato e fai clic su Aggiorna.
  • Molti prodotti tramite importazione: con la lingua dell'area di amministrazione impostata sulla lingua predefinita, importa nuovamente i prodotti con ProdottiImporta e spunta Aggiorna i prodotti esistenti. Il file può contenere i valori che gli originali hanno già. Questo riallinea anche i prodotti variabili.
  • Molti prodotti tramite REST: invia PUT /wc/v3/products/<id> con il prezzo per ogni prodotto, ad esempio {"regular_price": "19.50"}.
  • Molti prodotti con un solo prezzo: in ProdottiTutti i prodotti, spunta i prodotti, scegli Azioni di gruppoModifica di gruppo e fai clic su Applica. In Prezzo scegli Cambia in:, inserisci il prezzo e fai clic su Aggiorna. Ogni prodotto spuntato ottiene quel singolo prezzo.

Eseguire wp wc product update con il valore che l’originale ha già non lo trasferisce alle traduzioni.

Come evitarlo: lascia che il connettore scriva tramite WooCommerce (l’API REST o le funzioni del prodotto) e mantieni WPML attivo durante le importazioni.

I prodotti creati tramite l’API REST finiscono nella lingua o nel gruppo sbagliato

Cosa vedi: una traduzione appare nella lingua sbagliata, oppure come un prodotto separato senza SKU e senza collegamento all’originale.

Perché succede:

  • Un codice lingua sconosciuto viene rifiutato con HTTP 422 Invalid language parameter: "ge" e non viene creato nulla.
  • Un codice valido ma sbagliato, come un testo in tedesco inviato con "lang": "fr", crea una traduzione in quella lingua.
  • Un translation_of mancante crea un prodotto nel proprio gruppo, senza SKU e senza prezzo o scorte copiati.

Come risolverlo ora: invia nuovamente il prodotto con la lingua corretta e il collegamento, con PUT /wc/v3/products/<id>:

JSON
{
  "lang": "de",
  "translation_of": 38
}

Il prodotto si sposta nel gruppo dell’originale e ottiene il suo SKU, il prezzo e le scorte. Per un prodotto variabile, WPML sostituisce le variazioni create senza collegamento con delle nuove collegate. Rileggi i nuovi ID delle variazioni.

Come evitarlo: invia lang e translation_of in ogni traduzione, crea prima i termini e lascia che WPML crei le variazioni delle traduzioni.

I nuovi prodotti importati non vengono tradotti automaticamente

Cosa vedi: i prodotti importati rimangono solo nella lingua originale.

Perché succede: Traduci tutto era disattivato durante l’importazione, oppure i prodotti sono privati (che Traduci tutto non traduce mai) o bozze (che traduce solo quando Traduci le bozze automaticamente è attivo e la bozza viene salvata di nuovo).

Come risolverlo ora:

  • Invia i prodotti: vai su WPMLTraduzioni, apri la sezione Prodotti, spunta i prodotti, scegli Traduci automaticamente per ogni lingua, scegli Pubblica senza revisione in “Cosa vorresti fare quando WPML finisce di tradurre automaticamente i tuoi contenuti?” e fai clic su Traduci contenuto. Questo funziona anche per le bozze e i prodotti privati; le loro traduzioni ottengono lo stato dell’originale.
  • Oppure attiva Traduci tutto. Traduce ogni prodotto pubblicato non ancora tradotto. WPML li invia durante il caricamento delle pagine dell'area di amministrazione di WPML.
    1. Vai su WPMLTraduzioniConfigura Traduci tuttoContinuaAbilita Traduci tutto automaticamente.
    2. Rimani su WPMLTraduzioni finché non appare “Traduzione dei contenuti completata”.

Come evitarlo: attiva Traduci tutto prima dell’importazione (Processo A) e importa i prodotti come pubblicati.

Scritto daAmir