Modifier en masse les champs personnalisés WordPress de toute extension ou thème

Pour modifier en masse les champs personnalisés WordPress créés par une autre extension ou par votre thème, vous avez besoin de deux informations sur chaque champ : sa clé méta et le format de la valeur qu'il enregistre. Champs Toolset, fiches d'annuaire et de petites annonces, options par article d'un thème : tant qu'ils sont stockés dans les métadonnées de l'article, WOLF peut les afficher sous forme de colonnes, filtrer selon leur valeur et les modifier pour des centaines d'articles à la fois. Ce guide explique comment trouver la clé, lire le format enregistré, choisir les réglages de colonne qui lui correspondent et reconnaître les champs qui ne peuvent pas être modifiés de cette façon.

Ce qu'est un champ personnalisé et ce que WOLF peut modifier

Un champ personnalisé est une ligne de la table wp_postmeta : un ID d'article, une clé méta et une valeur. L'extension propriétaire du champ décide de la clé et du format. Son écran d'édition affiche un contrôle convivial, comme un groupe de cases à cocher, un outil d'envoi d'image ou un sélecteur de date, mais ce qui est enregistré est une valeur dans cette ligne : une liste de clés d'options, un ID de fichier média, une chaîne de date.

WOLF travaille sur cette valeur enregistrée, pas sur le contrôle de l'extension. Cela a deux conséquences :

• Toute valeur des métadonnées d'article peut devenir une colonne WOLF, quelle que soit l'extension qui l'a écrite.
• Les données que l'extension conserve ailleurs, dans ses propres tables de base de données, dans les options ou dans les métadonnées de termes, ne peuvent être ni une colonne, ni un filtre, ni une opération en masse.

Pour Advanced Custom Fields, un guide distinct décrit le format de chaque type de champ : modifier des champs ACF en masse.

Trouver la clé méta d'un champ personnalisé

Utilisez ces trois méthodes dans cet ordre :

1. Lister les clés d'un article. Renseignez le champ sur un article avec une valeur facilement reconnaissable et enregistrez. Dans WOLF, sélectionnez le type de contenu, ouvrez Champs méta (Meta Fields), saisissez l'ID de l'article sous Obtenir les clés méta de n'importe quel article par son ID (Get meta keys from any post by its ID) et cliquez sur Obtenir (Get). Les clés aux noms lisibles s'expliquent généralement d'elles-mêmes. Pour vérifier une clé candidate, conservez-la, enregistrez les champs méta, activez sa colonne dans Réglages (Settings) et regardez la valeur de votre article de test. Les clés qui commencent par un tiret bas sont masquées dans la boîte des champs personnalisés de WordPress, mais de nombreuses extensions y stockent leurs vraies données : ne les ignorez donc pas.
2. Inspecter le champ sur l'écran d'édition. Faites un clic droit sur le champ de saisie dans l'écran d'édition de l'article et choisissez Inspecter. Son attribut name contient souvent la clé ou une partie de celle-ci. Toolset, par exemple, ajoute le préfixe wpcf- au slug du champ : un champ listing-amenities est donc stocké sous wpcf-listing-amenities.
3. Demander à l'auteur. Si aucune des deux méthodes ne fonctionne, la documentation de l'extension ou son support peut vous indiquer la clé et le format.

Faire correspondre la colonne à la valeur enregistrée

Une fois que la colonne affiche la valeur brute, sa forme vous indique comment configurer le champ dans Champs méta (Meta Fields). La documentation des champs méta décrit chaque vue.

Deux remarques sur ce tableau. La vue calendar enregistre un horodatage Unix : n'ajoutez-la que pour les champs qui en stockent déjà un ; pour tout autre format de date, elle changerait le format et l'extension propriétaire ne pourrait plus lire la date. Et pour les valeurs textuelles d'une case à cocher, ajoutez une règle dans Réglages (Settings) → Remplacer la case à cocher méta (Override meta checkbox) : une règle se compose de la clé méta, de deux-points et de la valeur, de sorte que featured:yes fait écrire yes à la case lorsqu'elle est cochée, et que featured:yes^no écrit aussi no lorsqu'elle est décochée. Plusieurs règles sont séparées par des virgules.

Les valeurs sérialisées et JSON s'ouvrent dans une fenêtre clé/valeur ; voir modifier en masse des métadonnées sérialisées.

Exemples tirés d'extensions et de thèmes réels

Cases à cocher et champs oui/non de Toolset

