Pour créer beaucoup de termes d’un coup, importez-les d’un fichier CSV, XLS ou XLSX. Cet article vous apprend à préparer le fichier dans votre tableur, à associer ses colonnes et à lire le compte rendu.
Avant de commencer
- L’import crée les termes d’une catégorie, par exemple deux cents villes ou toutes les marques d’un catalogue. Il n’est proposé que sur la liste d’une catégorie. Il ne met jamais à jour un terme qui existe.
- Un membre qui peut modifier les contenus peut importer. Le rôle Administrateur n’est pas demandé.
- Les champs et les références du type doivent exister avant l’import. Un champ se crée dans le menu Types de contenu, jamais depuis l’import. Ajouter des champs à un type décrit cette étape.
Préparer votre fichier
- Ouvrez la liste de la catégorie, par exemple Villes, dans le menu du type qui la cite.
- Cliquez sur Importer, à côté du bouton d’ajout. La fenêtre Importer des entrées s’ouvre.
- Cliquez sur Télécharger le modèle (.csv). Vous recevez le fichier
entries-import-template.csv. - Ouvrez-le dans votre tableur. Il compte une colonne par langue du site, la langue principale en premier. L’en-tête de chaque colonne est le code de sa langue, par exemple
frouen. - Écrivez un terme par ligne, son titre dans chaque langue. Ajoutez une colonne par champ ou par référence à remplir, par exemple
Latitude. - Enregistrez le fichier en CSV, XLS ou XLSX.
Le fichier téléchargé commence par la ligne sep=;. Avec elle, Excel l’ouvre en colonnes quel que soit son réglage régional. L’import ignore cette ligne.
| Élément | Règle |
|---|---|
| Ligne d’en-tête | Obligatoire. L’import associe chaque colonne par son en-tête, jamais par sa place : l’ordre des colonnes est libre. |
| Colonne d’une langue | Son en-tête est le code de la langue (fr, fr_FR ou fr-FR) ou son nom complet dans sa langue (français (France)). Les majuscules ne comptent pas. |
| Titre | Une ligne sans titre, ni dans une langue ni dans une colonne envoyée vers Titre de l’entrée, est ignorée. Une cellule de titre vide ne crée pas cette langue, sauf la langue principale quand une colonne va vers Titre de l’entrée. |
| Valeur d’un champ | Écrite dans toutes les langues du terme : la latitude d’une ville est la même partout. |
| Référence | Le titre ou le slug du contenu lié, jamais un identifiant. Plusieurs contenus dans une cellule se séparent par des virgules. Une référence qui n’en accepte qu’un garde le premier. |
| Cellule vide | N’écrit rien. |
Importer le fichier
- Dans la fenêtre Importer des entrées, glissez votre fichier sur la zone Glissez votre fichier ou cliquez sur Choisir un fichier. Le message Lecture du fichier… s’affiche.
- Sous Colonnes détectées, vérifiez la langue de chaque colonne de titre. Sous Premières lignes du fichier, vérifiez les titres des cinq premières lignes.
- Sous Colonnes qui ne sont pas une langue, choisissez dans la liste Va dans la destination de chaque colonne : un champ, une référence, Titre de l’entrée ou Ignorer cette colonne.
- Lisez le nombre annoncé. C’est le nombre de termes que l’import va créer : une par ligne et par langue dont le titre est rempli. Pour deux cents lignes remplies dans trois langues, la fenêtre affiche 600 entrées seront créées, langues comprises.
- Cliquez sur le bouton Importer 600 entrées, qui reprend le nombre annoncé. Le message Création… s’affiche. À 0, le bouton reste grisé : envoyez une colonne vers Titre de l’entrée.
- Lisez le compte rendu, puis cliquez sur Fermer et rafraîchir. La liste montre les termes créés.
Rien n’est créé avant votre clic sur le bouton d’import. Une colonne dont l’en-tête ressemble au nom ou à la clé d’un champ est proposée sur ce champ. L’import ne tient compte ni des accents, ni des majuscules, ni des espaces : LATITUDE tombe sur le champ Latitude. Vous confirmez chaque colonne.
Une langue du site sans colonne est signalée par Aucune colonne pour ces langues du site : suivi de ses codes. L’import se fait quand même, sans cette langue.
Importer un fichier sans colonne de langue
Un fichier dont la colonne des noms s’appelle par exemple Nom n’a pas de colonne de langue. Dans la liste Va dans de cette colonne, choisissez Titre de l’entrée. Chaque ligne dont le nom est rempli crée un terme dans la langue principale du site. Le nombre annoncé et le bouton se mettent à jour, et la langue principale quitte la liste des langues sans colonne.
Titre de l’entrée sert aussi quand le fichier a des colonnes de langue : il donne le titre dans la langue principale aux lignes qui n’ont pas de titre dans cette langue.
Lire le compte rendu
Une ligne du fichier crée un terme par langue. Ces termes sont reliés entre eux comme traductions. Chaque terme créé reçoit sa langue.
- Un terme complet est publié.
- Un terme dont un champ obligatoire est vide reste en brouillon. Le statut se décide langue par langue : la version française peut être publiée et l’anglaise rester en brouillon.
- Une ligne sans titre est ignorée.
Le compte rendu commence par Import terminé et le total, par exemple Publiées : 23. En brouillon : 2. Ignorées : 1. Une ligne par cas particulier suit, par exemple Ligne 11 : « Couëron » laissée en brouillon, car il manque Latitude. Complétez ces brouillons dans l’éditeur, puis publiez-les.
Le sitemap.xml est reconstruit à la fin de l’import. L’historique du site garde une seule ligne pour l’import, avec le nombre de termes créés.
Corriger une erreur de lecture
| Message | Correction |
|---|---|
| Le fichier n’a pas pu être lu. Utilisez du CSV, du XLS ou du XLSX. | Enregistrez le fichier dans l’un de ces formats. |
| Le fichier ne contient aucune ligne de données. | Ajoutez au moins une ligne sous la ligne d’en-tête. |
| La ligne d’en-tête est vide. Écrivez un code de langue ou un nom au-dessus de chaque colonne. | Écrivez en en-tête le code d’une langue du site, par exemple fr, ou le nom de chaque colonne. |
Une colonne de titre dont l’en-tête est mal écrit, par exemple French, n’est pas reconnue comme une langue. Elle apparaît sous Colonnes qui ne sont pas une langue : corrigez son en-tête et renvoyez le fichier, ou envoyez-la vers Titre de l’entrée si c’est la langue principale.