Texto Alternativo Automático
Genera automáticamente texto alternativo para imágenes utilizando la API de Microsoft Azure Cognitive Services Computer Vision cuando el usuario no ha proporcionado texto alternativo.
auto_alter
Install
composer require 'drupal/auto_alter:^2.0'
Overview
El módulo Automatic Alternative Text se integra con Microsoft Azure Cognitive Services para proporcionar generación de texto alternativo impulsada por IA para imágenes en Drupal. Cuando los editores de contenido cargan o guardan imágenes sin proporcionar texto alternativo, el módulo consulta automáticamente la API Computer Vision de Azure para analizar la imagen y generar una descripción.
El módulo opera de forma transparente durante las operaciones de guardado de entidades, examinando todos los campos de imagen y rellenando los campos de texto alternativo vacíos con descripciones generadas por IA. También proporciona funcionalidad opcional para sugerir texto alternativo inmediatamente al cargar la imagen, permitiendo a los editores revisar y modificar el texto generado por IA antes de guardar.
Las descripciones generadas incluyen puntuaciones de confianza de la API de Azure, que opcionalmente pueden mostrarse a los usuarios mediante mensajes de estado. Para imágenes mayores de 1MB, el módulo crea automáticamente derivados escalados para optimizar las solicitudes a la API y reducir el uso de ancho de banda.
Un submódulo complementario (Automatic Alternative Text Translation) extiende la funcionalidad traduciendo las descripciones en inglés devueltas por Azure al idioma actual del sitio utilizando la API Azure Translator Text.
Features
- Generación automática de texto alternativo utilizando la API Microsoft Azure Computer Vision durante las operaciones de guardado de entidades
- Sugerencias opcionales de texto alternativo inmediatas cuando se cargan imágenes
- Soporte para todos los campos de imagen en todos los tipos de entidades de contenido
- Escalado automático de imágenes para archivos mayores de 1MB para optimizar las solicitudes a la API
- Mensajes de estado mostrando el texto alternativo generado con porcentajes de confianza
- Integración con el diálogo de imagen de CKEditor para generación de texto alternativo en imágenes en línea
- Validación de API integrada durante la configuración para verificar credenciales
- Registro completo de errores para problemas de comunicación con la API
- Submódulo para traducir descripciones generadas en inglés a otros idiomas
Use Cases
Mejorando el Cumplimiento de Accesibilidad
Las organizaciones que deben cumplir con los estándares de accesibilidad WCAG pueden usar este módulo para asegurar que todas las imágenes tengan texto alternativo significativo. Cuando los editores de contenido olvidan añadir texto alternativo o no tienen tiempo para escribir descripciones, el módulo genera automáticamente texto apropiado, ayudando a mantener el cumplimiento de accesibilidad en todo el sitio.
Sitios con Alto Volumen de Contenido
Sitios de noticias, plataformas de comercio electrónico u otros sitios con mucho contenido donde los editores cargan muchas imágenes diariamente se benefician de la generación automática de texto alternativo. Los editores pueden revisar y refinar las sugerencias en lugar de escribir descripciones desde cero, reduciendo significativamente el tiempo de creación de contenido.
Sitios Multilingües
Los sitios que sirven audiencias en múltiples idiomas pueden combinar el módulo principal con el submódulo de traducción para generar y traducir automáticamente el texto alternativo. La API Computer Vision analiza las imágenes y devuelve descripciones en inglés, que luego se traducen al idioma del visitante (alemán, francés, español, etc.).
Migración de Contenido Heredado
Al migrar contenido de sistemas sin texto alternativo o importar grandes bibliotecas de imágenes, este módulo puede rellenar automáticamente el texto alternativo para imágenes que carecen de descripciones, mejorando la accesibilidad del contenido migrado sin intervención manual.
Imágenes en Línea de CKEditor
Los editores de contenido que insertan imágenes directamente en contenido WYSIWYG usando CKEditor pueden hacer clic en el botón 'Obtener sugerencia' en el diálogo de imagen para generar texto alternativo sin salir del editor, agilizando el flujo de trabajo de creación de contenido.
Tips
- Prueba tu configuración de API de Azure utilizando la validación integrada en el formulario de configuración antes de confiar en la generación automática de texto alternativo
- Habilita 'Mostrar mensaje de estado al usuario' durante la configuración inicial para verificar que el módulo está funcionando y ver las puntuaciones de confianza
- Usa la opción 'Hacer sugerencia' para permitir que los editores revisen y mejoren las descripciones generadas por IA antes de guardar
- Monitorea tu uso de la API de Azure para evitar costos inesperados, especialmente en sitios de alto tráfico
- El módulo crea un estilo de imagen 'auto_alter_help' que escala las imágenes a 1440x1440 y las convierte a JPG - esto se usa automáticamente para archivos mayores de 1MB
- Considera el submódulo de traducción si tu sitio sirve audiencias que no hablan inglés - añade una sobrecarga mínima y asegura texto alternativo localizado
Technical Details
Admin Pages 2
/admin/config/media/auto_alter
Configura la integración de la API Microsoft Azure Computer Vision para la generación automática de texto alternativo. Esta página te permite ingresar tus credenciales de API de Azure y controlar cómo se comporta el módulo al generar texto alternativo.
/admin/config/media/auto_alter/translate
Configura la API Microsoft Azure Translator Text para traducir las descripciones en inglés generadas por IA a otros idiomas. Esta página de configuración es proporcionada por el submódulo auto_alter_translate.
Permissions 1
Hooks 3
hook_entity_presave
Examina todos los campos de imagen en entidades de contenido durante las operaciones de guardado. Para cualquier imagen sin texto alternativo, llama a la API de Azure para generar y rellenar el texto alternativo automáticamente.
hook_form_alter
Modifica los formularios de entidades para proporcionar sugerencias de texto alternativo cuando se cargan imágenes. También añade un botón 'Obtener sugerencia' al diálogo de imagen de CKEditor para la inserción de imágenes en línea.
hook_modules_installed
Muestra un mensaje recordatorio cuando el módulo se instala por primera vez, solicitando a los administradores que configuren sus credenciales de API de Azure.
Troubleshooting 6
Navega a /admin/config/media/auto_alter e ingresa tu clave API y URL de endpoint de Azure Computer Vision. Primero debes crear un recurso Computer Vision en tu Azure Portal.
Verifica que copiaste la clave API completa desde Azure Portal. Asegúrate de que estás usando la clave de un recurso Computer Vision, no de otro servicio de Azure.
Verifica que tu URL de endpoint esté completa y correcta. Debe incluir la región, versión de API y operación de descripción. Ejemplo: https://westeurope.api.cognitive.microsoft.com/vision/v1.0/describe?maxCandidates=1
1) Verifica que las credenciales de API sean correctas mediante la validación en la página de configuración. 2) Revisa los registros de Drupal para mensajes de error de la API de Azure. 3) Asegúrate de que el campo de imagen tenga habilitado el campo 'Texto alternativo' en la configuración del campo.
Asegúrate de que el submódulo auto_alter_translate esté habilitado, que la casilla 'Habilitar traducción' esté marcada y que las credenciales válidas de la API Azure Translator estén configuradas. El idioma origen debe diferir del idioma destino.
El módulo escala automáticamente las imágenes mayores de 1MB utilizando el estilo de imagen 'auto_alter_help'. Si los problemas persisten, considera reducir el tamaño máximo de carga u optimizar las imágenes antes de cargarlas.
Security Notes 4
- Las claves API se almacenan en la configuración de Drupal - asegura controles de acceso apropiados en los archivos de exportación de configuración
- El módulo sanea las respuestas de la API utilizando el filtro XSS de Drupal antes de almacenar el texto alternativo
- Los datos de imagen se transmiten a los servidores de Microsoft Azure para su procesamiento - revisa las políticas de manejo de datos de Azure para requisitos de cumplimiento
- Asegúrate de que el permiso 'Administrar Texto Alternativo Automático' se otorgue solo a administradores de confianza