{"id":8071,"date":"2023-08-14T14:21:13","date_gmt":"2023-08-14T21:21:13","guid":{"rendered":"https:\/\/membermouse.com\/?post_type=ht_kb&p=8071"},"modified":"2024-08-07T14:02:15","modified_gmt":"2024-08-07T18:02:15","slug":"membermouse-wordpress-hooks","status":"publish","type":"ht_kb","link":"https:\/\/membermouse.com\/fr\/docs\/membermouse-wordpress-hooks\/","title":{"rendered":"Crochets WordPress MemberMouse"},"content":{"rendered":"

Hooks are provided by WordPress to allow your plugin to ‘hook into’ the rest of WordPress; that is, to call functions in your plugin at specific times, and thereby set your plugin in motion. MemberMouse defines its own set of hooks that you can utilize to ‘hook into’ MemberMouse so you can call functions in your plugin when specific events occur in MemberMouse.<\/p>\n\n\n\n

Here’s a basic example: <\/p>\n\n\n\n

<\/div>\n\n\n\n
function memberAdded($data)\n{\n    \/\/ effectue l'action\n}\nadd_action('mm_member_add', 'memberAdded') ;\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
In this example, we’re using the ‘add_action()<\/a>‘ method to indicate that the ‘memberAdded() ‘method should be called when MemberMouse executes a ‘mm_member_add’ action. To learn more about working with WordPress’ Action API lire cet article<\/a>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Cat\u00e9gories de crochets WordPress<\/h5>\n\n\n\n
R\u00e9f\u00e9rence de l'action MemberMouse<\/h6>\n\n\n\n
The following table lists all of the MemberMouse actions, a description of when they’re executed and what data will be passed to any function hooked into the action.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Action<\/strong><\/td>Description<\/strong><\/td>Donn\u00e9es transmises<\/strong><\/td><\/tr>
mm_member_add<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'un nouveau membre est ajout\u00e9 \u00e0 MemberMouse.<\/td>donn\u00e9es des membres<\/a><\/td><\/tr>
mm_member_membership_change<\/code><\/td>This action is executed when a member’s membership level is changed.<\/td>donn\u00e9es des membres<\/a><\/td><\/tr>
mm_member_status_change<\/code><\/td>This action is executed when the status of a member’s account changes.<\/td>donn\u00e9es des membres<\/a><\/td><\/tr>
mm_member_account_update<\/code><\/td>This action is executed when certain data on a member’s account is updated.
Il s'agit du pr\u00e9nom, du nom de famille, de l'adresse \u00e9lectronique, du nom d'utilisateur et du num\u00e9ro de t\u00e9l\u00e9phone,
les notes, l'adresse de facturation, l'adresse de livraison, la m\u00e9thode de calcul du nombre de jours en tant que membre et les donn\u00e9es des champs personnalis\u00e9s.<\/td>		donn\u00e9es des membres<\/a><\/td><\/tr>
mm_member_delete<\/code><\/td>This action is executed when a member’s account is deleted.<\/td>donn\u00e9es des membres<\/a><\/td><\/tr>
mm_bundles_add<\/code><\/td>This action is executed when a bundle is added to a member’s account.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de la liasse<\/a><\/td><\/tr>
mm_bundles_status_change<\/code><\/td>This action is executed when the status of a bundle changes on a member’s account.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de la liasse<\/a><\/td><\/tr>
mm_product_purchase<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'une commande est soumise, avant la validation et le paiement.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de commande<\/a><\/td><\/tr>
mm_achat_complet<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'un achat est effectu\u00e9. Elle est disponible \u00e0 partir de la version 3.0.6 de MemberMouse.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de commande<\/a><\/td><\/tr>
mm_payment_received<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'un paiement est re\u00e7u.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de commande<\/a><\/td><\/tr>
mm_payment_rebill<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'un paiement de refacturation est re\u00e7u.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de commande<\/a><\/td><\/tr>
mm_payment_rebill_declined<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'un paiement de refacturation est refus\u00e9.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de commande<\/a><\/td><\/tr>
mm_refund_issued<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'un remboursement est \u00e9mis.<\/td>donn\u00e9es des membres<\/a>, donn\u00e9es de commande<\/a><\/td><\/tr>
mm_commission_initiale<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'une premi\u00e8re commission d'affili\u00e9 doit \u00eatre suivie.<\/td>donn\u00e9es sur les affili\u00e9s<\/a><\/td><\/tr>
mm_commission_rebill<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'une commission d'affiliation de type \"rebill\" doit \u00eatre suivie.<\/td>donn\u00e9es sur les affili\u00e9s<\/a><\/td><\/tr>
mm_commission_cancel<\/code><\/td>Cette action est ex\u00e9cut\u00e9e lorsqu'une commission d'affiliation doit \u00eatre annul\u00e9e.<\/td>donn\u00e9es sur les affili\u00e9s<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Attributs des donn\u00e9es par type<\/h5>\n\n\n\n
Toutes les donn\u00e9es sont transmises aux fonctions sous la forme d'un tableau associatif et sont accessibles de la mani\u00e8re suivante : <\/p>\n\n\n\n
<\/div>\n\n\n\n
$data[\"first_name\"]\n$data[\"last_name\"]\n$data[\"email\"]\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
Les sections ci-dessous \u00e9num\u00e8rent les attributs de donn\u00e9es disponibles pour chaque type.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Donn\u00e9es des membres<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Attribut<\/strong><\/td>Description<\/strong><\/td><\/tr>
num\u00e9ro de membre<\/code><\/td>L'identifiant attribu\u00e9 au membre par MemberMouse.<\/td><\/tr>
enregistr\u00e9<\/code><\/td>La date d'inscription du membre dans le format AAAA-MM-JJ HH:MM:SS.<\/td><\/tr>
dernier_cong\u00e9<\/code><\/td>Date de la derni\u00e8re connexion du membre au format AAAA-MM-JJ HH:MM:SS.<\/td><\/tr>
derni\u00e8re_mise_\u00e0_jour<\/code><\/td>The date the member’s account was last updated in the format YYYY-MM-DD HH:MM:SS.<\/td><\/tr>
jours_comme_me_membre<\/code><\/td>Le nombre de jours depuis lesquels le membre est membre.<\/td><\/tr>
statut<\/code><\/td>The status of the member’s account as an integer: 1 = active, 2 = canceled, 3 = locked, 4 = paused, 5 = overdue, 6 = pending activation, 7 = error, 8 = expired, 9 = pending cancellation<\/td><\/tr>
nom_du_statut<\/code><\/td>The status of the member’s account as a string (i.e. actif<\/em>, annul\u00e9<\/em>etc).<\/td><\/tr>
est_compl\u00e9mentaire<\/code><\/td>This indicates if the member’s account is complimentary or not. It will be set to ‘true’ if the account is complimentary and ‘false’ if not.<\/td><\/tr>
niveau d'adh\u00e9sion<\/code><\/td>The ID of the membership level associated with the member’s account.<\/td><\/tr>
nom_du_niveau_d'appartenance<\/code><\/td>The name of the membership level associated with the member’s account.<\/td><\/tr>
pr\u00e9nom<\/code><\/td>The member’s first name.<\/td><\/tr>
nom de famille<\/code><\/td>The member’s last name.<\/td><\/tr>
Nom d'utilisateur<\/code><\/td>The member’s username.<\/td><\/tr>
courriel<\/code><\/td>The member’s email address.<\/td><\/tr>
t\u00e9l\u00e9phone<\/code><\/td>The member’s phone number.<\/td><\/tr>
cf_#<\/code><\/td>Outputs the member’s value for the custom field with ID #. For example, if the ID of the custom field that stores birthday is 4 then to output the member’s birthday you would use ‘cf_4’.<\/td><\/tr>
adresse_de_facturation<\/code><\/td>The member’s billing address.<\/td><\/tr>
ville_de_facturation<\/code><\/td>The member’s billing city.<\/td><\/tr>
\u00e9tat de la facturation<\/code><\/td>The member’s billing state.<\/td><\/tr>
code postal de facturation<\/code><\/td>The member’s billing zip code.<\/td><\/tr>
pays de facturation<\/code><\/td>The member’s billing country.<\/td><\/tr>
adresse_d'exp\u00e9dition<\/code><\/td>The member’s shipping address.<\/td><\/tr>
ville_d'exp\u00e9dition<\/code><\/td>The member’s shipping city.<\/td><\/tr>
\u00e9tat_de_livraison<\/code><\/td>The member’s shipping state.<\/td><\/tr>
code postal<\/code><\/td>The member’s shipping zip code.<\/td><\/tr>
pays d'exp\u00e9dition<\/code><\/td>The member’s shipping country.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Donn\u00e9es de l'offre group\u00e9e<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Attribut<\/strong><\/td>Description<\/strong><\/td><\/tr>
bundle_id<\/code><\/td>L'ID de la liasse.<\/td><\/tr>
nom_du_groupe<\/code><\/td>Le nom de la liasse.<\/td><\/tr>
jours_avec_forfait<\/code><\/td>The number of days the bundle has been active on the member’s account.<\/td><\/tr>
bundle_status<\/code><\/td>Le statut de l'offre group\u00e9e : 1 = actif, 2 = annul\u00e9, 3 = verrouill\u00e9, 4 = en pause, 5 = en retard, 6 = en attente d'activation, 7 = erreur, 8 = expir\u00e9, 9 = en attente d'annulation.<\/td><\/tr>
bundle_is_complimentary<\/code><\/td>This indicates if the bundle is complimentary or not. It will be set to ‘true’ if the bundle is complimentary and ‘false’ if not.<\/td><\/tr>
bundle_status_name<\/code><\/td>Le statut de la liasse sous forme de cha\u00eene de caract\u00e8res (c'est-\u00e0-dire actif<\/em>, annul\u00e9<\/em>etc).<\/td><\/tr>
bundle_date_added<\/code><\/td>The date the bundle was added to the member’s account in the format YYYY-MM-DD HH:MM:SS.<\/td><\/tr>
bundle_last_updated<\/code><\/td>The date the bundle was last updated on the member’s account in the format YYYY-MM-DD HH:MM:SS.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Donn\u00e9es de commande<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Attribut<\/strong><\/td>Description<\/strong><\/td><\/tr>
num\u00e9ro de commande<\/code><\/td>Le num\u00e9ro de r\u00e9f\u00e9rence attribu\u00e9 \u00e0 la commande par MemberMouse.<\/td><\/tr>
order_transaction_id<\/code><\/td>The transaction ID associated with the order. This can be used as a unique ID for all payments associated with an order. When a customer purchases a subscription, each rebill payment is part of the same order so they’ll all share the same order ID. Each rebill payment will have a unique transaction ID.<\/td><\/tr>
total_de_la_commande<\/code><\/td>Le total de la commande qui est \u00e9gal \u00e0 (sous-total - remise) + frais de port.<\/td><\/tr>
commande_sous-total<\/code><\/td>Le sous-total de la commande.<\/td><\/tr>
remise_commande<\/code><\/td>La r\u00e9duction appliqu\u00e9e \u00e0 la commande.<\/td><\/tr>
commande_exp\u00e9dition<\/code><\/td>Frais d'exp\u00e9dition appliqu\u00e9s \u00e0 la commande.<\/td><\/tr>
m\u00e9thode_d'exp\u00e9dition_de_la_commande<\/code><\/td>Le nom de la m\u00e9thode d'exp\u00e9dition choisie par le client lors du paiement.<\/td><\/tr>
adresse_de_facturation_de_la_commande<\/code><\/td>L'adresse de facturation associ\u00e9e \u00e0 la commande.<\/td><\/tr>
ville_de_facturation_de_la_commande<\/code><\/td>La ville de facturation associ\u00e9e \u00e0 la commande.<\/td><\/tr>
\u00e9tat_de_la_facturation_de_la_commande<\/code><\/td>L'\u00e9tat de la facturation associ\u00e9 \u00e0 la commande.<\/td><\/tr>
code postal de facturation de la commande<\/code><\/td>Le code postal de facturation associ\u00e9 \u00e0 la commande.<\/td><\/tr>
pays_de_facturation_de_la_commande<\/code><\/td>Le pays de facturation associ\u00e9 \u00e0 la commande.<\/td><\/tr>
adresse_d'exp\u00e9dition_de_la_commande<\/code><\/td>L'adresse de livraison associ\u00e9e \u00e0 la commande.<\/td><\/tr>
ville_d'exp\u00e9dition_de_la_commande<\/code><\/td>La ville d'exp\u00e9dition associ\u00e9e \u00e0 la commande.<\/td><\/tr>
\u00e9tat_d'exp\u00e9dition_de_la_commande<\/code><\/td>L'\u00e9tat d'exp\u00e9dition associ\u00e9 \u00e0 la commande.<\/td><\/tr>
code postal de la commande<\/code><\/td>Le code postal d'exp\u00e9dition associ\u00e9 \u00e0 la commande.<\/td><\/tr>
pays_d'exp\u00e9dition_de_la_commande<\/code><\/td>Le pays d'exp\u00e9dition associ\u00e9 \u00e0 la commande.<\/td><\/tr>
commander_produits<\/code><\/td>Un tableau de produits associ\u00e9s \u00e0 la commande. Voir le tableau Donn\u00e9es sur le produit<\/em> Le tableau ci-dessous indique les param\u00e8tres disponibles pour chaque produit.<\/td><\/tr>
commander_coupons<\/code><\/td>Un tableau de coupons associ\u00e9s \u00e0 la commande. Voir le tableau Donn\u00e9es sur les coupons<\/em> tableau ci-dessous pour les param\u00e8tres disponibles pour chaque coupon.<\/td><\/tr>
prorata des commandes<\/code><\/td>Un tableau des prorata associ\u00e9s \u00e0 la commande. Voir le tableau Donn\u00e9es de proratisation<\/em> Le tableau ci-dessous indique les param\u00e8tres disponibles pour chaque \u00e9l\u00e9ment de proratisation.<\/td><\/tr>
order_affiliate_id<\/code><\/td>L'identifiant de l'affili\u00e9 associ\u00e9 \u00e0 la commande.<\/td><\/tr>
order_subaffiliate_id<\/code><\/td>L'identifiant du sous-affili\u00e9 associ\u00e9 \u00e0 la commande.<\/td><\/tr>
adresse_ip_de_la_commande<\/code><\/td>L'adresse IP associ\u00e9e \u00e0 la commande.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Donn\u00e9es sur les affili\u00e9s<\/h6>\n\n\n\n
<\/div>\n\n\n\n
Attribut<\/strong><\/td>Description<\/strong><\/td><\/tr>
order_affiliate_id<\/code><\/td>L'identifiant de l'affili\u00e9 associ\u00e9 \u00e0 la commande.<\/td><\/tr>
order_subaffiliate_id<\/code><\/td>L'identifiant du sous-affili\u00e9 associ\u00e9 \u00e0 la commande.<\/td><\/tr>
num\u00e9ro de membre<\/code><\/td>L'identifiant attribu\u00e9 au membre par MemberMouse.<\/td><\/tr>
num\u00e9ro de commande<\/code><\/td>Le num\u00e9ro unique associ\u00e9 \u00e0 la commande concat\u00e9n\u00e9 avec l'identifiant de la transaction associ\u00e9e au paiement (c'est-\u00e0-dire 1456-3462). Cela permet de s'assurer que le num\u00e9ro de commande fourni ici est unique pour toutes les transactions de refacturation associ\u00e9es \u00e0 la commande.<\/td><\/tr>
total_de_la_commande<\/code><\/td>Le total de la commande disponible pour les commissions qui est \u00e9gal au total de la commande moins les remises et les frais d'exp\u00e9dition.<\/td><\/tr>
adresse_ip_de_la_commande<\/code><\/td>L'adresse IP associ\u00e9e \u00e0 la commande.<\/td><\/tr>
commander_produits<\/code><\/td>Un tableau de produits associ\u00e9s \u00e0 la commande. Voir le tableau Donn\u00e9es sur le produit<\/em> Le tableau ci-dessous indique les param\u00e8tres disponibles pour chaque produit.<\/td><\/tr>
commander_coupons<\/code><\/td>Un tableau de coupons associ\u00e9s \u00e0 la commande. Voir le tableau Donn\u00e9es sur les coupons<\/em> tableau ci-dessous pour les param\u00e8tres disponibles pour chaque coupon.<\/td><\/tr>
prorata des commandes<\/code><\/td>Un tableau des prorata associ\u00e9s \u00e0 la commande. Voir le tableau Donn\u00e9es de proratisation<\/em> Le tableau ci-dessous indique les param\u00e8tres disponibles pour chaque \u00e9l\u00e9ment de proratisation.<\/td><\/tr>
taux fixe de la commission de refacturation<\/code><\/td>This will only be included on commission rebill events. Based on the commission profile applied to the order, this indicates if there’s a flat rate commission override that should be taken into account.<\/td><\/tr>
pourcent_de_la_commission_de_la_refacturation<\/code><\/td>This will only be included on commission rebill events. Based on the commission profile applied to the order, this indicates if there’s a percentage commission override that should be taken into account.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Donn\u00e9es sur le produit<\/h6>\n\n\n\n
Product data is stored as an array of JSON-encoded objects in the ‘order_products’ attribute and is included with Order Data and Affiliate Data. Prior to interacting with the array make sure to JSON decode is as follows:<\/p>\n\n\n\n
<\/div>\n\n\n\n
json_decode(stripslashes($data[\"order_products\"]) ;<\/code><\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
This sample code assumes that the data was passed to your script in variable called ‘$data’. The table below outlines the available parameters for each item in the ‘order_products’ array.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Attribut<\/strong><\/td>Description<\/strong><\/td><\/tr>
id<\/code><\/td>L'ID du produit.<\/td><\/tr>
nom<\/code><\/td>Le nom du produit.<\/td><\/tr>
sku<\/code><\/td>L'UGS du produit.<\/td><\/tr>
montant<\/code><\/td>Montant pay\u00e9 pour chaque unit\u00e9 du produit.<\/td><\/tr>
quantit\u00e9<\/code><\/td>Le nombre de ce produit achet\u00e9.<\/td><\/tr>
total<\/code><\/td>Le prix total pay\u00e9 \u00e9quivaut au montant * quantit\u00e9.<\/td><\/tr>
is_recurring<\/code><\/td>Indicates where this product has a subscription associated with it or not. Possible values are ‘true’ or ‘false’.<\/td><\/tr>
montant r\u00e9current<\/code><\/td>Le montant pay\u00e9 \u00e0 chaque p\u00e9riode de facturation.<\/td><\/tr>
p\u00e9riode de facturation<\/code><\/td>Un nombre entier repr\u00e9sentant la dur\u00e9e de la p\u00e9riode de facturation. Pour d\u00e9terminer la dur\u00e9e totale de la p\u00e9riode de refacturation, il faut la combiner avec rebill_frequency (c'est-\u00e0-dire 1 mois, 30 jours, 2 semaines, etc.).<\/td><\/tr>
fr\u00e9quence des re-facturations<\/code><\/td>Cha\u00eene de caract\u00e8res indiquant l'unit\u00e9 de mesure utilis\u00e9e pour la p\u00e9riode de facturation. Les valeurs possibles sont les jours, les semaines, les mois ou les ann\u00e9es.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Donn\u00e9es sur les coupons<\/h6>\n\n\n\n
Coupon data is stored as an array of JSON-encoded objects in the ‘order_coupons’ attribute and is included with Order Data and Affiliate Data. Prior to interacting with the array make sure to JSON decode is as follows:<\/p>\n\n\n\n
<\/div>\n\n\n\n
json_decode(stripslashes($data[\"order_coupons\"]) ;<\/code><\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
This sample code assumes that the data was passed to your script in variable called ‘$data’. The table below outlines the available parameters for each item in the ‘order_coupons’ array.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Attribut<\/strong><\/td>Description<\/strong><\/td><\/tr>
id<\/code><\/td>L'ID du coupon.<\/td><\/tr>
nom<\/code><\/td>Le nom du coupon.<\/td><\/tr>
code<\/code><\/td>Le code de r\u00e9duction.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Donn\u00e9es de proratisation<\/h6>\n\n\n\n
Proration data is stored as an array of JSON-encoded objects in the ‘order_prorations’ attribute and is included with Order Data and Affiliate Data. Prior to interacting with the array make sure to JSON decode is as follows:<\/p>\n\n\n\n
<\/div>\n\n\n\n
json_decode(stripslashes($data[\"order_prorations\"]) ;\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
This sample code assumes that the data was passed to your script in variable called ‘$data’. The table below outlines the available parameters for each item in the ‘order_prorations’ array.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Attribut<\/strong><\/td>Description<\/strong><\/td><\/tr>
montant<\/code><\/td>Le montant de la proratisation.<\/td><\/tr>
description<\/code><\/td>La description associ\u00e9e \u00e0 l'achat.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>","protected":false},"excerpt":{"rendered":"
Les hooks sont fournis par WordPress pour permettre \u00e0 votre plugin de \"s'accrocher\" au reste de WordPress, c'est-\u00e0-dire d'appeler des fonctions dans votre plugin \u00e0 des moments sp\u00e9cifiques, et ainsi...<\/p>","protected":false},"author":21411,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"footnotes":""},"ht-kb-category":[188],"ht-kb-tag":[],"class_list":["post-8071","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mm-wp-hooks-filters"],"acf":[],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t