Come funziona
L'esportazione CSV elenca ogni testo del negozio per la lingua selezionata, dal lettore corsi alla pagina di ringraziamento del checkout, alla pagina dello stato dell'ordine e a I miei corsi, con la sua formulazione predefinita e il tuo testo attuale. Compili la colonna your text e importi il file nella stessa lingua. Le celle vuote non cambiano nulla e un'importazione non elimina mai testi.
Le colonne del CSV
Ogni esportazione ha le stesse quattro colonne, in quest'ordine:
| Colonna | Cosa contiene | All'importazione |
|---|---|---|
locale |
La lingua: all per Tutte le lingue, oppure un codice come fr, de o pt-BR. Ogni riga ha lo stesso valore. |
Deve corrispondere alla lingua selezionata nell'editor. |
key |
L'ID del testo, lo stesso codice grigio mostrato sotto ogni campo nell'editor, come homePage.title. |
Deve essere un testo elencato dall'editor. Non modificarlo. |
default text |
La formulazione integrata per quella lingua, oppure l'inglese per Tutte le lingue. | Ignorata. Serve solo come riferimento. |
your text |
La tua formulazione attuale, oppure vuota se non hai cambiato quel testo. | Vuota mantiene il testo attuale. Qualsiasi altro valore lo sostituisce. |
Come tradurre i testi del negozio con un CSV
1. Seleziona la lingua
Apri l'editor dei testi del negozio e scegli la lingua dal menu Lingua, per esempio francese. Sia l'esportazione sia l'importazione usano la lingua selezionata.
2. Esporta il CSV
Clicca su Esporta → Esporta in CSV (foglio di calcolo). Alva Courses scarica un file con il nome del codice lingua, come storefront-text-fr.csv, oppure storefront-text-all.csv per Tutte le lingue. Il file contiene solo i testi salvati, non le modifiche non salvate.
3. Compila la colonna your text
Apri il file in un'app di fogli di calcolo e scrivi ogni nuova formulazione nella colonna your text. Lascia invariate le celle locale e key, mantieni i segnaposto come {{count}} e lascia vuota una cella per mantenere il testo attuale.
4. Salva come CSV
Salva il file come CSV con le virgole tra le colonne. Scegli CSV UTF-8 dove la tua app lo offre, così i caratteri accentati e non latini si conservano. Non aggiungere colonne e non rimuovere né rinominare le colonne locale, key o your text.
5. Importa e controlla l'anteprima
Nell'editor, con la stessa lingua selezionata, clicca su Importa, poi su Scegli file. Alva Courses controlla il file e mostra la lingua in cui importerà, quanti testi sono modificati e quanti invariati, e ogni modifica dalla vecchia formulazione alla nuova.
6. Conferma l'importazione
Clicca sul pulsante Importa che indica il numero di testi, come Importa 42 testi. Il testo viene salvato subito, senza il passaggio della barra di salvataggio, e compare al successivo caricamento di una pagina del negozio.
Regole di importazione
- Una lingua per file. Se la lingua del file è diversa da quella selezionata, Alva Courses nomina entrambe e non importa nulla. Seleziona la lingua del file e riprova.
- Tutto o niente. Se una riga ha un problema, non viene importato nulla e ogni problema è elencato con il numero di riga. L'intestazione è la riga 1, come nel tuo foglio di calcolo.
- Valgono le regole sui testi dell'editor. Ogni testo può contenere fino a 500 caratteri, non può contenere
<o>e può usare solo i segnaposto che usa il suo testo predefinito. - File fino a 1 MB, in formato
.csvo.json. - L'importazione non elimina mai. Per rimuovere un testo, usa i pulsanti di ripristino nell'editor, poi salva.
In Tutte le lingue, l'anteprima elenca separatamente i testi impostati in Personalizza accesso che il file cambierebbe, perché quel testo compare in ogni lingua.
Consigli per i fogli di calcolo
Il testo che inizia con =, +, - o @ viene esportato con un apostrofo davanti, così i fogli di calcolo non lo leggono come una formula. L'importazione rimuove di nuovo quell'apostrofo. Le righe con una cella your text vuota vengono saltate, quindi puoi tradurre pochi testi alla volta e importare tutte le volte che vuoi.
Esporta in JSON per un backup
Esporta → Esporta in JSON scarica solo i testi che hai personalizzato per la lingua selezionata. È un backup rapido prima di un grande ripristino, e Importa lo accetta come un CSV.
Domande frequenti
Un file può contenere più lingue?
No. Ogni file contiene una sola lingua e ogni riga deve avere lo stesso locale. Esporta e importa ogni lingua separatamente, selezionandola prima nel menu Lingua.
Come rimuovo un testo con un'importazione?
Non puoi. Una cella vuota mantiene il testo attuale e un'importazione non elimina mai nulla. Per tornare al testo predefinito, usa Ripristina predefinito, Ripristina questo gruppo o il pulsante per ripristinare tutto nell'editor, poi salva.
Perché non è stato importato nulla?
Le importazioni sono tutto o niente. Se una riga ha un problema, come una chiave sconosciuta, una lingua diversa, un testo di oltre 500 caratteri o un segnaposto che il testo non può usare, Alva Courses elenca ogni problema con il numero di riga e non importa nulla. Correggi il file e importalo di nuovo.
Il CSV include i testi del checkout e dell'account cliente?
Sì. L'esportazione elenca i testi della pagina di ringraziamento del checkout, della pagina dello stato dell'ordine e di I miei corsi dopo i testi del lettore corsi. Le loro chiavi iniziano con ext., come ext.membersArea.page_title per il titolo della pagina I miei corsi.
Vedi anche
È stato utile?
Ultimo aggiornamento 2026-10-08