Documentación Oficial: BuenForm

BuenForm es el sistema de construcción y gestión de formularios avanzados de Buenclick Suite. A diferencia de otros plugins tradicionales, está construido al 100% sobre la tecnología nativa de bloques de WordPress (Gutenberg), ofreciendo una experiencia de diseño visual fluida y un rendimiento excepcional en la base de datos.

1. Constructor Visual Nativo (Bloques de Gutenberg)

BuenForm no utiliza interfaces «Drag and Drop» pesadas o de terceros. Su arquitectura registra bloques personalizados en el editor nativo de WordPress (mediante los archivos ubicados en el directorio blocks/), garantizando la compatibilidad con cualquier tema moderno (Full Site Editing).

La jerarquía de los bloques disponibles es la siguiente:

  • Bloque Contenedor (buenclick/form): Es la envoltura principal. En sus ajustes laterales puedes configurar el correo electrónico de destino para las notificaciones, el mensaje de éxito y la acción tras enviar el formulario.
  • Bloques Estructurales (buenclick/step): BuenForm soporta formularios de múltiples pasos nativamente. Puedes organizar campos largos separándolos en «Steps» (Pasos) para mejorar la tasa de conversión. El frontend (bform-frontend.js) se encargará de crear la navegación y las animaciones de transición automáticamente.
  • Bloques de Campos: field-text (texto corto), field-textarea (párrafos), field-email (validación de correo), field-checkbox, field-radio y field-select (desplegables).
  • Bloque de Envío (buenclick/submit): Botón personalizable para procesar el formulario.

2. Base de Datos Desacoplada y Optimizada

El problema común de los plugins de formularios es que guardan cada respuesta como un Custom Post Type en wp_posts, lo que degrada el rendimiento de toda la web con el tiempo. El módulo Buenform_DB resuelve esto instalando tablas relacionales propias, completamente separadas:

  • wp_bform_entries: Guarda la metadata principal del envío (fecha, IP, URL de origen, formulario asociado).
  • wp_bform_entry_values: Almacena las respuestas individuales vinculadas a los campos exactos, indexadas para consultas ultrarrápidas.

3. API REST y Webhooks (Captura Automática de Leads)

La clase Buenform_API expone endpoints seguros que no solo reciben los envíos AJAX del frontend del sitio, sino que también actúan como receptores (listeners) de aplicaciones externas.

  • Google Ads Webhook: Si conectas una extensión de formularios para clientes potenciales de Google Ads directamente a la API de BuenForm, el plugin procesará los datos entrantes automáticamente, guardará la entrada en la base de datos etiquetándola con el meta source: google_ads, y te enviará una notificación inmediata por correo.
  • Hooks para Desarrolladores: Dispara filtros como buenclick_suite_google_ads_lead_received para inyectar estos leads en otras herramientas de la suite (ej. BuenChat o Hubspot).

4. Gestión de Entradas (Dashboard)

A través de la clase Buenform_Entries_Table, el panel de administración centraliza la vista de prospectos:

  • Muestra un listado interactivo con columnas dinámicas según los campos del formulario.
  • Identifica rápidamente de dónde proviene el contacto (tráfico orgánico vs. anuncios).
  • Permite la exportación masiva o filtrada a archivos CSV para cargarlos en hojas de cálculo o CRMs externos.

5. Frontend y Validaciones

El motor frontend (bform-frontend.js y bform-frontend.css) opera de forma ligera y asíncrona:

  • Evita la recarga de página (AJAX submission).
  • Realiza validaciones de campos obligatorios, formatos de email y estructura directamente en el navegador antes de consumir recursos del servidor.
  • Está preparado para convivir con los sistemas de seguridad de Buenclick Hub (como Google reCAPTCHA v3) en formularios públicos sensibles al spam.

6. Configuración Rápida

  1. Dirígete a cualquier Página, Entrada o Custom Post Type en tu editor de WordPress.
  2. Añade el bloque BuenForm (Formulario) buscando en el listado de bloques.
  3. En la barra lateral derecha (Ajustes del Bloque), configura a qué correo deseas que lleguen las notificaciones y cuál será el mensaje de éxito.
  4. Dentro del marco del formulario, añade los campos que requieras (Texto, Email, Selección).
  5. Si deseas hacerlo de múltiples pasos, añade primero el bloque Paso de Formulario (Step) e ingresa los campos dentro de él. Crea tantos pasos como necesites.
  6. Guarda o publica la página. Para ver o descargar los envíos, dirígete a Buenclick Hub > Formularios en el menú de WordPress.