Anleitung: Entwicklungsmodus (Sandbox)

1. Was ist der Entwicklungsmodus?

Der Entwicklungsmodus (auch Sandbox-Modus genannt) ist eine Einstellung in Easy Form Builder, die das Plugin
von Produktionsservern auf Sandbox-/Demo-Server umschaltet. Damit können Sie Zahlungsintegrationen (wie PayPal), Addon-Installationen
und andere serverabhängige Funktionen testen, ohne echte Transaktionen oder Live-Daten zu beeinflussen.

Auf einen Blick

Modus	Server	PayPal API	Anwendungsfall
Produktion	`whitestudio.team`	`api-m.paypal.com`	Live-Website, echte Zahlungen
Sandbox	`demo.whitestudio.team`	`api-m.sandbox.paypal.com`	Test, Entwicklung, Staging

Admin schaltet Dev-Modus um

→

Einstellungen speichern

→

Plugin deaktivieren & reaktivieren

→

Modus wird aktiv

2. Aktivieren / Deaktivieren

Der Entwicklungsmodus-Schalter befindet sich auf der Panel-Seite von Easy Form Builder. Öffnen Sie den Bereich Settings über die obere Menüleiste und wechseln Sie dann zum Tab General.

📍 Schritt für Schritt: Entwicklungsmodus aktivieren

Melden Sie sich in Ihrem WordPress-Admin-Dashboard an
Klicken Sie in der linken Seitenleiste auf Easy Form Builder → Panel
Klicken Sie auf der Panel-Seite auf Settings in der oberen Menüleiste
Stellen Sie sicher, dass Sie sich im Tab General befinden (er ist der erste Tab und standardmäßig ausgewählt)
Scrollen Sie nach unten, bis Sie den Abschnitt Development Mode (Sandbox) mit einem Umschaltknopf und dem </> Code-Symbol sehen
Klicken Sie auf den Umschaltknopf, um ihn auf ON zu stellen (der Schalter wird aktiv/hervorgehoben)
Klicken Sie auf die Schaltfläche Save am Ende der Einstellungsseite, um Ihre Änderungen zu speichern
Navigieren Sie zu Plugins in der WordPress-Seitenleiste
Suchen Sie Easy Form Builder in der Plugin-Liste, klicken Sie auf Deaktivieren und dann auf Aktivieren

⚠️ Wichtig: Nach dem Ändern der Option Development Mode (Sandbox) müssen Sie die Einstellungen speichern und dann das Easy Form Builder Plugin auf der Plugins-Seite deaktivieren und reaktivieren, damit die Änderungen wirksam werden. Die Konstante EMSFB_DEV_MODE wird einmalig bei der Plugin-Initialisierung definiert, daher ist ein Plugin-Neustart erforderlich.

🔒 Schritt für Schritt: Entwicklungsmodus deaktivieren

Folgen Sie den gleichen Schritten oben, schalten Sie den Schalter aber auf OFF. Speichern Sie dann, deaktivieren und reaktivieren Sie das Plugin.

❌ Warnung: Lassen Sie den Entwicklungsmodus niemals auf einer Produktions-/Live-Website aktiviert. Dies leitet alle Zahlungstransaktionen über PayPal Sandbox (kein echtes Geld) und Addon-Downloads über den Demo-Server.

3. Was ändert sich im Dev-Modus

Wenn der Entwicklungsmodus aktiviert ist, ändern die folgenden Komponenten von Easy Form Builder ihr Verhalten:

Komponente	Produktion (OFF)	Sandbox (ON)
Server-URL	`https://whitestudio.team`	`https://demo.whitestudio.team`
PayPal API	`https://api-m.paypal.com/`	`https://api-m.sandbox.paypal.com/`
Addon-Downloads	`https://whitestudio.team/`	`https://demo.whitestudio.team/`
Zahlungsverarbeitung	Echte Transaktionen	Nur Test-/Sandbox-Transaktionen

💡 Hinweis: Der Entwicklungsmodus betrifft mehrere Subsysteme gleichzeitig. Es ist ein globaler Schalter — Sie können nicht selektiv nur PayPal sandboxen, während Addons auf Produktion bleiben, oder umgekehrt.

