CMS et API

Guide de mise en œuvre du WordPress.

Choisissez délibérément la livraison par widget ou API, conservez la page d'origine canonique et publiez les versions linguistiques via des révisions.

Clarifier la tâche et la décision

Ce guide transforme le guide de mise en œuvre du wordpress en un flux de travail opérationnel révisable. Il relie les décisions de domaine, la propriété, les preuves et l'acceptation afin que le résultat continue de fonctionner en production.

Choisissez délibérément la livraison par widget ou API, conservez la page d'origine canonique et publiez les versions linguistiques via des révisions.

Méthode pratique

  1. 1

    Types de sources d'inventaire, identifiants, champs, paramètres régionaux, propriétaires et états de publication.

  2. 2

    Choisissez le modèle de livraison parmi le volume, la latence, le contrôle éditorial et la tolérance aux pannes.

  3. 3

    Mappez l’enregistrement source à un enregistrement de version linguistique distincte avec un lien durable.

  4. 4

    Ajoutez l'authentification, l'idempotence, les nouvelles tentatives, l'invalidation du cache, la journalisation et les contrôles d'accès.

  5. 5

    Testez la publication, les modifications de source, les résultats indisponibles, la restauration, le fonctionnement du clavier et la surveillance avant la publication.

Exemple ou outil

Un flux de travail Gutenberg cartographie les pages sources, les états de révision, les clés de cache et la navigation dans les langues. Dans l'outil, enregistrez également la référence, le propriétaire, la décision, les preuves, le problème en suspens et la date d'approbation. Utilisez une page ou une transaction réelle pour que l'équipe voie les dépendances, les exceptions et le travail de maintenance qui suit la publication.

Point de décisionEnregistrerCritère d'acceptation
RéférenceÉtat actuel observéSource et date d'enregistrement
DécisionOption sélectionnée et justificationRisque et public pris en compte
PreuveTester, documenter ou mesurerRévisable et spécifique à la version
ApprobationNom, rôle et dateTous les critères obligatoires sont remplis

Choisissez la livraison d'un widget, d'un plugin ou d'un API côté serveur

Utilisez un widget lorsque la vitesse de déploiement est importante, que les pages sources ont déjà des identifiants durables et qu'une dépendance côté client est acceptable. Utilisez un plugin WordPress lorsque les éditeurs ont besoin de génération et de révision dans l'interface d'administration. Utilisez la livraison API côté serveur lorsque les versions linguistiques doivent être indexées, mises en cache, incluses dans les flux et rendues même lorsque JavaScript n'est pas disponible. Les grands éditeurs combinent souvent un plugin pour le flux de travail avec un rendu côté serveur pour la livraison.

Documentez le choix par rapport au contrôle éditorial, aux performances, à l'accessibilité, à la recherche, au comportement en cas d'échec, au flux de données et à la propriété de la maintenance. La page originale reste la source faisant autorité. Une version linguistique obtient sa propre publication ou enregistrement structuré, une URL stable, un statut de révision et un lien source-révision. Évitez de stocker du contenu alternatif uniquement dans un champ personnalisé sans version ou dans le cache du navigateur, car les réviseurs ne peuvent pas l'approuver, le restaurer ou l'auditer de manière fiable.

ModèleMeilleur ajustementContrôle primaire
WidgetAjout rapide à un site contrôléÉtat de repli et de défaillance accessible
Flux de travail du pluginLes éditeurs travaillent entièrement dans WordPressRôles, noms occasionnels, capacités et révisions
API côté serveurPages indexées, pouvant être mises en cache et résilientesOpérations de file d'attente, d'invalidation du cache et de déploiement

Modéliser les relations sources et les états éditoriaux

Créez un type de publication en version linguistique ou utilisez une structure multilingue qui prend en charge les relations sources explicites. Stockez l’ID de publication source, l’ID de révision source, les paramètres régionaux cible, le mode de langue, l’ID de résultat, la version du glossaire, l’état de révision, les approbateurs, la révision publiée et le déclencheur de révision. Conservez la structure de bloc transformée dans la mesure du possible afin que les titres, listes, liens, tableaux et avis restent sémantiques plutôt que d'être aplatis dans un seul champ HTML.

Définissez les statuts pour demandé, génération, brouillon, révision du sujet, révision de la langue, approuvé, publié, périmé et échoué. Mappez chaque transition sur une fonctionnalité WordPress, et pas simplement sur un bouton visible. Un générateur peut créer un brouillon mais ne peut pas l'approuver. Lorsque la source change, comparez sa révision avec la révision source approuvée et déplacez la version linguistique vers obsolète ou comme révision requise. Ne publiez pas silencieusement un résultat régénéré.

  1. 1

    Enregistrez l'enregistrement de la version linguistique et les métadonnées requises avec les autorisations de nettoyage et REST.

  2. 2

    Mappez les blocs Gutenberg pris en charge et définissez le comportement des blocs non pris en charge.

  3. 3

    Configurez les rôles et les transitions de statut autorisées.

  4. 4

    Générez dans une révision distincte et présentez une comparaison des sources.

  5. 5

    Publiez uniquement après les approbations requises pour le niveau de risque du contenu.

