Simple Block
Proporciona bloques personalizados almacenados como entidades de configuración en lugar de entidades de contenido, haciéndolos fácilmente desplegables a través de la gestión de configuración.
simple_block
Instalar
composer require 'drupal/simple_block:8.x-1.7'
composer require 'drupal/simple_block:8.x-1.4'
Overview
Simple Block proporciona un plugin de bloque que crea bloques basados en entidades de configuración. A diferencia del módulo core Block Content (block_content) que almacena bloques como entidades de contenido en la base de datos, Simple Block almacena bloques como entidades de configuración. Esta arquitectura proporciona ventajas significativas cuando necesitas desplegar bloques usando el sistema de gestión de configuración de Drupal.
Cada simple block se identifica por un nombre máquina único y contiene solo un título y un área de texto formateado. Los bloques soportan reemplazo de tokens globales, permitiendo la inserción de contenido dinámico. Una vez creados, los simple blocks pueden exportarse como archivos YAML a tu directorio de sincronización de configuración y desplegarse como configuración a otros entornos, haciéndolos ideales para flujos de trabajo de desarrollo que dependen de la sincronización de configuración.
El módulo también proporciona un submódulo de integración con Layout Builder que permite crear y editar simple blocks directamente dentro de la interfaz de Layout Builder.
Features
- Almacena bloques personalizados como entidades de configuración en lugar de entidades de contenido para facilitar el despliegue mediante gestión de configuración
- Crea bloques con un título y contenido de texto formateado usando cualquier formato de texto disponible
- Soporte para reemplazo de tokens globales en el contenido del bloque (ej., [site:name])
- Clona bloques existentes para crear rápidamente bloques similares con nuevos nombres máquina
- Enlaces contextuales para edición rápida de bloques en el frontend
- Field formatter para mostrar simple blocks a través de campos de referencia a entidad
- Integración con Layout Builder mediante submódulo opcional para crear y editar bloques directamente en la interfaz de Layout Builder
- Los bloques están automáticamente disponibles como plugins de bloque en la interfaz de Block Layout
Use Cases
Desplegar avisos a nivel de sitio entre entornos
Crea un simple block para anuncios o avisos a nivel de sitio que necesitan ser consistentes entre entornos de desarrollo, staging y producción. El bloque puede exportarse como configuración y desplegarse a través de tu pipeline de despliegue normal, asegurando que el mismo contenido aparezca en todos los entornos.
Bloques de contenido de pie de página o encabezado
Crea simple blocks para contenido de pie de página como avisos de copyright, información de contacto, o banners de encabezado. Estos pueden incluir tokens como [current-date:custom:Y] para el año actual, que se actualiza automáticamente.
Fragmentos de contenido reutilizables para Layout Builder
Con el submódulo de Layout Builder habilitado, los editores de contenido pueden crear simple blocks reutilizables directamente mientras construyen layouts. Esto es útil para contenido que debe aparecer en múltiples lugares o a través de múltiples tipos de contenido.
Bloques promocionales basados en configuración
Crea bloques promocionales o bloques de llamada a la acción que pueden ser controlados por versiones y revisados a través de procesos de revisión de código antes del despliegue, a diferencia de los bloques basados en contenido que se almacenan en la base de datos.
Tips
- Usa nombres máquina significativos para tus simple blocks ya que no pueden cambiarse después de la creación
- Aprovecha el reemplazo de tokens para contenido dinámico como el nombre del sitio o la fecha actual
- Exporta los simple blocks como configuración antes del despliegue para asegurar consistencia entre entornos
- La función de Clonar es útil para crear variaciones de bloques existentes con contenido similar
- Los simple blocks son ideales para contenido que necesita ser controlado por versiones y desplegado mediante pipelines de CI/CD
Technical Details
Admin Pages 5
/admin/structure/block/simple-block
Lista todos los simple blocks creados en el sitio. Desde esta página puedes ver, editar, clonar y eliminar simple blocks existentes, así como añadir nuevos.
/admin/structure/block/simple-block/add
Crea un nuevo simple block con un nombre máquina único, título y contenido formateado.
/admin/structure/block/simple-block/manage/{simple_block}/edit
Modifica el título y contenido de un simple block existente. El nombre máquina no puede cambiarse después de la creación.
/admin/structure/block/simple-block/manage/{simple_block}/clone
Crea una copia de un simple block existente con un nuevo nombre máquina. El título y contenido se prerellenan desde el bloque origen.
/admin/structure/block/simple-block/manage/{simple_block}/delete
Página de confirmación para eliminar un simple block. Esta acción no puede deshacerse.
Permisos 4
Troubleshooting 3
Esto ocurre cuando un plugin de bloque referencia una entidad simple block que ha sido eliminada. O bien recrea el simple block con el mismo ID, o elimina el bloque de la configuración de block layout.
Limpia la caché después de hacer cambios. Los simple blocks invalidan la caché del plugin de bloque al guardar, pero puede que necesites limpiar las cachés manualmente en algunos escenarios.
Asegúrate de que el submódulo Simple Block + Layout Builder esté habilitado. La funcionalidad de edición en línea requiere que este submódulo esté activo.
Security Notes 3
- Los simple blocks respetan los permisos de formato de texto - los usuarios solo pueden seleccionar formatos de texto a los que tienen acceso
- El contenido se renderiza usando processed_text, que aplica los filtros de seguridad del formato de texto seleccionado
- Los usuarios necesitan el permiso 'administer blocks' o permisos específicos de simple block para gestionar bloques