En la actualidad no disponemos de documentación detallada para desarrolladores, pero aquí tiene algunos fragmentos de código y recursos útiles para desarrolladores.
Tablas de la base de datos
El plugin tiene sus propias tablas de base de datos de las que puedes obtener ciertos datos:
wcusage_activity - Registro de actividad.
wcusage_campaigns - Campañas de URL de referencia.
wcusage_clicks - Registro de clics en URL de referencia.
wcusage_directlinks - Dominios de seguimiento de enlaces directos.
wcusage_mlainvites - Invitaciones para afiliados multinivel.
wcusage_payouts - Pago de comisiones
wcusage_register - Aplicaciones de registro de afiliados.
Pedidos de afiliados
Obtiene todos los pedidos de afiliados de un cupón, sin un rango de datos determinado. Esto devuelve un array de datos que incluye los cálculos totales de todos los pedidos, y todos los pedidos individuales.
$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 );Datos del pedido
Puede obtener un array de datos relacionados con afiliados para un determinado pedido a través de esta función. Esto devuelve una matriz de datos incluyendo las ganancias de comisión.
$order_data = wcusage_calculate_order_data( $order_id, $coupon_code, 0, 1 );Para obtener la comisión del pedido, por ejemplo:
$commission = $order_data['totalcommission'];URL de afiliado
Obtenga la URL de afiliación de un cupón mediante la siguiente función:
$coupon_code = ""; // Establezca aquí el nombre del código del cupón.
$affiliate_url = wcusage_get_affiliate_url($coupon_code);O si quieres construir tu propia URL personalizada aquí tienes un ejemplo:
$coupon_code = ""; // Establezca aquí el nombre del código del cupón.
$prefix = wcusage_get_setting_value('wcusage_field_urls_prefix', 'coupon');
$affiliate_url = get_home_url() . "?" . $prefix . "=" . 1TP4Código_cupón;Total ventas y comisiones
Obtenga el total de ventas y comisiones obtenidas por un cupón determinado, sin un intervalo de fechas determinado. Deje $start_date vacío para obtener todas las ventas.
$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 );
$total_orders = $orders['total_orders']; // Ventas totales
$total_discounts = $orders['full_discount']; // Descuentos totales
$total_commission = $orders['total_commission']; // Comisión total
$order_count = $orders['total_count']; // Recuento de pedidosComisión no pagada
Obtén la comisión total no pagada por un cupón de afiliado.
$coupon_id = ""; // Establezca aquí el ID del código del cupón.
$unpaid_commission = get_post_meta( $coupon_id, 'wcu_text_unpaid_commission', true );Gancho (Acción): Registro de nuevos afiliados
Cuando haya un nuevo registro de afiliado, se ejecutará el hook "wcusage_hook_registration_new" que pasará el ID de registro, el ID de usuario y el código de cupón.
Por lo tanto, podría llamar a este hook para aceptar automáticamente el registro bajo ciertas condiciones con la función "wcusage_set_registration_status". Por ejemplo, esto aceptará automáticamente el registro si el rol del usuario es "ejemplo":
add_action( 'wcusage_hook_registration_new', 'trigger_wcusage_hook_registration_new', 10, 3 );
function trigger_wcusage_hook_registration_new( $registration_id, $user_id, $coupon_code ) {
$user_info = get_userdata( $user_id );
$roles = $user_info->roles;
if ( in_array( 'ejemplo', $roles ) ) {
wcusage_set_registration_status( 'accepted', $registration_id, $user_id, $coupon_code, '', '' );
}
}Gancho (Acción): Nuevo afiliado aceptado
Cuando un nuevo afiliado es aceptado y añadido a su programa, se ejecutará el "wcusage_hook_affiliate_register_accepted" que pasará lo siguiente:
- $id - ID de registro.
- $userid - ID de usuario.
- $coupon_code - Código del cupón.
- $message - El mensaje de aceptación del registro.
- $status - El estado de su registro.
add_action( 'wcusage_hook_affiliate_register_accepted', 'trigger_wcusage_hook_registration_accepted', 10, 5 );
function trigger_wcusage_hook_registration_accepted( $id, $userid, $coupon_code, $message, $status ) {
// Su código aquí.
}API Endpoint: Información del cupón
En Información sobre cupones le permite obtener información detallada sobre un cupón específico por su ID. Esto incluye el nombre del cupón, la comisión no pagada y los pagos pendientes, por lo que es una herramienta esencial para el seguimiento del rendimiento del cupón y el estado de los pagos. Sólo los administradores pueden acceder a este punto final.
Para utilizar la API, envíe un GET solicitar a /wp-json/woo-coupon-usage/v1/coupon-info con el parámetro requerido cupón_id (el ID del cupón que desea consultar). La respuesta incluirá una matriz que contendrá nombre_cupón, comisión_no_pagaday pagos_pendientes.
API Endpoint: Cupones de usuarios
En Cupones de usuario El punto final de API le permite recuperar una lista de ID de cupón asignados a un usuario específico, junto con su comisión no pagada asociada. Esta funcionalidad es útil para supervisar y gestionar las asignaciones de cupones y comisiones específicas de un usuario. El acceso a este punto final está limitado a los administradores.
Para utilizar la API, envíe un GET solicitar a /wp-json/woo-coupon-usage/v1/users-coupons con el parámetro requerido usuario (el nombre de usuario cuyos cupones desea recuperar). La API devolverá una matriz de ID de cupón junto con su comisión no pagada, proporcionando una visión general de la actividad de cupones del usuario.
API Endpoint: Solicitar pago
En Solicitar pago El punto final de API le permite activar solicitudes de pago para un cupón específico. Verifica el usuario que solicita el pago y comprueba si la comisión no pagada del cupón es válida y está lista para su procesamiento.
Para utilizar la API, haga una POST solicitar a /wp-json/woo-coupon-usage/v1/request-payout con dos parámetros obligatorios: cupón_id (el ID del cupón) y usuario (el nombre de usuario del usuario que solicita el pago). Asegúrese de que el usuario que llama tiene permisos de administrador. Si la validación es correcta, el sistema procesa la solicitud de pago y devuelve 1 para el éxito o 0 para el fracaso.
—
¿Necesita ayuda con una función personalizada? Póngase en contacto con nosotros y le indicaremos cómo hacerlo.
English 
Spanish 
German 
French