4. PayPal Sandbox

Eine der wichtigsten Auswirkungen des Entwicklungsmodus ist die Umschaltung von PayPal auf den Sandbox-Modus.
Das bedeutet, dass alle Zahlungs-API-Aufrufe an api-m.sandbox.paypal.com statt an den Live-PayPal-Endpunkt gehen.

Wichtige Punkte

Sie müssen PayPal-Sandbox-Zugangsdaten (Client ID & Secret Key aus dem PayPal Developer Dashboard) verwenden, wenn Dev Mode aktiviert ist
Wenn Sie Produktions-Zugangsdaten mit aktiviertem Dev Mode verwenden (oder umgekehrt), schlägt die Authentifizierung fehl
Sandbox-Transaktionen verwenden Testkonten — es wird kein echtes Geld belastet
Admin-Benutzer sehen detaillierte Fehlermeldungen einschließlich Modus-Mismatch-Warnungen
Nicht-Admin-Benutzer sehen eine generische freundliche Nachricht, wenn die Zahlung fehlschlägt

Häufiges Zugangsdaten-Mismatch-Szenario

Dev-Modus	Verwendete Zugangsdaten	Ergebnis
Sandbox AN	Sandbox-Schlüssel	✅ Funktioniert korrekt
Produktion AUS	Produktions-Schlüssel	✅ Funktioniert korrekt
Sandbox AN	Produktions-Schlüssel	❌ Authentifizierungsfehler
Produktion AUS	Sandbox-Schlüssel	❌ Authentifizierungsfehler

⚠️ Denken Sie daran: Wenn Sie zwischen Sandbox und Produktion wechseln, aktualisieren Sie immer Ihre PayPal Client ID und den Secret Key unter Easy Form Builder > Settings, um dem Modus zu entsprechen.

5. Addon-Server

Wenn Sie Addons installieren oder aktualisieren (Telegram, PayPal, SMS usw.), lädt Easy Form Builder diese vom WhiteStudio-Server herunter.
Der Entwicklungsmodus ändert, welcher Server verwendet wird:

Modus	Server
Produktion	`https://whitestudio.team/`
Sandbox	`https://demo.whitestudio.team/`

💡 Tipp: Wenn die Addon-Installation im Sandbox-Modus fehlschlägt, versuchen Sie, den Dev-Modus zu deaktivieren und zum Produktionsserver zu wechseln. Der Demo-Server verfügt möglicherweise nicht immer über die neuesten Addon-Pakete.

6. Datenbank-Option Referenz

Der Status des Entwicklungsmodus wird in der WordPress-Tabelle wp_options gespeichert:

Optionsname	Wert	Bedeutung
`emsfb_dev_mode`	`'0'`	Produktionsmodus (Standard)
`emsfb_dev_mode`	`'1'`	Sandbox- / Entwicklungsmodus
`emsfb_dev_mode`	`'2'`	Erststart-Status (wird automatisch auf `'0'` zurückgesetzt)

PHP-Konstante

Die Option wird einmalig beim Plugin-Start gelesen und als PHP-Konstante gespeichert:

// Definiert in emsfb.php während der Plugin-Initialisierung

define(„EMSFB_DEV_MODE“, true);   // Sandbox

define(„EMSFB_DEV_MODE“, false);  // Produktion

💡 Warum deaktivieren/reaktivieren? Weil EMSFB_DEV_MODE als PHP-constant beim Laden des Plugins definiert wird. Konstanten können zur Laufzeit nicht geändert werden. Der einzige Weg, einen neuen Wert anzuwenden, ist das Plugin neu zu laden, was durch Deaktivieren und Reaktivieren geschieht.

7. Technische Details

Wie der Wert fließt

UI-Umschalter in Settings

→

AJAX speichert in wp_options

→

Plugin-Neustart liest Option

→

EMSFB_DEV_MODE Konstante gesetzt

Betroffene Dateien

