Dépannage
Avant de parcourir la liste, circonscrivez le problème. Presque tous les signalements tombent dans l'une de deux moitiés : soit les règles n'ont jamais été créées, et c'est un problème de sync, soit les règles existent mais les liens ne se rendent pas, et c'est un problème d'affichage.
Le journal d'activité vous dit dans quelle moitié vous êtes. Si la règle y figure, le sync a fonctionné et le problème est en aval. Si elle n'y figure pas, rien en aval n'y changera quoi que ce soit.
Les liens n'apparaissent pas sur le site public
Les règles existent dans le journal mais les pages n'affichent rien. Vérifiez ces quatre points, dans cet ordre.
Le cache. C'est la réponse la plupart du temps. Les liens sont injectés par le filtre the_content, et une page en cache n'exécute jamais ce filtre. Videz les transients du plugin avec Delete Transient Cache dans l'onglet Sync, puis votre plugin de cache (WP Super Cache, LiteSpeed, W3 Total Cache) et votre CDN. Le bouton du plugin ne vide que ses propres transients, il ne peut pas toucher au cache d'un autre plugin.
La sélection des types de contenu. Si seules les Pages sont cochées dans les réglages et que vous regardez un article, l'article n'est pas traité. Vérifiez que la sélection correspond à l'endroit que vous regardez.
Les exclusions. Contrôlez les quatre niveaux : le keyword est-il dans la liste d'exclusion, la page est-elle exclue page par page, l'URL de destination est-elle dans la liste noire, et la balise contenante figure-t-elle dans Exclude HTML Tags ?
L'auto-lien. Le plugin ne lie jamais une page à elle-même. Si la seule destination correspondante est la page où vous êtes, aucun lien n'est créé, et c'est le comportement correct, pas un défaut.
Le FETCH ne trouve aucun élément
Rien à synchroniser, donc rien en aval ne peut fonctionner.
Un plugin SEO supporté doit être actif : Yoast SEO, Rank Math, All in One SEO ou SEOPress. Auto Focus Keyword en cherche un à l'exécution et n'a nulle part où écrire sans lui.
Confirmez ensuite qu'il existe du contenu publié dans les types sélectionnés. Sur Automatic Internal Links, le FETCH cherche les contenus qui possèdent un focus keyword : un site dont le champ est encore vide partout ne renvoie donc rien, par conception. C'est le cas traité par aucun focus keyword défini.
Les focus keywords n'apparaissent pas dans le plugin SEO
Vérifiez que le plugin SEO est installé et activé, pas seulement présent. Si aucun des quatre plugins supportés n'est détecté, il n'y a aucun champ où écrire.
Si vous faites tourner plus d'un plugin SEO, vous écrivez peut-être dans l'un et lisez dans l'autre. Fixez une seule source de vérité, comme l'explique la page compatibilité.
Le SYNC se bloque
Le SYNC s'exécute par lots via AJAX. Si un lot échoue, la barre de progression se fige.
Ne fermez pas la page. Cliquez STOP, puis SYNC NOW de nouveau : le traitement reprend là où il s'est arrêté plutôt que de repartir de zéro. S'il se fige régulièrement au même endroit, la cause est généralement côté serveur : vérifiez la limite de mémoire PHP et le temps d'exécution maximal avec votre hébergeur.
Le SYNC est lent sur un gros site
Au-delà d'environ 1 000 éléments, un sync complet prend des minutes plutôt que des secondes. C'est attendu, et le traitement par lots est délibéré pour que le passage reste dans les limites PHP habituelles.
Pro ajoute le traitement en arrière-plan sur une planification cron, avec taille de lot et fréquence configurables, pour que le travail se fasse sans garder un onglet ouvert. Des lots plus petits sur un intervalle plus long, c'est le réglage à privilégier en mutualisé contraint.
Rien ne se passe sur le contenu d'un page builder
Elementor, Divi, WPBakery et les constructeurs similaires peuvent stocker le contenu hors de post_content et l'émettre sans passer par the_content. Dans ce cas, le plugin ne voit jamais le texte, aucun lien ne peut donc être créé.
Confirmez-le rapidement : créez un article Gutenberg ou Classique ordinaire contenant le même keyword et regardez si les liens y apparaissent. Si oui, la variable est le constructeur, pas le plugin. Voir thèmes, page builders et chemin de rendu.
La même chose vaut pour le texte stocké dans des champs ACF, qui est en postmeta et n'est jamais traité.
Des liens sont créés dans les titres
Par défaut, h1, h2 et h3 sont exclus. Si des liens apparaissent dans les titres, le réglage Exclude HTML Tags a très probablement été vidé ou écrasé. Rétablissez les valeurs par défaut, une balise par ligne.
Ajoutez au même champ tout autre conteneur que vous voulez protéger, comme une citation ou un encadré d'appel à l'action.
Trop de liens sur une page
Baissez Max Links. La valeur par défaut est 3, et 2 à 3 convient généralement même sur des pages longues.
Si le compte reste élevé, deux sources s'additionnent probablement : les règles issues du SYNC et les liens manuels portant le même keyword. Vérifiez si Global Override est activé, car il applique une seule valeur de Max Links à tout et remplace les limites que vous aviez définies lien par lien.
Des liens franchissent la frontière des langues
Depuis la version 2.0.8, le plugin écarte ces liens au rendu dès qu'il peut déterminer la langue des deux pages, ce qu'il fait par le filtre que WPML fournit. La première chose à vérifier est donc si ce filtre est disponible sur votre stack.
Si vous êtes sous WPML et voyez encore le lien, le contrôle est permissif en cas de doute : il autorise un lien dès que la langue d'un des deux côtés ne se résout pas. Vérifiez que la destination est bien un contenu réel connu du plugin de langue, et non une URL personnalisée qui ne résout vers rien.
Si vous êtes sous Polylang, le comportement n'a pas été testé et peut différer.
Si aucun plugin de langue ne fournit ce signal, le contrôle ne peut pas s'exécuter et l'ancien comportement s'applique. Supprimez les règles fautives dans le journal d'activité, puis ajoutez les mots communs à la liste d'exclusion de keywords pour qu'elles ne réapparaissent pas.
La procédure de vérification et l'ensemble des contrôles sont dans sites multilingues.
Si rien de tout cela ne s'applique
Deux faits à garder en tête pendant l'investigation. Rien n'est écrit dans votre contenu, aucune expérimentation n'abîme donc vos articles, et désactiver le plugin retire immédiatement tous les liens générés. Il est donc sûr de le désactiver, de confirmer que le comportement disparaît, puis de le réactiver.
Les utilisateurs de la version gratuite peuvent demander de l'aide sur les forums de support WordPress.org ; les licences Pro incluent un support direct. Voir la page contact pour savoir quoi inclure dans un signalement.
Lire ensuite
- Pré-requis et compatibilité, les limites connues
- Lancer le sync, le journal, le cache, le moteur d'arrière-plan
- Contrôler ce qui est lié, les quatre niveaux d'exclusion
- FAQ, les réponses courtes