WordPress

Zwei Wege der Integration

Diese Anleitung zeigt dir zwei Wege, WordPress mit Easytools zu verbinden:

1. Teil 1: Über Automatisierungen - nutzt die Easytools-Automatisierungen, um WordPress-Nutzer anzulegen, und das Plugin Simple Restrict für die einfache Zugangskontrolle.
2. Teil 2: Über Webhooks - nutzt ein eigenes WordPress-Plugin, das Webhooks von Easytools empfängt, für eine anspruchsvollere Abo-Verwaltung.

Wähle den Weg, der besser zu dir passt. Beide Videos zeigen den kompletten Ablauf von der Einrichtung bis zum Test.

Teil 1: Automatisierungen mit dem Plugin Simple Restrict

Beim ersten Weg nutzen wir die Easytools-Automatisierungen, um beim Kauf automatisch WordPress-Konten anzulegen. Mit dem Plugin Simple Restrict legst du danach fest, welche Seiten ein aktives Abo voraussetzen.

Voraussetzungen

Prüfe vor dem Start, ob deine WordPress-Seite diese Anforderungen erfüllt:

• SSL-Zertifikat: Deine WordPress-Seite braucht ein aktives SSL-Zertifikat (die URL beginnt mit https://).
• Permalinks: Gehe in WordPress zu Settings → Permalinks (Einstellungen → Permalinks). Die Struktur darf nicht auf “Plain” stehen. Nutze “Post name” oder eine eigene Struktur.
• Administratorzugang: Du brauchst Adminrechte, um Anwendungspasswörter zu erzeugen und Plugins zu installieren.

Schritt 1: WordPress-Anwendungspasswort erzeugen

Mit einem Anwendungspasswort verbinden sich externe Dienste wie Easytools sicher mit deiner WordPress-Seite, ohne dein eigentliches Login-Passwort zu nutzen.

1. Melde dich in deinem WordPress-Admin-Dashboard an
2. Gehe zu Users → Profile (Benutzer → Profil) oder bearbeite dein Administrator-Konto
3. Scrolle zum Bereich Application Passwords (Anwendungspasswörter)
4. Trage im Feld “New Application Password Name” einen Namen ein, zum Beispiel Easytools
5. Klicke auf Add New Application Password
6. Wichtig: Kopiere das erzeugte Passwort sofort. Später kannst du es nicht mehr einsehen.

Schritt 2: WordPress-App in Easytools verbinden

Jetzt stellst du die Verbindung zwischen Easytools und deiner WordPress-Seite her.

1. Melde dich in deinem Easytools-Konto an
2. Klicke in der linken Seitenleiste auf Store, um den Bereich aufzuklappen, und wähle Automations
3. Klicke in der oberen Navigation auf den Tab Apps
4. Klicke oben rechts auf + New app (+Neue App)
5. Fülle das Formular aus:
   • Connection name: Trage einen sprechenden Namen ein
   • Select app: Wähle Wordpress aus der Liste
   • Platform URL: Trage die URL deiner WordPress-Seite ein (inklusive https://)
   • Username: Dein WordPress-Admin-Benutzername
   • Application password: Füge das Anwendungspasswort aus Schritt 1 ein
6. Klicke auf Check connection (Verbindung prüfen) und danach auf Save (Speichern)

Schritt 3: Automatisierungs-Szenario anlegen

Richte eine Automatisierung ein, die bei jedem Kauf ein WordPress-Konto anlegt.

1. Gehe in den Easytools-Automatisierungen zum Tab Scenarios
2. Klicke auf + New scenario (+Neues Szenario)
3. Konfiguriere das Szenario:
   • Scenario name: Vergib einen sprechenden Namen
   • Send email on failure: Aktiviere das, um bei Fehlern benachrichtigt zu werden
   • Assign to products: Wähle das Easytools-Produkt, das die Automatisierung auslöst
   • Assign to variants: Wähle “All variants” oder einzelne Varianten
   • Connection: Wähle die WordPress-Verbindung aus Schritt 2
   • Action: Wähle Create user (Nutzer anlegen)
4. Klicke auf Save (Speichern)

Schritt 4: Kaufablauf testen

Teste jetzt den kompletten Ablauf, damit Nutzer in WordPress korrekt angelegt werden.

1. Gehe zu deiner Easytools-Produktseite
2. Klicke auf Checkout, um deine Checkout-Seite in der Vorschau zu sehen
3. Führe einen Testkauf durch und fülle alle nötigen Angaben aus
4. Prüfe nach erfolgreichem Kauf dein Postfach auf die Bestätigungs-E-Mail von Easytools

Schritt 5: Nutzeranlage in WordPress prüfen

Kontrolliere, ob die Automatisierung das Konto erfolgreich angelegt hat.

1. Gehe in Easytools zum Tab Automations → Executions, um die Ausführungen zu sehen
2. Klicke auf einen aktuellen Durchlauf und prüfe, ob er erfolgreich war
3. Melde dich in deinem WordPress-Admin-Panel an
4. Gehe zu Users → All Users (Benutzer → Alle Benutzer)
5. Dort sollte ein neues Konto mit der Rolle Subscriber und der beim Kauf genutzten E-Mail-Adresse stehen

Schritt 6: Plugin Simple Restrict installieren

Jetzt installierst du ein Plugin, das festlegt, welche Seiten eine Anmeldung voraussetzen. Wir empfehlen Simple Restrict als schlanke Lösung für einfache Zugangskontrolle. Brauchst du mehr Funktionen, findest du im WordPress-Repository viele weitere Membership- und Zugangs-Plugins.

1. Gehe im WordPress-Admin zu Plugins → Add New Plugin
2. Suche nach Simple Restrict (oder deinem bevorzugten Plugin)
3. Klicke auf Install Now und danach auf Activate

Schritt 7: Zugriffsrecht für den Nutzer setzen

Gib dem angelegten Nutzer die Berechtigung für geschützte Seiten.

1. Gehe im WordPress-Admin zu Users → All Users
2. Klicke auf den Nutzer, den die Automatisierung angelegt hat
3. Scrolle zum Bereich Permissions (Berechtigungen)
4. Setze den Haken bei only-logged - “Allow this user to see pages marked as only-logged”
5. Klicke auf Update User, um zu speichern

Schritt 8: Seitenberechtigungen konfigurieren

Lege fest, welche Seiten nur angemeldeten Nutzern offenstehen.

1. Gehe im WordPress-Admin zu Pages → All Pages (Seiten → Alle Seiten)
2. Wähle die Seite, die du schützen willst, und klicke auf Edit
3. Suche in der rechten Seitenleiste das Feld Permissions
4. Setze den Haken bei only-logged, um die Seite auf angemeldete Nutzer zu beschränken
5. Klicke auf Update, um zu speichern

Schritt 9: Zugangskontrolle testen

Das ist der entscheidende letzte Schritt - prüfe, ob die Zugangskontrolle für angemeldete und nicht angemeldete Nutzer korrekt greift.

Fall 1: Test ohne Anmeldung (sollte blockiert werden)

1. Öffne ein neues Inkognito- bzw. privates Fenster
2. Rufe die URL der geschützten Seite auf
3. Du solltest:
   • zu einer Login-Seite weitergeleitet werden, ODER
   • eine Meldung wie “Access Denied” bzw. “This content is restricted” sehen, ODER
   • eine leere Seite oder einen 403-Fehler sehen (je nach Plugin-Einstellung)
4. Damit ist bestätigt, dass die Beschränkung wirkt

Fall 2: Test als angemeldeter Subscriber (sollte Inhalte sehen)

1. Gehe im selben Inkognito-Fenster zu https://deineseite.de/wp-login.php
2. Melde dich mit den Zugangsdaten des per Automatisierung angelegten Nutzers an:
   • Username: der angelegte Benutzername (zum Beispiel test123 oder auf E-Mail-Basis)
   • Password: Falls der Nutzer es nicht hat, muss er das WordPress-Passwort zurücksetzen
3. Rufe nach der Anmeldung die geschützte Seite erneut auf
4. Jetzt solltest du den vollständigen Inhalt ohne Einschränkung sehen
5. Oben erscheint die WordPress-Adminleiste mit Howdy, [username]

Fall 3: Test als Administrator (voller Zugriff)

1. Melde dich mit deinem WordPress-Administratorkonto an
2. Rufe die geschützte Seite auf
3. Du solltest den vollständigen Inhalt plus die Adminleiste sehen
4. Damit ist bestätigt, dass die Rollen jeweils die passenden Rechte haben

Geschafft! Teil 1 ist abgeschlossen. Wer dein Produkt kauft, erhält automatisch ein WordPress-Konto und Zugang zu geschützten Inhalten. Läuft das Abo aus, kannst du die Automatisierung so einrichten, dass das WordPress-Konto gelöscht wird.

Teil 2: Webhooks mit eigenem Plugin

Der zweite Weg nutzt Webhooks für die Kommunikation zwischen Easytools und WordPress in Echtzeit. Ein eigenes Plugin verarbeitet die Abo-Events, verwaltet Nutzerkonten, verschickt Willkommens-E-Mails und stellt eine Bouncer-Seite für Nicht-Abonnenten bereit.

Schritt 1: Webhooks in Easytools konfigurieren

Zuerst richtest du die Webhook-Benachrichtigungen in deinem Easytools-Konto ein.

1. Melde dich bei Easytools an

2. Klicke in der linken Seitenleiste auf deinen Shopnamen und wähle Store settings

3. Klicke im oberen Menü auf API & Webhooks

4. Du siehst zwei Bereiche:

   • Webhook-Bereich

     • Webhook URL: Ein Textfeld für deinen WordPress-Webhook-Endpunkt (den bekommst du nach der Installation des Plugins)
     • Beispielformat: https://deineseite.de/wp-json/easytools/v1/webhook?api\_token=IgCWvRX
     • Webhook signing key: Zeigt, wann der Schlüssel erstellt wurde (zum Beispiel “Created 16.11.2025, 11:37:04”)
     • Buttons: Delete und Change key (mit Aktualisieren-Symbol)
     • Hast du noch keinen Signing Key, siehst du einen Button zum Erstellen

   • API-keys-Bereich

     • Beschreibung: “Create and manage API keys for your Store. You can find API docs here.” (mit Link)
     • Button + New API key oben rechts
     • Der Bereich zeigt “Add a new API key” mit einer Anleitung zum Erstellen von API-Tokens

5. Wichtig: Trage die Webhook-URL noch nicht ein - dafür musst du zuerst das Plugin installieren

6. Hast du noch keinen Webhook Signing Key, erzeuge ihn jetzt und kopiere ihn sofort

Schritt 2: Plugin “Easytools subscription manager” installieren

Installiere das Plugin Easytools subscription manager, das die Webhook-Events verarbeitet.

1. Lade die Plugin-Datei herunter
2. Gehe im WordPress-Admin zu Plugins → Add New Plugin
3. Klicke auf Upload Plugin und wähle die ZIP-Datei
4. Klicke auf Install Now
5. Klicke auf Activate Plugin
6. Nach der Aktivierung erscheint “Easytools” in der linken Seitenleiste

Schritt 3: Plugin-Einstellungen konfigurieren

Richte das Plugin mit deinen Easytools-Zugangsdaten ein.

1. Klicke in der WordPress-Seitenleiste auf Easytools

2. Wähle im Untermenü Settings

3. Konfiguriere die folgenden Bereiche: Grundeinstellungen:

   • Easytools Checkout URL: Trage die Checkout-URL deines Produkts ein
   • Webhook Signing Key: Füge den Signing Key aus Easytools ein
   • API Token (Optional): Optionaler zusätzlicher Sicherheitstoken
   • Webhook URL: Zeigt deinen WordPress-Webhook-Endpunkt - den kopierst du später nach Easytools

   Einstellungen der Bouncer-Seite:

   • Enable Bouncer Page: Aktivieren, um die Seite einzuschalten
   • Bouncer Page: Wähle die Seite aus, die als Bouncer-Seite dient
   • Product URL: Deine Easytools-Checkout-URL
   • Icon Color: Passe bei Bedarf die Button-Farben an

   Zugangskontrolle:

   • Protect Entire Site: Optional alle Seiten außer den ausgewählten schützen
   • Exclude Pages: Lege fest, welche Seiten öffentlich bleiben

4. Klicke auf Save Settings

Schritt 4: Willkommens-E-Mail einrichten

Passe die E-Mail an, die neue Abonnenten mit dem Link zur Passwortvergabe erhalten.

1. Scrolle in den Plugin-Einstellungen zum Bereich Email Configuration
2. Dort steht: “Customize the content of welcome emails sent to new users. Available placeholders: {username}, {site_name}, {login_url}”
3. Konfiguriere diese Felder:
   • Email Subject: Standard ist [{site_name}] Welcome! Set Your Password
   • Email Heading: Standard zeigt ein Party-Emoji und Welcome to {site_name}!
   • Email Message: Mehrzeiliges Textfeld für deinen Inhalt
   • Button Text: Standard ist Set Your Password
4. Darunter findest du den Bereich Test Email:
   • Überschrift: “Test your email configuration”
   • Beschreibung: “Send a test welcome email to verify your email settings, sender information, and template”
   • Trage eine Test-E-Mail-Adresse ein
   • Klicke auf Send test email
5. Prüfe in deinem Postfach, ob die Willkommens-E-Mail korrekt aussieht

Schritt 5: Webhook-Verbindung abschließen

Jetzt verbindest du Easytools mit deinem WordPress-Webhook-Endpunkt.

1. Suche in den Plugin-Einstellungen unter Grundeinstellungen das Feld Webhook URL
2. Klicke auf den grünen Button Show, um die vollständige URL einzublenden
3. Klicke auf den pinken Button Copy URL
4. Gehe zurück zu Easytools → Store settings → API & Webhooks
5. Füge die kopierte URL in das Feld Webhook URL ein
6. Die URL enthält den API-Token-Parameter (zum Beispiel ?api_token=IgCWvRXUx1o45kJfbcem0SbodmQmmT1)
7. Klicke auf Save

Schritt 6: Webhook-Integration testen

Nutze das eingebaute Testwerkzeug, um zu prüfen, ob die Webhooks funktionieren.

1. Gehe im WordPress-Admin zu Easytools → Webhook Testing

2. Du siehst die Seite Easytools Webhook Testing mit der Beschreibung “Test and debug webhook integrations with Easytools payment platform”

3. Die Seite hat drei Bereiche:

   • Webhook-Endpunkt:

     • Webhook URL (with API Token): Zeigt deinen Endpunkt mit maskiertem Token
     • Beschreibung: “Use this URL in Easytools → API & Webhooks. The API token provides additional security.”
     • Signing Key: Mit Punkten maskiert (••••••••••••••••••)
     • API Token: Mit Punkten maskiert
     • Jeweils mit grünem Show- und pinkem Copy-Button

   • Beispiel-Payloads:

     • Custom Test Email: Feld für eine Test-E-Mail-Adresse
     • Product Assigned: Bereich mit dem Button “Send test webhook”
     • Zeigt eine Vorschau des JSON-Payloads
     • Entsprechende Bereiche für weitere Event-Typen

4. Trage im Feld Custom test email eine Test-Adresse ein

5. Klicke im Bereich Product assigned auf Send test webhook

6. Prüfe die Erfolgsmeldung und ob der Test funktioniert hat

Schritt 7: Webhook-Protokolle überwachen

Sieh dir alle Webhook-Events an, die deine WordPress-Seite empfangen hat.

1. Gehe im WordPress-Admin zu Easytools → Webhook logs
2. Die Seite trägt den Untertitel “Monitor and debug webhook communications from Easytools”
3. Oben findest du einen Datumsfilter:
   • Zwei Datumsfelder im Format dd.mm.rrrr
   • Dazwischen der Text “to”
   • Blauer Button Filter
   • Pinker Button Clear
4. Rechts findest du den Bereich Export:
   • Grüner Button Export to CSV
   • Grüner Button Export to MD
5. Die Tabelle listet die Webhook-Events mit grünen Spaltenköpfen:
   • Date: Zeitstempel (zum Beispiel “2025-11-16 22:16:18”)
   • Event Type: Event-Namen wie:
     • product_assigned
     • subscription_created
     • product_access_expired
     • subscription_deleted
   • Customer Email: E-Mail-Adresse des Kunden
   • User ID: WordPress-Nutzer-ID (zum Beispiel “46”, “45”, “44”)
   • Status: Grüne success-Badges
6. Klicke bei einer Zeile auf Details, um den vollständigen Payload und die Antwort zu sehen

Schritt 8: Abonnenten verwalten

Prüfe aktive und inaktive Abos im Abonnenten-Dashboard.

1. Gehe im WordPress-Admin zu Easytools → Subscribers

2. Dort steht: “View and manage all users with active and inactive subscriptions”

3. Die Seite ist in zwei Bereiche mit grünen Überschriften geteilt: Aktive Abos:

   • Grünes Häkchen mit der Überschrift Active Subscriptions
   • Tabelle mit den Spalten:
     • User: WordPress-Benutzername
     • Email: E-Mail des Nutzers
     • Subscription Type: Art des Abos
     • Renewal Date: Nächstes Verlängerungsdatum
     • Status: Status-Badge
   • Ist die Liste leer: “No active subscriptions found.”

   Inaktive Konten:

   • Rotes X mit der Überschrift Inactive Accounts
   • Beschreibung: “Users who previously had a subscription that was cancelled, expired, or is no longer active.”
   • Tabelle mit den Spalten:
     • User: Benutzername
     • Email: E-Mail-Adresse
     • Last Subscription Type: Art (zum Beispiel “monthly”)
     • Last Renewal Date: Datum (zum Beispiel “2025-11-28 16:14:03”)
     • Status: Rotes Badge Inactive

Schritt 9: Kompletten Kaufablauf testen

Teste die gesamte Integration von Anfang bis Ende.

1. Rufe die Checkout-Seite deines Easytools-Produkts auf
2. Führe einen Testkauf mit einer echten E-Mail-Adresse durch
3. Prüfe danach dein Postfach auf die Willkommens-E-Mail mit einem Betreff wie “Welcome! Set Your Password”
4. Die E-Mail sollte enthalten:
   • Einen violett-blauen Button mit dem Text “Set your password”
   • Eine Überschrift mit Party-Emoji und Willkommensgruß
   • Deinen Benutzernamen
5. Klicke auf den Button, um dein Passwort zu setzen
6. Gehe in WordPress zu Easytools → Subscribers
7. Prüfe, ob der Nutzer unter “Active Subscriptions” erscheint
8. Gehe zu Webhook Logs und prüfe, ob die Events protokolliert wurden:
   • Event product_assigned
   • Event subscription_created

Schritt 10: Bouncer-Seite und Zugangskontrolle testen

Prüfe, ob Nicht-Abonnenten zur Bouncer-Seite geleitet werden.

1. Öffne ein Inkognito- bzw. privates Fenster
2. Rufe eine geschützte Seite deiner WordPress-Site auf
3. Du solltest zur Bouncer-Seite weitergeleitet werden
4. Die Bouncer-Seite sollte zeigen:
   • Dein Branding bzw. Logo (je nach Template)
   • Einen Hinweis, dass ein Abo nötig ist
   • Einen Button zum Kauf bzw. Abo (verlinkt auf deinen Easytools-Checkout)
5. Melde dich jetzt als Abonnent an
6. Rufe dieselbe geschützte Seite auf
7. Du solltest den vollständigen Inhalt sehen - ohne Bouncer-Seite
8. Oben erscheint der Hinweis, dass du als Abonnent angemeldet bist

Glückwunsch! Du hast die WordPress-Integration über Webhooks mit dem eigenen Plugin eingerichtet. Dieser Weg bietet Abo-Verwaltung in Echtzeit, automatische Nutzeranlage, Willkommens-E-Mails, Zugangskontrolle und ein vollständiges Protokoll.