Administrador de archivos IMCE
IMCE es un administrador de archivos basado en AJAX que permite a los usuarios navegar, cargar y gestionar archivos en el servidor con soporte para directorios personales y cuotas de usuario.
imce
Install
composer require 'drupal/imce:^3.1'
Overview
IMCE (Image for TinyMCE) es un módulo completo de administración de archivos para Drupal que proporciona una interfaz basada en AJAX para gestionar archivos en el servidor. A pesar de que su nombre se origina de su propósito inicial como navegador de imágenes para TinyMCE Editor, IMCE ha evolucionado hacia una solución completa de gestión de archivos.
El módulo permite a los administradores crear perfiles de configuración que definen el acceso a carpetas, permisos de carga de archivos, extensiones de archivo permitidas, límites de tamaño y cuotas de disco. Estos perfiles pueden asignarse a roles de usuario por sistema de archivos (público, privado, etc.), permitiendo un control de acceso detallado. Se admiten carpetas personales mediante tokens de usuario, permitiendo que cada usuario tenga su propio espacio de directorio dedicado.
IMCE proporciona una interfaz de usuario moderna y adaptable con navegación en árbol de carpetas, listado de archivos con opciones de ordenación, panel de vista previa de archivos y botones de barra de herramientas para diversas operaciones. El administrador de archivos admite la carga de archivos, la creación de nuevas carpetas, la eliminación de archivos y carpetas, y el redimensionamiento de imágenes. Se proporciona integración con CKEditor 5, BUEditor y los widgets nativos de campo de archivo/imagen de Drupal, permitiendo a los usuarios navegar y seleccionar archivos directamente desde estos contextos.
Features
- Navegador de archivos basado en AJAX con navegación en árbol de carpetas y listado de archivos
- Perfiles de configuración para control de acceso basado en roles por sistema de archivos
- Carpetas personales usando tokens de usuario (ej., [user:uid], [user:name])
- Carga de archivos con validación de extensiones, límites de tamaño y dimensiones de imagen
- Eliminación de archivos con verificación de uso para prevenir la eliminación de archivos en uso
- Creación de nuevas carpetas dentro de directorios accesibles
- Redimensionamiento de imágenes con opción de copia y validación de dimensiones
- Gestión de cuota de disco por usuario
- Soporte de vista previa de miniaturas usando estilos de imagen de Drupal
- Integración con CKEditor 5 con botones de barra de herramientas para imágenes y enlaces
- Integración con BUEditor como navegador de archivos configurable
- Integración con widget de campo File/Image con botón 'Abrir navegador de archivos'
- Soporte para múltiples sistemas de archivos (público, privado, S3, etc.)
- Generación de URLs absolutas y relativas para archivos
- Opción de tema de administración para rutas del administrador de archivos
- Memoria de carpeta activa basada en sesión
Use Cases
Directorios personales de usuario
Cree espacios de archivos personales para cada usuario configurando una ruta de carpeta con tokens de usuario como 'users/user[user:uid]'. Cada usuario solo verá y gestionará archivos en su propio directorio, con creación automática de carpeta en el primer acceso.
Gestión de medios basada en roles
Configure diferentes niveles de acceso creando perfiles para editores de contenido (acceso completo a carpeta de medios compartida), autores (acceso solo de carga a su carpeta personal) y miembros (acceso solo de visualización). Asigne perfiles a roles por sistema de archivos.
Inserción de imágenes en CKEditor 5
Permita a los editores de contenido insertar imágenes del servidor de archivos en el contenido. Configure un formato de texto con CKEditor 5, deshabilite las cargas de imágenes integradas y use el botón de barra de herramientas de imagen de IMCE. Los usuarios pueden navegar, cargar y seleccionar imágenes.
Descargas de archivos privados
Gestione archivos en el sistema de archivos privado que requieren autenticación. IMCE implementa hook_file_download() para validar el acceso, asegurando que los usuarios solo puedan descargar archivos a los que tienen acceso en IMCE.
Gestión de galería de imágenes
Configure un perfil con extensiones solo de imagen (jpg png gif webp), límites de dimensión de imagen y permiso de redimensionamiento. Los usuarios pueden cargar imágenes que se escalan automáticamente a las dimensiones máximas y redimensionar manualmente imágenes existentes.
Almacenamiento compartido multi-sitio
Use IMCE con S3 u otros sistemas de archivos remotos habilitando las opciones 'Alteración de URL' y 'Dimensiones diferidas' en el perfil para manejar correctamente las URLs de archivos remotos y mejorar el rendimiento.
Tips
- Cree un elemento de menú personalizado en /imce para proporcionar acceso directo al administrador de archivos para usuarios finales
- Deshabilite las cargas de imágenes de CKEditor 5 para ver el enlace de IMCE en el diálogo de imagen, o use el botón dedicado de barra de herramientas IMCE Image
- Use la operación Duplicar para crear rápidamente perfiles similares con diferentes configuraciones
- Habilite las vistas previas de miniaturas con precaución ya que pueden ralentizar el navegador de archivos con muchas imágenes
- Use el orden de peso de roles para controlar qué perfil tiene precedencia para usuarios con múltiples roles (el último asignado gana)
- Habilite 'Usar tema de administración para rutas IMCE' si experimenta problemas de interfaz con su tema frontal
- Las carpetas personales se crean automáticamente cuando los usuarios acceden a ellas por primera vez
- El navegador recuerda la última carpeta activa en la sesión del usuario para mayor comodidad
Technical Details
Admin Pages 9
/admin/config/media/imce
Página principal de configuración de IMCE que muestra tanto el formulario de configuración como la lista de perfiles de configuración. Los administradores pueden asignar perfiles a roles de usuario por sistema de archivos y gestionar la configuración global.
/admin/config/media/imce/add-profile
Formulario para crear un nuevo perfil de configuración de IMCE que define el acceso a carpetas, permisos y restricciones de archivos.
/admin/config/media/imce/{imce_profile}
Editar un perfil de configuración de IMCE existente.
/admin/config/media/imce/{imce_profile}/delete
Formulario de confirmación para eliminar un perfil de configuración de IMCE.
/admin/config/media/imce/{imce_profile}/duplicate
Crea una copia de un perfil de configuración existente con un nuevo nombre.
/admin/imce/help
Página de ayuda con documentación y videos tutoriales para configurar y usar IMCE.
/admin/imce/browser
Interfaz administrativa del navegador de archivos incrustada en un iframe, permitiendo a los administradores gestionar archivos directamente.
/imce/{scheme}
La interfaz principal del navegador de archivos IMCE. El parámetro {scheme} especifica el sistema de archivos (público, privado, etc.). Por defecto usa el sistema de archivos predeterminado del sitio cuando no se especifica.
/user/{user}/imce
Pestaña de perfil de usuario que muestra el navegador de archivos IMCE para usuarios cuyo perfil asignado tiene la opción 'Mostrar pestaña de navegador de archivos en páginas de perfil de usuario' habilitada.
Permissions 1
Hooks 2
hook_imce_supported_widgets_alter
Permite a los módulos alterar la lista de widgets de campo de archivo admitidos que pueden integrarse con IMCE.
hook_imce_plugin_info_alter
Permite a los módulos alterar las definiciones de plugins de IMCE.
Security Notes 7
- El permiso 'administer imce' está restringido y otorga acceso completo a todas las funciones de gestión de archivos
- Se muestra una advertencia de acceso de usuario anónimo al configurar perfiles para el rol anónimo
- La verificación de uso de archivo previene la eliminación de archivos referenciados por contenido a menos que se deshabilite explícitamente
- La validación de nombre de archivo previene el recorrido de directorios y caracteres especiales
- La validación de token CSRF protege todas las operaciones AJAX
- Las rutas de carpetas personales con tokens de usuario aseguran que los usuarios no puedan acceder a los directorios de otros usuarios
- Los archivos cargados a través de IMCE se establecen como permanentes y se registran en la tabla file_managed