=== CMB SQLite Form ===
Contributors: cmorillas1
Tags: contact form, sqlite, forms, gdpr, anti-spam
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.9.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Un plugin modular, de alto rendimiento para formularios de contacto con SQLite, que incluye seguridad avanzada, funciones anti-spam y cero sobrecarga en la base de datos principal.

== Description ==

**CMB SQLite Form** es una solución de formularios de contacto ligera pero potente, diseñada pensando en el rendimiento y la privacidad. A diferencia de los plugins de formularios tradicionales que saturan tu base de datos principal de WordPress, este plugin almacena todos los envíos en una base de datos SQLite local y segura.

Cuenta con un robusto sistema de **Configuración Global vs. Por Formulario**, que te permite establecer los valores predeterminados una sola vez y anularlos solo cuando sea necesario para formularios específicos.

= Características Clave =

*   **🚀 Almacenamiento Cero-Sobrecarga**
    *   Utiliza un archivo de base de datos SQLite dedicado para los envíos.
    *   Mantiene tu base de datos principal de WordPress limpia y rápida.
    *   Datos portables: Descarga el archivo `.db` completo para copias de seguridad o migración.

*   **🛡️ Protección Avanzada contra Bots**
    *   **Campo Honeypot:** Campo invisible para atrapar bots.
    *   **Validación de Tiempo:** Rechaza los envíos que se rellenan demasiado rápido (análisis de comportamiento humano).
    *   **CAPTCHA Simple:** Preguntas ligeras basadas en texto (ej., "¿2 + 2 = ?") sin dependencias externas.

*   **📧 Protección contra Correo Electrónico Basura (Junk Email)**
    *   **Bloqueador de Correos Desechables:** Bloquea automáticamente las direcciones de correo electrónico temporales/desechables.
    *   **Múltiples Fuentes:** Soporta múltiples fuentes de listas de bloqueo con deduplicación automática.
    *   **Actualizaciones Automáticas:** Mantiene tu lista de bloqueo actualizada con un solo clic.

*   **🎨 Estilo Profesional**
    *   **Plantillas Prediseñadas:** Elige entre múltiples estilos profesionales (Predeterminado, Modo Oscuro, Minimalista, etc.).
    *   **Compatible con el Personalizador de WordPress:** Totalmente compatible con "CSS Adicional" para una personalización avanzada.
    *   **Diseño Responsivo:** Los formularios se ven muy bien en todos los dispositivos automáticamente.

*   **📨 Notificaciones de Correo Electrónico Flexibles**
    *   **Notificaciones Duales:** Envía correos distintos al Administrador (notificación) y al Usuario (confirmación).
    *   **Soporte SMTP Personalizado:** Configuración SMTP integrada (Host, Puerto, Auth, SSL/TLS) para evitar `wp_mail()` si es necesario.
    *   **Personalización del Remitente:** Personaliza el "Nombre del Remitente" y el "Correo del Remitente" por formulario.

*   **⚙️ Sistema de Configuración Inteligente**
    *   **Valores Predeterminados Globales:** Establece tus ajustes preferidos una vez para todo el sitio.
    *   **Anulaciones por Formulario:** Anula CUALQUIER configuración (campos, correos, estilo, protección) para formularios individuales.
    *   **Arquitectura Modular:** Habilita o deshabilita las funciones según sea necesario.

*   **📊 Gestión Completa de Entradas (Gratis)**
    *   **Envíos Ilimitados:** Sin límites en el número de entradas.
    *   **Buscar y Filtrar:** Encuentra fácilmente envíos específicos en el panel.
    *   **Herramientas de Exportación:** Descarga todos tus datos como CSV o copia de seguridad completa de la DB (a menudo una característica premium en otros plugins).

*   **🔒 Privacidad y GDPR**
    *   **Casilla de Consentimiento:** Campo integrado de aceptación de la política de privacidad.
    *   **Gestión de Datos:** Herramientas para exportar (CSV/DB) o eliminar datos al desinstalar.
    *   **Almacenamiento Local:** Los datos permanecen en tu servidor, no en nubes de terceros.

= Perfecto Para =

*   **Formularios de Contacto:** Páginas de contacto simples, rápidas y seguras.
*   **Generación de Leads:** Captura leads en páginas de aterrizaje con mínima fricción.
*   **Puertas de Descarga:** Entrega archivos (PDFs, ebooks) a través de enlaces de confirmación por correo.
*   **Solicitudes de Soporte:** Organiza las consultas de los clientes de manera eficiente.
*   **Solicitudes de Eventos y Presupuestos:** Recolección de datos estructurados para necesidades comerciales.
*   **Comentarios y Encuestas:** Recopila opiniones de usuarios sin servicios externos.
*   **Sitios de Alto Rendimiento:** Cero sobrecarga de base de datos mantiene tu sitio rápido.
*   **Proyectos Enfocados en la Privacidad:** Almacenamiento local con herramientas GDPR integradas.
*   **Desarrolladores y Agencias:** Arquitectura limpia que mantiene la DB principal optimizada.
*   **Propiedad de los Datos:** Acceso total a tus datos (ver/exportar) sin muros de pago.

