CMS y API

Guía de implementación de WordPress.

Elija deliberadamente la entrega de widget o API, mantenga canónica la página original y publique versiones de idiomas mediante revisiones.

Aclarar la tarea y la decisión.

Esta guía convierte la guía de implementación de wordpress en un flujo de trabajo operativo revisable. Conecta decisiones de dominio, propiedad, evidencia y aceptación para que el resultado continúe funcionando en producción.

Elija deliberadamente la entrega de widget o API, mantenga canónica la página original y publique versiones de idiomas mediante revisiones.

Proceso práctico

  1. 1

    Tipos de fuentes de inventario, identificadores, campos, configuraciones regionales, propietarios y estados de publicación.

  2. 2

    Elija el patrón de entrega entre volumen, latencia, control editorial y tolerancia a fallos.

  3. 3

    Asigne el registro de origen a un registro de versión de idioma independiente con un vínculo duradero.

  4. 4

    Agregue autenticación, idempotencia, reintento, invalidación de caché, registro y controles de acceso.

  5. 5

    Publicación de prueba, cambios de fuente, resultados no disponibles, reversión, operación del teclado y monitoreo antes del lanzamiento.

Ejemplo o herramienta

Un flujo de trabajo de Gutenberg asigna páginas de origen, estados de revisión, claves de caché y navegación de idiomas. En la herramienta, registre también la línea de base, el propietario, la decisión, la evidencia, el problema abierto y la fecha de aprobación. Utilice una página o transacción real para que el equipo vea las dependencias, las excepciones y el trabajo de mantenimiento posterior al lanzamiento.

Punto de decisiónRegistroCriterio de aceptación
BaseEstado actual observadoFuente y fecha de registro
DecisiónOpción seleccionada y justificaciónRiesgo y audiencia considerados.
EvidenciaProbar, documentar o medirRevisable y específico de la versión
AprobaciónNombre, cargo y fechaSe cumplieron todos los criterios obligatorios.

Elija la entrega de widget, complemento o API del lado del servidor

Utilice un widget cuando la velocidad de implementación sea importante, las páginas de origen ya tengan identificadores duraderos y una dependencia del lado del cliente sea aceptable. Utilice un complemento WordPress cuando los editores necesiten generación y revisión dentro de la interfaz de administración. Utilice la entrega API del lado del servidor cuando las versiones de idiomas deban indexarse, almacenarse en caché, incluirse en feeds y representarse incluso cuando JavaScript no esté disponible. Los grandes editores suelen combinar un complemento para el flujo de trabajo con renderizado del lado del servidor para la entrega.

Documente la elección frente al control editorial, el rendimiento, la accesibilidad, la búsqueda, el comportamiento de falla, el flujo de datos y la propiedad del mantenimiento. La página original sigue siendo la fuente autorizada. Una versión de idioma obtiene su propia publicación o registro estructurado, URL estable, estado de revisión y enlace de revisión de la fuente. Evite almacenar contenido alternativo solo en un campo personalizado sin versión o en la caché del navegador porque los revisores no pueden aprobarlo, restaurarlo ni auditarlo de manera confiable.

PatrónMejor ajustecontrol primario
widgetAdición rápida a un sitio controladoEstado de falla y respaldo accesible
Flujo de trabajo del complementoLos editores trabajan completamente en WordPressRoles, nonces, capacidades y revisiones
API del lado del servidorPáginas indexadas, almacenables en caché y resistentesOperaciones de implementación, invalidación de caché y cola

Modelo de relaciones de origen y estados editoriales.

Cree un tipo de publicación de versión de idioma o utilice una estructura multilingüe que admita relaciones de origen explícitas. Almacene el ID de la publicación de origen, el ID de la revisión de la fuente, la configuración regional de destino, el modo de idioma, el ID del resultado, la versión del glosario, el estado de la revisión, los aprobadores, la revisión publicada y el activador de la revisión. Mantenga la estructura de bloque transformada siempre que sea posible para que los encabezados, listas, enlaces, tablas y avisos sigan siendo semánticos en lugar de agruparse en un campo HTML.

Defina estados para solicitado, generando, borrador, revisión de tema, revisión de idioma, aprobado, publicado, obsoleto y fallido. Asigne cada transición a una capacidad WordPress, no simplemente a un botón visible. Un generador puede crear un borrador pero no puede aprobarlo. Cuando la fuente cambie, compare su revisión con la revisión de la fuente aprobada y mueva la versión del idioma a obsoleta o se requiera revisión. No publique silenciosamente un resultado regenerado.

  1. 1

    Registre el registro de versión de idioma y los metadatos requeridos con permisos de desinfección y REST.

  2. 2

    Asigne bloques de Gutenberg compatibles y defina el comportamiento de los bloques no compatibles.

  3. 3

    Configure roles y transiciones de estado permitidas.

  4. 4

    Generar en una revisión separada y presentar una comparación de fuentes.

  5. 5

    Publique solo después de las aprobaciones requeridas para el nivel de riesgo del contenido.