Un champ de cases à cocher Toolset tel que wpcf-listing-amenities stocke une liste sérialisée des options sélectionnées, identifiées par les clés d'option internes de Toolset, et non par leurs titres. Définissez-le en array : la fenêtre n'affiche que les options sélectionnées, sous ces clés. Saisir ces clés à la main est source d'erreurs ; copiez plutôt une sélection : définissez-la sur un article dans l'éditeur Toolset, sélectionnez cet article ainsi que les articles qui doivent recevoir la même sélection dans WOLF, activez l'édition liée (binded editing), ouvrez la fenêtre array de l'article exemple et cliquez sur Appliquer (Apply). La valeur est écrite dans chaque article sélectionné, comme décrit dans définir la même valeur pour plusieurs articles. Un simple champ oui/non tel que wpcf-featured-listing stocke 1 lorsqu'il est coché ; la vue checkbox s'en charge.

Modèles de page et options d'article du thème

WordPress conserve le modèle choisi pour une page ou un article dans _wp_page_template. Ajoutez-le comme chaîne, copiez la valeur exacte depuis un article qui utilise déjà le modèle, puis modifiez les autres en masse avec cette valeur ; default les ramène au modèle par défaut. Les thèmes dotés de leurs propres options par article les regroupent souvent dans un seul champ sérialisé, comme le modèle d'article du thème Newspaper. Ajoutez cette clé en array, modifiez le réglage sur un article et copiez-le sur les autres avec l'édition liée, comme ci-dessus.

Images dans les extensions de fiches et d'annuaires

Les champs d'image stockent généralement des ID de fichiers médias, et non des URL : une URL saisie dans la colonne ne produit donc aucun effet. Saisissez l'ID de l'image de la Médiathèque (Media Library). Si le champ contient l'image principale de l'article, vérifiez s'il s'agit simplement de l'image mise en avant : c'est la colonne native Miniature (Thumbnail) de WOLF. Certaines extensions stockent leurs listes d'images dans un format qui leur est propre ; si la valeur n'est ni un ID, ni une liste séparée par des virgules, ni une liste sérialisée, laissez-la à l'éditeur de l'extension.

Quand un champ personnalisé ne peut pas être modifié en masse

• Les données ne sont pas dans les métadonnées de l'article. Certaines extensions d'annuaire et de fiches, dont GeoDirectory, conservent les détails des fiches dans leurs propres tables de base de données. Si un champ n'apparaît jamais dans Obtenir les clés méta de n'importe quel article par son ID (Get meta keys from any post by its ID), même sur un article où il est renseigné, il n'existe aucune ligne méta à modifier. Seuls les outils de l'extension, ou son support, peuvent aider pour de tels champs.
• Plusieurs lignes partagent une même clé. Quelques extensions enregistrent un champ à valeurs multiples sous forme de plusieurs lignes méta avec la même clé, une par valeur. WOLF traite un champ méta comme une seule valeur : la colonne affiche la première ligne, et l'enregistrement remplace toutes les lignes de cette clé par la valeur unique. Ne modifiez pas ces champs en masse.
• La valeur n'est pas une vraie liste. Des valeurs telles que red|blue ou red, blue sont du texte brut. Modifiez-les comme chaîne ; la vue array ne peut pas y ajouter d'éléments.

Un effet surprend souvent : modifier uniquement des champs méta ne change pas la Date de modification (Date modified) de l'article. WOLF enregistre les métadonnées avec update_post_meta() et déclenche les actions save_post et edit_post afin que les autres extensions puissent réagir, mais il n'enregistre pas la ligne de l'article. Si la date de modification compte, par exemple pour les sitemaps ou les mentions « dernière mise à jour », incluez la colonne Date de modification (Date modified) dans la même opération en masse : WordPress appose l'heure actuelle sur chaque article qu'il enregistre, quelle que soit la date choisie.

Tester sur un article, puis modifier les champs personnalisés en masse

1. Modifiez le champ sur un article dans le tableau WOLF.
2. Ouvrez cet article dans l'écran d'édition de l'extension propriétaire et sur le site public, et vérifiez que la nouvelle valeur s'affiche correctement.
3. Filtrez les articles à modifier dans l'onglet Filtres (Filters) et lancez l'opération dans l'onglet Édition en masse (Bulk Edit).
4. Si le résultat n'est pas bon, annulez toute l'opération dans l'onglet Historique (History).

Si un champ est stocké dans les métadonnées de l'article et ne se comporte pourtant pas comme décrit ici, ouvrez un sujet sur le forum de support de WOLF en indiquant la clé méta, un exemple de sa valeur enregistrée et l'extension qui la crée.