Blog technique
Vérifier la modification avant de l’écrire dans WordPress
En bref
Quand le propriétaire d’un site choisit d’appliquer une suggestion, nous récupérons le contenu WordPress actuel et vérifions où la modification doit se faire. Nous écrivons lorsque la cible est claire, et proposons le texte à copier quand une modification manuelle est nécessaire.
Encadrer la connexion et la cible
Nous stockons le mot de passe d’application WordPress sous forme chiffrée et l’utilisons pour appeler l’API REST en HTTPS sur l’hôte enregistré. Au moment d’appliquer, nous vérifions l’état de l’abonnement et que la page de la proposition appartient bien à ce site.
Pour les articles et les pages, nous comparons l’URL renvoyée par WordPress. Pour la page d’accueil, nous lisons le réglage de page d’accueil de WordPress.
Planifier à partir de la valeur actuelle
Pour les titres et les descriptions, le texte d’origine doit correspondre à une valeur actuelle. Pour une modification du contenu d’un article, nous analysons le HTML, cherchons une seule correspondance admissible dans un nœud de texte visible et comparons le nombre de nœuds non textuels avant et après la modification.
L’écriture du contenu exige aussi l’autorisation de conserver le HTML. Si le HTML public contient un marqueur reconnu de constructeur de pages, ou si le texte d’origine apparaît à deux endroits admissibles, nous proposons le texte pour que le propriétaire du site le copie dans son éditeur.
Vérifier la réponse et limiter l’annulation
Nous enregistrons la modification prévue avant d’écrire, puis comparons la valeur enregistrée renvoyée avec la valeur attendue. Si elles diffèrent, nous tentons de restaurer la valeur précédente et signalons l’échec ; la restauration elle-même peut échouer. Elle ne peut pas non plus empêcher complètement d’écraser une modification faite entre-temps.
L’annulation compare une empreinte (hash) de tout le champ ciblé et ne l’écrase pas s’il a changé depuis l’écriture. Une modification faite entre la lecture et l’écriture peut encore entrer en concurrence avec ce processus. Un contenu appliqué à la main à partir d’une copie échappe à ce mécanisme d’annulation.
Suivre une modification fictive du contenu
Supposons que le contenu enregistré de la page fictive d’un atelier de réparation soit « <p>Nous réparons les vélos.</p> ». Le texte d’origine proposé est « Nous réparons les vélos. » et le remplacement « Nous entretenons les vélos. ». Si l’URL correspond, que le texte d’origine apparaît dans un seul nœud de texte visible admissible et que les autres conditions sont remplies, le système planifie ce remplacement. Un plan ne garantit pas que l’écriture réussisse.
Si la phrase d’origine apparaît deux fois, le système ne peut pas choisir et propose le texte pour une copie manuelle. Une valeur actuelle qui a changé, une description SEO prise en charge mais illisible, ou l’absence d’autorisation de conserver le HTML peuvent aussi empêcher l’application automatique. Comparez la proposition avec l’éditeur WordPress et choisissez l’emplacement voulu.
Contrôler la page et restaurer en connaissance de cause
Avant d’appliquer, vérifiez l’URL et les deux versions. Après l’application, ouvrez la page publique et examinez la phrase modifiée ainsi que la mise en page autour. Un cache peut retarder ce que voient les visiteurs : vérifiez séparément la valeur enregistrée et l’affichage public.
Si l’annulation signale une valeur modifiée ou échoue, n’écrasez pas aveuglément les modifications suivantes. Comparez le champ WordPress actuel avec les révisions disponibles et décidez avec la personne qui gère le site de ce qu’il faut restaurer. La restauration automatique peut elle-même échouer ; les modifications collées à la main échappent au mécanisme d’annulation de ce service.