Afiliados DM

Plugin de WordPress para gestión completa de programas de afiliados: registro de afiliados, enlaces de referido, tracking de visitas, comisiones, pagos y dashboard. Incluye integración automática con WooCommerce.

Características

• Registro de afiliados — formulario front-end ([adm_registro]) con aprobación manual o automática; también crea la cuenta de WordPress si el visitante no tiene una.
• Enlaces de referido — cada afiliado obtiene un enlace ?ref=ID que funciona sobre cualquier URL del sitio.
• Tracking de visitas — cookie configurable (30 días por defecto), registro de URL, origen e IP, marca de conversión.
• Comisiones — porcentaje o monto fijo, tasa global o por afiliado; ciclo de vida pending → unpaid → paid / rejected.
• Integración WooCommerce — crea la comisión al procesar el pedido, la aprueba al completarse y la rechaza si el pedido se reembolsa o cancela. Evita autocompras y duplicados por pedido.
• Pagos — botón "Pagar" liquida todas las comisiones pendientes del afiliado y registra el pago; pago mínimo configurable.
• Dashboard del afiliado — [adm_dashboard]: estadísticas, enlace de referido y últimas comisiones.
• Panel de administración — menú Afiliados en wp-admin: afiliados, comisiones, visitas, pagos y ajustes.

Instalación

1. Copia la carpeta afiliados-dm a wp-content/plugins/.
2. Activa Afiliados DM en Plugins.
3. Configura tasa, cookie y moneda en Afiliados → Ajustes.
4. Crea una página con [adm_registro] y otra con [adm_dashboard].

Con WP-CLI:

wp plugin activate afiliados-dm

Shortcodes

Hooks para desarrolladores

• adm_affiliate_added( $affiliate_id, $status )
• adm_affiliate_status_updated( $affiliate_id, $status )
• adm_referral_added( $referral_id, $affiliate_id, $amount )
• adm_referral_status_updated( $referral_id, $new_status, $old_status )
• adm_payout_created( $payout_id, $affiliate_id, $total )

Comisiones manuales y por API

ADM_Referrals::add( array(
    'affiliate_id' => 1,
    'base_amount'  => 500,          // aplica la tasa configurada
    'description'  => 'Venta externa',
    'reference'    => 'factura-123', // evita duplicados
    'context'      => 'custom',
    'status'       => 'unpaid',
) );

Requisitos

• WordPress 6.0+
• PHP 7.4+

Licencia

GPL-2.0-or-later