Almacene en caché de forma segura y proporcione una navegación de idiomas duradera

Cree claves de caché a partir del sitio, ID de la publicación fuente, revisión de la fuente, configuración regional, modo de idioma y versión del renderizador. Invalide la página de idioma relacionada cuando cambie su revisión aprobada, su fuente cambie, cambie un bloque compartido o se vuelva a publicar una regla terminológica relevante. Si el procesamiento se ejecuta de forma asincrónica, entregue la última versión aprobada mientras se revisa el nuevo borrador. Nunca reemplace el contenido aprobado con un estado vacío porque la generación no está disponible.

Agregue enlaces de idiomas como anclajes ordinarios representados por el servidor con nombres claros como "lenguaje claro" y "lectura fácil". Incluya enlaces recíprocos a la página de origen y corrija los metadatos en idiomas alternativos. Conserve el foco del teclado después de un cambio en la página y anuncie un cambio de ruta solo a través del título y encabezado de la página normal. Una versión faltante debe explicar que no está disponible y vincularse a la fuente, no ocultar el control ni retroceder silenciosamente.

  • Las claves de caché incluyen versiones de origen y de renderizado.

  • La última página aprobada sobrevive al API y a las interrupciones de la cola.

  • Los enlaces de idiomas funcionan sin JavaScript y utilizan terminología aprobada.

  • Los metadatos canónicos y alternativos reflejan la relación real.

  • Los cambios en el bloque compartido y el glosario desencadenan tareas de revisión afectadas.

Pruebe la ruta completa de publicación y reversión

Utilice una copia provisional con bloques representativos de Gutenberg, campos personalizados, formularios integrados, bloques reutilizables y publicaciones restringidas. Generación de pruebas, aplicación de roles, revisión de comentarios, publicación programada, vista previa, invalidación de caché, actualización de fuente, marcado obsoleto, eliminación, restauración y reversión. Confirme que los puntos finales REST rechacen lecturas y escrituras no autorizadas y que los trabajos en segundo plano no se puedan activar entre sitios sin credenciales nonce o de servidor válidas.

Antes de la producción, defina el monitoreo de colas, la propiedad de los errores, la rotación de credenciales, las pruebas de actualización de complementos, la copia de seguridad de la base de datos y un procedimiento de desactivación segura. La aceptación requiere una representación correcta en los puntos de interrupción comunes, navegación con teclado y lector de pantalla, ningún cambio de diseño debido al contenido tardío, encabezados estructurados válidos, aprobación rastreable y restauración de la última revisión aprobada. Registre las configuraciones de WordPress, PHP, editor, complemento multilingüe y almacenamiento en caché compatibles.

Roles, evidencia y aprobación

Mantenga la generación separada de la publicación. Una respuesta exitosa es un borrador, no una aprobación. Almacene el identificador de origen y la versión, la configuración de transformación, el identificador de resultado, el estado de revisión, el aprobador y la hora de publicación. Cuando cambie la fuente, marque la versión del idioma para su revisión en lugar de reemplazar silenciosamente el contenido aprobado. Esto hace posible la reversión y la auditoría en todas las plataformas.

Operaciones y mantenimiento

El trabajo no termina con la publicación. Vincule la versión o configuración del idioma a su fuente, monitoree las medidas de calidad y servicio, y defina desencadenantes de revisión concretos. Los desencadenantes incluyen cambios de fuente, cambios legales, nuevas necesidades de audiencia, preguntas de soporte recurrentes, cambios técnicos e incidentes. Un propietario designado evalúa el desencadenante, abre una nueva revisión cuando es necesario y registra la aprobación renovada.

Lista de comprobación para publicar

  • La integración utiliza identificadores de fuente duraderos.

  • Las credenciales se almacenan en el lado del servidor y se rotan.

  • Se definen el comportamiento de tiempo de espera, reintento y límite de velocidad.

  • Las solicitudes repetidas son idempotentes.

  • El contenido generado entra en estado de revisión.

  • Los cambios de fuente invalidan o vuelven a abrir la versión.

  • La navegación por idiomas funciona mediante teclado y tecnología de asistencia.

  • El monitoreo cubre fallas, colas, latencia y contenido obsoleto.

Fuentes de referencia

  1. Documentación de Simple8 API
  2. Patrones de entrega Simple8
  3. Pautas de accesibilidad al contenido web (WCAG) 2.2

Pon la guía en práctica.

Pruebe Simple8 con contenido representativo y utilice la lista de verificación para planificar un flujo de trabajo de producción controlado.

Prueba tu propio texto