Este artículo explica de forma clara, detallada y práctica cómo conectar paquetes y membresías del sistema BUQ con una página web diseñada en Elementor, utilizando atributos personalizados en los botones.
Está pensado para:
Clientes
Equipos técnicos
Equipos de soporte
Partners
¿Qué vas a lograr con esta guía?
Al finalizar este tutorial podrás:
Conectar un botón de Elementor con un paquete de BUQ.
Conectar un botón de Elementor con una membresía de BUQ.
Definir correctamente la ubicación donde se aplicará la compra.
Evitar errores comunes de configuración.
¿Cómo funciona la integración?
BUQ se conecta con tu sitio web mediante atributos personalizados en los botones. Estos atributos le indican al sistema:
Qué tipo de producto se está vendiendo (paquete o membresía)
Qué producto específico debe cargar
En qué ubicación debe aplicarse la compra
Esto permite que el botón abra directamente el checkout de BUQ, con el producto correcto precargado.
Requisitos previos
Antes de comenzar, asegúrate de contar con:
Acceso al administrador de WordPress
Elementor instalado y activo
Acceso al panel administrativo de BUQ
El ID del paquete o membresía
El ID de la ubicación
Conceptos clave
¿Qué es el ID del producto?
Es el identificador único del paquete o membresía dentro de BUQ.
Cada paquete y cada membresía tiene su propio ID.
¿Qué es el ID de ubicación?
Es el identificador de la sucursal o ubicación física donde se aplicará la compra.
Esto permite que BUQ asigne correctamente la venta.
Parte 1 – Cómo conectar un PAQUETE con Elementor
Atributos necesarios para paquetes
Para conectar un paquete, usaremos estos tres atributos:
data-gf-theme | purchase-button
data-bq-combo-id | ID_DEL_PAQUETE
data-bq-location-id | ID_DE_LA_UBICACION
Ejemplo real:
data-gf-theme|purchase-button
data-bq-combo-id|2397
data-bq-location-id|285
Paso 1 – Obtener el ID del paquete
Ingresa al panel de BUQ.
Ve al módulo de Paquetes.
Abre el paquete que deseas vender.
Copia el ID del paquete.
Ejemplo:
2397
Paso 2 – Obtener el ID de la ubicación
Ingresa al panel de BUQ.
Ve al módulo de Ubicaciones.
Abre la sucursal deseada.
Copia el ID de ubicación.
Ejemplo:
285
Paso 3 – Crear o editar el botón en Elementor
Abre tu página con Elementor.
Arrastra un widget de Botón.
Personaliza el diseño (texto, color, tamaño, etc.).
Ejemplo de texto:
Comprar paquete
Paso 4 – Configurar los atributos del botón
Selecciona el botón.
Ve a la pestaña Avanzado.
Busca la sección Atributos.
Da clic en Agregar elemento.
Agrega los siguientes atributos:
Atributo 1
Clave:
data-gf-theme
Valor:
purchase-button
Atributo 2
Clave:
data-bq-combo-id
Valor:
2397
Atributo 3
Clave:
data-bq-location-id
Valor:
285
Resultado final para paquetes
data-gf-theme|purchase-button
data-bq-combo-id|2397
data-bq-location-id|285
Parte 2 – Cómo conectar una MEMBRESÍA con Elementor
La configuración es muy similar, solo cambia un atributo clave.
Atributos necesarios para membresías
data-gf-theme | purchase-button
data-bq-membership-id | ID_DE_LA_MEMBRESIA
data-bq-location-id | ID_DE_LA_UBICACION
Ejemplo real:
data-gf-theme|purchase-button
data-bq-membership-id|981
data-bq-location-id|285
Paso 1 – Obtener el ID de la membresía
Ingresa al panel de BUQ.
Ve al módulo de Membresías.
Abre la membresía que deseas vender.
Copia el ID de la membresía.
Ejemplo:
981
Paso 2 – Configurar el botón en Elementor
Repite el mismo proceso:
Selecciona el botón.
Ve a Avanzado → Atributos.
Agrega los siguientes valores:
Atributo 1
Clave:
data-gf-theme
Valor:
purchase-button
Atributo 2
Clave:
data-bq-membership-id
Valor:
981
Atributo 3
Clave:
data-bq-location-id
Valor:
285
Resultado final para membresías
data-gf-theme|purchase-button
data-bq-membership-id|981
data-bq-location-id|285
Parte 3 – Validación y pruebas
Cómo verificar que todo funciona correctamente
Guarda los cambios.
Abre la página publicada.
Haz clic en el botón.
Resultado esperado:
Se abre el checkout de BUQ.
El producto aparece precargado automáticamente.
Se muestra la ubicación correcta.
Errores comunes y soluciones
El botón no hace nada
Verifica que exista este atributo:
data-gf-theme|purchase-button
Abre checkout sin producto
Revisa:
Que el ID sea correcto.
Que el atributo corresponda al tipo correcto:
Paquete → data-bq-combo-id
Membresía → data-bq-membership-id
Error de ubicación
Verifica que:
data-bq-location-id
corresponda a una ubicación activa.
Buenas prácticas
Usar copiar / pegar para evitar errores tipográficos.
Probar siempre en modo incógnito.
Crear un botón independiente por producto.
Crear un botón independiente por ubicación si manejas varias sucursales.
Plantillas rápidas (copy & paste)
Paquete
data-gf-theme|purchase-button
data-bq-combo-id|ID_PAQUETE
data-bq-location-id|ID_UBICACION
Membresía
data-gf-theme|purchase-button
data-bq-membership-id|ID_MEMBRESIA
data-bq-location-id|ID_UBICACION
Resultado final
Con esta configuración puedes:
Integrar BUQ con Elementor sin desarrollos extra.
Vender paquetes y membresías directamente desde tu web.
Centralizar pagos, membresías y reservas en BUQ.