Media Alias Display
Permite ver archivos directamente a través de alias de URL de medios en lugar de renderizar la página completa de la entidad de medios.
media_alias_display
Instalar
composer require 'drupal/media_alias_display:^2.1'
composer require 'drupal/media_alias_display:^1.0'
Overview
Media Alias Display es un módulo que transforma la forma en que se accede a las entidades de medios a través de sus URLs. En lugar de mostrar la página estándar de la entidad de medios con todos sus campos, este módulo sirve el archivo real directamente cuando se visita una URL con alias de medios.
Esta funcionalidad es particularmente útil para organizaciones que necesitan URLs limpias y legibles para documentos como PDFs, imágenes u otros archivos descargables. Por ejemplo, en lugar de que los usuarios vean el contenedor de la entidad de medios, pueden ver o descargar directamente el archivo usando una URL amigable como /informe-anual-2024 en lugar de /sites/default/files/informe-anual-2024.pdf.
Un beneficio clave es que cuando una entidad de medios se referencia en múltiples ubicaciones en tu sitio, actualizar el archivo en un lugar lo actualiza automáticamente en todas partes. El alias de URL permanece consistente mientras que el archivo subyacente puede cambiarse según sea necesario.
Features
- Muestra archivos directamente a través de URLs con alias de medios en lugar de renderizar la página completa de la entidad de medios
- Funciona tanto con revisiones actuales de medios como con URLs de revisiones específicas
- Soporta navegación rápida a la página de edición de medios agregando ?edit-media a la URL (requiere permisos de edición)
- Fuerza la descarga del archivo en lugar de mostrarlo en línea agregando el parámetro ?download o ?dl
- Proporciona una configuración de interruptor de emergencia para deshabilitar completamente la funcionalidad del módulo
- Permite limitar la funcionalidad a bundles de medios específicos
- Maneja correctamente tanto sistemas de archivos públicos como privados
- Incluye caché completo con contextos y etiquetas de caché apropiados
- Registra avisos cuando los elementos de medios carecen de fuentes de archivos o los archivos no existen en el disco
- Incluye submódulo para anular el comportamiento de visualización por entidad
Use Cases
Biblioteca de Documentos con URLs Limpias
Crea una biblioteca de documentos donde PDFs, documentos de Word y otros archivos son accesibles a través de URLs amigables como /politicas/politica-de-privacidad o /formularios/formulario-de-solicitud. Los usuarios pueden compartir estas URLs limpias, y cuando el documento necesita actualizarse, simplemente reemplaza el archivo en la entidad de medios - la URL permanece igual.
Acceso Directo a Galería de Imágenes
Permite acceso directo a imágenes de alta resolución a través de alias de URL. Los visitantes pueden marcar como favoritos o compartir URLs de imágenes directamente sin ver la página contenedora de la entidad de medios.
Descargas Forzadas para Documentos Sensibles
Usa el parámetro ?download o ?dl para forzar a los navegadores a descargar archivos en lugar de mostrarlos en línea. Útil para formularios que los usuarios necesitan imprimir o documentos que no deberían verse en el navegador.
Acceso Rápido de Administrador para Editar Medios
Los editores de contenido pueden navegar rápidamente para editar un elemento de medios agregando ?edit-media a la URL. Esto es especialmente útil cuando se está viendo un archivo y se necesita hacer actualizaciones inmediatas sin navegar a través de la interfaz de administración.
Configuración Selectiva de Bundles
Habilita la visualización directa de archivos solo para tipos de medios específicos como Documentos mientras mantiene los tipos de medios de Imagen o Video renderizándose como páginas de entidad completas con miniaturas y metadatos.
Interruptor de Deshabilitación de Emergencia
Usa la función de interruptor de emergencia para deshabilitar rápidamente la funcionalidad del módulo sin desinstalarlo. Útil para solución de problemas o para revertir temporalmente a la visualización estándar de entidad de medios.
Anulación por Entidad para Contenido Destacado
Usando el submódulo Field Override, marca entidades de medios específicas para que se muestren como páginas de entidad completas. Útil cuando ciertos documentos destacados necesitan contexto adicional, contenido relacionado o metadatos mostrados junto al archivo.
Tips
- Usa Pathauto para generar automáticamente alias de URL limpios para entidades de medios basados en sus nombres u otros campos
- Agrega ?edit-media a cualquier URL de alias de medios para saltar rápidamente al formulario de edición de medios (requiere permisos de edición)
- Usa los parámetros ?download o ?dl para forzar descargas de archivos en lugar de visualización en línea
- El módulo funciona tanto con sistemas de archivos públicos como privados, estableciendo automáticamente encabezados de caché apropiados
- Cuando el submódulo Field Override está habilitado, puedes deshabilitar selectivamente la visualización por alias en entidades de medios específicas
- El caché se invalida correctamente cuando cambia la configuración, pero limpia los cachés manualmente si notas comportamiento desactualizado
Technical Details
Admin Pages 1
/admin/config/media/media_alias_display
Configura qué bundles de medios deben mostrar archivos directamente a través de sus alias de URL, y controla la funcionalidad general del módulo con la opción de interruptor de emergencia.
Troubleshooting 5
Verifica que 'Standalone media URL' esté habilitado en /admin/config/media/media-settings. Revisa la página de Informe de Estado para cualquier advertencia. Asegúrate de que el interruptor de emergencia no esté habilitado en /admin/config/media/media_alias_display.
Revisa la configuración de bundles en /admin/config/media/media_alias_display. Si hay bundles específicos seleccionados, solo esos usarán la función de visualización por alias. Limpia todas las selecciones para habilitar para todos los bundles.
El módulo maneja automáticamente archivos privados con encabezados Cache-Control apropiados. Asegúrate de que tu sistema de archivos privados esté configurado correctamente en la configuración de Drupal.
Esta función requiere que el usuario tenga permisos de edición apropiados para el bundle de medios - ya sea 'edit own [bundle] media', 'edit any [bundle] media', o 'administer media'.
Agrega ?download o ?dl a la URL para forzar al navegador a descargar el archivo en lugar de mostrarlo en línea.
Security Notes 4
- El módulo respeta el sistema de control de acceso de Drupal - los archivos solo se sirven para entidades de medios accesibles
- Los archivos privados se sirven con encabezados Cache-Control privados para prevenir caché no autorizado
- La redirección ?edit-media solo funciona para usuarios con permisos apropiados de edición de medios
- Este módulo no agrega nuevos permisos - depende de los permisos existentes de medios y configuración del sitio