Lo que necesitas
WordPress 6.3 o superior, PHP 7.4 o superior y permisos de administrador para instalar plugins. 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 WordPress, abre Plugins → Añadir nuevo plugin, busca «Accessonaut» y haz clic en «Instalar ahora» en el plugin de Accessonaut. Llega directamente del directorio de plugins de WordPress y recibes las actualizaciones automáticamente. También puedes descargar el archivo ZIP en la página de WordPress e instalarlo en Plugins → Añadir nuevo plugin → Subir plugin.
- Activa el plugin y abre Ajustes → Accessonaut.
- Copia la dirección HTTPS del servicio y el ID público del proyecto desde el código de inserción de tu proyecto de Accessonaut. Elige el diseño central del proyecto o ajusta localmente colores, tipografía, formas, textos y espaciados. Carga la vista previa de forma explícita cuando la necesites.
- Lee los avisos sobre el servicio externo y activa la conexión. Guarda los ajustes y vacía las cachés de WordPress y de la CDN.
El plugin de WordPress
El plugin inserta el código por ti. Lo instalas directamente desde el directorio de plugins de WordPress o, si lo prefieres, como ZIP. Activarlo no inicia por sí solo ninguna conexión: activas el widget de forma explícita solo después de configurarlo.
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
Una inserción adicional en el tema o en el gestor de etiquetas genera scripts duplicados. Usa un solo método de instalación. El tema debe generar wp_footer(). El plugin no modifica archivos del tema ni del núcleo.
Preguntas frecuentes sobre WordPress
¿Qué pasa con plugins de caché como WP Rocket?
El plugin genera el script con defer en el pie de página. La opción «Delay JavaScript execution» de WP Rocket carga los scripts solo tras la primera interacción. El botón aparece entonces con retraso. Si quieres que se vea enseguida, añade widget.js en «Excluded JavaScript Files». Después vacía la caché con «Clear and preload cache».
¿Funciona el plugin en una red multisitio?
Sí. Puedes activarlo en toda la red. Pero el plugin guarda sus ajustes por sitio. Sin configuración propia, el widget sigue desactivado en un sitio. Por eso, introduce en cada sitio la dirección del servicio y el ID del proyecto. Si un sitio tiene dominio propio, crea para él un proyecto de Accessonaut aparte.
¿Qué hago con mi banner de cookies?
El widget no instala cookies. Guarda los ajustes de lectura en el almacenamiento local del navegador. Al cargar la página, el navegador obtiene el script y la configuración del proyecto del servicio. Si bloqueas el script hasta el consentimiento lo decides tú, según tu evaluación de privacidad. Muchos plugins de consentimiento reconocen los scripts por su dirección o ID: el plugin usa el ID accessonaut-widget-js. Ten en cuenta que, si lo bloqueas, la ayuda de lectura solo estará disponible tras el consentimiento.
¿Funciona con temas de bloques y el editor del sitio?
Sí. Los temas de bloques también llaman a wp_footer() a través de la plantilla de página de WordPress. Ahí es donde el plugin genera el script. El widget no se carga en el editor del sitio ni en el resto del área de administración. Por eso, revisa siempre el resultado en la web pública.
¿Cómo vuelvo a quitar el widget?
Desactiva el plugin en Plugins. A partir de ahí, WordPress deja de generar el script; tus ajustes se conservan. Si después borras el plugin, también elimina sus ajustes; en una red multisitio, en todos los sitios de la red. Después vacía las cachés de página y de la CDN.
Si algo no funciona
El widget no aparece aunque la conexión está activa.
Causa: Una caché de página sigue sirviendo la página antigua, o el tema no genera wp_footer().
Solución: Vacía las cachés del plugin, del servidor y de la CDN. Luego busca accessonaut-widget-js en el código fuente de la página pública. Si no aparece, revisa la plantilla del pie de página de tu tema.
El widget muestra el diseño estándar y el aviso de Accessonaut aunque guardaste un diseño.
Causa: La web funciona con un dominio distinto del registrado en el proyecto, por ejemplo un subdominio de pruebas. Allí el widget no carga la configuración de tu proyecto.
Solución: Compara el dominio del proyecto con la dirección del navegador. El prefijo www da igual, pero un subdominio cuenta como dominio propio.
Una inserción antigua del tema o del gestor de etiquetas sigue teniendo efecto.
Causa: El widget se inicia una sola vez por página, con el script que se ejecuta primero. Aun así, un segundo script se carga sin necesidad.
Solución: Elimina el código antiguo de los archivos del tema, de los plugins de fragmentos y del gestor de etiquetas. Usa solo el plugin.
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.