Micro-content
Proporciona un tipo de entidad de contenido ligero y reutilizable con soporte de bundles para crear pequeños fragmentos de contenido habilitados para campos que admiten revisiones y traducciones.
microcontent
Install
composer require 'drupal/microcontent:^2.0'
composer require 'drupal/microcontent:8.x-1.8'
Overview
Micro-content es un módulo de Drupal que proporciona un tipo de entidad de contenido ligero y reutilizable diseñado para crear pequeñas piezas de contenido estructurado. A diferencia de los nodos completos, las entidades de micro-content están pensadas para fragmentos de contenido más pequeños y reutilizables, como testimonios, tarjetas de persona, calificaciones o resultados profesionales.
El módulo proporciona un sistema de bundles (tipos de micro-content) que permite a los constructores del sitio definir diferentes tipos de micro-content con sus propias configuraciones de campos. Cada tipo de micro-content puede tener una descripción y una clase CSS para ayudar a los editores de contenido a distinguir visualmente entre los tipos en la interfaz de administración.
Las capacidades clave incluyen soporte completo de revisiones con registro de revisiones, soporte de traducción para sitios multilingües, seguimiento de propiedad de entidades, flujo de trabajo de publicar/despublicar e integración con el sistema de moderación de contenido de Drupal cuando está habilitado. El módulo también proporciona integración con Views para crear listados personalizados e integración con Entity Browser para seleccionar micro-content en campos de referencia de entidad.
Features
- Tipo de entidad de contenido personalizado (microcontent) con tipos de bundle configurables (microcontent_type)
- Soporte completo de revisiones con seguimiento de usuario de revisión, marca de tiempo y mensaje de registro
- Soporte de traducción para gestión de contenido multilingüe
- Seguimiento de propiedad de entidades con información del autor
- Flujo de trabajo de publicar/despublicar con campo de estado
- Integración con Content Moderation - impone revisiones cuando la moderación está habilitada
- Integración con Views con datos de vistas personalizados para construir listados de administración y frontends
- Integración con Entity Browser con visualización modal para seleccionar micro-content existente o crear nuevo
- Soporte de JSON API con acceso de filtro para contenido publicado/no publicado
- Soporte de enlaces contextuales para edición rápida desde la salida renderizada
- Integración con Field UI para añadir campos personalizados a los tipos de micro-content
- Granularidad de permisos basada en bundles para control de acceso detallado
- Soporte de clase CSS de tipo para personalización del tema de administración para distinguir visualmente los tipos de contenido
- Modo de vista de previsualización para mostrar micro-content en contextos de administración
Use Cases
Testimonios y Citas
Crea un tipo de micro-content 'Testimonio' con campos para texto de cita, nombre del autor, título del autor, empresa y foto. Usa esto para gestionar testimonios de clientes que pueden ser referenciados desde múltiples páginas sin duplicar contenido.
Tarjetas de Persona
Crea un tipo de micro-content 'Tarjeta de Persona' para perfiles de personal o miembros del equipo con campos para foto, nombre, título, biografía e información de contacto. Referencia estas tarjetas en páginas de equipo, biografías de autores de artículos o listados de ponentes de eventos.
Calificaciones y Reseñas
Crea un tipo de micro-content 'Calificación' con campos para valor de calificación, texto de reseña, nombre del reseñador y fecha. Usa para reseñas de productos, calificaciones de cursos o comentarios de servicios que pueden mostrarse en múltiples contextos.
Bloques de Llamada a la Acción
Crea un tipo de micro-content 'CTA' con campos de titular, descripción, texto de botón y enlace. Permite a los editores de contenido crear componentes de llamada a la acción reutilizables que pueden colocarse en varios diseños de página.
Destacados de Características
Crea un tipo de micro-content 'Característica' con campos de icono, título y descripción para destacar características de productos o servicios. Referencia estos en páginas de aterrizaje, tablas de comparación o matrices de características.
Elementos de Preguntas Frecuentes
Crea un tipo de micro-content 'FAQ' con campos de pregunta y respuesta. Gestiona el contenido de FAQ centralmente y referéncialo en múltiples páginas de FAQ o áreas de contenido contextualmente relevantes.
Tips
- Usa el campo Clase de tipo al crear tipos de micro-content para añadir clases CSS que ayuden a distinguir visualmente los diferentes tipos en la interfaz de administración
- Considera habilitar 'Crear nueva revisión' por defecto para tipos donde quieras rastrear el historial de contenido
- Usa el modo de vista de previsualización para personalizar cómo aparece el micro-content en listados de administración y navegadores de entidades
- Al usar Entity Browser, el módulo proporciona una configuración de navegador lista para usar con capacidades tanto de selección como de creación en línea
- Los tipos de micro-content soportan todos los tipos de campo estándar de Drupal, por lo que puedes crear contenido estructurado complejo con imágenes, texto formateado, referencias de entidad y más
- El módulo se integra con JSON API para arquitecturas headless/desacopladas - el micro-content puede exponerse como recursos de API
Technical Details
Admin Pages 8
/admin/structure/microcontent-types
Lista todos los tipos de micro-content. Desde esta página puedes añadir nuevos tipos, editar tipos existentes, gestionar campos, configurar ajustes de formulario y visualización, y eliminar tipos.
/admin/structure/microcontent-types/add
Formulario para crear un nuevo tipo de micro-content con etiqueta, nombre de máquina, descripción, clase de tipo para estilos y ajustes de revisión.
/admin/structure/microcontent-types/manage/{microcontent_type}
Formulario para editar los ajustes de un tipo de micro-content existente incluyendo etiqueta, descripción, clase de tipo y comportamiento de revisiones.
/admin/content/microcontent
Listado administrativo de todas las entidades de micro-content. Muestra previsualización, tipo, autor, estado, fecha de actualización y operaciones. Soporta filtrado por etiqueta, tipo, autor y estado de publicación.
/admin/content/microcontent/add
Página de selección que muestra los tipos de micro-content disponibles. Haz clic en un tipo para crear nuevo micro-content de ese tipo.
/admin/content/microcontent/add/{microcontent_type}
Formulario para crear una nueva entidad de micro-content del tipo especificado. Los campos del formulario dependen de los campos configurados para el tipo de micro-content.
/admin/content/microcontent/{microcontent}/edit
Formulario para editar una entidad de micro-content existente. La URL canónica redirige al formulario de edición ya que el micro-content es contenido solo de administración.
/admin/content/microcontent/{microcontent}/delete
Formulario de confirmación para eliminar una entidad de micro-content. Esta acción no se puede deshacer.
Permissions 9
Hooks 2
hook_preprocess_microcontent
Prepara variables para plantillas de microcontent. Configura la entidad microcontent, view_mode, name (etiqueta) y variables de contenido para la tematización.
hook_jsonapi_microcontent_filter_access
Controla el acceso de filtro de JSON API para entidades microcontent. Permite filtrar entre todas las entidades si el usuario tiene el permiso 'view unpublished microcontent', o entre entidades publicadas si el usuario tiene el permiso 'access content'.
Troubleshooting 5
Debes crear al menos un tipo de micro-content antes de crear contenido. Ve a Administración > Estructura > Tipos de micro-content y haz clic en 'Añadir tipo de micro-content'.
Asegúrate de tener el permiso 'access microcontent overview'. Este permiso es independiente de los permisos de creación/edición de contenido.
Asegúrate de que el módulo Entity Browser esté instalado y habilitado. La configuración de Entity Browser solo se instala cuando el módulo está disponible.
Verifica los ajustes del tipo de micro-content para asegurarte de que 'Crear nueva revisión' esté habilitado. Si usas Content Moderation, las revisiones se imponen automáticamente.
Asegúrate de tener el permiso 'view unpublished microcontent' (para todo el contenido) o el permiso 'access content' (solo para contenido publicado).
Security Notes 4
- Los permisos 'administer microcontent types' y 'administer microcontent' están marcados como restringidos - solo otórguelos a administradores de confianza
- Los permisos basados en bundles permiten control granular sobre quién puede crear, editar y eliminar tipos específicos de micro-content
- El acceso de visualización al micro-content no publicado requiere el permiso explícito 'view unpublished microcontent'
- Considera usar flujos de trabajo de Content Moderation para micro-content que requiera revisión editorial antes de la publicación