Datei	Wie sie den Dev-Modus verwendet
`emsfb.php`	Liest die Option `emsfb_dev_mode`, definiert die Konstante `EMSFB_DEV_MODE` und setzt `EMSFB_SERVER_URL`
`class-Emsfb-admin.php`	Speichert den `devMode`-Umschaltwert in die Option `emsfb_dev_mode` per AJAX und bestimmt die Addon-Download-Domain
`class-Emsfb-panel.php`	Übergibt den aktuellen `devMode`-Status an JavaScript als lokalisierte Variable
`class-Emsfb-addon.php`	Wählt Produktions- oder Demo-Domain für Addon-URLs
`functions.php`	Wählt Produktions- oder Demo-Domain für Addon-Installations-API-Aufrufe
`class-Emsfb-paypal-handler.php`	Schaltet die PayPal API zwischen `api-m.paypal.com` und `api-m.sandbox.paypal.com` um
`class-Emsfb-paypal-payment.php`	Verwendet die Konstante, um zu bestimmen, welchen PayPal-Server für Zahlungsvorgänge abgefragt wird
`list_form-efb.js`	Rendert den Entwicklungsmodus-Umschaltknopf in Panel > Settings > Tab General

Server-URL-Konstante

Zusätzlich zur Definition von EMSFB_DEV_MODE definiert das Plugin auch EMSFB_SERVER_URL:

// emsfb.php

if (EMSFB_DEV_MODE) {

    define(„EMSFB_SERVER_URL“, „https://demo.whitestudio.team“);

} else {

    define(„EMSFB_SERVER_URL“, „https://whitestudio.team“);

}

8. Fehlerbehebung

❌ Problem: Dev-Modus wird nicht wirksam

Stellen Sie sicher, dass Sie die Einstellungen gespeichert haben, nachdem Sie den Dev-Modus umgeschaltet haben
Gehen Sie zur Plugins-Seite, klicken Sie bei Easy Form Builder auf Deaktivieren und dann auf Aktivieren
Leeren Sie jeden serverseitigen Cache (Object Cache, Page Cache), falls Sie ein Caching-Plugin verwenden
Überprüfen Sie den Datenbankwert in wp_options:

— In phpMyAdmin oder MySQL CLI ausführen
SELECT option_value FROM wp_options WHERE option_name = ‚emsfb_dev_mode‘;
— Ergebnis: ‚1‘ = Sandbox AN, ‚0‘ = Produktion

❌ Problem: PayPal gibt 401 Unauthorized zurück

Prüfen Sie, ob Dev Mode aktiviert ist, Sie aber Produktions-PayPal-Zugangsdaten verwenden (oder umgekehrt)
Gehen Sie zu Easy Form Builder > Panel > Settings und aktualisieren Sie die PayPal Client ID und den Secret Key entsprechend dem aktuellen Modus
Sandbox-Zugangsdaten werden unter developer.paypal.com erstellt
Produktions-Zugangsdaten werden unter developer.paypal.com (Live) erstellt

❌ Problem: Addon-Installation schlägt im Sandbox fehl

Der Demo-Server verfügt möglicherweise nicht über alle Addon-Pakete
Schalten Sie den Dev-Modus auf OFF, speichern Sie die Einstellungen, deaktivieren/reaktivieren Sie das Plugin und versuchen Sie die Addon-Installation erneut
Stellen Sie sicher, dass Ihr Server demo.whitestudio.team erreichen kann (prüfen Sie Firewall oder DNS)

❌ Problem: Optionswert ist ‚2‘

Der Wert '2' ist der Erststart-Status — das Plugin setzt ihn beim nächsten Laden automatisch auf '0' zurück
Deaktivieren und reaktivieren Sie einfach das Plugin, um das Zurücksetzen auszulösen
Danach ist der Wert '0' (Produktionsmodus)

🐛 Debug-Protokollierung aktivieren

PayPal-Vorgänge protokollieren detaillierte Informationen, wenn WP_DEBUG aktiviert ist:

// In wp-config.php hinzufügen

define(‚WP_DEBUG‘, true);

define(‚WP_DEBUG_LOG‘, true);

Prüfen Sie dann wp-content/debug.log. PayPal-Protokolle sind mit [EFB][PayPal][HANDLER] präfixiert und enthalten den aktuellen EMSFB_DEV_MODE-Status, die Server-URL und die Länge der Zugangsdaten.