Les filtres sont des fonctions par lesquelles WordPress fait passer les donn\u00e9es, \u00e0 certains moments de l'ex\u00e9cution, juste avant d'effectuer une action sur les donn\u00e9es. MemberMouse d\u00e9finit son propre ensemble de filtres que vous pouvez utiliser pour contr\u00f4ler le flux d'ex\u00e9cution dans MemberMouse avant que certaines actions ne soient effectu\u00e9es.<\/p>\n\n\n\n
Voici un exemple de base :<\/p>\n\n\n\n
function customContentProtection($data)\n{\n return true ;\n}\nadd_filter('mm_bypass_content_protection', 'customContentProtection') ;\n<\/code><\/pre>\n\n\n\n<\/div>\n\n\n\nDans cet exemple, nous utilisons le add_filter()<\/em><\/a> pour indiquer que la m\u00e9thode customContentProtection()<\/em> doit \u00eatre appel\u00e9e lorsque MemberMouse applique la m\u00e9thode mm_bypass_content_protection<\/em> filtre. <\/p>\n\n\n\nPour en savoir plus sur l'utilisation de l'API d'action de WordPress lire cet article<\/a>.<\/p>\n\n\n\nR\u00e9f\u00e9rence du filtre MemberMouse<\/h2>\n\n\n\n
Voici une liste de tous les filtres MemberMouse, une description du moment o\u00f9 ils sont ex\u00e9cut\u00e9s et des informations sur les donn\u00e9es qui seront transmises \u00e0 toute fonction connect\u00e9e au filtre.<\/p>\n\n\n\n
<\/div>\n\n\n\nIntervalle d'analyse de la facturation<\/h3>\n\n\n\n
mm_intervalle_de_facturation<\/strong><\/p>\n\n\n\nMemberMouse 3.0+<\/mark><\/em><\/p>\n\n\n\nMemberMouse ex\u00e9cute p\u00e9riodiquement un WP-Cron<\/a> qui recherche les abonnements devant \u00eatre refactur\u00e9s et les met en file d'attente en vue de leur traitement par le syst\u00e8me de facturation local. Par d\u00e9faut, les analyses sont effectu\u00e9es toutes les quinze minutes. Ce filtre vous permet de modifier l'intervalle entre les analyses, ce qui peut s'av\u00e9rer utile pour optimiser les performances de votre site. <\/p>\n\n\n\nLe plugin passe un seul argument $scanInterval<\/code> \u00e0 votre fonction, un nombre entier repr\u00e9sentant le nombre de minutes par d\u00e9faut entre les balayages. Votre fonction doit renvoyer un nombre entier repr\u00e9sentant le nombre de minutes souhait\u00e9 entre les analyses. Par exemple, la fonction suivante recherche les abonnements pr\u00eats \u00e0 \u00eatre factur\u00e9s toutes les cinq minutes :<\/p>\n\n\n\nfunction customBillingScanInterval($scanInterval)\n{\n retourne 5 ;\n}\nadd_filter(\"mm_billing_scan_interval\", \"customBillingScanInterval\", 10, 2) ;\n<\/code><\/pre>\n\n\n\n<\/div>\n\n\n\n
\n\n\n\nIntervalle de relance de l'abonnement<\/h3>\n\n\n\n
mm_billing_subscription_dunning_intervalle<\/strong><\/p>\n\n\n\nMemberMouse 3.0+<\/mark><\/em><\/p>\n\n\n\nSi un abonnement n'est pas factur\u00e9 \u00e0 la date pr\u00e9vue, MemberMouse effectue trois tentatives suppl\u00e9mentaires pour recouvrer le paiement. Ce filtre vous permet de contr\u00f4ler l'intervalle entre les tentatives.<\/p>\n\n\n\n
MemberMouse transmet deux arguments \u00e0 votre fonction. Le premier est un entier $failureIntervalle<\/code> qui repr\u00e9sente le nombre de jours par d\u00e9faut avant la prochaine tentative. Le deuxi\u00e8me est un nombre entier $failureState<\/code> qui repr\u00e9sente l'\u00e9tat d'\u00e9chec particulier de la facturation. Il existe actuellement trois \u00e9tats d'\u00e9chec : 2, 3 et 4, qui repr\u00e9sentent respectivement la deuxi\u00e8me, la troisi\u00e8me et la derni\u00e8re tentative de recouvrement.<\/p>\n\n\n\nVotre fonction doit renvoyer un nombre entier repr\u00e9sentant le nombre de jours qui doivent s'\u00e9couler avant la prochaine tentative. Voici un exemple qui reproduit les intervalles de relance par d\u00e9faut :<\/p>\n\n\n\n
function customDunningInterval($failureInterval, $failureState)\n{\n switch ($failureState)\n {\n case 2 :\n return 2 ; \/\/ Premi\u00e8re tentative, deux jours apr\u00e8s l'\u00e9chec de la refacturation initiale.\n \n case 3 :\n return 3 ; \/\/ Deuxi\u00e8me tentative, trois jours apr\u00e8s la premi\u00e8re tentative.\n \n cas 4 : return 2 ; \/\/ Troisi\u00e8me tentative, deux jours apr\u00e8s la deuxi\u00e8me tentative\n return 2 ; \/\/ Troisi\u00e8me tentative, deux jours apr\u00e8s la deuxi\u00e8me.\n \n par d\u00e9faut :\n return $failureInterval ;\n }\n}\nadd_filter(\"mm_billing_subscription_dunning_interval\", \"customDunningInterval\", 10, 2) ;<\/code><\/pre>\n\n\n\nPour personnaliser les intervalles de relance, il vous suffit de modifier les valeurs renvoy\u00e9es dans les trois instructions de cas pour obtenir la dur\u00e9e souhait\u00e9e en jours.<\/p>\n\n\n\n
<\/div>\n\n\n\n
\n\n\n\nAcc\u00e8s en bloc<\/h3>\n\n\n\n
mm_block_access<\/strong><\/p>\n\n\n\nCe filtre est appliqu\u00e9 apr\u00e8s que MemberMouse a d\u00e9termin\u00e9 que le visiteur actuel a acc\u00e8s au contenu, et vous permet de bloquer s\u00e9lectivement l'acc\u00e8s au contenu prot\u00e9g\u00e9.<\/p>\n\n\n\n
MemberMouse transmet une valeur bool\u00e9enne $blockAccess<\/code> \u00e0 votre fonction, indiquant si elle bloque l'acc\u00e8s au contenu par d\u00e9faut. Votre fonction doit renvoyer un bool\u00e9en indiquant si MemberMouse doit bloquer l'acc\u00e8s au contenu.<\/p>\n\n\n\nPar exemple, pour emp\u00eacher tous les membres d'acc\u00e9der \u00e0 des contenus prot\u00e9g\u00e9s :<\/p>\n\n\n\n
function blockMemberAccess($blockAccess)\n{\n return true ;\n}\nadd_filter(\"mm_block_access\", \"blockMemberAccess\", 10, 2) ;\n<\/code><\/pre>\n\n\n\n<\/div>\n\n\n\n
\n\n\n\nContourner la protection du contenu<\/h3>\n\n\n\n
mm_bypass_content_protection<\/strong><\/p>\n\n\n\nCe filtre est appliqu\u00e9 apr\u00e8s que MemberMouse a d\u00e9termin\u00e9 que le visiteur actuel n'a pas acc\u00e8s au contenu, et vous permet de contourner s\u00e9lectivement la protection du contenu. <\/p>\n\n\n\n
MemberMouse transmet une valeur bool\u00e9enne $allowAccess<\/code> \u00e0 votre fonction, indiquant si elle doit permettre l'acc\u00e8s au contenu par d\u00e9faut. Votre fonction doit renvoyer un bool\u00e9en indiquant si MemberMouse doit autoriser l'acc\u00e8s au contenu.<\/p>\n\n\n\nPar exemple, l'option suivante permet \u00e0 tous les membres auxquels a \u00e9t\u00e9 attribu\u00e9 le droit de vote d'avoir acc\u00e8s \u00e0 l'information sur les droits d'auteur. Contributeur<\/em> l'acc\u00e8s \u00e0 toutes les pages et \u00e0 tous les messages prot\u00e9g\u00e9s : <\/p>\n\n\n\nfunction allowAccessForContributors($allowAccess)\n{\n if (current_user_can(\"contributor\"))\n {\n return true ;\n }\n else\n {\n return $allowAccess ;\n }\n}\nadd_filter(\"mm_bypass_content_protection\", \"allowAccessForContributors\", 10, 2) ;\n<\/code><\/pre>\n\n\n\nVeuillez noter que si ce filtre permet d'acc\u00e9der \u00e0 des pages et \u00e0 des messages qui seraient autrement inaccessibles, il n'a pas d'incidence sur l'analyse des SmartTags de d\u00e9cision.<\/p>\n\n\n\n
<\/div>\n\n\n\n
\n\n\n\nRedirection de la connexion<\/h3>\n\n\n\n
mm_login_redirect<\/strong><\/p>\n\n\n\nCe filtre est appliqu\u00e9 avant que MemberMouse n'ex\u00e9cute son comportement de redirection de connexion par d\u00e9faut, \u00e0 savoir configur\u00e9 dans les param\u00e8tres de la page d'accueil des membres<\/a>. Renvoyer une URL pour indiquer que MemberMouse doit rediriger l'utilisateur vers cette URL. Renvoyer une cha\u00eene vide pour indiquer que MemberMouse doit utiliser ses propres r\u00e8gles internes pour d\u00e9terminer o\u00f9 l'utilisateur doit \u00eatre envoy\u00e9.<\/p>\n\n\n\nL'objet transmis \u00e0 votre fonction contient l'URL vers laquelle MemberMouse redirigera l'utilisateur si vous ne renvoyez pas d'URL de remplacement et un objet utilisateur contenant des donn\u00e9es sur l'utilisateur connect\u00e9.
Si le nom de l'objet dans votre fonction est $infoObj<\/code> vous acc\u00e9derez aux deux \u00e9l\u00e9ments de donn\u00e9es comme suit :<\/p>\n\n\n\n<\/div>\n\n\n\n$infoObj->currentUrl\n$infoObj->user<\/code><\/pre>\n\n\n\n
\n\n\n\n<\/p>\n\n\n\n
Descripteur de la d\u00e9claration de stripe<\/h3>\n\n\n\n
mm_stripe_billing_statement_descriptor<\/strong><\/p>\n\n\n\nLorsque MemberMouse lance une refacturation, il envoie diverses donn\u00e9es descriptives sur la charge. Le descripteur de relev\u00e9 est ce qui sera affich\u00e9 au client sur sa facture de carte de cr\u00e9dit, et il est \u00e9galement visible dans Stripe. Ce filtre vous permet de personnaliser le descripteur de relev\u00e9 pour les transactions de refacturation.<\/p>\n\n\n\n
Veuillez noter que la longueur totale maximale du descripteur de relev\u00e9 est de 22 caract\u00e8res, et que l'envoi d'une cha\u00eene plus longue entra\u00eenera l'\u00e9chec du traitement du paiement. De plus, les donn\u00e9es que vous envoyez peuvent \u00eatre tronqu\u00e9es. Stripe cr\u00e9e finalement un \"descripteur de relev\u00e9 calcul\u00e9\" en ajoutant le descripteur que vous envoyez au descripteur abr\u00e9g\u00e9 sp\u00e9cifi\u00e9 dans la section Tableau de bord Stripe Param\u00e8tres publics<\/a>mais la longueur maximale de cette cha\u00eene calcul\u00e9e est \u00e9galement de 22 caract\u00e8res, et tout ce qui d\u00e9passe cette longueur sera rejet\u00e9. <\/p>\n\n\n\nPour calculer la longueur maximale du contenu qui sera affich\u00e9, utilisez la formule suivante :<\/p>\n\n\n\n
longueur maximale affich\u00e9e = 22 - (longueur du descripteur raccourci + 2)<\/em><\/p>\n\n\n\nMemberMouse transmet deux param\u00e8tres \u00e0 votre fonction. Le premier est $descripteur<\/code> qui est une cha\u00eene contenant les informations que MemberMouse enverra si elle n'est pas modifi\u00e9e. La seconde est 1TP4Commande<\/code> qui est un objet de classe standard contenant les donn\u00e9es de l'ordre MemberMouse, que vous pouvez utiliser pour construire le descripteur de d\u00e9claration. <\/p>\n\n\n\nVoici un exemple : <\/p>\n\n\n\n
add_filter(\"mm_stripe_billing_statement_descriptor\", function($descriptor, $order)\n{\n\n $descriptor = \"Commande # : \" . $order->orderNumber ;\n $maxLengthDescriptor = substr($descriptor,0,22) ;\n return $maxLengthDescriptor ;\n}, 1, 2) ;<\/code><\/pre>\n\n\n\nSi votre descripteur abr\u00e9g\u00e9 est ABC<\/em> vos clients devraient voir quelque chose comme cela sur leurs relev\u00e9s de carte de cr\u00e9dit :<\/p>\n\n\n\nABC* R\u00e9f\u00e9rence # : 10043<\/em><\/p>\n\n\n\nCe filtre ne peut agir que sur les re-facturations, et non sur les paiements initiaux. <\/p>\n\n\n\n
<\/div>\n\n\n\n
\n\n\n\nStripe PaymentIntent Description<\/h3>\n\n\n\n
mm_stripe_paymentintent_description<\/strong><\/p>\n\n\n\nUn autre \u00e9l\u00e9ment de donn\u00e9es envoy\u00e9 \u00e0 Stripe avec les factures est la description, que ce filtre vous permet de personnaliser. La description est l'une des colonnes qui s'affichent lorsque vous s\u00e9lectionnez Paiements<\/em> dans Stripe Dashboard. La longueur maximale de ce champ est de 350 caract\u00e8res.<\/p>\n\n\n\nMemberMouse transmet deux param\u00e8tres \u00e0 votre fonction. Le premier est $description<\/code> qui est une cha\u00eene contenant les informations que MemberMouse enverra si elle n'est pas modifi\u00e9e. La seconde est 1TP4Commande<\/code> qui est un objet de classe standard contenant les donn\u00e9es de l'ordre MemberMouse, que vous pouvez utiliser pour construire la description. <\/p>\n\n\n\nPar exemple, pour attribuer \u00e0 ce champ la valeur Order# 1234, Item : Adh\u00e9sion num\u00e9rique <\/em>vous pouvez utiliser la fonction suivante dans votre plugin :<\/p>\n\n\n\nadd_filter('mm_stripe_paymentintent_description', function($description, $order)\n{\n $description = \"Commande # \" . $order->orderNumber ;\n if (isset($order->orderProducts) && is_array($order->orderProducts))\n {\n $description .= \", Article : \" . array_pop($order->orderProducts)->description ;\n }\n return $description ;\n}, 1, 2) ;<\/code><\/pre>\n\n\n\nCe filtre ne peut agir que sur les re-facturations et non sur les paiements initiaux. Pour voir toutes les donn\u00e9es auxquelles il est possible d'acc\u00e9der sur le site Web de la 1TP4Commande<\/code> voir cet objet\u00a0exemple d'objet de commande<\/a>.<\/p>\n\n\n\n<\/div>\n\n\n\n
\n\n\n\nFiltres par d\u00e9faut de MemberMouse<\/h2>\n\n\n\n
Il s'agit de filtres inclus dans le plugin qui peuvent \u00eatre remplac\u00e9s dans votre code personnalis\u00e9 \u00e0 l'aide de la fonction remove_filter<\/a> pour mettre en \u0153uvre vos propres filtres.<\/p>\n\n\n\n<\/div>\n\n\n\nValidateur de la force du mot de passe<\/h3>\n\n\n\n
mm_password_strength_validator<\/strong><\/p>\n\n\n\n\u00c0 partir de la version 2.2.9, MemberMouse prend en charge l'ajout d'un filtre de validation de mot de passe personnalis\u00e9. Cela permet d'\u00e9valuer le mot de passe en fonction d'exigences personnalis\u00e9es. Par d\u00e9faut, MemberMouse associe un filtre de base qui v\u00e9rifie que le mot de passe comporte au moins 8 caract\u00e8res. Les d\u00e9veloppeurs ont la possibilit\u00e9 d'ajouter un filtre suppl\u00e9mentaire qui sera appliqu\u00e9 en conjonction avec le filtre par d\u00e9faut, ou de supprimer le filtre par d\u00e9faut et de le remplacer par un filtre personnalis\u00e9.<\/p>\n\n\n\n