{"id":14525,"date":"2023-09-26T15:04:16","date_gmt":"2023-09-26T15:04:16","guid":{"rendered":"http:\/\/a8759758b2.nxcli.io\/?post_type=docs&#038;p=14525"},"modified":"2026-01-07T23:02:13","modified_gmt":"2026-01-07T23:02:13","password":"","slug":"developpeurs","status":"publish","type":"docs","link":"https:\/\/couponaffiliates.com\/fr\/documents\/developpeurs\/","title":{"rendered":"D\u00e9veloppeurs : Extraits de code et ressources"},"content":{"rendered":"<p>Nous ne disposons pas actuellement d'une documentation approfondie pour les d\u00e9veloppeurs, mais voici quelques extraits de code et ressources utiles pour les d\u00e9veloppeurs, qui peuvent \u00eatre utiles ou que d'autres clients ont demand\u00e9s dans le pass\u00e9.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Tables de la base de donn\u00e9es<\/h2>\n\n\n\n<p>Le plugin poss\u00e8de ses propres tables de base de donn\u00e9es \u00e0 partir desquelles vous pouvez obtenir certaines donn\u00e9es :<\/p>\n\n\n\n<p>wcusage_activity - Journal d'activit\u00e9.<\/p>\n\n\n\n<p>wcusage_campaigns - Campagnes d'URL de r\u00e9f\u00e9rence.<\/p>\n\n\n\n<p>wcusage_clicks - Journal des clics de l'URL de r\u00e9f\u00e9rence.<\/p>\n\n\n\n<p>wcusage_directlinks - Domaines de suivi des liens directs.<\/p>\n\n\n\n<p>wcusage_mlainvites - Invitations d'affili\u00e9s multi-niveaux.<\/p>\n\n\n\n<p>wcusage_payouts - Paiement des commissions<\/p>\n\n\n\n<p>wcusage_register - Applications d'enregistrement des affili\u00e9s.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Commandes des affili\u00e9s<\/h2>\n\n\n\n<p>Obtenir toutes les commandes d'affili\u00e9s pour un coupon, sans certaines plages de donn\u00e9es. Cette fonction renvoie un tableau de donn\u00e9es comprenant le total des calculs pour toutes les commandes et toutes les commandes individuelles.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 ) ;<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Donn\u00e9es de commande<\/h2>\n\n\n\n<p>Cette fonction vous permet d'obtenir un tableau de donn\u00e9es relatives \u00e0 l'affiliation pour une certaine commande. Cette fonction renvoie un tableau de donn\u00e9es comprenant les revenus de la commission.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$order_data = wcusage_calculate_order_data( $order_id, $coupon_code, 0, 1 ) ;<\/code><\/pre>\n\n\n\n<p>Pour obtenir la commission de la commande, par exemple :<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$commission = $order_data['totalcommission'] ;<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">URL de l'affili\u00e9<\/h2>\n\n\n\n<p>La fonction suivante permet d'obtenir l'URL d'affiliation d'un coupon :<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$coupon_code = \"\" ; \/\/ D\u00e9finissez ici le nom du code du coupon.\n$affiliate_url = wcusage_get_affiliate_url($coupon_code) ;<\/code><\/pre>\n\n\n\n<p>Si vous souhaitez cr\u00e9er votre propre URL, voici un exemple :<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$coupon_code = \"\" ; \/\/ D\u00e9finissez ici le nom du code du coupon.\n$prefix = wcusage_get_setting_value('wcusage_field_urls_prefix', 'coupon') ;\n$affiliate_url = get_home_url() . \" ?\" . $prefix . \"=\" . $coupon_code ;<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Total des ventes et des commissions<\/h2>\n\n\n\n<p>Obtenez le total des ventes et des commissions gagn\u00e9es par un certain coupon, sans une certaine plage de dates. <em>Laissez $start_date vide pour obtenir toutes les ventes.<\/em><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$orders = wcusage_wh_getOrderbyCouponCode( $coupon_code, $start_date, $end_date, '', 1 ) ;\n$total_orders = $orders['total_orders'] ; \/\/ Total des ventes\n$total_discounts = $orders['full_discount'] ; \/\/ Total des remises\n$total_commission = $orders['total_commission'] ; \/\/ Commission totale\n$order_count = $orders['total_count'] ; \/\/ Nombre de commandes<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Commission non r\u00e9mun\u00e9r\u00e9e<\/h2>\n\n\n\n<p>Obtenir la commission totale non pay\u00e9e pour un coupon d'affili\u00e9.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$coupon_id = \"\" ; \/\/ D\u00e9finissez ici l'ID du code du coupon.\n$unpaid_commission = get_post_meta( $coupon_id, 'wcu_text_unpaid_commission', true ) ;<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Crochet (Action) : Inscription d'un nouvel affili\u00e9<\/h2>\n\n\n\n<p>Lorsqu'il y a une nouvelle inscription d'affili\u00e9, il lance le hook \"wcusage_hook_registration_new\" qui transmet l'ID de l'inscription, l'ID de l'utilisateur et le code du coupon.<\/p>\n\n\n\n<p>Vous pouvez donc appeler ce crochet pour accepter automatiquement l'enregistrement sous certaines conditions avec la fonction \"wcusage_set_registration_status\". Par exemple, cette fonction acceptera automatiquement l'enregistrement si le r\u00f4le de l'utilisateur est \"exemple\" :<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>add_action('wcusage_hook_registration_new', 'trigger_wcusage_hook_registration_new', 10, 3 ) ;\nfunction trigger_wcusage_hook_registration_new( $registration_id, $user_id, $coupon_code ) {\n    $user_info = get_userdata( $user_id ) ;\n    $roles = $user_info-&gt;roles ;\n\n    if ( in_array( 'example', $roles ) ) {\n        wcusage_set_registration_status( 'accepted', $registration_id, $user_id, $coupon_code, '', '' ) ;\n    }\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Crochet (Action) : Nouvel affili\u00e9 accept\u00e9<\/h2>\n\n\n\n<p>Lorsqu'un nouvel affili\u00e9 est accept\u00e9 et ajout\u00e9 \u00e0 votre programme, il ex\u00e9cute le \"wcusage_hook_affiliate_register_accepted\" qui transmet les \u00e9l\u00e9ments suivants :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>$id - ID d'enregistrement.<\/li>\n\n\n\n<li>$userid - Identifiant de l'utilisateur.<\/li>\n\n\n\n<li>$coupon_code - Code Coupon.<\/li>\n\n\n\n<li>$message - Le message d'acceptation de l'enregistrement.<\/li>\n\n\n\n<li>$status - Le statut de leur enregistrement.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>add_action( 'wcusage_hook_affiliate_register_accepted', 'trigger_wcusage_hook_registration_accepted', 10, 5 ) ;\nfunction trigger_wcusage_hook_registration_accepted( $id, $userid, $coupon_code, $message, $status ) {\n\/\/ Votre code ici.\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Point final API : Informations sur les coupons<\/h2>\n\n\n\n<p>Le <code>Informations sur les coupons<\/code> vous permet de r\u00e9cup\u00e9rer les d\u00e9tails d'un coupon sp\u00e9cifique \u00e0 l'aide de son ID. Cela inclut le nom du coupon, la commission non pay\u00e9e et les paiements en attente, ce qui en fait un outil essentiel pour suivre les performances des coupons et le statut des paiements. Seuls les administrateurs peuvent acc\u00e9der \u00e0 ce point de terminaison.<\/p>\n\n\n\n<p>Pour utiliser l'API, envoyez un <strong>GET<\/strong> demande \u00e0 <code>\/wp-json\/woo-coupon-usage\/v1\/coupon-info<\/code> avec le param\u00e8tre requis <code>coupon_id<\/code> (l'identifiant du coupon que vous souhaitez interroger). La r\u00e9ponse comprendra un tableau contenant les <code>nom_du_coupon<\/code>, <code>commission_non_r\u00e9mun\u00e9r\u00e9e<\/code>et <code>paiements en attente<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Point final de l'API : Coupons d'utilisateurs<\/h2>\n\n\n\n<p>Le <code>Coupons de l'utilisateur<\/code> vous permet de r\u00e9cup\u00e9rer une liste d'identifiants de coupons attribu\u00e9s \u00e0 un utilisateur sp\u00e9cifique, ainsi que la commission non pay\u00e9e qui leur est associ\u00e9e. Cette fonctionnalit\u00e9 est utile pour contr\u00f4ler et g\u00e9rer les attributions de coupons et les commissions propres \u00e0 un utilisateur. L'acc\u00e8s \u00e0 ce point de terminaison est limit\u00e9 aux administrateurs.<\/p>\n\n\n\n<p>Pour utiliser l'API, envoyez un <strong>GET<\/strong> demande \u00e0 <code>\/wp-json\/woo-coupon-usage\/v1\/users-coupons<\/code> avec le param\u00e8tre requis <code>utilisateur<\/code> (le nom de connexion de l'utilisateur dont vous souhaitez r\u00e9cup\u00e9rer les coupons). L'API renvoie un tableau d'identifiants de coupons avec leur commission non pay\u00e9e, ce qui permet d'avoir une vue d'ensemble de l'activit\u00e9 de l'utilisateur en mati\u00e8re de coupons.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Point final API : Demande de paiement<\/h2>\n\n\n\n<p>Le <code>Demande de paiement<\/code> Ce point de terminaison de l'API vous permet de d\u00e9clencher des demandes de paiement pour un coupon sp\u00e9cifique. Il v\u00e9rifie l'utilisateur qui demande le paiement et v\u00e9rifie si la commission non pay\u00e9e du coupon est valide et pr\u00eate \u00e0 \u00eatre trait\u00e9e.<\/p>\n\n\n\n<p>Pour utiliser l'API, cr\u00e9ez un <strong>POST<\/strong> demande \u00e0 <code>\/wp-json\/woo-coupon-usage\/v1\/request-payout<\/code> avec deux param\u00e8tres obligatoires : <code>coupon_id<\/code> (l'ID du coupon) et <code>utilisateur<\/code> (le nom de connexion de l'utilisateur qui demande le paiement). Assurez-vous que l'utilisateur qui appelle a des droits d'administrateur. Si la validation est r\u00e9ussie, le syst\u00e8me traite la demande de paiement et renvoie les informations suivantes <code>1<\/code> pour r\u00e9ussir ou <code>0<\/code> de l'\u00e9chec.<\/p>\n\n\n\n<p>&#8212;<\/p>\n\n\n\n<p>Vous avez besoin d'aide pour une fonction personnalis\u00e9e ? N'h\u00e9sitez pas \u00e0 nous contacter et nous pourrons peut-\u00eatre vous orienter dans la bonne direction.<\/p>","protected":false},"excerpt":{"rendered":"<p>Nous ne disposons pas actuellement d'une documentation d\u00e9taill\u00e9e pour les d\u00e9veloppeurs, mais voici quelques extraits de code et ressources utiles pour les d\u00e9veloppeurs, qui peuvent \u00eatre utiles ou que d'autres clients ont demand\u00e9 dans le pass\u00e9. Tables de la base de donn\u00e9es Le plugin poss\u00e8de ses propres tables de base de donn\u00e9es \u00e0 partir desquelles vous pouvez obtenir certaines donn\u00e9es : wcusage_activity - Journal d'activit\u00e9. wcusage_campaigns [...]<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","footnotes":"","_links_to":"","_links_to_target":""},"doc_category":[136],"doc_tag":[],"class_list":["post-14525","docs","type-docs","status-publish","hentry","doc_category-developers","wpbf-post"],"year_month":"2026-04","word_count":872,"total_views":"3266","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Elliot Sowersby","author_link":"#"},"doc_category_info":[{"term_name":"Developers","term_url":"https:\/\/couponaffiliates.com\/fr\/categorie-docs\/developpeurs\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":136,"label":"Developers"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs\/14525","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/comments?post=14525"}],"version-history":[{"count":24,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs\/14525\/revisions"}],"predecessor-version":[{"id":22499,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs\/14525\/revisions\/22499"}],"wp:attachment":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/media?parent=14525"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/doc_category?post=14525"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/doc_tag?post=14525"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}