Dashboard
Proporciona paneles de control personalizables con integración de Layout Builder para crear experiencias de administración personalizadas.
dashboard
Instalar
composer require 'drupal/dashboard:^2.1'
composer require 'drupal/dashboard:^2.0'
Overview
El módulo Dashboard proporciona un sistema flexible para crear y gestionar paneles de control personalizables en Drupal. Aprovecha el módulo Layout Builder para permitir a los administradores diseñar diseños de paneles organizando bloques y contenido en secciones.
Cada panel de control es una entidad de configuración que puede configurarse de forma independiente con su propio diseño, permisos y orden de visualización. Los usuarios son redirigidos automáticamente a su panel de control accesible al iniciar sesión, proporcionando una experiencia de página de inicio personalizada.
El módulo incluye bloques de Views integrados para mostrar contenido específico del usuario, como contenido reciente, borradores y contenido editado. Se integra perfectamente con el tema de administración Gin, el módulo Coffee para navegación rápida y el módulo Navigation del core para la integración con la barra de herramientas.
Features
- Crear múltiples paneles de control personalizables usando Layout Builder para una organización flexible del contenido
- Asignar permisos de visualización por panel de control para controlar qué roles de usuario pueden acceder a cada panel
- Redirección automática al primer panel de control accesible del usuario después de iniciar sesión
- Ordenamiento basado en peso para controlar la prioridad de visualización de paneles cuando existen múltiples
- Bloques de Views integrados para contenido específico del usuario: contenido reciente, borradores, contenido editado y gestión de contenido del sitio
- Bloque Dashboard Text para agregar texto formateado personalizado a los paneles de control
- Bloque Site Status para mostrar errores de requisitos del sistema en el panel de control
- Integración con el tema de administración Gin para estilos mejorados
- Integración con el módulo Coffee para navegación rápida del panel mediante comandos de teclado
- Integración con el módulo Navigation para enlace del panel en la barra de herramientas de administración
- Modo de vista previa para probar diseños del panel antes de publicar
- Reordenamiento mediante arrastrar y soltar de paneles en la lista de administración
Use Cases
Panel de control para editores de contenido
Crea un panel para editores de contenido mostrando sus borradores, contenido recientemente editado y enlaces rápidos para crear nuevo contenido. Asigna el permiso de visualización al rol de Editor de Contenido, y los editores verán esto como su página de inicio después de iniciar sesión.
Panel de visión general para administradores
Construye un panel de administración completo mostrando errores de estado del sitio, contenido reciente del sitio y bloques de monitoreo del sistema. Esto proporciona a los administradores una visión rápida de la salud del sitio y la actividad reciente.
Páginas de inicio basadas en roles
Crea múltiples paneles con diferentes diseños para diferentes roles de usuario. Los miembros del equipo de marketing podrían ver contenido relacionado con campañas, mientras los desarrolladores ven el estado de despliegue y registros de errores. Cada panel puede adaptarse a necesidades específicas de flujo de trabajo.
Monitoreo de salud del sitio
Agrega el bloque Site Status a un panel de administración para mostrar errores de requisitos del sistema de forma prominente. Combinado con la integración del tema Gin, esto proporciona una interfaz limpia para monitorear la salud del sitio.
Centro de navegación rápida
Usa el bloque Dashboard Text para crear un centro de navegación con enlaces importantes, anuncios y recursos útiles para los miembros del equipo. Layout Builder permite una organización flexible de las secciones de contenido.
Tips
- Crea un nuevo panel antes de eliminar uno existente para asegurar que los usuarios siempre tengan una página de inicio
- Usa el ordenamiento por peso estratégicamente - el panel con el peso más bajo se convierte en el predeterminado para usuarios con acceso a múltiples paneles
- La integración con Coffee permite acceso rápido a paneles escribiendo ':dashboard' seguido del nombre de máquina del panel
- Para usuarios del tema Gin, los estilos del panel se mejoran automáticamente sin configuración adicional
- Previsualiza el diseño de tu panel antes de habilitarlo para asegurar que la organización se vea correcta
- Considera usar los bloques de Views integrados para visualizaciones de contenido personalizadas antes de crear bloques personalizados
- Los permisos del panel son independientes - los usuarios pueden tener acceso a algunos paneles pero no a otros
Technical Details
Admin Pages 6
/admin/dashboard
La página principal del panel de control que muestra el panel accesible predeterminado del usuario. Los usuarios son redirigidos automáticamente aquí después de iniciar sesión si tienen permiso para ver al menos un panel. El contenido del panel se renderiza usando secciones de Layout Builder.
/admin/structure/dashboard
Página administrativa para gestionar todos los paneles de control. Proporciona una lista de paneles existentes con su estado, y permite reordenar mediante arrastrar y soltar para controlar la prioridad de visualización.
/admin/structure/dashboard/add
Formulario para crear un nuevo panel de control. Después de la creación, el panel necesitará que se configure su diseño y se asignen permisos antes de que los usuarios puedan acceder a él.
/admin/structure/dashboard/{dashboard}
Formulario para editar la configuración básica de un panel de control existente. El diseño se edita por separado usando la interfaz de Layout Builder.
/admin/structure/dashboard/{dashboard}/permissions
Configura qué roles de usuario pueden ver este panel de control específico. Cada panel tiene su propio permiso 'view [dashboard_id] dashboard' que puede asignarse a cualquier rol.
/admin/structure/dashboard/{dashboard}/preview
Vista previa del panel de control tal como aparecerá a los usuarios. Esto permite a los administradores verificar el diseño y contenido antes de habilitar el panel.
Permisos 2
Hooks 7
hook_user_login
Redirige a los usuarios a su panel de control predeterminado después de iniciar sesión. La redirección se omite si ya está establecido un parámetro de destino o si el usuario está en la página de restablecimiento de contraseña.
hook_coffee_commands
Proporciona comandos del módulo Coffee para navegación rápida a los paneles de control. Crea un comando para cada panel accesible.
hook_library_info_alter
Agrega CSS específico del tema Gin cuando el tema de administración Gin está activo. Mejora los estilos del panel para usuarios de Gin.
hook_toolbar_alter
Adjunta la biblioteca de la barra de herramientas del panel a la barra de administración para mostrar iconos.
hook_menu_local_tasks_alter
Elimina pestañas duplicadas del panel del menú de tareas locales y agrega metadatos de caché apropiados.
hook_navigation_defaults
Proporciona configuración predeterminada del bloque de navegación para la integración con el módulo Navigation.
hook_block_alter
Marca los bloques internos del panel como ocultos de la interfaz de bloques ya que solo deben usarse en paneles de control.
Troubleshooting 5
Asegúrate de que el usuario tenga el permiso 'view [dashboard_id] dashboard' para al menos un panel habilitado. También verifica que ningún parámetro de destino esté siendo establecido por otros módulos durante el inicio de sesión.
Verifica que el panel esté habilitado y que el usuario tenga permiso para verlo. El enlace del panel solo aparece para usuarios que pueden acceder a al menos un panel.
Asegúrate de hacer clic en 'Guardar diseño' en lugar de navegar fuera. Layout Builder usa un almacenamiento temporal para los cambios hasta que se guardan explícitamente.
Verifica que se cumplan las condiciones de acceso del bloque. Algunos bloques (como Site Status) solo se muestran cuando ciertas condiciones son verdaderas (por ejemplo, cuando hay errores).
El bloque Navigation dashboard requiere que el usuario tenga permiso para ver al menos un panel. Verifica que los permisos estén correctamente asignados.
Security Notes 4
- Los permisos de visualización del panel se aplican tanto a nivel de ruta como de acceso a entidad para protección integral
- El permiso 'administer dashboard' solo debe otorgarse a administradores de confianza ya que permite crear y modificar todos los paneles
- El contenido de cada panel está sujeto a los controles de acceso individuales del bloque además del permiso del panel
- La redirección de la página de restablecimiento de contraseña se omite intencionalmente para prevenir problemas de seguridad durante la recuperación de contraseña