Vue d'ensemble de l'utilisation de l'addon MemberPress Developer Tools

Note: Cette option est réservée aux abonnés à la formule « Scale » de MemberPress. Si vous êtes abonné à une autre formule, vous pouvez passer à la formule « Scale ». Pour ce faire, cliquez sur le Plan de changement sur votre page du compte.

Note: Si vous n'êtes pas développeur, vous trouverez peut-être notre Intégration Zapier, WP Fusionou le Uncanny Automator plus facile à utiliser.

MemberPress Developer Tools Add-on (module d'extension des outils de développement) étend MemberPress pour inclure un API REST complète et capacité d'événements Webhook complète.

Note: Veuillez noter qu'à partir de la version 1.2.14, nous avons supprimé l'argument du mot de passe pour la création et la mise à jour des membres car il présente un risque de sécurité.

Si la documentation présente sur cette page semble succincte en ce qui concerne les outils de développement, c’est parce que toutes les informations relatives aux événements de webhook et aux URL de l’API REST sont disponibles dans l’interface du plugin. Cette interface vous fournira en effet des résultats dynamiques sur lesquels vous pourrez vous appuyer et vous permettra de tester les webhooks directement depuis votre site. Vous pouvez également consulter les documents supplémentaires suivants pour plus d’informations :

• Outils du développeur Actions
• Outils du développeur Déclencheurs d'événements
• Comment ajouter des Usermeta via l'API REST (Outils pour développeurs)

Rien de plus simple pour commencer… Voici comment faire

1. Assurez-vous que votre clé d'activation MemberPress correspond à l'application MemberPress Édition à l'échelle.
2. Pour installer le module complémentaire MemberPress Developer Tools, rendez-vous sur la page MemberPress > Modules complémentaires et cliquez sur le bouton "Installer le module complémentaire".
3. Pour utiliser l'API REST MemberPress, vous devez disposer de WordPress 4.7 ou une version ultérieure.
4. Une fois le module complémentaire Developer Tools installé et activé, vous devriez voir apparaître un nouvel élément dans votre menu MemberPress :
5. Depuis le menu « Développeur », vous pouvez désormais configurer des webhooks, consulter la documentation dynamique relative aux événements de webhook et les tester, ainsi que consulter la documentation dynamique concernant toutes les URL de l'API REST MemberPress :

Exemple de code cURL en PHP

Cet exemple ajoute un membre, l'affecte à une adhésion (par le biais d'une transaction) et déclenche un courrier électronique de bienvenue :

'testingboy897@test.com',
    'username' => 'testingboy897@test.com',
    'first_name' => 'test',
    'last_name' => 'test_last_name',
    'send_welcome_email' => true, // Déclenche un email de bienvenue - ceci ne fonctionne que si l'on ajoute une transaction (ci-dessous)
    'transaction' => [
      'membership' => 376, // ID de l'adhésion
      'amount' => '0.00',
      'total' => '0.00',
      'tax_amount' => '0.00',
      'tax_rate' => '0.000',
      'trans_num' => 'mp-txn-' . uniqid(),
      'status' => 'complete',
      'gateway' => 'free',
      'created_at' => gmdate( 'c' ),
      'expires_at' => '0000-00-00 00:00:00'
    ]
  ]
) ;

curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true ) ;
curl_setopt( $ch, CURLOPT_CUSTOMREQUEST, "POST" ) ;
curl_setopt( $ch, CURLOPT_POSTFIELDS, $data_string ) ;

$header = array() ;
$header[] = 'MEMBERPRESS-API-KEY : MgCUGSO5Qg' ; // Votre clé API des outils de développement MemberPress ici
$header[] = 'Content-Type : application/json' ;
$header[] = 'Content-Length : ' . strlen($data_string) ;
curl_setopt($ch, CURLOPT_HTTPHEADER, $header) ;

$response = curl_exec($ch) ;

if(curl_errno($ch)){
  lance une nouvelle Exception(curl_error($ch)) ;
}

echo $response ;

curl_close($ch) ;

Clé Webhook

Depuis la version MemberPress Developer Tools Add-on 1.2.5, nous avons introduit un paramètre de clé Webhook qui peut être trouvé dans le menu MemberPress > Développeurs > onglet Webhook.

