Überblick über die Verwendung des MemberPress Developer Tools Addon

Hinweis: This add-on is available to MemberPress Scale plan members. You can upgrade to the Scale plan if you're subscribed to another plan. To upgrade, click the Plan ändern Link auf Ihrer Konto-Seite.

Hinweis: Wenn Sie kein Entwickler sind, finden Sie vielleicht unsere Zapier-Integration, WP Fusionoder die Uncanny Automator einfacher zu bedienen.

MemberPress Entwickler-Tools Add-on erweitert MemberPress um eine vollständige REST-API und vollständige Webhook-Ereignisfähigkeit.

Hinweis: Bitte beachten Sie, dass wir ab der Version 1.2.14 das Passwort-Argument bei der Erstellung und Aktualisierung von Mitgliedern entfernt haben, da es ein Sicherheitsrisiko darstellt.

If the documentation on this page seems light for developer tools, that's because all the documentation for the webhook events and REST API URLs can be found in the plugin's interface. The interface will actually give you dynamic results to work from and the ability to test webhooks directly from your site. You may also refer to the following additional docs for more info:

• Entwickler-Tools-Aktionen
• Entwicklertools Ereignisauslöser
• Hinzufügen von Usermeta über REST API (Entwickler-Tools)

Der Einstieg könnte nicht einfacher sein... so geht's

1. Stellen Sie sicher, dass Ihr MemberPress-Aktivierungsschlüssel für die MemberPress Scale edition.
2. Um das MemberPress Developer Tools Add-on zu installieren, gehen Sie auf die Seite MemberPress > Add-ons, und klicken Sie auf die Schaltfläche "Add-on installieren".
3. Um die MemberPress REST API nutzen zu können, müssen Sie WordPress 4.7+ verwenden.
4. Sobald das Add-on Developer Tools installiert und aktiviert ist, sollten Sie einen neuen Eintrag in Ihrem MemberPress-Menü sehen:
5. Über das Entwickler-Menü können Sie nun Webhooks einrichten, dynamische Dokumentation zu Webhook-Ereignissen anzeigen und testen sowie dynamische Dokumentation zu allen MemberPress REST API URLs anzeigen:

Beispiel PHP cURL Code

Dieses Beispiel fügt ein Mitglied hinzu, ordnet es einer Mitgliedschaft zu (über eine Transaktion) und löst dabei eine Willkommens-E-Mail aus:

'testingboy897@test.com',
    'username' => 'testingboy897@test.com',
    'vorname' => 'test',
    'nachname' => 'test_nachname',
    'send_welcome_email' => true, // Auslösen einer Willkommens-E-Mail - dies funktioniert nur, wenn eine Transaktion hinzugefügt wird (siehe unten)
    'Transaktion' => [
      'membership' => 376, // ID der Mitgliedschaft
      'Betrag' => '0.00',
      'gesamt' => '0.00',
      'tax_amount' => '0.00',
      'steuer_satz' => '0.000',
      'trans_num' => 'mp-txn-' . uniqid(),
      'status' => 'complete',
      'gateway' => 'frei',
      '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'; // Ihr API-KEY von MemberPress Developer Tools hier
$header[] = 'Inhalt-Typ: application/json';
$header[] = 'Inhalts-Länge: ' . strlen($data_string);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);

$response = curl_exec($ch);

if(curl_errno($ch)){
  throw new Exception(curl_error($ch));
}

echo $response;

curl_close($ch);

Webhook-Schlüssel

Seit MemberPress Developer Tools Add-on 1.2.5 haben wir eine Webhook-Schlüssel-Einstellung eingeführt, die Sie im MemberPress-Menü > Entwickler > Registerkarte Webhook finden.

You can use the key to authenticate webhook POST requests. It is generated automatically by the MemberPress add-on, but if you feel your key has been compromised, you can regenerate a new webhook key at any time.

To validate the webhook request, fetch HTTP headers and look for memberpress-webhook-key. Here's an example of an HTTP header with memberpress-webhook-key received after creating a new Webhook URL in the MemberPress menu > Developers > Webhook tab and listening to signup events:

Fehlerbehebung bei der Basisauthentifizierung

Die bevorzugte Methode zur Authentifizierung ist der API-Schlüssel, der von MemberPress Developer Tools bereitgestellt wird. Wir wissen jedoch, dass viele von Ihnen auch die weniger sichere Methode der Basis-Authentifizierung verwenden, um sich mit der WP-API zu verbinden. Dies kann jedoch ein paar Herausforderungen mit sich bringen, bei denen Ihnen die folgenden Informationen helfen können.

Wenn Sie Probleme haben, die Basisauthentifizierung zum Laufen zu bringen, stellen Sie sicher, dass Sie die
das Plugin für Anwendungskennwörter installiert und befolgte dessen Anweisungen.

Eine typische Basic Auth-Anfrage sieht wie folgt aus:

Name der Überschrift:
Autorisierung
Kopfzeile Wert: 
Basic base64_encode( wp_admin_user_login_here:application_passwords_password_here )

Ihr Benutzer sollte die
remove_users Fähigkeit, oder MemberPress Developer Tools gibt eine 401-Antwort zurück.

Wenn Sie sich immer noch nicht authentifizieren können, liegt möglicherweise ein Konfigurationsproblem auf Ihrem Hosting-Server vor.
Lesen Sie hier mehr über die häufigste Ursache. Für das Application Passwords Plugin müssen die Variablen PHP_AUTH_USER und PHP_AUTH_PW gesetzt sein. Wenn sie nicht gesetzt sind, kann Application Passwords den Benutzer nicht authentifizieren, und Sie müssen mit Ihrem Webhost zusammenarbeiten, um dies zu korrigieren. Normalerweise müssen Sie etwas wie das Folgende in die .htaccess-Datei einfügen:

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

Wenn alles andere fehlschlägt, ist es am besten, einfach den API-Schlüssel in der 
MEMBERPRESS-API-KEY HTTP-Anfrage-Header zu verwenden. Nachstehend finden Sie einen Beispielcode mit dem API-Schlüssel und 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;

Fehlerbehebung bei Webhooks

Wenn Ihre Test-Webhooks funktionieren, aber Ihre Live-Tests nicht ausgelöst werden, dann ist WP Cron höchstwahrscheinlich deaktiviert oder funktioniert nicht so, wie es sollte. Die MemberPress-Entwickler-Tools verlassen sich auf WP Cron, um die Webhooks zu senden.

In diesem Fall ist es am einfachsten, die Tabelle wp_mepr_jobs in Ihrer Datenbank zu überprüfen, um zu sehen, ob die Webhook-Aufträge dort mit dem Status "pending" hängen bleiben.

Wenn möglich, empfehlen wir, WP Cron für das Laden von Seiten zu deaktivieren und stattdessen einen serverseitigen Cron auszulösen, der jede Minute läuft. SiteGround hat einen großartigen Artikel über
dies hier zu tun. Und WordPress.org hat einige zusätzliche Informationen hier. Leider können wir Ihnen dabei nicht helfen, und Ihr Webhost muss Ihnen bei der Einrichtung helfen.

Wenn Sie nicht in der Lage sind, WP Cron korrekt zu starten, selbst nachdem Sie einen serverseitigen Cron aktiviert haben, dann müssen Sie (als letzten Ausweg) die folgende Abfrage stellen:

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