Genera un plugin de puntos de fidelización para WooCommerce
Los programas de fidelización casi siempre se quedan cortos con el plugin genérico que instalas al principio. Marketing quiere "puntos dobles en la semana del cumpleaños". El contable quiere que el canje aparezca como línea de descuento en la factura, no como un total negativo aleatorio. Los clientes habituales deberían subir a VIP al alcanzar 500€ de gasto de por vida, y ese tier debería tener ratio de canje distinto. Cada pieza es trivial; juntas hacen que el plugin genérico se sienta equivocado.
Un plugin de fidelización generado se construye sobre tus reglas exactas de gane y canje. Creamos una tabla de ledger de puntos, enganchamos los eventos de gane a las transiciones de estado que importan y generamos el flujo de canje — como cupón, como opción de checkout, o como saldo tipo tarjeta regalo — que encaja con cómo tu tienda piensa las recompensas.
¿Por qué generarlo en vez de instalar un plugin existente?
YITH WooCommerce Points and Rewards (79-129€/año) y Points and Rewards for WooCommerce (99€/año) son decentes. Cubren los casos comunes y traen UI con toda la configuración. La fricción aparece en la cola: no puedes decir fácil "puntos extra si el pedido incluye X", o "ratio distinto para mayoristas", o "expiración a los 12 meses" sin subir de tier o escribir código encima.
El dato de fidelización también es un moat que conviene poseer. Un plugin custom guarda el ledger en tu DB, accesible por tus endpoints REST para apps móviles o kioskos. Nada pasa por SaaS externo.
La mayoría de tiendas no usan más de 4-6 reglas de gane y 2-3 patrones de canje. Un plugin enfocado haciendo esas 8-9 cosas bien, con un admin que sólo muestra esas 8-9 cosas, es más fácil de mantener que un genérico con 30 tipos de regla de los que 20 sobran.
Prompt de ejemplo
Este es el tipo de descripción que genera este plugin. Puedes partir de aquí y ajustar lo que necesites antes de generar.
Nombre del plugin: Acme Fidelización
Gane:
- 1 punto por 1 EUR gastado (neto de IVA) en pedidos completed.
- 2x puntos en la semana del cumpleaños del cliente (user meta).
- +50 bonus en el primer pedido.
- Se añaden al ledger cuando el pedido pasa a "completed"; se descuentan si se reembolsa.
Canje:
- 100 puntos = 1 EUR de descuento.
- Canje desde bloque en checkout: slider "Usar X puntos (tienes Y)".
- Aplica como línea de descuento (no cupón) para trazabilidad en factura.
- Mínimo 500 puntos para canjear.
Tiers:
- "Bronce" (por defecto).
- "Plata" al gastar 500 EUR (1,25 pts/EUR en adelante).
- "Oro" al gastar 2000 EUR (1,5 pts/EUR).
Expiración: 18 meses tras gane, limpieza cron diaria.
Admin:
- Listado de clientes con saldo + tier.
- Ajuste manual por cliente (sumar/restar con motivo).
Pestaña Mi cuenta "Recompensas" con saldo, historial, próximas expiraciones.
Compatible HPOS. Tabla ledger: acme_points_ledger (id, user_id, delta, reason, order_id, created_at, expires_at).Qué suele incluir el plugin generado
- Tabla ledger con dbDelta en activación y versión de esquema
- Hooks a woocommerce_order_status_completed y reembolsos
- Extensión del bloque de checkout con Store API register_endpoint_data
- Endpoint custom en Mi cuenta renderizando historial paginado
- WP_List_Table mostrando clientes con saldo + tier
- Cron diario limpiando expirados + recálculo de gasto total
- Lecturas de pedido HPOS-compatible
Añade bonus por referido, puntos por compartir en redes, canje por reseñas, regalos por tier — describe la mecánica y el plugin la implementa.
Preguntas frecuentes
¿Verán los clientes su saldo?
Sí, en Mi cuenta y opcionalmente con shortcode [acme_points_balance] en cualquier parte (p.ej. el header). También endpoint REST si tienes app móvil.
¿Qué pasa con los puntos al reembolsar?
Por defecto se revierten al pasar el pedido a refunded. Si prefieres un periodo de gracia o política distinta (sólo reembolsos totales), descríbelo y se refleja.
¿Puedo migrar desde otro plugin?
Sí, si produces un CSV con user_id y saldo actual, añadimos import (WP-CLI o admin) que siembra el ledger con una entrada de migración por usuario. El historial antiguo no se preserva si no puedes exportarlo.
¿Cómo trabaja con HPOS?
El ledger tiene su propia tabla (no post meta de pedido). Referenciamos pedidos por order_id, y todas las lecturas usan $order->get_meta() / wc_get_order(). Declaramos HPOS en before_woocommerce_init.