Iniciar sesión

Integrar Composer con Canvas o un tema de terceros

Composer y el tema activo tienen responsabilidades distintas:

  • Composer gestiona el Config Set, Site Contract, los Blueprints, la validación, auditoría y ejecución limitada a borradores.
  • El tema gestiona plantillas, partes de plantilla, patrones, estilos, tokens de theme.json y renderizado final.

Composer nunca edita archivos del tema y un tema nunca activa silenciosamente configuraciones de Composer.

Agent Canvas​

Agent Canvas es una implementación de referencia y entorno inicial opcional. Proporciona un conjunto coherente de plantillas, patrones y estilos creados con bloques del núcleo y un manifiesto de presentación de solo lectura para probar y demostrar el modelo completo de contratos de Composer. No es obligatorio, no forma parte de la cadena de dependencias de runtime de Composer y no sustituye el tema, los patrones ni el proceso de diseño de una agencia.

Composer puede integrarse con un tema creado por una agencia o personalizado siempre que el sitio exponga un contrato de contenido claro mediante sus patrones, tipos de contenido y configuración de Composer. El tema activo y los patrones aprobados por la agencia definen el sistema visual. Un manifiesto de Canvas solo confirma las asignaciones semánticas de presentación que Composer puede inspeccionar; no debe contener credenciales de proveedores, prompts, callbacks de runtime ni políticas ejecutables.

Una configuración de Canvas debe seguir este orden:

  1. Instale y active Canvas.
  2. En Composer, vuelva a escanear el sitio y confirme el tema Canvas, las plantillas, los patrones y los bloques del núcleo.
  3. Cree un Config Set inactivo desde Universal Gutenberg, SmartCloud Recommended o Detected Theme Starter, o créalo manualmente.
  4. Revise el Site Contract generado y cada Blueprint en lugar de suponer que el preset se ajusta al sitio.
  5. Confirme que las plantillas de destino y los slugs de patrones de los Blueprints existen en la versión activa de Canvas.
  6. Valide y active explícitamente el Config Set.
  7. Realice una prueba de borrador y vista previa para cada tipo de página antes de usarlo en un flujo habitual.

Mantenga los contratos de WP Suite específicos del sitio separados de los presets generales de Canvas. Un contrato privado especializado no debe convertirse en la configuración predeterminada de una instalación pública y limpia de Canvas.

Temas de bloques de terceros​

Composer puede funcionar con un tema de bloques Gutenberg estándar o de terceros sin Canvas. La compatibilidad depende de las capacidades, no de la marca.

Comienza con un contrato deliberadamente pequeño:

  1. Active el tema elegido y vuelva a escanear Theme & providers.
  2. Inspeccione las plantillas, patrones y bloques registrados y los presets de theme.json.
  3. Seleccione Detected Theme Starter cuando Composer encuentre un patrón seguro del tema o comienza con Universal Gutenberg.
  4. Defina un tipo de página sencillo usando solo capacidades confirmadas.
  5. Prefiere los bloques del núcleo y patrones estables del tema frente a HTML copiado o estilos en línea.
  6. Valide, active y cree un borrador de prueba.
  7. Amplía el contrato solo después de que la vista previa demuestre que el tema actual renderiza correctamente el primer Blueprint.

Detected Theme Starter solo acepta un patrón del tema con una única raíz y bloques del núcleo; excluye patrones dinámicos de consultas, navegación, plantillas, HTML, shortcodes y utilidades ocultas; añada el contrato H1 obligatorio y elimine del patrón de trabajo generado los estilos en línea que no procedan de presets. Es normal disponer de compatibilidad parcial. Un tema puede admitir un Blueprint estándar de página y artículo, pero no un diseño especializado de producto o arquitectura. No debilite la validación para ocultar una capacidad ausente: añada al tema un patrón o plantilla adecuados o elimina el requisito del Config Set de trabajo.

Reglas de patrones y plantillas​

Un patrón permitido debe estar registrado en el sitio actual, y cada bloque anidado en él también debe estar permitido por el Blueprint. Las secuencias obligatorias deben contener únicamente patrones que toda versión válida del borrador necesite realmente.

Use una plantilla sin título cuando el patrón de contenido proporcione el H1. Si la plantilla del tema renderiza el título de la entrada, no añada otro H1 dentro del contenido. Composer valida el árbol ensamblado completo, pero el administrador debe elegir una combinación de plantilla y patrón que evite títulos duplicados en el renderizado final.

Cambios de tema​

Después de cambiar o actualizar un tema:

  1. mantenga sin cambios el Config Set actualmente activo;
  2. vuelva a escanear el sitio;
  3. clone el Config Set activo;
  4. actualice en el clon las referencias a plantillas, patrones, bloques y presets;
  5. valide cada Blueprint afectado;
  6. previsualiza borradores representativos;
  7. active el clon solo después de revisarlo.

Si los temas anterior y nuevo exponen capacidades distintas, conserva ambos Config Sets para compararlos y poder hacer rollback. Cambiar de tema nunca debe reescribir ni activar una configuración por sí solo.

Plugins proveedores​

Los plugins proveedores registran sus tipos de contenido, taxonomías asociadas, campos visibles mediante REST, almacenamiento y contrato de destino de las relaciones, bloques y Abilities empresariales específicas. Composer gestiona la ejecución genérica de campos, relaciones y términos de taxonomía gobernados. Los proveedores no deben duplicar las Abilities de Composer para buscar, crear o asignar relaciones o taxonomías; el Site Contract activo decide qué taxonomías ya registradas puede usar el flujo genérico. Composer delega únicamente operaciones de componentes o negocio que sean realmente específicas de un proveedor. Un Blueprint solo puede requerir un bloque de proveedor cuando el plugin está instalado, registrado y preparado. Consulte la documentación del proveedor sobre servicios externos y privacidad antes de activar contenido respaldado por él.