Lo que necesitas
WordPress 7.0 o superior, WooCommerce 11.2.2 o superior activo, PHP 7.4 o superior (se recomienda 8.3) y permisos de administrador. El plugin normal de WordPress es opcional. 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
- Haz una copia de seguridad y prepara una copia de prueba de tu tienda. Comprueba que WordPress, PHP y WooCommerce cumplen las versiones necesarias.
- Descarga el archivo ZIP en la página de descarga de WooCommerce e instálalo en Plugins → Añadir nuevo plugin → Subir plugin. Activa Accessonaut for WooCommerce.
- Abre WooCommerce → Accessonaut. Copia la dirección HTTPS del servicio y el ID público del proyecto desde tu proyecto de Accessonaut.
- Elige el diseño central del proyecto o ajustes locales. Cinco plantillas y una vista previa que cargas de forma explícita te ayudan a personalizarlo.
- Revisa la selección de áreas: la vista general de la tienda, los productos, las categorías y las etiquetas de producto vienen preseleccionados. El carrito, la página de pago y la cuenta de cliente están desmarcados al principio y solo se incluyen si los activas por separado.
- Lee los avisos sobre el servicio externo y activa el widget de forma explícita. Guarda, vacía las cachés y revisa las páginas seleccionadas, incluidas las vistas móviles y el manejo con teclado.
El plugin de WooCommerce
El plugin inserta el código por ti. Está disponible como ZIP. Activarlo no inicia por sí solo ninguna conexión: activas el widget de forma explícita solo después de configurarlo. El plugin de WooCommerce funciona sin el conector normal de WordPress.
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 WooCommerce 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
Las confirmaciones de pedido y las páginas para pagar pedidos ya creados quedan siempre excluidas. Si usas ambos plugins, el conector de WordPress a partir de la versión 1.2.0 se encarga del resto de páginas; las áreas de WooCommerce las controla el plugin de WooCommerce. Debes eliminar los scripts adicionales del tema o del gestor de etiquetas. La integración no modifica la lógica de pedidos, pagos ni de la Store API.
Preguntas frecuentes sobre WooCommerce
¿Tengo que excluir el carrito, el pago y Mi cuenta de la caché de página?
Sí. WooCommerce recomienda no guardar en caché estas tres páginas en los plugins de caché, porque muestran contenido propio de cada cliente. Esto vale con independencia del widget. Si cambias la selección de áreas en el plugin, vacía después las cachés de las demás páginas de la tienda.
¿Funciona el plugin con el bloque de pago y con el pago clásico?
El plugin declara su compatibilidad con los bloques de carrito y de pago y con HPOS. No interviene en el envío de pedidos. Desde WooCommerce 8.3, las tiendas nuevas usan los bloques de forma predeterminada; las existentes mantienen su variante. Prueba exactamente la variante que usa tu tienda.
¿Necesito además el plugin normal de WordPress?
Solo si el widget también debe aparecer fuera de la tienda, por ejemplo en el blog o en la página de contacto. El plugin de WooCommerce controla únicamente las áreas de tienda reconocidas. El plugin normal se encarga entonces del resto de páginas. Usa para ello la versión 1.2.0 o superior.
¿Por qué no veo el uso de las ayudas de lectura en las páginas de la tienda?
En el modo WooCommerce, el widget no envía avisos de uso anónimos. Así, las solicitudes solo contienen el origen de la web. Por eso, los menús abiertos y las ayudas de lectura activadas en estas páginas no aparecen en «Uso y estadísticas».
¿Qué pasa si desactivo el plugin de WooCommerce?
Deja de generar el script en las páginas de la tienda. Pero si el plugin normal de WordPress está activo, vuelve a encargarse de esas páginas, también del carrito y del pago, y sin el modo WooCommerce. Si hace falta, desactiva ambos plugins. Si borras el plugin de WooCommerce, elimina sus ajustes.
Si algo no funciona
El widget no aparece en el carrito o en la página de pago.
Causa: Estas áreas están desmarcadas al principio en la selección de áreas. Las confirmaciones de pedido y las páginas de pago de pedidos existentes quedan siempre excluidas.
Solución: Marca expresamente el carrito, la página de pago o la cuenta de cliente en WooCommerce → Accessonaut, guarda y vacía las cachés.
En la tienda, el widget sigue enviando direcciones de página.
Causa: Una inserción adicional del tema o del gestor de etiquetas se carga primero. El widget se inicia una sola vez por página, con el script que se ejecuta primero. Entonces se aplica el modo normal en lugar del modo WooCommerce.
Solución: Elimina todas las demás inserciones. En las páginas de la tienda, el código fuente solo debe contener el script con data-privacy-mode="commerce".
Comprueba la instalación
- Abre una página de la tienda activada expresamente 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.
Prueba por separado el carrito, el pago y la cuenta
- Revisa con el teclado las variantes de producto, la selección de cantidad, el minicarrito y los diálogos. Comprueba el foco, el cierre y la vuelta al elemento que los abrió.
- Prueba tu carrito y tu checkout clásicos o basados en bloques con un carrito de prueba lleno, errores de formulario y la selección de envío y pago. Si usas ambas variantes, revisa las dos.
- Sin una activación por separado, el carrito, la página de pago y la cuenta de cliente no muestran el widget de Woo. Las confirmaciones de pedido y las páginas para pagar pedidos ya creados quedan siempre excluidas.
- Revisa por separado los campos de pago integrados y usa pagos de prueba en la tienda de prueba. El plugin no modifica los procesos de pago, de pedidos ni de la Store API.
- Si ambos plugins de Accessonaut están activos, usa el conector normal a partir de la versión 1.2.0. Las áreas de WooCommerce siguen exclusivamente los ajustes del plugin de WooCommerce; el resto de páginas, los del conector normal.
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.
Para la configuración del proyecto, el modo WooCommerce solo usa el origen de la web: protocolo, nombre de host y, en su caso, puerto. Para ello no se envían direcciones de página completas ni parámetros. Las solicitudes del widget se hacen sin referrer. Las asignaciones de textos alternativos y el asistente de navegador privado no se cargan en este modo.
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.