Conectar bloques del CMS con datos dinámicos de plugins

Un complemento de catálogo, comercio, eventos o noticias a menudo posee datos de dominio útiles. Eso no significa que también deba ser propietario del diseño de la página y del marcado público utilizado para presentar esos datos.

Las fuentes de contenido WebBlocks CMS separan esas responsabilidades. Un complemento expone registros escritos; los editores conectan esos registros a campos de bloques familiares de CMS; la página mantiene el control de la composición, traducción, vista previa y renderizado.

Una fuente de contenido responde qué datos están disponibles. Un bloque responde cómo se presentan esos datos. La página y su árbol de slots responden donde aparece .

Esto permite que un complemento reutilice el comportamiento principal de encabezado, texto enriquecido, imagen, botón, lista de enlaces, cuadrícula, pila y control deslizante en lugar de enviar otro conjunto paralelo de renderizadores.

Edite un bloque compatible y abra su pestaña Settings. En Content source, cada campo compatible puede mantener el valor literal ingresado en Campos de bloque o seleccionar una fuente de complemento, un registro estable y un campo declarado.

Por ejemplo, un título de encabezado se puede conectar a un campo de texto de una entrada de catálogo. Los editores eligen la relación de una lista; ninguna expresión vinculante se escribe a mano.

El valor del bloque original sigue siendo importante: es el recurso editorial. Si el complemento está deshabilitado, la fuente desaparece, el registro no se puede resolver o el valor resuelto está vacío, la página pública sigue mostrando el valor editorial almacenado.

Las fuentes de recopilación manejan listas de registros. Agregue un contenedor con capacidad de colección, como Grid o Stack, cree un hijo directo como plantilla visual y luego seleccione la colección y el hijo para repetir.

Puede establecer un límite de registros, filtrar en un campo declarado, ordenar en cualquier dirección y decidir si un resultado vacío o un error de resolución oculta la plantilla o muestra su respaldo editorial.

Abra un descendiente compatible dentro de la plantilla elegida. Sus opciones Content source ahora incluyen Current collection item. Conecte el encabezado, descripción, imagen o enlace a los campos compatibles en ese registro actual.

En el momento del procesamiento, el CMS clona el subárbol de la plantilla una vez para cada registro resuelto y proporciona ese registro como el elemento actual. Otros niños en el contenedor permanecen contenidos editoriales manuales y mantienen su posición.

Las vinculaciones de entidades actualmente cubren títulos de encabezado; Contenido de texto sin formato y texto enriquecido; Fuente de la imagen, título, texto alternativo y enlace; Etiquetas y URL de botones y enlaces de botones; y el título, texto secundario, descripción y URL del elemento de la lista de enlaces.

El soporte de cobranza se basa en contratos. La sección principal, el contenedor, la pila, el grupo, la cuadrícula y la diapositiva pueden repetir elementos secundarios directos válidos. El control deslizante repite la diapositiva; Columnas repite el elemento de columna; La cuadrícula de funciones repite el elemento de función o el elemento de columna; y la Lista de enlaces repite el elemento de la Lista de enlaces. Los contenedores estructurales que producirían composiciones no válidas no anuncian soporte de colección.

Un complemento habilitado registra una fuente de entidad o una fuente de colección con un identificador de espacio de nombres, un solucionador y definiciones de campos tipadas. Los solucionadores de entidades devuelven opciones de editor seguras y un registro para una clave estable. Los solucionadores de colecciones devuelven registros iterables; Las fuentes grandes pueden implementar el contrato consultable de modo que el filtrado, la clasificación, los límites, los totales y las ventanas de página permanezcan en la base de datos o en la API ascendente.

Los datos restringidos pueden adjuntar una política de acceso. Las fuentes también pueden optar por el almacenamiento en caché limitado e invalidar sus variantes almacenadas en caché después de las escrituras en el dominio. La salida del solucionador nunca se convierte en la fuente de verdad del CMS: las revisiones y transferencias almacenan la configuración vinculante y el respaldo editorial normal, no la salida ejecutable.

La parte útil de este diseño no es sólo que los datos puedan ser dinámicos. Es que el comportamiento de falla es explícito. Los registros faltantes, los complementos deshabilitados, la denegación de acceso, las colecciones vacías y las excepciones de resolución no necesitan cerrar la página.

Los editores conservan un respaldo visible, el panel de Configuración informa fuentes o campos faltantes y el renderizador público puede seguir ofreciendo contenido coherente mientras se repara la integración.

Para conocer los contratos de desarrollador completos y las formas Internal Content API, lea Content Sources and Block Field Bindings.