Vous pouvez utiliser la clé pour authentifier les demandes POST du webhook. Elle est générée automatiquement par le module complémentaire MemberPress, mais si vous pensez que votre clé a été compromise, vous pouvez régénérer une nouvelle clé webhook à tout moment.

Pour valider la requête du webhook, récupérez les en-têtes HTTP et recherchez « memberpress-webhook-key ». Voici un exemple d'en-tête HTTP contenant « memberpress-webhook-key » reçu après avoir créé une nouvelle URL de webhook dans le menu MemberPress > Développeurs > onglet Webhook et après avoir activé l'écoute des événements d'inscription :

Dépannage de l'authentification de base

La méthode d'authentification préférée est la clé API fournie par MemberPress Developer Tools. Cependant, nous savons que beaucoup d'entre vous utilisent également la méthode d'authentification de base, moins sûre, pour se connecter à l'API WP. Cependant, cette méthode peut présenter quelques difficultés, que les informations ci-dessous peuvent vous aider à résoudre.

Si vous rencontrez des difficultés pour faire fonctionner l'authentification de base, assurez-vous d'avoir
a installé le plugin Application Passwords et a suivi ses instructions.

Une demande d'authentification de base typique se présente comme suit :

Nom de l'en-tête :
Autorisation
Valeur de l'en-tête : 
Basic base64_encode( wp_admin_user_login_here:application_passwords_password_here )

Votre utilisateur doit avoir le
remove_users ou MemberPress Developer Tools renverra une réponse 401.

Si vous ne parvenez toujours pas à vous authentifier, cela signifie peut-être que votre serveur d'hébergement présente des problèmes de configuration.
Pour en savoir plus sur la cause la plus fréquente, cliquez ici. Le plugin « Application Passwords » nécessite que les variables PHP_AUTH_USER et PHP_AUTH_PW soient définies. Si elles ne le sont pas, « Application Passwords » ne parviendra pas à authentifier l'utilisateur, et vous devrez contacter votre hébergeur pour corriger ce problème. En général, cela nécessite d'ajouter une ligne similaire à celle-ci dans le fichier .htaccess :

SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Si tout le reste échoue, le mieux est simplement d'utiliser la clé API dans le 
MEMBERPRESS-API-KEY à la place de l'en-tête de requête HTTP. Vous trouverez ci-dessous un exemple de code avec la clé API et PHP cURL :

<?php
$url = 'http://testsite.com/wp-json/mp/v1/me' ;
$ch = curl_init( $url ) ;
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true ) ;
$headers = [ 'MEMBERPRESS-API-KEY : MdCUPSO5Qr', 'Content-Type : application/json' ] ;
curl_setopt( $ch, CURLOPT_HTTPHEADER, $headers ) ;
$response = curl_exec( $ch ) ;
if( curl_errno( $ch ) ) { throw new Exception( curl_error( $ch ) ) ; }
curl_close($ch) ;
echo $response ;

Dépannage des webhooks

Si vos webhooks de test fonctionnent, mais que vos tests live ne se déclenchent pas, alors WP Cron est probablement désactivé ou ne fonctionne pas comme il le devrait. Les outils de développement MemberPress s'appuient sur WP Cron pour envoyer les webhooks.

Dans ce cas, le moyen le plus simple de vérifier est de consulter la table wp_mepr_jobs dans votre base de données pour voir si les tâches du webhook y sont bloquées avec un statut "en attente".

Dans la mesure du possible, nous recommandons de désactiver le chargement de page basé sur WP Cron et de le déclencher à la place à partir d'un cron côté serveur qui s'exécute toutes les minutes. SiteGround a un excellent article sur
faire cela ici. Et WordPress.org a quelques des informations complémentaires ici. Malheureusement, nous ne pouvons pas vous aider à ce sujet ; c'est votre hébergeur qui devra vous aider à le configurer.

Si vous ne parvenez pas à faire fonctionner correctement WP Cron, même après avoir activé un cron côté serveur, vous devrez peut-être (en dernier recours) exécuter la requête suivante :

UPDATE wp_options SET option_value = '' WHERE option_name = 'cron' ;