Admin Toolbar
Transforma la barra de herramientas predeterminada de Drupal en un sistema mejorado de menús desplegables, proporcionando acceso rápido y completo a todos los enlaces de administración con comportamiento configurable y funcionalidad de búsqueda opcional.
admin_toolbar
Install
composer require 'drupal/admin_toolbar:^3.6'
Overview
Admin Toolbar es un módulo de mejora de administración ampliamente utilizado que mejora significativamente la experiencia de usuario de la barra de herramientas predeterminada de Drupal. Transforma el menú de administración estándar en un sistema de menús desplegables jerárquicos, permitiendo a los administradores del sitio acceder rápidamente a todas las páginas administrativas sin múltiples clics ni desplazamiento excesivo.
El módulo mantiene un impacto mínimo al integrarse estrechamente con la funcionalidad de Toolbar del núcleo de Drupal. Proporciona comportamiento adhesivo configurable, soporte de hoverIntent para interacciones de menú más suaves, atajos de teclado para la visibilidad de la barra de herramientas y configuraciones ajustables de profundidad de menú. El módulo puede extenderse con sus submódulos complementarios para agregar funcionalidades adicionales como atajos para limpiar cache, ejecución de cron y un campo de búsqueda con autocompletado para encontrar páginas de administración.
Admin Toolbar es particularmente valioso para editores de contenido, constructores de sitios y administradores que acceden frecuentemente a varias páginas de administración durante su flujo de trabajo, reduciendo drásticamente el tiempo necesario para navegar por la interfaz de administración de Drupal.
Features
- Transforma la barra de herramientas predeterminada de Drupal en un menú desplegable jerárquico con submenús anidados para navegación rápida
- Comportamiento adhesivo configurable con tres opciones: siempre visible, oculto al desplazarse hacia abajo con mostrar al desplazarse hacia arriba, o completamente deshabilitado
- Integración del plugin jQuery hoverIntent para interacciones de menú más suaves, previniendo activaciones accidentales de menú con configuraciones de tiempo de espera configurables
- Atajo de teclado (Alt + p) para alternar la visibilidad de la barra de herramientas, con persistencia de estado entre cargas de página usando localStorage
- Profundidad máxima de menú configurable (1-9 niveles) para controlar cuántos niveles de menú anidados se muestran
- Clases de iconos CSS agregadas automáticamente a los enlaces de menú según sus nombres de ruta para personalización visual
- Atributos de título con descripciones de enlaces agregados a los elementos del menú para mejorar la accesibilidad
- Reconstrucción automática del menú cuando se guardan los cambios de configuración
Use Cases
Limpieza rápida de cache durante el desarrollo
Durante el desarrollo de temas o módulos, use Admin Toolbar Extra Tools para limpiar rápidamente caches específicos (CSS/JS, Twig, Renderizado, Registro de temas) sin limpiar todos los caches. Pase el cursor sobre el icono de Drupal, navegue a 'Vaciar todos los caches' y seleccione el cache específico a limpiar. Esto ahorra tiempo significativo comparado con limpiar todos los caches.
Gestión rápida de tipos de contenido
Al gestionar múltiples tipos de contenido, use el menú desplegable para acceder rápidamente a la configuración de cualquier tipo de contenido, configuración de campos, visualización de formulario o visualización sin navegar a través de múltiples páginas. Simplemente pase el cursor sobre Estructura > Tipos de contenido y seleccione el tipo de contenido y operación deseados.
Encontrar páginas de administración con búsqueda
Habilite Admin Toolbar Search y use Alt+a para enfocar rápidamente el campo de búsqueda. Escriba nombres parciales de página como 'rend' para encontrar configuración de Rendimiento, o 'cron' para encontrar páginas relacionadas con cron. El autocompletado muestra páginas coincidentes con su ruta completa de menú para contexto.
Maximizar el espacio de pantalla
Al editar contenido o trabajar en modo de pantalla completa, use Alt+p para ocultar completamente la barra de herramientas. Un botón flotante aparece en la esquina para restaurarla. La preferencia persiste entre cargas de página, haciéndolo ideal para sesiones de trabajo enfocadas en contenido.
Gestionar roles de usuario y permisos
Navegue rápidamente al formulario de edición de cualquier rol de usuario o permisos directamente desde el desplegable Personas > Roles. Cada rol muestra enlaces anidados para Editar permisos y Eliminar (para roles personalizados), eliminando múltiples clics a través de la página de listado de roles.
Ejecutar Cron y actualizaciones
Acceda a los enlaces Ejecutar cron y Ejecutar actualizaciones directamente desde el menú del icono de Drupal sin navegar al Informe de estado. Útil para tareas de mantenimiento rápido o después de desplegar actualizaciones.
Tips
- Habilite Admin Toolbar Extra Tools para la experiencia completa con limpieza de cache, cron y atajos de gestión de entidades
- Use la función de Búsqueda (Alt+a) para encontrar rápidamente cualquier página de administración sin memorizar ubicaciones de menú
- Configure el tiempo de espera de hoverIntent a 500ms (predeterminado) para una capacidad de respuesta equilibrada; aumente si frecuentemente cierra menús accidentalmente
- Reduzca la profundidad del menú a 3 o 4 si tiene preocupaciones de rendimiento con muchos elementos de menú anidados
- El alternador de visibilidad de la barra de herramientas (Alt+p) recuerda su preferencia - útil para editores de contenido que necesitan máximo espacio de pantalla
- Admin Toolbar agrega automáticamente clases CSS basadas en nombres de ruta, facilitando agregar iconos personalizados vía CSS
- La visualización de tareas locales en Admin Toolbar Tools muestra pestañas de editar/eliminar para la entidad actual en la barra de herramientas para acceso rápido
Technical Details
Admin Pages 3
/admin/config/user-interface/admin-toolbar
Página de configuración principal del módulo Admin Toolbar. Permite a los administradores configurar el comportamiento adhesivo de la barra de herramientas, los ajustes de hoverIntent para interacciones de hover, atajos de teclado y profundidad del menú. Los cambios surten efecto inmediatamente después de guardar y activan una reconstrucción del cache del menú.
/admin/config/user-interface/admin-toolbar-tools
Página de configuración del submódulo Admin Toolbar Extra Tools. Controla el número de paquetes de entidad mostrados en los menús y si las tareas locales (pestañas editar/eliminar) se muestran en la barra de herramientas.
/admin/config/user-interface/admin-toolbar-search
Página de configuración del submódulo Admin Toolbar Search. Controla el modo de visualización del campo de búsqueda y la disponibilidad del atajo de teclado.
Permissions 1
Hooks 4
hook_toolbar_alter
Altera el render array de la barra de herramientas para inyectar el callback de pre-renderizado de Admin Toolbar y adjuntar las bibliotecas JavaScript necesarias según los ajustes de configuración.
hook_toolbar
Implementa hook_toolbar() para agregar elementos de barra de herramientas para Admin Toolbar Tools (enlaces adicionales, tareas locales) y Admin Toolbar Search (campo de búsqueda).
hook_entity_insert / hook_entity_update / hook_entity_delete
Activa la reconstrucción de enlaces de menú cuando se crean, actualizan o eliminan entidades que afectan la estructura del menú (menús, roles de usuario, vistas, paquetes de tipos de contenido).
hook_preprocess_menu
Usado por Admin Toolbar Links Access Filter para ocultar enlaces de menú a los que el usuario actual no tiene acceso para ver.
Troubleshooting 6
Limpie todos los caches (Admin > Vaciar todos los caches) y asegúrese de que JavaScript no esté bloqueado. Verifique la consola del navegador para errores de JavaScript. Verifique que el módulo Toolbar esté habilitado.
Intente deshabilitar hoverIntent en la configuración de Admin Toolbar o ajustar el valor del tiempo de espera. Valores de tiempo de espera más bajos (250-500ms) proporcionan una respuesta más ágil.
Verifique conflictos con extensiones del navegador, herramientas de accesibilidad u otros módulos. Intente deshabilitar los atajos en la configuración si entran en conflicto con funcionalidades esenciales.
Ajuste 'Número máximo de submenús de paquetes a mostrar' en la configuración de Admin Toolbar Tools. El valor predeterminado es 20; aumente para sitios con muchos tipos de contenido o disminuya para mejor rendimiento.
Asegúrese de que el usuario tenga el permiso 'Usar Admin Toolbar Search'. Si usa Admin Toolbar Tools, los enlaces adicionales se cargan vía AJAX en la primera búsqueda - espere a que se complete la carga inicial.
Este submódulo está obsoleto para Drupal 10.3+. Desinstálelo y confíe en el manejo mejorado de acceso a menú del núcleo en su lugar.
Security Notes 5
- Admin Toolbar respeta el sistema de permisos de Drupal - los usuarios solo ven elementos de menú a los que tienen acceso (mejorado cuando se usa el submódulo Links Access Filter)
- Las operaciones de limpieza de cache y cron requieren el permiso 'administrar configuración del sitio'
- Los tokens CSRF protegen todas las rutas de limpieza de cache y cron contra falsificación de solicitudes entre sitios
- El endpoint de búsqueda (/admin/admin-toolbar-search) requiere el permiso 'use admin toolbar search'
- Nunca otorgue acceso a la barra de herramientas de administración a usuarios no confiables ya que proporciona acceso rápido a operaciones poderosas del sitio