Edit History

⚽ CF Football Bypass para PrestaShop

Módulo de PrestaShop que automatiza el cambio entre los modos **Proxied** y **DNS Only** en Cloudflare cuando se aplican bloqueos masivos durante partidos de fútbol.  

El módulo obtiene el feed de [hayahora.futbol](https://hayahora.futbol/) y activa/desactiva los registros DNS seleccionados para mantener accesible tu tienda legítima, con un periodo de enfriamiento configurable antes de reactivar Cloudflare.  

---

 🚀 Instalación rápida

1. Descarga el archivo ZIP desde https://github.com/JoseManuelPedraja/cf-football-bypass-prestashop/releases
2. Copia la carpeta `cffootballbypass` en el directorio de módulos de tu PrestaShop:  
3. Desde el **Back Office** de PrestaShop, ve a **Módulos > Gestor de módulos** y activa **CF Football Bypass**.  
4. Configura el módulo en **Parámetros Avanzados > CF Football Bypass**, donde podrás ajustar:  
- El intervalo de comprobación  
- El periodo de enfriamiento tras desactivar Cloudflare  
- Los registros DNS que quieres gestionar  

---

⚙️ Requisitos

- PrestaShop 8 o superior  
- Cuenta activa en Cloudflare  
- Acceso a API de Cloudflare con permisos para gestionar DNS  

GitHub del poryecto  

https://github.com/JoseManuelPedraja/cf-football-bypass-prestashop

cffootballbypass.zip

CF Football Bypass es un módulo de PrestaShop que automatiza la gestión de registros DNS en Cloudflare. Alterna automáticamente entre modo Proxy (CDN) y DNS Only según detecte bloqueos en tu sitio web.

Es especialmente útil para sitios que sufren bloqueos de IP periódicos y necesitan activar/desactivar rápidamente el proxy de Cloudflare sin intervención manual.

¿Qué hace?

✅ Monitorea automáticamente el estado de tu dominio

✅ Alterna entre Proxy ON (CDN) y Proxy OFF (DNS Only) según bloqueos detectados

✅ Interfaz gráfica intuitiva en el backoffice de PrestaShop

✅ Panel de control con botones para acciones manuales

✅ Compatibilidad con autenticación Global API Key y API Token de Cloudflare

✅ Caché persistente de registros DNS

✅ Sistema de logs para auditoría

✅ Soporte para intervalos configurables de comprobación

Requisitos

PrestaShop: 8.1.0 o superior

PHP: 7.4 o superior (recomendado 8.0+)

Cloudflare: Zona activa con acceso a API

Credenciales de Cloudflare: API Key o Token Bearer

Instalación

1. Descarga el módulo

Descarga los archivos del módulo y colócalos en:

/modules/cffootballbypass/

2. Estructura de carpetas necesaria

Asegúrate de que existan estas carpetas:

/modules/cffootballbypass/ ├── controllers/ │ └── front/ │ └── ajax.php ├── logs/ ├── cffootballbypass.php └── index.php

3. Instala desde el backoffice

Ve a Administración → Módulos y busca "CF Football Bypass". Haz clic en Instalar.

4. Configura las credenciales de Cloudflare

En la página de configuración del módulo:

Selecciona el tipo de autenticación:

Global API Key: Requiere tu email de Cloudflare

API Token: No requiere email (recomendado)

Ingresa tu API Key o Token de Cloudflare

Ingresa tu Zone ID (lo encuentras en el dashboard de Cloudflare)

Haz clic en Guardar

Configuración

Parámetros principales

Tipo de autenticación: Global API Key o API Token Bearer

Intervalo de comprobación: 5-60 minutos (por defecto 15)

Cooldown tras desactivar: Tiempo de espera antes de reactivar (5-1440 minutos)

Registro de acciones: Habilita/deshabilita los logs

Retención de logs: Días que se guardan los registros

Uso del panel de control

Probar conexión y cargar DNS: Verifica la conexión con Cloudflare y carga los registros DNS disponibles

Comprobación manual: Ejecuta un chequeo manual del estado

Forzar Proxy OFF: Desactiva el proxy en los registros seleccionados

Forzar Proxy ON: Activa el proxy en los registros seleccionados

Características técnicas

API utilizada

Cloudflare API v4: https://api.cloudflare.com/client/v4/

Tipos de registros soportados

A (IPv4)

AAAA (IPv6)

CNAME

Métodos de validación

Verificación de credenciales antes de guardar configuración

Validación de Zone ID

Comprobación de acceso a registros DNS

Almacenamiento

Configuración: Base de datos de PrestaShop (tabla ps_configuration)

Logs: Archivo JSON en /modules/cffootballbypass/logs/cfb-actions.log

Caché DNS: Base de datos de PrestaShop

Archivos incluidos

Estructura principal

cffootballbypass.php // Clase principal del módulo controllers/ └── front/ └── ajax.php // Controlador AJAX para operaciones logs/ └── cfb-actions.log // Archivo de logs (se crea automáticamente)

Métodos públicos principales

quickSettingsTest(): Verifica la conexión con Cloudflare

computeStatusesFromJson(): Calcula el estado actual del dominio

fetchDnsRecords(): Obtiene los registros DNS de Cloudflare

updateRecordProxyStatus(): Actualiza el estado proxy de un registro

refreshDnsCache(): Refresca la caché de registros DNS

checkFootballAndManageCloudflare(): Ejecuta la comprobación automática

Troubleshooting

Error: "Acceso denegado"

Solución: Asegúrate de que el archivo controllers/front/ajax.php existe y está en la ruta correcta.

Error: "Conexión con Cloudflare fallida"

Verifica:

API Key/Token es correcto

Zone ID es válido

Las credenciales tienen permisos para acceder a la zona

Los registros DNS no se cargan

Comprueba:

Que exista al menos un registro A, AAAA o CNAME en tu zona de Cloudflare

Que el Token/API Key tenga permisos de lectura en dns_records

Notas de seguridad

⚠️ Importante:

Guarda tus credenciales de Cloudflare en un lugar seguro

No compartas tu API Key o Token

Usa API Tokens con permisos limitados (recomendado)

El módulo valida todas las credenciales antes de guardar

Soporte y contribuciones

Si encuentras bugs o tienes sugerencias de mejora:

Describe detalladamente el problema

Incluye la versión de PrestaShop y PHP

Comparte los logs del módulo (/modules/cffootballbypass/logs/cfb-actions.log)

GitHub del poryecto  

https://github.com/JoseManuelPedraja/cf-football-bypass-prestashop

cffootballbypass.zip