Descripción
El plugin AccessiTrans – Traductor ARIA para WPML y Elementor facilita la traducción de atributos ARIA en sitios desarrollados con Elementor y WPML, garantizando que la información de accesibilidad esté disponible en todos los idiomas de tu sitio web.
Características principales
- Detecta automáticamente y hace disponibles los atributos ARIA para traducción
- Integración completa con WPML String Translation
- Compatible con todos los elementos y plantillas de Elementor
- Múltiples métodos de captura para garantizar una detección exhaustiva
- Mecanismo de reintento para traducciones fallidas
- Función para forzar la actualización y limpiar cachés
- Modo de depuración para solución de problemas
- Ajustes de optimización de rendimiento
- Sistema de caché de traducciones para mejorar rendimiento
- Compatible con internacionalización
Atributos ARIA compatibles
El plugin permite traducir los siguientes atributos:
aria-label: Para proporcionar un nombre accesible a un elementoaria-description: Para proporcionar una descripción accesiblearia-roledescription: Para personalizar la descripción del rol de un elementoaria-placeholder: Para textos de ejemplo en campos de entradaaria-valuetext: Para proporcionar representación textual de valores numéricos
Métodos de captura
El plugin ofrece varios métodos de captura para asegurar que todos los atributos ARIA sean detectados:
- Captura total de HTML: Captura todo el HTML de la página (altamente efectivo pero puede afectar al rendimiento)
- Filtro de contenido de Elementor: Procesa el contenido generado por Elementor
- Procesamiento de plantillas de Elementor: Procesa los datos de plantillas de Elementor
- Procesamiento de elementos individuales: Procesa cada widget y elemento de Elementor individualmente
Ajustes avanzados
- Reintentar traducciones fallidas: Reintenta automáticamente las traducciones que fallaron en el primer intento
- Modo de depuración: Activa el registro detallado de eventos
- Captura solo para administradores: Limita los métodos de captura intensivos en recursos a usuarios administradores
- Captura solo en idioma principal: Solo captura cadenas al navegar en el idioma predeterminado
Compatibilidad
Funciona con todo tipo de contenido de Elementor:
- Páginas regulares
- Plantillas
- Secciones globales
- Cabeceras y pies de página
- Ventanas emergentes y otros elementos dinámicos
Versiones probadas:
* WordPress 6.8
* Elementor 3.28.4
* WPML Multilingual CMS 4.7.4
* WPML String Translation 3.3.3
Por qué este plugin es importante para la accesibilidad
En sitios web multilingües, la información de accesibilidad debe estar disponible en todos los idiomas. Los atributos ARIA proporcionan información esencial de accesibilidad que ayuda a las tecnologías de asistencia a entender y navegar por tu sitio web. Al hacer que estos atributos sean traducibles, garantizas que todos los usuarios, independientemente de su idioma o capacidad, puedan acceder a tu contenido de manera efectiva.
Instrucciones de uso
Cómo añadir atributos ARIA en Elementor
- Edita cualquier elemento en Elementor
- Ve a la pestaña «Avanzado»
- Busca la sección «Atributos personalizados»
- Añade los atributos ARIA que deseas traducir
Formatos compatibles
Elementor indica: «Configura atributos personalizados para el elemento contenedor. Cada atributo en una línea separada. Separa la clave del atributo del valor usando el carácter |.»
Puedes añadir los atributos ARIA de dos formas:
Formato básico (una línea por atributo):
aria-label|Texto a traducir
Formato multilínea (varios atributos):
aria-label|Texto a traducir
aria-description|Otra descripción
Esto generará los atributos HTML correspondientes en la vista pública:
aria-label=»Texto a traducir» aria-description=»Otra descripción»
Cómo traducir los atributos
- Una vez añadidos los atributos, guarda la página o plantilla
- Ve a «WPML String Translation» (traducción de cadenas)
- Filtra por el contexto «AccessiTrans ARIA Attributes»
- Traduce las cadenas como harías con cualquier otro texto en WPML
Mejores prácticas para un rendimiento óptimo
Para la mejor experiencia y rendimiento del sitio web, sigue estas recomendaciones:
-
Navega por el sitio solo en el idioma principal mientras generas cadenas para traducción. Esto evita el registro de cadenas duplicadas.
-
Utiliza la función «Forzar actualización» cuando las traducciones no aparezcan como se esperaba.
-
Desactiva los métodos de captura después de la configuración inicial:
- Una vez que hayas capturado todos los atributos ARIA para traducción, recomendamos desactivar todos los métodos de captura
- Esto mejora significativamente el rendimiento del sitio y evita que se registren cadenas adicionales en WPML
- Vuelve a activar los métodos de captura temporalmente cuando realices cambios en tu sitio que incluyan nuevos atributos ARIA
Ejemplos prácticos
Para un botón de menú:
* Atributo: aria-label|Abrir menú
Para un enlace de teléfono:
* Atributo: aria-label|Llamar a atención al cliente
Para un icono sin texto:
* Atributo: aria-label|Enviar email
Para un carrusel:
* Atributo: aria-label|Galería de imágenes
* Atributo: aria-description|Navega por las imágenes del producto
Autor
Desarrollado por Mario Germán Almonte Moreno:
- Miembro de IAAP (International Association of Accessibility Professionals)
- Certificado CPWA (CPACC y WAS)
- Profesor en el Curso de Especialización en Accesibilidad Digital (Universidad de Lleida)
- 20 años de experiencia en ámbitos digitales y educativos
Capturas
Interfaz de ajustes mostrando los diferentes métodos de captura 
Pestaña Avanzado de Elementor mostrando dónde añadir atributos ARIA 
Proceso de transformación de código mostrando cómo se procesan los atributos ARIA 
Interfaz de WPML String Translation mostrando atributos ARIA listos para traducción 
Interfaz de herramientas de diagnóstico para solucionar problemas de traducción 
Interfaz de ajustes con opciones de activación para métodos de captura
Instalación
- Instala el plugin a través del repositorio de plugins de WordPress.org, o sube los archivos al directorio
/wp-content/plugins/accessitrans-aria/ - Activa el plugin a través del menú ‘Plugins’ en WordPress
- Ve a «Ajustes AccessiTrans» para configurar las opciones del plugin
- Configura los atributos ARIA en Elementor (ver instrucciones de uso)
FAQ
-
¿Funciona con otros maquetadores de páginas además de Elementor?
-
No, actualmente el plugin está diseñado específicamente para trabajar con Elementor.
-
¿Es compatible con la última versión de WPML?
-
Sí, el plugin ha sido probado con la versión 4.7.4 de WPML Multilingual CMS y 3.3.3 de WPML String Translation.
-
¿Por qué veo entradas duplicadas en WPML String Translation?
-
El plugin registra las cadenas utilizando diferentes formatos para garantizar la máxima compatibilidad con todos los tipos de contenido de Elementor. Solo necesitas traducir cada texto único una vez.
-
¿Este plugin ralentizará mi sitio web?
-
El plugin incluye varias opciones de optimización de rendimiento. Por defecto, el método de captura más intensivo en recursos (Captura total de HTML) solo se ejecuta para usuarios administradores. Puedes ajustar estos ajustes en la página de configuración del plugin.
-
¿Puedo usar este plugin con Elementor gratis?
-
Sí, el plugin funciona tanto con Elementor Free como con Elementor Pro.
-
¿Qué debo hacer si las traducciones no funcionan correctamente?
-
Prueba a utilizar el botón «Forzar actualización» en la configuración del plugin. Esto vaciará todas las cachés y reinicializará el sistema de traducción.
-
¿Necesito mantener todos los métodos de captura activados?
-
No. Se recomienda activar todos los métodos durante la configuración inicial para capturar todos los atributos ARIA. Después de eso, puedes desactivar para mejorar el rendimiento y solo reactivarlos cuando añadas nuevos atributos ARIA a tu sitio.
-
¿Cómo sé si los atributos ARIA se están traduciendo correctamente?
-
Puedes verificarlo:
1. Añadiendo atributos ARIA en Elementor
2. Traduciéndolos en WPML String Translation
3. Cambiando a un idioma diferente en tu vista pública
4. Inspeccionando el elemento con las herramientas de desarrollo del navegador para ver si aparece el texto traducido -
¿Funciona con widgets globales y plantillas de Elementor?
-
Sí, el plugin funciona con todos los tipos de contenido de Elementor, incluidos widgets globales, plantillas y elementos dinámicos.
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«AccessiTrans – Traductor ARIA para WPML y Elementor» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
«AccessiTrans – Traductor ARIA para WPML y Elementor» está traducido en 1 idioma. Gracias a los traductores por sus contribuciones.
Traduce «AccessiTrans – Traductor ARIA para WPML y Elementor» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.0.5
- Traducida una cadena más
1.0.4
- Traducidas dos cadenas faltantes
1.0.3
- Mejoras de internacionalización: Actualizadas todas las cadenas del plugin a inglés para cumplir con las directrices de WordPress.org
- Hacer el plugin totalmente compatible con el sistema de traducción de WordPress.org
- Flujo de trabajo de traducción mejorado para mejor compatibilidad de idiomas
- Refinamientos menores de código para mejor mantenibilidad
1.0.2
- Corrección de seguridad: Implementado sanitize_callback en register_setting()
- Mejorada la estructura de saneado para cumplir con las mejores prácticas de WordPress
1.0.1
- Mejora de seguridad: Implementada saneado adecuada de inputs
- Optimizado el sistema de logging para entornos de producción
- Testeado con WPML 4.7.4 y String Translations 3.3.3
- Corregido el uso de register_setting() para mejor seguridad
- Implemented proper JavaScript and CSS enqueuing
- Eliminados scripts y estilos inline del código PHP
- Creada estructura de carpetas assets/css y assets/js
- Extraídos estilos a admin-styles.css y scripts a admin-scripts.js
- Implementados wp_enqueue_style() y wp_enqueue_script()
- Usado wp_localize_script() para pasar variables a JavaScript
- Fixed file/directory location:
- Reemplazado uso directo de WP_CONTENT_DIR para archivos de log
- Implementado wp_upload_dir() para determinar ubicación correcta
- Creado directorio específico ‘accessitrans-logs’ en uploads
- Removed load_plugin_textdomain():
- Eliminada función innecesaria desde WordPress 4.6+
- Mantenida estructura de carpetas /languages para traducciones
- Actualizada la documentación
1.0.0
- Primera versión pública
- Corregidos y actualizados los archivos de traducción
- Listo para el repositorio de WordPress.org
0.2.5
- Añadido interruptor principal para activar/desactivar el escaneo de nuevas cadenas
- Mejorada toda la interfaz de administración con estructura semántica accesible
- Implementados anuncios para lectores de pantalla en procesos interactivos
- Rediseñada la interfaz con fieldset/legend reemplazando tablas
- Mejorados los estilos visuales y la activación/desactivación de campos dependientes
- Optimizado el rendimiento cuando la exploración está desactivada
0.2.4
- Mejorado sistema de verificación de idioma para captura de cadenas
- Implementado sistema robusto para prevenir duplicados en WPML
- Optimizado el sistema de caché con persistencia mejorada y control de tamaño
- Corregido problema de entradas duplicadas en la herramienta de diagnóstico
- Mejorado rendimiento general reduciendo consultas a la base de datos
0.2.3
- Reestructuración del sistema de archivos del plugin
0.2.3
- Añadido sistema de caché de traducciones persistente para mejorar el rendimiento
- Mejorado algoritmo de búsqueda de traducciones con múltiples métodos alternativos
- Mejorada la accesibilidad de la interfaz de administración para lectores de pantalla
- Añadida herramienta de diagnóstico para solucionar problemas de traducción
- Solucionados problemas con la detección de atributos en plantillas complejas
0.2.2
- Añadida detección del atributo aria-valuetext
- Mejorado la compatibilidad con plantillas de Elementor y widgets globales
- Mejorada compatibilidad con las últimas versiones de WPML y Elementor
0.2.1
- Solucionados problemas con el registro de cadenas en contextos específicos
- Mejorado manejo de errores y registro de depuración
- Mejoras menores en la interfaz de usuario de la página de ajustes
0.2.0
- Añadido mecanismo de reintento para traducciones fallidas
- Añadido botón para forzar actualización y limpiar todas las cachés
- Mejorada información de depuración con registro detallado
- Mejorada compatibilidad con WordPress 6.8
0.1.0
- Mejorada la accesibilidad de la página de configuración
- Mejorada estructura semántica con landmarks ARIA adecuados
- Mejorado título de página para mejor identificación
- Añadidos elementos de sección con encabezados semánticos
0.0.0
- Versión inicial con funcionalidad básica
- Compatible con la traducción de aria-label, aria-description, aria-roledescription y aria-placeholder
- Múltiples métodos de captura para detección exhaustiva
- Integración con WPML String Translation
- Página de ajustes de configuración
- Modo de depuración para solución de problemas
- Compatibilidad con todos los tipos de contenido de Elementor