Mettez en cache en toute sécurité et fournissez une navigation linguistique durable

Créez des clés de cache à partir du site, de l'ID de publication source, de la révision source, des paramètres régionaux, du mode linguistique et de la version du moteur de rendu. Invalidez la page de langue associée lorsque sa révision approuvée change, sa source change, un bloc partagé change ou lorsqu'une règle terminologique pertinente est republiée. Si le traitement s'exécute de manière asynchrone, diffusez la dernière version approuvée pendant que le nouveau brouillon est examiné. Ne remplacez jamais le contenu approuvé par un état vide car la génération n'est pas disponible.

Ajoutez des liens linguistiques sous forme d'ancres ordinaires rendues par le serveur avec des noms clairs tels que « langage clair » et « FALC ». Incluez des liens réciproques vers la page source et corrigez les métadonnées dans une autre langue. Conservez le focus du clavier après un changement dans la page et annoncez un changement d'itinéraire uniquement via le titre et l'en-tête normaux de la page. Une version manquante doit expliquer qu'elle n'est pas disponible et établir un lien vers la source, sans masquer le contrôle ou revenir en arrière silencieusement.

  • Les clés de cache incluent les versions source et de rendu.

  • La dernière page approuvée survit à API et aux pannes de file d'attente.

  • Les liens linguistiques fonctionnent sans JavaScript et utilisent une terminologie approuvée.

  • Les métadonnées canoniques et alternatives reflètent la relation réelle.

  • Les modifications des blocs partagés et du glossaire déclenchent les tâches de révision concernées.

Testez le chemin complet de publication et de restauration

Utilisez une copie intermédiaire avec des blocs Gutenberg représentatifs, des champs personnalisés, des formulaires intégrés, des blocs réutilisables et des publications restreintes. Génération de tests, application des rôles, révision des commentaires, publication planifiée, aperçu, invalidation du cache, mise à jour de la source, marquage obsolète, suppression, restauration et restauration. Confirmez que les points de terminaison REST rejettent les lectures et écritures non autorisées et que les tâches en arrière-plan ne peuvent pas être déclenchées sur plusieurs sites sans identifiants de serveur ou de nonce valides.

Avant la production, définissez la surveillance des files d'attente, la propriété des erreurs, la rotation des informations d'identification, les tests de mise à jour du plugin, la sauvegarde de la base de données et une procédure de désactivation sécurisée. L'acceptation nécessite un rendu correct aux points d'arrêt communs, une navigation au clavier et avec un lecteur d'écran, aucun changement de mise en page par rapport au contenu tardif, des titres structurés valides, une approbation traçable et la restauration de la dernière révision approuvée. Enregistrez les configurations WordPress, PHP, éditeur, plugin multilingue et mise en cache prises en charge.

Rôles, preuves et approbation

Séparez la génération de la publication. Une réponse réussie est un brouillon et non une approbation. Stockez l'identifiant et la version de la source, les paramètres de transformation, l'identifiant du résultat, l'état de révision, l'approbateur et l'heure de publication. Lorsque la source change, marquez la version linguistique pour révision au lieu de remplacer silencieusement le contenu approuvé. Cela rend la restauration et l’audit possibles sur toutes les plateformes.

Opérations et entretien

Le travail ne s'arrête pas à la publication. Liez la version linguistique ou la configuration à sa source, surveillez les mesures de qualité et de service et définissez des déclencheurs de révision concrets. Les déclencheurs incluent les changements de source, les changements juridiques, les nouveaux besoins du public, les questions d'assistance récurrentes, les changements techniques et les incidents. Un propriétaire nommé évalue le déclencheur, ouvre une nouvelle révision si nécessaire et enregistre une nouvelle approbation.

Liste de contrôle avant publication

  • L'intégration utilise des identifiants de source durables.

  • Les informations d'identification sont stockées côté serveur et alternées.

  • Le comportement en matière de délai d'attente, de nouvelle tentative et de limite de débit est défini.

  • Les demandes répétées sont idempotentes.

  • Le contenu généré entre dans un état de révision.

  • Les modifications de source invalident ou rouvrent la version.

  • La navigation linguistique fonctionne par clavier et technologie d'assistance.

  • La surveillance couvre les échecs, les files d'attente, la latence et le contenu obsolète.

Sources de référence

  1. Documentation Simple8 API
  2. Modèles de livraison Simple8
  3. Directives pour l'accessibilité du contenu Web (WCAG) 2.2

Mettre le guide en pratique

Testez Simple8 avec un contenu représentatif et utilisez la liste de contrôle pour planifier un flux de production contrôlé.

Testez votre propre texte