== Installation ==

1.  Sube la carpeta `cmb-sqlite-form` al directorio `/wp-content/plugins/`.
2.  Activa el plugin a través del menú 'Plugins' en WordPress.
3.  Navega a **CMB SQLite Form** en el menú de administración.
4.  (Opcional) Configura tus **Ajustes Globales** para establecer valores predeterminados para todos los formularios.
5.  Crea un nuevo formulario y copia su shortcode: `[cmb_sqlite_form id="1"]`.

== Configuration ==

= Ajustes Globales vs. Por Formulario =
El plugin utiliza un sistema de herencia inteligente:
1.  **Ajustes Globales:** Definen el comportamiento predeterminado para TODOS los formularios (ej., tu servidor SMTP, estilo predeterminado, correo electrónico del administrador).
2.  **Ajustes del Formulario:** Al editar un formulario específico, puedes activar **"Anular Ajustes Globales"** en cualquier sección para personalizarla solo para ese formulario.

= Configuración de la Protección contra Bots =
1.  Ve a **Ajustes Globales > Protección contra Bots**.
2.  Habilita **Honeypot** (recomendado).
3.  Habilita **Validación de Tiempo** (ej., establece 3 segundos).
4.  (Opcional) Habilita **CAPTCHA** para formularios más estrictos.

= Configuración del Envío de Correos Electrónicos =
Puedes elegir cómo se envían los correos:
*   **Predeterminado de WordPress:** Utiliza la función estándar PHP `mail()` de tu servidor.
*   **SMTP Personalizado:** Ve a **Notificaciones > Servidor de Salida** para configurar un servidor SMTP específico (Gmail, SendGrid, etc.) para una entrega fiable.

== Frequently Asked Questions ==

= ¿Dónde se almacenan los datos? =
Los datos se almacenan en un archivo seguro `.db` (SQLite) dentro de tu directorio `wp-content/uploads/cmb-sqlite-form/`. Esto asegura que tu base de datos principal de WordPress permanezca intacta.

= ¿Puedo personalizar el CSS del formulario? =
¡Sí! Puedes seleccionar una plantilla predefinida en la sección **Estilo**. Para cambios específicos, utiliza el Personalizador de WordPress (**Apariencia > Personalizar > CSS Adicional**) y apunta a clases como `.cmbsqf-form`, `.cmbsqf-input` y `.cmbsqf-button`.

= ¿Cómo actualizo la lista de bloqueo de correos electrónicos desechables? =
Ve a **Protección contra Correo Electrónico Basura**, añade tus URL de origen (ej., de listas de GitHub) y haz clic en **"Actualizar Lista de Bloqueo Ahora"**. El plugin descargará, fusionará y deducirá los dominios automáticamente.

= ¿Qué sucede si desinstalo el plugin? =
Por defecto, los datos se conservan. Puedes habilitar **"Eliminar al Desinstalar"** en **Ajustes Globales > Gestión de Datos** si deseas borrar todos los formularios y entradas al eliminar el plugin.

== Screenshots ==

1.  **Panel de Formularios** - Vista general de todos tus formularios.
2.  **Ajustes Globales** - Configuración de valores predeterminados para todo el sitio.
3.  **Anulaciones del Formulario** - Personalización de ajustes específicos para un solo formulario.
4.  **Protección contra Bots** - Configuración de Honeypot, Validación de Tiempo y CAPTCHA.
5.  **Correo Electrónico Basura** - Gestión de listas de bloqueo y fuentes.
6.  **Gestión de Entradas** - Visualización y exportación de envíos.

== Changelog ==
= 0.9.3 =
*   Iconos Añadidos

= 0.9.2 =
*   Añadida la constante FORM_FIELDS para definiciones de campos.
*   Mejorada la sanitización de ajustes con una tabla de reglas explícita.
*   Añadida la validación realpath() para las plantillas CSS.
*   Mejorado el manejo de errores en las conexiones SQLite.
*   Corregida la codificación de las cabeceras de descarga.
*   Eliminada la duplicación de la puesta en cola de scripts.
*   Limpieza de código y mejoras en PHPDoc.

= 0.9.1 =
*	Error corregido

= 0.9.0 =
*   Lanzamiento inicial.
*   Implementación del motor de base de datos SQLite.
*   Arquitectura de ajustes Globales vs. Por Formulario.
*   Protección Avanzada contra Bots (Honeypot, Tiempo, CAPTCHA).
*   Protección contra Correo Electrónico Basura con listas de bloqueo de múltiples fuentes.
*   Sistema de estilos basado en plantillas.
*   Soporte para SMTP personalizado.
*   Herramientas de exportación a CSV y Base de Datos.
