Solución de problemas de WordPress

La mayoría de los problemas entre WordPress y ClubHelix no están en ninguno de los dos productos. Vienen del alojamiento que rodea a WordPress: un plugin de seguridad, una caché de páginas, el reloj del servidor o un firewall. Esta página cubre los seis que vemos con más frecuencia, cómo saber cuál tienes y cómo solucionarlo. Empieza con un paso en ClubHelix que es fácil pasar por alto después de conectar. La página de WordPress explica cómo conectar un sitio en primer lugar.

Empieza por Herramientas → Salud del sitio en WordPress. El plugin de ClubHelix agrega allí siete comprobaciones, cada una marcada con ClubHelix. La Referencia de campos las enumera y indica qué sección de esta página corresponde a cada una.

Quién puede usar esto

Cualquier persona que se ocupe del sitio de WordPress del club. La mayoría de las soluciones requieren a un administrador de WordPress, y algunas requieren a tu proveedor de alojamiento o a quien gestione el servidor. En ClubHelix, solo los administradores ven la página de WordPress, donde se muestran el último reporte de la conexión y su último error.

Qué hay en la página

Una sección por problema. Cada una dice qué notarás, cómo confirmarlo y cómo solucionarlo:

• El sitio está conectado y verificado, pero los pagos no regresan a él
• La API REST de WordPress está bloqueada
• WP-Cron no se está ejecutando
• Un plugin de seguridad está bloqueando las actualizaciones de ClubHelix
• Las páginas no cambian después de actualizar algo en ClubHelix
• El reloj del servidor está mal
• WordPress no tiene permiso para comunicarse con otros sitios web

Paso a paso

El sitio está conectado y verificado, pero los pagos no regresan a él

Qué notarás: Salud del sitio dice La propiedad del sitio está verificada, pero quienes pagan terminan en una página de ClubHelix en lugar de volver a tu sitio, tus widgets de ClubHelix no se muestran en él y no puedes convertirlo en tu sitio web público. En la pestaña Dominio del plugin quizá veas «Un administrador todavía no confirmó este sitio en ClubHelix».

Por qué: Verificado solo demuestra que el plugin controla la dirección del sitio. Un enlace de conexión puede nombrar cualquier sitio web, así que además un administrador tiene que confirmar en ClubHelix que el sitio es el de tu club. WordPress no puede hacer este paso por ti.

Solución:

1. Un administrador abre Gestión del sitio web → WordPress en el panel de administración de ClubHelix.
2. En Requiere tu atención, busca Un sitio nuevo está esperando que lo confirmes.
3. Marca Reconozco … como el sitio de WordPress de nuestro club y elige Confirmar este sitio. Si no reconoces la dirección, revoca la conexión.

Después de reinstalar el plugin o de volver a conectar, la nueva conexión se debe confirmar otra vez. Consulta WordPress para más información.

La API REST de WordPress está bloqueada

Qué notarás: Salud del sitio dice No han llegado actualizaciones recientes de ClubHelix, y los cambios hechos en ClubHelix tardan hasta 15 minutos en aparecer. Si estás trasladando tu sitio a ClubHelix, es posible que la migración pase a leer tus páginas de una en una.

Por qué: ClubHelix envía los avisos de actualización a /wp-json/clubhelix/v1/webhook en tu sitio. Algunos plugins de seguridad, y algunos plugins para «desactivar la API REST», bloquean todo lo que está bajo /wp-json/ para los visitantes que no iniciaron sesión. Eso incluye a ClubHelix.

Solución:

1. Abre https://tu-sitio/wp-json/ en una ventana privada del navegador. Si ves un error o una página de inicio de sesión en lugar de una página de texto, la API REST está bloqueada.
2. En el plugin que la bloquea, permite la ruta /wp-json/clubhelix/v1/webhook. La mayoría de estos plugins tienen una lista de rutas o espacios de nombres permitidos; agrega clubhelix/v1.
3. De vuelta en Salud del sitio, ejecuta las comprobaciones otra vez.

No necesitas abrir toda la API REST al público. La ruta de ClubHelix solo acepta mensajes firmados con el secreto de tu sitio e ignora todo lo demás.

WP-Cron no se está ejecutando

Qué notarás: Salud del sitio dice WP-Cron está desactivado o La tarea de respaldo de ClubHelix no se ejecuta desde hace más de una hora. Los eventos y partidos sincronizados quedan desactualizados cuando se pierde un aviso de actualización, y el informe diario de estado deja de llegar, por lo que la página de WordPress de ClubHelix dice que el plugin no se ha reportado.

Por qué: WordPress ejecuta las tareas programadas cuando alguien visita el sitio. En un sitio con poco tráfico, o cuando tu proveedor de alojamiento configuró DISABLE_WP_CRON en true en wp-config.php, es posible que esas tareas no se ejecuten en absoluto. El plugin las usa para consultar a ClubHelix si hay cambios cada 15 minutos, como respaldo de los avisos de actualización perdidos.

Solución:

• Si DISABLE_WP_CRON está definido, tu proveedor espera que una tarea real del servidor ejecute el programador de WordPress. Pídele que lo ejecute cada cinco minutos. En la mayoría de los proveedores es una tarea cron que llama a wp cron event run --due-now o que solicita https://tu-sitio/wp-cron.php?doing_wp_cron.
• En los proveedores administrados, busca un ajuste de «cron» o de «tareas programadas» en el panel de alojamiento.

