Lo que necesitas
TYPO3 14.3 o 13.4 LTS (PHP 8.2 a 8.5) o TYPO3 12.4 con ELTS (PHP 8.1 a 8.4) y una cuenta de backend con acceso a la gestión de sitios. Para instalarla necesitas Composer o, sin Composer, acceso al módulo de extensiones. 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
- Instala la extensión
accessonautdesde la sección «La extensión de TYPO3» más abajo: con Composer o, sin Composer, en Admin Tools → Extensions → «Upload Extension». En el modo Composer, ejecuta despuésvendor/bin/typo3 extension:setup. - TYPO3 13.4 y 14.3: abre Site Management → Sites, edita tu sitio y añade en Sets «Widget de ayudas de lectura de Accessonaut». También puedes añadir
accessonaut/widgeta las dependencias del set de tu site package. - Abre Site Management → Settings, elige tu sitio y la categoría «Ayudas de lectura de Accessonaut». Introduce el ID público del proyecto de la página de instalación de tu proyecto de Accessonaut y mantén la dirección del servicio https://accessonaut.com. En TYPO3 12.4 usa en su lugar la pestaña «Accessonaut» de la configuración del sitio; funciona en todas las versiones.
- Lee el aviso sobre el servicio externo, activa el widget y guarda. El cambio se aplica a partir de la siguiente carga de página, también en las páginas de la caché de TYPO3. Después revisa varias páginas públicas en una ventana privada.
La extensión de TYPO3
La extensión «Accessonaut reading aids» (clave de extensión accessonaut, paquete de Composer accessonaut/typo3-accessibility) inserta el script por ti, sin cambios en plantillas ni en TypoScript. Funciona con TYPO3 14.3 y 13.4 LTS, así como con 12.4 (solo con ELTS), y empieza desactivada en cada sitio. Solo cuando la activas e introduces un ID de proyecto válido, el navegador carga algo del servicio. El widget nunca aparece en el backend.
accessonaut_1.0.0.zip
Suma de comprobación SHA-256 · Licencia: GPLv2 o posterior
La publicación en Packagist y en el TYPO3 Extension Repository (TER) está preparada. Hasta entonces, instala el archivo ZIP: sin Composer en Admin Tools → Extensions → «Upload Extension», con Composer como paquete local:
mkdir -p packages
cp ~/Downloads/accessonaut_1.0.0.zip packages/
composer config repositories.accessonaut artifact ./packages
composer require accessonaut/typo3-accessibility:^1.0
vendor/bin/typo3 extension:setupSin la extensión o el bundle puedes seguir insertando tú mismo el código de inserción. Aparece en la sección siguiente; las preguntas frecuentes más abajo explican cómo hacerlo.
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
Usa un único método de instalación y elimina una entrada anterior en page.footerData o en la plantilla. Si la extensión ya encuentra en una página un script del mismo servicio, no añade un segundo. Las cachés de páginas estáticas, los proxies y las CDN debes vaciarlos tú. Si cada sitio tiene su propio dominio, cada uno necesita su propio proyecto de Accessonaut. Una Content Security Policy activa en el frontend debe permitir el origen de tu servicio.
Preguntas frecuentes sobre TYPO3
¿Cómo integro el widget sin la extensión?
Con TypoScript en tu site package: añade a tu objeto PAGE una entrada libre, por ejemplo page.footerData.1729 = TEXT, y define el código de inserción sin cambios como page.footerData.1729.value. TYPO3 muestra footerData al final de la página. Después vacía las cachés del frontend con el icono del rayo. Si más adelante instalas la extensión, elimina esta entrada.
¿Cómo configuro varios sitios?
La extensión lee sus ajustes por sitio. Activa el widget en cada sitio que deba mostrarlo. Si cada sitio tiene su propio dominio, crea un proyecto de Accessonaut por dominio e introduce su ID de proyecto en el sitio correspondiente. Los idiomas de un sitio comparten sus ajustes.
¿Qué hago si la CSP del frontend está activa?
Si security.frontend.enforceContentSecurityPolicy está activo, amplía la política del sitio en config/sites/<sitio>/csp.yaml. Añade con mutations y mode: "extend" la dirección de tu servicio en las directivas script-src y connect-src. Además, el widget inserta elementos style sin nonce. Por eso, comprueba que style-src permita estilos incrustados.
¿Necesito un ajuste distinto para cada idioma?
No. Con el idioma «auto», el widget sigue el atributo lang de tu página mientras el diseño del proyecto no tenga guardado un idioma fijo. Habla alemán, inglés y español. Un idioma fijo en la extensión se aplica a todas las páginas de este sitio y tiene prioridad sobre el diseño del proyecto.
¿Cómo vuelvo a quitar el widget?
Desactívalo en los ajustes del sitio o en la pestaña «Accessonaut». El cambio se aplica a partir de la siguiente carga de página. Si quieres eliminar la extensión por completo, usa composer remove accessonaut/typo3-accessibility o desinstálala en el módulo de extensiones. Después vacía las cachés estáticas, los proxies y las CDN.
Si algo no funciona
El script no aparece en el código fuente.
Causa: El widget no está activado en este sitio, el ID del proyecto tiene un formato no válido o la dirección del servicio no es una dirección HTTPS. Si el sitio incluye el site set, solo se aplican sus ajustes y no la pestaña «Accessonaut».
Solución: Revisa el interruptor, el ID del proyecto (entre 20 y 40 letras minúsculas y cifras) y la dirección del servicio justo en el sitio que sirve la página. Vacía las cachés estáticas y las CDN.
La consola del navegador muestra una infracción de CSP.
Causa: La política del frontend de TYPO3 aún no permite la dirección de tu servicio.
Solución: Añádela en el csp.yaml del sitio y vacía las cachés.
Una inserción anterior sigue funcionando y los cambios en la extensión no surten efecto.
Causa: El site package aún contiene una entrada con el código de inserción, por ejemplo en page.footerData. La extensión no añade entonces un segundo script.
Solución: Elimina la entrada antigua y elige «Flush frontend caches».
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.