Skip to content

Pourquoi l'alt text ne change pas dans la Médiathèque

C'est la question la plus fréquente à propos de Bialty. Vous installez le plugin, configurez une règle, sauvegardez, puis ouvrez la Médiathèque — et le champ alt text a exactement la même apparence qu'avant. Rien n'a changé.

Ce n'est pas un bogue. C'est le fonctionnement normal du produit.

Bialty n'écrit pas dans la Médiathèque

Bialty utilise l'injection dynamique frontend. Il se branche sur les filtres de rendu WordPress et modifie le HTML au moment où la page est servie à un visiteur. L'attribut alt est ajouté ou remplacé dans la sortie rendue, mais les métadonnées stockées dans la base WordPress restent intactes.

C'est une décision de conception délibérée. L'état original de la Médiathèque est toujours préservé, le processus est instantanément réversible, et il n'y a aucun risque qu'une réécriture de masse corrompe des années de métadonnées stockées. La contrepartie est que la Médiathèque ne montre jamais la valeur injectée, parce que la valeur n'est pas stockée — elle est générée au moment du rendu.

Où vérifier le résultat réel

La bonne couche de vérification est le HTML frontend rendu. Voici la séquence qui donne une réponse fiable.

Ouvrez la page publiée dans un navigateur — pas l'éditeur WordPress, pas la modale média, pas un aperçu. Utilisez l'URL publique réelle. Si le site utilise une couche de cache (cache de page, cache serveur, CDN, plugin de performance), purgez-la d'abord. Un HTML périmé provenant d'une version en cache ne reflètera pas la règle actuelle.

Une fois sur la page publiée, faites un clic droit sur l'image et sélectionnez « Inspecter » (ou affichez la source de la page). Regardez l'attribut alt sur la balise <img>. Si Bialty fonctionne, l'alt text correspondra à la règle configurée — le focus keyword, le titre du post, le nom d'image, ou la combinaison choisie.

Si l'attribut alt est présent et correct dans le HTML, le plugin fait son travail. Le fait que la Médiathèque montre toujours l'ancienne valeur (ou un champ vide) est normal.

Raisons courantes pour lesquelles le frontend reste aussi inchangé

Si vous vérifiez le HTML rendu et que l'alt text est toujours manquant ou incorrect, le problème n'est pas que Bialty « ne fonctionne pas ». C'est habituellement l'une de ces situations.

Le cache n'a pas été purgé. C'est la cause la plus courante. Le navigateur, le plugin de cache WordPress, le serveur ou le CDN sert une version HTML périmée d'avant l'application de la règle. Purgez toutes les couches de cache et rechargez.

Le type de contenu n'est pas dans le périmètre. L'édition gratuite de Bialty couvre les posts et pages. Les custom post types et les produits WooCommerce nécessitent le périmètre commercial. Si vous testez une page produit avec l'édition gratuite, la règle ne s'appliquera pas.

La source de signal est vide. Si la règle utilise le focus keyword mais que le post n'a pas de focus keyword défini dans Yoast, Rank Math ou AIOSEO, le plugin n'a pas de valeur à injecter. Vérifiez que la source de signal contient effectivement des données pour la page spécifique que vous testez.

Un page builder contourne le chemin de rendu. Certains builders rendent les images via un code personnalisé qui ne passe pas par les filtres de contenu WordPress standards. Si le thème ou le builder contourne the_content ou post_thumbnail_html, Bialty ne peut pas intercepter la sortie.

La page est dans la liste noire ou Bialty est désactivé pour ce post. Le périmètre commercial inclut une fonctionnalité de liste noire et une option de désactivation par post. Vérifiez si la page ou le produit spécifique a été exclu.

Le debug mode est nécessaire. Dans de rares cas, la stratégie de wrapper utilisée par Bialty pour le traitement DOM peut entrer en conflit avec certains thèmes. Le debug mode change l'approche de rendu et peut résoudre le problème. Utilisez-le uniquement pour le dépannage.

Pourquoi ce design est en fait un avantage

Une fois qu'on comprend le modèle, le fait que la Médiathèque reste inchangée devient une force plutôt qu'une source de confusion.

Ça signifie que vous pouvez tester une règle, voir le résultat sur le frontend, et changer d'avis sans aucun nettoyage. Vous pouvez comparer différentes sources de signaux — focus keyword, titre, nom d'image — et passer de l'une à l'autre instantanément. Le plugin est sûr à essayer sur un site en production parce que le pire scénario est simplement de le désactiver, avec zéro effet résiduel sur les données stockées.

La phrase qui résout la plupart de la confusion

Si vous ne retenez qu'une chose de cet article : Bialty change le HTML frontend rendu, pas la Médiathèque. Vérifiez la page publiée, pas l'éditeur média.

Guide complet de dépannage →