Exporter des articles WordPress en CSV avec champs personnalisés et taxonomies

Pour exporter des articles WordPress en CSV avec leurs champs personnalisés, ces champs doivent d'abord devenir des colonnes. L'onglet Exporter (Export) de WOLF n'a pas de sélecteur de champs propre : il écrit exactement les colonnes du tableau de l'éditeur d'articles, dans leur ordre, pour tous les articles, pour les articles filtrés ou pour ceux que vous avez cochés. Un bon export est donc surtout une question de préparation : ajouter les champs personnalisés, organiser les colonnes, filtrer les articles. Vous trouverez ci-dessous ce déroulement, le contenu du fichier (y compris la raison pour laquelle les colonnes de champs personnalisés s'intitulent Meta: key), la façon de l'ouvrir dans un tableur sans caractères corrompus, l'option XML et ce que l'export ne fait pas.

Ce qui détermine les lignes et les colonnes de l'export

• Lignes. Si des articles sont cochés dans le tableau, seuls ceux-ci sont exportés. Sinon, l'export prend tous les articles correspondant au filtre actuel, ou tous les articles du type de publication actuel si aucun filtre n'est appliqué. Les cases ne fonctionnent que sur la page actuelle du tableau (jusqu'à 100 lignes) ; pour des sélections plus larges, utilisez l'onglet Filtres. Un export couvre un seul type de publication.
• Colonnes. Toutes les colonnes activées dans l'onglet Réglages, dans le même ordre, à l'exception de la colonne des cases à cocher. La colonne ID est toujours incluse, ce qui est utile pour rapprocher les lignes par la suite.
• Formats. CSV, avec un choix de séparateur (, ; | ^ ~), et XML. Il n'existe pas de format Excel distinct ; Excel ouvre le CSV, comme décrit plus bas.

Exporter des articles avec leurs champs personnalisés en CSV, pas à pas

1. Ajoutez les champs personnalisés. Dans l'onglet Champs méta (Meta Fields), saisissez l'ID d'un article dont tous les champs sont remplis sous Get meta keys from any post by its ID, cliquez sur Get, conservez les clés que vous voulez exporter, puis cliquez sur Enregistrer les champs méta (Save meta fields). La façon de trouver les bonnes clés est expliquée dans la documentation Champs méta.
2. Choisissez et ordonnez les colonnes. Dans l'onglet Réglages (Settings), activez les nouvelles colonnes méta ainsi que les colonnes standard et les taxonomies dont vous avez besoin, désactivez le reste, faites-les glisser dans l'ordre voulu pour le fichier, puis cliquez sur Enregistrer tous les réglages (Save all settings).
3. Enregistrez cet ensemble comme profil de colonnes si vous exporterez de nouveau les mêmes colonnes : ouvrez Profils de colonnes (Columns profiles) dans le panneau d'outils de l'éditeur d'articles, saisissez un nom sous New Profile et cliquez sur Créer (Create). La prochaine fois, chargez le profil et l'ensemble de colonnes revient en une seule étape.
4. Sélectionnez les articles. Filtrez par catégorie, statut, date, auteur ou valeur d'un champ personnalisé, ou cochez des lignes sur la page actuelle. L'avis en haut de l'onglet Exporter indique à quoi l'export sera appliqué.
5. Exportez. Dans l'onglet Exporter (Export), choisissez le séparateur et cliquez sur Exporter en CSV (Export to CSV). WOLF traite les articles par lots de dix et affiche la progression ; gardez l'onglet ouvert jusqu'à 100 pour cent. Cliquez ensuite sur télécharger (download).

La documentation Export décrit l'onglet lui-même ; un exemple concret, une liste de prix exportée à partir d'annonces immobilières, se trouve dans l'édition en masse d'annonces immobilières.

Noms de colonnes : pourquoi les champs personnalisés s'intitulent « Meta: key »

Les colonnes standard et les taxonomies reçoivent les titres que vous voyez dans l'onglet Réglages, y compris les titres que vous y avez modifiés. Les colonnes de champs méta s'intitulent toujours Meta: suivi de la clé méta, par exemple Meta: wpcf-number-of-bathrooms pour un champ Toolset, quel que soit le titre donné au champ dans WOLF. Le titre est une étiquette du tableau WOLF ; l'article ne stocke que la clé et la valeur, et l'export écrit ce qui appartient aux articles. La colonne intégrée Miniature est elle aussi stockée comme méta, son en-tête est donc Meta: _thumbnail_id.

Si le fichier est destiné à quelqu'un qui a besoin d'en-têtes lisibles, renommez la première ligne dans le tableur. Comme l'ordre des colonnes provient de votre profil enregistré, les en-têtes se trouvent toujours aux mêmes endroits, et un modèle de tableur enregistré ou une courte macro peut les renommer à chaque fois.

À quoi ressemblent les valeurs

L'export écrit les données telles que WordPress les stocke, avec quelques conversions pour les rendre lisibles :

Ouvrir le CSV dans Excel ou LibreOffice

Le fichier est encodé en UTF-8. LibreOffice Calc demande le jeu de caractères et le séparateur à l'ouverture d'un CSV ; choisissez UTF-8 et le séparateur avec lequel vous avez exporté. Excel, ouvert par un double-clic, devine au lieu de demander, et les caractères accentués ou non latins peuvent se transformer en chaînes comme é. Importez plutôt le fichier : dans Excel, utilisez Données → À partir d'un fichier texte/CSV (Data → From Text/CSV), réglez Origine du fichier (File origin) sur 65001: Unicode (UTF-8), vérifiez le séparateur et cliquez sur Charger (Load).

Dans les pays où la virgule est le séparateur décimal, Excel attend des points-virgules entre les colonnes ; exportez donc avec ; dans ce cas. Utilisez |, ^ ou ~ lorsque le séparateur apparaîtrait sinon souvent dans vos valeurs et que l'outil de destination vous permet de le choisir.

Exporter en XML

Exporter en XML (Export to XML) écrit les mêmes articles dans la structure d'un fichier d'export WordPress : un élément par article avec les champs standard activés (titre, contenu, extrait, dates, slug, statut et autres), ses termes sous forme d'éléments category portant le nom du terme, la taxonomie et le slug du terme, et les champs méta activés de l'onglet Champs méta sous forme de paires clé et valeur wp:postmeta. Les valeurs de tableau sont sérialisées. Une fois l'export terminé, cliquez sur télécharger le XML (download XML).

C'est un fichier de données destiné aux outils qui lisent le XML, non un export complet du site : il ne contient que les colonnes que vous avez activées et n'est pas prévu pour Outils → Importer (Tools → Import). Pour déplacer du contenu entre des sites WordPress, utilisez Outils → Exporter (Tools → Export). L'en-tête du fichier nomme l'utilisateur qui a exporté, avec son identifiant et son adresse e-mail ; gardez-le à l'esprit avant d'envoyer le fichier à quelqu'un d'extérieur au site.

Ce que l'export ne fait pas

• Pas d'import. WOLF modifie les articles existants et les exporte ; il ne peut pas créer ni mettre à jour des articles à partir d'un fichier CSV. Effectuez plutôt les modifications dans le tableau, cellule par cellule, ou pour de nombreux articles à la fois dans l'onglet Édition en masse. Pour créer quelques articles, le bouton Nouvel article (New Post) du panneau d'outils ajoute des brouillons vides que vous remplissez dans le tableau. Pour créer de nombreux articles à partir d'un tableur, utilisez une extension d'import CSV.
• Pas de colonnes calculées. Une valeur dérivée de deux champs, comme un pourcentage de remise calculé à partir d'un ancien et d'un nouveau prix, n'est pas remplie automatiquement. Calculez-la dans le tableur ; ou, pour enregistrer une telle valeur une fois dans les articles, utilisez les opérations numériques de l'onglet Édition en masse, qui peuvent modifier un champ numérique et le combiner avec un autre champ numérique à l'aide de +, -, * ou /, une opération à la fois.
• Pas de stockage permanent du fichier. Le fichier est écrit dans le dossier ext/export/__exported_files/ de l'extension et peut être ouvert à partir de son URL. WOLF le supprime au début de l'export suivant et efface les fichiers de plus de deux jours ; téléchargez-le donc immédiatement.

Liste de contrôle

• Les champs personnalisés sont enregistrés dans l'onglet Champs méta et activés comme colonnes dans Réglages.
• Les colonnes sont dans le bon ordre et enregistrées comme profil de colonnes pour la prochaine fois.
• L'avis de l'onglet Exporter indique la bonne sélection : articles cochés, filtrés ou tous les articles du bon type de publication.
• Le CSV est ouvert avec UTF-8 et le séparateur que vous avez choisi.
• Les en-têtes lisibles sont renommés dans le tableur ; les colonnes méta arrivent toujours sous la forme Meta: key.

Si une colonne manque dans le fichier ou si une valeur paraît erronée, ouvrez un sujet sur le forum d'assistance de WOLF en indiquant le type de publication, la colonne et un exemple d'article.