Un plugin de seguridad está bloqueando las actualizaciones de ClubHelix

Qué notarás: La página de WordPress de ClubHelix muestra actualizaciones recientes que no llegaron, mientras que Salud del sitio muestra que la API REST funciona cuando la pruebas tú mismo.

Por qué: Los firewalls como Wordfence pueden limitar la frecuencia de las solicitudes que no vienen de un navegador, o bloquearlas. Los avisos de actualización de ClubHelix vienen de nuestros servidores, no de un navegador, así que una regla del firewall puede detenerlos.

Solución (Wordfence):

1. En WordPress, ve a Wordfence → Firewall → Todas las opciones del firewall.
2. En Opciones avanzadas del firewall, agrega /wp-json/clubhelix/v1/webhook a las URL permitidas.
3. Si la limitación de frecuencia está activada, asegúrate de que no bloquee esa dirección.

No permitas a ClubHelix por dirección IP. Nuestros servidores no tienen direcciones fijas, y la firma de cada aviso es lo que demuestra que viene de nosotros.

Otros plugins de seguridad tienen una lista de permitidos similar. Agrega la misma dirección allí.

Las páginas no cambian después de actualizar algo en ClubHelix

Qué notarás: Cambiaste un evento o un precio en ClubHelix, la actualización figura como entregada en la página de WordPress de ClubHelix, pero tu sitio sigue mostrando la versión anterior.

Por qué: Una caché de páginas está sirviendo una copia guardada de la página. El plugin vacía la caché de las páginas afectadas cuando llega una actualización, pero solo con los plugins de caché con los que sabe comunicarse (FlyingPress, LiteSpeed Cache y WP Rocket). No puede llegar a una caché que esté en el panel de tu proveedor de alojamiento o en una red de distribución de contenido.

Solución:

• Vacía la caché una vez desde tu plugin de caché o desde el panel de alojamiento, para confirmar que esta es la causa.
• Si usas una caché a nivel del proveedor o una red de distribución de contenido, define un tiempo de caché corto para las páginas que muestran bloques de ClubHelix, o pregunta a tu proveedor si se puede vaciar automáticamente.
• Los cambios siempre aparecen cuando vence la copia guardada, así que es una demora, no datos perdidos.

El reloj del servidor está mal

Qué notarás: Salud del sitio dice El reloj del servidor está mal, y los avisos de actualización se rechazan aunque no haya ningún otro problema.

Por qué: Cada aviso de actualización lleva la hora en que se envió, y el plugin rechaza uno que tenga más de cinco minutos. Eso evita que alguien reenvíe un aviso antiguo. Si el reloj de tu servidor está desfasado unos minutos, los avisos genuinos parecen antiguos y se rechazan.

Solución: Pide a tu proveedor de alojamiento que active la sincronización automática de la hora (NTP) en el servidor. No puedes solucionarlo desde el propio WordPress. Mientras tanto, la comprobación de 15 minutos mantiene tu sitio actualizado.

WordPress no tiene permiso para comunicarse con otros sitios web

Qué notarás: La conexión falla de inmediato, y los bloques muestran «No se pudo cargar … en este momento». Salud del sitio no tiene una comprobación propia para esto. Su comprobación de conexión dice Las llamadas a ClubHelix han estado fallando, normalmente con el código network_error.

Por qué: Algunos proveedores y configuraciones de seguridad agregan WP_HTTP_BLOCK_EXTERNAL a wp-config.php, lo que impide que WordPress se comunique con cualquier otro sitio web. El plugin necesita comunicarse con ClubHelix.

Solución: Mantén el bloqueo y agrega ClubHelix a la lista de sitios permitidos en wp-config.php:

define( 'WP_ACCESSIBLE_HOSTS', 'clubhelix.com' );

Si esa línea ya incluye otros sitios, agrega clubhelix.com a la lista, separado por una coma. Si no puedes editar wp-config.php, consulta a tu proveedor de alojamiento.

Referencia de campos

Cada comprobación muestra un título cuando todo está bien y otro cuando no. Los títulos son las palabras del propio plugin.

Consejos y preguntas frecuentes

Mi sitio sigue funcionando, ¿algo de esto es urgente? No. Los bloques de ClubHelix siguen mostrando su última copia buena cuando algo de esto falla, así que tu página de inicio nunca se rompe por nuestra causa. Solucionarlo mantiene esa copia al día.

¿Esto significa que hackearon mi sitio? No. Son ajustes de tu sitio o de tu servidor, y cada sección describe el ajuste involucrado.

¿Debo desactivar mi plugin de seguridad? No. Permite en cambio la dirección de ClubHelix. Cada aviso que llega a ella está firmado, así que permitirla no debilita tu sitio.

¿A quién contacto? Para cualquier paso de «Solución» que mencione a tu proveedor de alojamiento, contacta a tu proveedor. Si la página de WordPress de ClubHelix sigue mostrando un problema después de una solución, usa Reportar un error en tu panel de ClubHelix y cuéntanos qué comprobación está fallando.