Moderation Sidebar
Proporciona una barra lateral off-canvas en el frontend para Content Moderation, permitiendo a los editores ver rápidamente el estado de moderación y cambiar los estados del flujo de trabajo.
moderation_sidebar
Install
composer require 'drupal/moderation_sidebar:8.x-1.8'
composer require 'drupal/moderation_sidebar:8.x-1.5'
Overview
Moderation Sidebar proporciona un menú off-canvas para moderar entidades de contenido directamente desde el frontend. Al visualizar cualquier entidad moderada, aparece un botón "Tareas" en la barra de herramientas de Drupal que abre un panel lateral deslizante. Este panel muestra el estado actual de moderación, información de revisión y proporciona botones de acción rápida para transicionar el contenido a través de los estados del flujo de trabajo.
El módulo se integra perfectamente con el módulo Content Moderation de Drupal, detectando automáticamente las entidades moderadas y mostrando las transiciones de flujo de trabajo apropiadas. Soporta sitios multilingües a través de la integración con Content Translation, mostrando el estado de traducción y enlaces rápidos para crear, ver o editar traducciones. Para los nodos, también proporciona una vista del historial de revisiones integrada dentro de la barra lateral.
Los administradores del sitio pueden configurar qué transiciones de flujo de trabajo aparecen en la barra lateral por cada flujo de trabajo, permitiéndoles ocultar ciertas transiciones de todos los usuarios cuando sea necesario. La barra lateral utiliza diálogos off-canvas habilitados con AJAX para una experiencia de usuario fluida y no disruptiva.
Features
- Panel de barra lateral off-canvas que se abre desde la barra de herramientas al visualizar entidades moderadas
- Muestra el estado actual de moderación con indicador de estado codificado por colores (Publicado/Borrador/Borrador Disponible) en la barra de herramientas
- Botones de transición rápida para cambiar estados del flujo de trabajo sin salir de la página
- Soporte para mensajes de registro de revisión personalizados al realizar transiciones de estado
- Ver y alternar entre contenido publicado y borradores de revisiones
- Funcionalidad de descartar borrador para revertir a la revisión publicada
- Vista del historial de revisiones integrada mostrando las últimas 5 revisiones (para nodos)
- Resumen de traducciones mostrando el estado de todas las versiones de idioma con botones rápidos de Ver/Editar/Crear
- Filtrado configurable de transiciones para ocultar transiciones específicas del flujo de trabajo globalmente
- Integración con la barra de herramientas con indicador visual de estado mostrando el estado actual de moderación
- Integración con el módulo Quick Edit para actualizar la barra lateral después de ediciones en línea
- Soporte para cualquier tipo de entidad de contenido revisionable (nodos, términos de taxonomía, etc.)
- Soporte para idiomas RTL en la interfaz de la barra lateral
Use Cases
Flujo de Trabajo de Revisión Editorial Rápida
Los editores que visualizan contenido publicado pueden hacer clic en el botón Tareas en la barra de herramientas para ver el estado actual de moderación. Pueden crear rápidamente un nuevo borrador haciendo clic en 'Editar contenido', o si ya existe un borrador, pueden verlo haciendo clic en 'Ver borrador existente'. La barra lateral indica claramente el estado 'Borrador disponible' en la barra de herramientas.
Publicar Contenido Rápidamente
Al revisar un borrador, los editores pueden usar los botones de transición rápida en la barra lateral para cambiar estados (ej., 'Publicar' o 'Archivar') sin navegar al formulario de edición. Opcionalmente pueden agregar un mensaje de registro de revisión personalizado marcando 'Usar mensaje de registro personalizado' antes de hacer clic en el botón de transición.
Descartar Borradores No Deseados
Si un borrador ya no es necesario, los editores pueden hacer clic en el botón 'Descartar borrador' en la barra lateral. Esto crea una nueva revisión desde la versión actualmente publicada, revirtiendo efectivamente al contenido en vivo mientras mantiene el borrador descartado en el historial de revisiones para propósitos de auditoría.
Gestionar Contenido Multilingüe
En sitios multilingües, los editores pueden hacer clic en el botón 'Traducir' en la barra lateral para ver todas las traducciones disponibles con sus estados actuales de moderación. Pueden ver o editar rápidamente traducciones existentes, o crear nuevas traducciones para idiomas que aún no tienen contenido.
Revisar Historial de Revisiones
Para nodos, los editores pueden hacer clic en 'Mostrar revisiones' para ver las últimas 5 revisiones con sus mensajes de registro, autores y marcas de tiempo. Cada revisión está enlazada para fácil visualización, y un botón 'Ver todas las revisiones' proporciona acceso al historial completo de revisiones.
Ocultar Transiciones Administrativas
Los administradores del sitio pueden ocultar ciertas transiciones del flujo de trabajo de la barra lateral por cada flujo de trabajo. Por ejemplo, podrían ocultar una transición 'Archivar' que solo debería ser realizada por administradores a través del formulario de edición completo, no a través de la interfaz rápida de la barra lateral.
Tips
- El indicador de estado codificado por colores en la barra de herramientas proporciona información de un vistazo: verde para Publicado, rojo para Borrador, naranja para Borrador Disponible
- Usar mensajes de registro de revisión personalizados al realizar cambios de estado significativos para mantener un rastro de auditoría claro
- La barra lateral respeta todos los permisos de Content Moderation - los usuarios solo ven las transiciones que tienen permitido realizar
- Las auto-transiciones (ej., Borrador a Borrador) se ocultan automáticamente para reducir el desorden
- La barra lateral funciona con cualquier tipo de entidad de contenido revisionable, no solo nodos, aunque algunas características como el historial de revisiones son específicas de nodos
Technical Details
Admin Pages 1
/admin/config/user-interface/moderation-sidebar
Configurar qué transiciones de flujo de trabajo deben ocultarse de Moderation Sidebar. Esto permite a los administradores del sitio deshabilitar globalmente ciertas transiciones de aparecer en la barra lateral para todos los usuarios.
Permissions 2
Hooks 1
hook_moderation_sidebar_alter
Permite a los módulos alterar el render array de la barra lateral de moderación antes de que se muestre. Puede usarse para agregar botones personalizados, enlaces o información a la barra lateral.
Troubleshooting 5
Verificar que: 1) El usuario tiene el permiso 'Usar Moderation Sidebar', 2) Está visualizando una entidad moderada (no una página de administración), 3) Content Moderation está habilitado con al menos un flujo de trabajo, 4) El tipo de entidad está configurado para usar un flujo de trabajo de moderación.
Revisar la configuración de Moderation Sidebar en /admin/config/user-interface/moderation-sidebar para ver si las transiciones han sido deshabilitadas globalmente. También verificar que el usuario actual tiene permiso para realizar esas transiciones específicas en la configuración del flujo de trabajo.
El botón Traducir solo aparece cuando: 1) El módulo Content Translation está habilitado, 2) El tipo de entidad está configurado para traducción, 3) El usuario tiene permisos de traducción para el tipo de entidad.
El botón de revisiones actualmente solo aparece para nodos (no otros tipos de entidad) y requiere que el usuario tenga el permiso 'ver todas las revisiones' para nodos.
La barra lateral debería actualizarse automáticamente después de que Quick Edit guarde. Si no lo hace, hacer clic en el botón Tareas para cerrar y reabrir la barra lateral para ver la información actualizada.
Security Notes 3
- El permiso 'administrar moderation sidebar' está marcado como acceso restringido y solo debería otorgarse a administradores de confianza
- La barra lateral respeta todos los permisos de acceso a entidades subyacentes - los usuarios solo pueden realizar acciones para las que tienen permiso
- Deshabilitar transiciones en la barra lateral no es una medida de seguridad - solo oculta los botones de la interfaz. Los usuarios con los permisos apropiados aún pueden realizar transiciones por otros medios (formulario de edición, Drush, etc.)