Dépannage

La majorité des problèmes apparents avec Bialty viennent d’une erreur simple :

la mauvaise couche est vérifiée.

Commence par le frontend, pas par la Médiathèque.

Premier contrôle : testes-tu bien le HTML frontend rendu ?

Bialty agit sur la sortie frontend.

La première question est donc :

• regardes-tu une page ou un produit publié ;
• ou regardes-tu l’éditeur, les métadonnées, ou la Médiathèque ?

Si tu n’es pas sur la vraie sortie frontend, tu ne vérifies pas encore la bonne couche.

Deuxième contrôle : purger le cache

Si le site utilise :

• cache de page ;
• cache serveur ;
• CDN ;
• plugin de performance ;

alors purge ces couches avant de juger le résultat.

Troisième contrôle : valider la règle elle-même

Assure-toi que la règle choisie a bien un signal exploitable.

Par exemple :

• si la règle repose sur un focus keyword, confirme que le contenu en a un ;
• si elle repose sur le titre, confirme que le titre est cohérent ;
• si elle repose sur le nom de fichier, confirme que le nom est utile.

Quatrième contrôle : confirmer le périmètre

Le périmètre gratuit et le périmètre commercial ne sont pas les mêmes.

Si tu testes :

• des custom post types ;
• WooCommerce ;
• des templates de boutique ;

alors confirme d’abord que l’édition installée correspond au périmètre testé.

Cinquième contrôle : builders et templates custom

Si le site utilise un builder, un framework de thème, ou une couche de template qui contourne le pipeline standard, Bialty peut ne pas toucher cette sortie de la même manière.

Pattern fréquent :

• les posts standard fonctionnent ;
• un template builder-heavy se comporte différemment ;
• un widget custom produit se comporte différemment ;
• une image dans un header ne change jamais.

Cela signifie souvent que le chemin de sortie diffère.

Quand utiliser le debug mode

Le debug mode sert au dépannage avancé.

Active-le seulement si tu soupçonnes que la stratégie normale de wrapper crée un conflit de :

• style ;
• structure DOM ;
• rendu thème ;
• sortie builder.

Contrôles spécifiques WooCommerce

Pour une boutique, valide séparément :

1. l’image principale du produit ;
2. la galerie ;
3. les produits variables si nécessaire ;
4. les zones related products ;
5. le comportement du cache après modification des réglages.

Checklist pratique

1. Ouvre une vraie page frontend.
2. Purge le cache.
3. Vérifie la règle et le signal.
4. Vérifie l’édition et le périmètre.
5. Teste sans mode édition builder.
6. Utilise le debug mode seulement si le wrapper semble le problème.
7. Isole la zone de template qui échoue.

Le bon état d’esprit

Le dépannage Bialty devient beaucoup plus simple quand tu arrêtes de demander :

pourquoi la Médiathèque n’a pas changé ?

et que tu commences à demander :

quel HTML a vraiment été rendu pour cette requête frontend ?