Utilisation de l'interface PHP

MemberMouse vous offre une large gamme de SmartTags™ que vous pouvez utiliser pour créer une expérience dynamique pour vos membres. Il existe des SmartTags™ qui affichent le nom du membre actuel, son adresse électronique et d'autres informations. Il existe des balises que vous pouvez utiliser pour permettre aux membres de gérer leurs abonnements, d'autres pour modifier le contenu en fonction des droits d'accès du membre actuel, et bien plus encore !

Tout cela est très utile lorsque vous travaillez dans l'éditeur de contenu de WordPress, mais qu'en est-il si vous voulez pouvoir faire tout cela dans un script PHP personnalisé ?

C'est là que l'interface PHP entre en jeu.

NOTE: MemberMouse requiert actuellement PHP 7. Nous recommandons la dernière version de la branche PHP 7. Veuillez consulter notre Exigences en matière de système et d'hébergement pour obtenir les informations les plus récentes.

Exigences relatives à l'interface PHP

Les fonctions d'interface PHP nécessitent l'accès aux bibliothèques MemberMouse pour fonctionner. Lorsque vous utilisez les fonctions d'interface PHP dans un modèle WordPress, ces bibliothèques sont automatiquement chargées. Toutefois, si vous souhaitez les utiliser dans un script PHP autonome, vous devez charger manuellement les bibliothèques MemberMouse en ajoutant les includes suivantes au début de votre fichier :

require_once("wp-load.php") ;
require_once("wp-content/plugins/membermouse/includes/mm-constants.php") ;
require_once("wp-content/plugins/membermouse/includes/init.php") ;

Si votre script est situé dans le répertoire racine de WordPress, vous pouvez utiliser les includes exactement comme ils sont présentés ci-dessus. Si votre script est situé dans un autre répertoire, vous devez mettre à jour les chemins de fichiers de manière appropriée.

Traduire les SmartTags™ dans les fonctions PHP

L'interface PHP de MemberMouse vous permet d'utiliser les MemberMouse SmartTags™ directement dans un script PHP personnalisé. Vous pouvez utiliser n'importe quel plugin WordPress pour l'exécution de PHP (c'est-à-dire PHP Exec) pour utiliser les fonctions de l'interface PHP directement dans l'éditeur de contenu de WordPress. Toutes les balises SmartTags™ sont prises en charge par l'interface PHP, à l'exception des balises MM_Form... et MM_Error... SmartTags™.

Lors de l'utilisation des SmartTags™ dans l'éditeur de contenu de WordPress, la syntaxe suivante est utilisée :

[MM_Member_Data name='email']
[MM_Member_Decision membershipId='2|3']...[/MM_Member_Decision].

Les SmartTags™ sont transformés en leur équivalent dans l'interface PHP en prenant le nom SmartTag™, en le mettant en minuscules et en ajoutant des parenthèses pour en faire une fonction PHP valide.

Ainsi, par exemple, [ MM_Order_Data ] devient mm_order_data ( ). 

Les attributs sont transmis aux fonctions d'interface PHP sous la forme d'un tableau associatif.

Voici quelques exemples :

mm_member_data(array("name"=>"email"))
mm_member_decision(array("isMember"=>"true", "membershipId"=>"2|3"))

La fonction d'interface PHP accepte tous les mêmes attributs que le SmartTag™ lui-même. Se référer à la fonction Documentation SmartTag™ pour une liste d'attributs par SmartTag™.

Valeurs de retour

mm_..._data() renvoient une chaîne de caractères contenant les données demandées.

mm_..._link() renvoient une chaîne de caractères contenant une URL ou une fonction javascript qui doit être placée à l'intérieur d'un fichier <a> ou  pour en faire un lien fonctionnel.

mm_..._decision() fonctions retour vrai ou faux en fonction des attributs transmis à la fonction et du contexte dans lequel elle est exécutée.

Exemples

Pour voir des exemples d'utilisation de chaque SmartTag™ en PHP, télécharger l'exemple de script.