Comment ça fonctionne
L’export CSV liste chaque texte de la boutique pour la langue sélectionnée, du lecteur de cours à la page de remerciement du paiement, à la page d’état de la commande et à Mes cours, avec sa formulation par défaut et votre texte actuel. Vous remplissez la colonne your text et importez le fichier dans la même langue. Les cellules vides ne changent rien, et un import ne supprime jamais de texte.
Les colonnes du CSV
Chaque export comporte les mêmes quatre colonnes, dans cet ordre :
| Colonne | Ce qu’elle contient | À l’import |
|---|---|---|
locale |
La langue : all pour Toutes les langues, ou un code comme fr, de ou pt-BR. Toutes les lignes ont la même valeur. |
Doit correspondre à la langue sélectionnée dans l’éditeur. |
key |
L’identifiant du texte, le même code gris affiché sous chaque champ de l’éditeur, par exemple homePage.title. |
Doit être un texte listé par l’éditeur. Ne le modifiez pas. |
default text |
La formulation intégrée pour cette langue, ou l’anglais pour Toutes les langues. | Ignorée. Elle sert uniquement de référence. |
your text |
Votre formulation actuelle, ou vide si vous n’avez pas modifié ce texte. | Vide : le texte actuel est conservé. Toute autre valeur le remplace. |
Comment traduire les textes de la boutique avec un CSV
1. Sélectionner la langue
Ouvrez l’éditeur de textes de la boutique et choisissez la langue dans le menu Langue, par exemple le français. L’export et l’import utilisent tous deux la langue sélectionnée.
2. Exporter le CSV
Cliquez sur Exporter → Exporter en CSV (tableur). Alva Courses télécharge un fichier nommé d’après le code de la langue, comme storefront-text-fr.csv, ou storefront-text-all.csv pour Toutes les langues. Le fichier contient uniquement vos textes enregistrés, pas les modifications non enregistrées.
3. Remplir la colonne « your text »
Ouvrez le fichier dans une application de tableur et saisissez chaque nouvelle formulation dans la colonne your text. Laissez telles quelles les cellules locale et key, conservez les variables comme {{count}} et laissez une cellule vide pour conserver le texte actuel.
4. Enregistrer au format CSV
Enregistrez le fichier au format CSV, avec des virgules entre les colonnes. Choisissez CSV UTF-8 lorsque votre application le propose, afin que les caractères accentués et non latins soient conservés. N’ajoutez pas de colonnes, et ne supprimez ni ne renommez les colonnes locale, key ou your text.
5. Importer et vérifier l’aperçu
Dans l’éditeur, avec la même langue sélectionnée, cliquez sur Importer, puis sur Choisir un fichier. Alva Courses vérifie le fichier et affiche la langue dans laquelle il sera importé, le nombre de textes modifiés et inchangés, et chaque modification de l’ancienne formulation vers la nouvelle.
6. Confirmer l’import
Cliquez sur le bouton Importer qui indique le nombre de textes, par exemple Importer 42 textes. Les textes sont enregistrés immédiatement, sans passer par la barre d’enregistrement, et s’affichent au prochain chargement de la boutique.
Règles d’import
- Une langue par fichier. Si la langue du fichier diffère de celle sélectionnée, Alva Courses nomme les deux et n’importe rien. Sélectionnez la langue du fichier et réessayez.
- Tout ou rien. Si une ligne pose problème, rien n’est importé, et chaque problème est listé avec son numéro de ligne. L’en-tête est la ligne 1, comme dans votre tableur.
- Les règles de texte de l’éditeur s’appliquent. Chaque texte peut compter jusqu’à 500 caractères, ne peut pas contenir
<ni>, et ne peut utiliser que les variables de son texte par défaut. - Fichiers jusqu’à 1 Mo, au format
.csvou.json. - L’import ne supprime jamais rien. Pour retirer un texte, utilisez les boutons de réinitialisation de l’éditeur, puis enregistrez.
Sous Toutes les langues, l’aperçu liste séparément les textes définis sous Personnaliser la connexion que le fichier modifierait, car ces textes s’affichent dans toutes les langues.
Conseils pour le tableur
Un texte commençant par =, +, - ou @ est exporté avec une apostrophe devant, pour que les tableurs ne le lisent pas comme une formule. L’import retire à nouveau cette apostrophe. Les lignes dont la cellule your text est vide sont ignorées : vous pouvez donc traduire quelques textes à la fois et importer aussi souvent que vous le souhaitez.
Exporter en JSON pour une sauvegarde
Exporter → Exporter en JSON télécharge uniquement les textes que vous avez personnalisés pour la langue sélectionnée. C’est une sauvegarde rapide avant une grande réinitialisation, et Importer l’accepte comme un CSV.
Questions fréquentes
Un seul fichier peut-il contenir plusieurs langues ?
Non. Chaque fichier contient une seule langue, et toutes les lignes doivent porter la même locale. Exportez et importez chaque langue séparément, en la sélectionnant d’abord dans le menu Langue.
Comment supprimer un texte avec un import ?
Ce n’est pas possible. Une cellule vide conserve le texte actuel, et un import ne supprime jamais rien. Pour revenir au texte par défaut, utilisez Rétablir le texte par défaut, Réinitialiser ce groupe ou le bouton de réinitialisation globale de l’éditeur, puis enregistrez.
Pourquoi rien n’a-t-il été importé ?
Les imports fonctionnent en tout ou rien. Si une ligne pose problème, par exemple une clé inconnue, une autre langue, un texte de plus de 500 caractères ou une variable que le texte ne peut pas utiliser, Alva Courses liste chaque problème avec son numéro de ligne et n’importe rien. Corrigez le fichier et importez-le à nouveau.
Le CSV inclut-il les textes du paiement et du compte client ?
Oui. L’export liste les textes de la page de remerciement du paiement, de la page d’état de la commande et de Mes cours après ceux du lecteur de cours. Leurs clés commencent par ext., comme ext.membersArea.page_title pour le titre de la page Mes cours.
Voir aussi
Cet article vous a-t-il été utile ?
Dernière mise à jour 2026-10-08