Lo que necesitas
Una cuenta de superusuario o un grupo de usuarios cuyo filtro de texto permita etiquetas script. Tu plantilla debe generar una posición de módulo al final de la página. En Accessonaut, crea primero un proyecto con el dominio real de tu web y abre en el proyecto la página de instalación.
Paso a paso
- En tu perfil de usuario, cambia temporalmente el editor a «Editor - Ninguno». El editor predeterminado no permite ciertas etiquetas HTML, como los scripts.
- Abre Sistema → Módulos del sitio, elige Nuevo y el tipo de módulo «Personalizado». Pega el código de inserción sin cambios y oculta el título del módulo.
- Elige una posición al final de la página. En la plantilla predeterminada Cassiopeia, la posición
debugestá justo antes de la etiqueta de cierre body. En Asignación de menú, elige «En todas las páginas». - Guarda el módulo y restablece tu editor. Si la caché de páginas está activa, vacía la caché de Joomla y revisa varias páginas públicas.
Así es la inserción
Usa el código listo de tu proyecto. El ejemplo necesita tu ID de proyecto real y la dirección del servicio accesible públicamente.
<script src="https://accessonaut.com/widget.js"
data-project-id="TU_ID_DE_PROYECTO"
data-language="es" defer></script>Adapta el diseño a tu web
En tu proyecto de Accessonaut, abre «Widget de ayudas de lectura». Cinco plantillas y una vista previa en directo te ayudan con el diseño: colores, tipografías, ancho del menú, esquinas, sombras, icono o botón de apertura con texto y textos propios. La posición y los márgenes se ajustan por separado para escritorio y smartphone. Al guardar, tu código de inserción actual adopta automáticamente el diseño del proyecto; la configuración pública se guarda en caché hasta un minuto.
En el plugin de WordPress puedes elegir ajustes locales en su lugar. Estos tienen prioridad sobre el diseño del proyecto. El diseño está disponible en todos los planes. En el plan Free, el aviso de Accessonaut sigue visible. Los ajustes de lectura personales de tus visitantes tienen prioridad sobre las indicaciones de diseño.
Ten en cuenta
De forma predeterminada, solo los superusuarios guardan etiquetas script sin filtrar. Para otros grupos, los filtros de texto de la Configuración global eliminan esas etiquetas. Otras plantillas llaman de otra forma a sus posiciones de módulo; comprueba la posición después de cada cambio de plantilla. No modifiques directamente los archivos de Cassiopeia, porque las actualizaciones los sobrescriben.
Preguntas frecuentes sobre Joomla
¿Qué tengo que tener en cuenta en una web multilingüe?
En el módulo, pon el campo de idioma en «Todos». Si no, el módulo solo aparece en un idioma. Con data-language="auto", el widget sigue el atributo lang de la página. Habla alemán, inglés y español.
¿Por qué no veo los cambios enseguida?
Si el plugin «System - Page Cache» está activo, Joomla sirve páginas guardadas en caché. Según Joomla, un cambio de contenido no vacía esta caché automáticamente. Por eso, vacía la caché en la sección de mantenimiento del menú Sistema.
¿Qué hago con una Content Security Policy?
Joomla incluye opciones de CSP, desactivadas de forma predeterminada. Según la versión, las encuentras en el plugin «System - HTTP Headers» o en las opciones de la Content Security Policy. Añade la dirección de tu servicio en script-src y connect-src. El widget inserta elementos style sin nonce; style-src debe permitir estilos incrustados. Prueba primero en el modo de solo informe.
¿Cómo vuelvo a quitar el widget?
Despublica el módulo o muévelo a la papelera. Vacía la papelera si quieres borrarlo definitivamente. Después vacía la caché de páginas.
Si algo no funciona
En el módulo solo hay texto y el script no aparece en el código fuente.
Causa: El editor o el filtro de texto de tu grupo de usuarios ha eliminado la etiqueta script.
Solución: Cambia el editor a «Editor - Ninguno», vuelve a pegar el código y guarda como Super User. Revisa los filtros de texto en la configuración global.
El widget solo aparece en algunas páginas.
Causa: La asignación de menú del módulo está limitada, o el campo de idioma tiene un solo idioma.
Solución: Pon la asignación de menú en «En todas las páginas» y el idioma en «Todos».
Tras cambiar de plantilla, el widget ha desaparecido.
Causa: La nueva plantilla no conoce la posición de módulo elegida.
Solución: Asigna al módulo una posición al final de la página en la nueva plantilla.
Comprueba la instalación
- Abre la web pública en una ventana privada. El widget se muestra exactamente una vez.
- Llega al botón con el teclado. Abre el panel, cambia el tamaño del texto y vuelve a cerrarlo.
- Revisa la página de inicio, una subpágina, un formulario y la vista móvil. El widget no debe tapar ningún control importante.
- En la pestaña Red, comprueba que widget.js y la configuración del proyecto se cargan desde la dirección de tu servicio. Si hay errores, revisa el dominio, el ID del proyecto y la CSP.
- En los proyectos Free, el aviso visible de Accessonaut sigue formando parte del widget. Los permisos dependen de tu proyecto.
Privacidad y límites
Al cargarse, el navegador del visitante obtiene el script y la configuración del proyecto del servicio de Accessonaut. Con ello se tratan la dirección IP, los datos de la solicitud del navegador y el nombre de host de la web. Las preferencias de visualización se guardan localmente en el navegador. Ten en cuenta la integración en tu política de privacidad y revisa tu configuración concreta.
Las ayudas de lectura no garantizan la conformidad. Revisa además las barreras en el código fuente y los recorridos completos de los usuarios, de forma automática y manual.