Conflictos con caché o plugins externos

Free & Pro Intermedio

Conflictos con caché y otros plugins

Los plugins de caché, minificación de código y seguridad pueden interferir con el funcionamiento de Agenda Lite. Si el formulario de reservas no carga correctamente, muestra disponibilidad desactualizada o las reservas fallan, siga esta guía.

Caché de página sirviendo disponibilidad desactualizada

Los plugins de caché almacenan una copia estática de sus páginas para mejorar el rendimiento. Sin embargo, la página de reservas necesita mostrar disponibilidad en tiempo real, y una versión en caché puede mostrar horarios que ya no están disponibles.

Identifique las páginas que contienen el formulario de reservas de Agenda Lite.
En la configuración de su plugin de caché, agregue esas páginas a la lista de exclusiones.
Si utiliza un CDN (como Cloudflare), configure también la exclusión en el nivel del CDN.
Vacíe la caché actual después de aplicar las exclusiones.

Nota: los plugins de caché más comunes incluyen WP Super Cache, W3 Total Cache, WP Rocket, LiteSpeed Cache y SG Optimizer. Cada uno tiene su propia forma de configurar exclusiones, pero todos permiten excluir páginas específicas.

Minificación de JavaScript rompiendo el formulario

Los plugins de optimización que combinan o minifican archivos JavaScript pueden alterar el código del formulario de reservas, causando errores o impidiendo que funcione.

En su plugin de optimización, busque la opción de excluir archivos JavaScript.
Agregue los scripts de Agenda Lite a la lista de exclusiones. Busque archivos que contengan agendalite en su nombre.
Alternativamente, desactive la minificación de JavaScript temporalmente para confirmar si es la causa del problema.

Plugins de seguridad bloqueando la API REST

Agenda Lite utiliza la API REST de WordPress para comunicarse entre el formulario del cliente y el servidor. Algunos plugins de seguridad bloquean el acceso a la API REST para usuarios no autenticados, lo que impide que el formulario funcione.

En su plugin de seguridad (Wordfence, Sucuri, iThemes Security, etc.), busque la configuración de la API REST.
Asegúrese de que los endpoints de Agenda Lite estén permitidos (whitelisted). Los endpoints utilizan el prefijo /wp-json/agendalite/.
Si el plugin tiene un firewall, verifique que no esté bloqueando solicitudes POST a la API REST.

Importante: no desactive completamente la API REST de WordPress. Muchos plugins y funcionalidades del núcleo de WordPress dependen de ella. Solo necesita asegurarse de que los endpoints de Agenda Lite estén accesibles.

Cómo diagnosticar el conflicto

Desactive temporalmente todos los plugins excepto Agenda Lite.
Pruebe el formulario de reservas. Si funciona, el problema es un conflicto con otro plugin.
Reactive los plugins uno por uno, probando el formulario después de cada activación.
Cuando el formulario deje de funcionar, habrá identificado el plugin conflictivo.
Configure las exclusiones necesarias en ese plugin según las instrucciones anteriores.

Consejo: si utiliza WP Rocket, puede agregar las exclusiones rápidamente desde WP Rocket → Opciones avanzadas → Archivos JS excluidos y Caché → Páginas excluidas.