$wsTestMode - Testmodus

Modul $wsTestMode: prüfen, ob der Testmodus aktiv ist, und neue Funktionen, Designs oder Produkte für reguläre Besucher unsichtbar testen.

Mit dem $wsTestMode Modul können Sie prüfen, ob der Testmodus aktiv ist, und Inhalte entsprechend steuern. Im Testmodus können Sie neue Funktionen, Designs oder Produkte testen, ohne dass diese für reguläre Besucher sichtbar sind. Zusätzlich zeigt das Modul an, ob das Debugging aktiviert ist, ob Zahlungen im Testmodus als fehlgeschlagen simuliert werden sollen und ob die Storefront die Test-API der WEBSALE-Suche verwenden soll. In diesem Abschnitt erfahren Sie, wie Sie den Testmodus abfragen und testspezifische Inhalte anzeigen können.

---

​

Modulübersicht

Beispiel / Ausschnitt über $wsTestMode

{{= $wsTestMode | json }}

JSON-Ausgabe

{
  "active": false,
  "debug": false,
  "makePaymentFail": false,
  "searchTestApi": false
}

Variablen in der Übersicht

Variable	Typ	Beschreibung
active	bool	Prüft, ob der Testmodus aktiviert ist.
debug	bool	Prüft, ob Debugging im Testmodus aktiviert ist.
makePaymentFail	bool	Prüft, ob im Testmodus Zahlungen absichtlich als fehlgeschlagen simuliert werden.
searchTestApi	bool	Prüft, ob die Storefront die Test-API der WEBSALE Suche verwenden soll.

---

​

Templates

Mit der Template-Engine können bestimmte Inhalte gezielt für den Testmodus sichtbar gemacht werden. Dadurch ist es möglich, spezielle Funktionen oder Designs zu testen, ohne dass diese für reguläre Besucher des Shops sichtbar sind.

Für die Passwort-Eingabe zur Aktivierung des Testmodus wird ein spezielles View-Template im Verzeichnis views benötigt. Welches Template der Shop verwendet, legt der Parameter template unter general.testMode fest. Ohne eigene Angabe lautet der Name testModeLogin.htm. In den WEBSALE Themes heißt das Template testMode.htm. Dieser Name muss dann im Parameter template hinterlegt sein.

Das Template kann umbenannt werden. Der neue Template-Name muss dann im Parameter template hinterlegt werden. Die Einstellung befindet sich im Admin Interface an der Stelle, an der auch das Passwort für den Testmodus hinterlegt und geändert werden kann.

Soll der Testmodus aus einer eigenen Storefront heraus gesteuert werden, stehen die Endpunkte der Storefront API Testmodus zur Verfügung.

---

​

Variablen

​

$wsTestMode.active

Gibt aus, ob der Testmodus aktiviert ist.

{{ if $wsTestMode.active }}
    // Test-Modus ist aktiv
{{ /if }}

​

$wsTestMode.debug

Gibt true aus, wenn das erweiterte Debugging aktiviert ist. Im Debug-Modus werden zusätzliche Informationen, beispielsweise zu Variablenwerten oder Ladezeiten, angezeigt.

{{ if $wsTestMode.debug }}
    // Debugging ist aktiv
{{ /if }}

​

$wsTestMode.makePaymentFail

Gibt true aus, wenn Zahlungen im Testmodus als fehlgeschlagen simuliert werden. Die Simulation wird beim Aktivieren des Testmodus über den Parameter makePaymentFail der Aktion TestModeOn eingeschaltet und kann anschließend über die Aktion TestModeChange geändert werden. Dadurch laufen Bestellungen gezielt in den Fehlerfall, sodass die dafür vorgesehenen Templates und Abläufe geprüft werden können.

{{ if $wsTestMode.makePaymentFail }}
    // Zahlungen werden als fehlgeschlagen simuliert
{{ /if }}

​

$wsTestMode.searchTestApi

Gibt true aus, wenn die Storefront die Test-API der WEBSALE-Suche statt der produktiven verwenden soll. Der Schalter wird beim Aktivieren des Testmodus über den Parameter searchTestApi der Aktion TestModeOn gesetzt und kann anschließend über die Aktion TestModeChange geändert werden.

Der Schalter verändert am Shop selbst nichts. Der Shop ruft die WEBSALE-Suche nicht selbst auf, sondern leitet den Wert lediglich weiter. Anhand dieses Wertes entscheidet die Storefront, welche API der WEBSALE-Suche sie anspricht.

{{ if $wsTestMode.searchTestApi }}
    // Die Storefront soll die Test-API der WEBSALE Suche verwenden
{{ /if }}

---

​

Methoden

Für $wsTestMode stehen keine Methoden zur Verfügung.

---

​

Aktionen

Für $wsTestMode stehen keine Aktionen zur Verfügung.

---

​

Beispiele zur Verwendung des Testmodus

​

Link zum Aktivieren des globalen Testmodus

Der Link kann versendet werden, wenn man den Shopbetreiber darüber informiert hat, dass Änderungen im Testmodus integriert worden sind und er sich diese über den folgenden Link ansehen kann:

https://www.beispielshop.de/?wsvc=View&view=testMode.htm

​

Prüfen, ob der Testmodus aktiv ist

{{ if $wsTestMode.active }}
   Dieser Inhalt ist nur im Test-Modus sichtbar
  {{ else}}   
   Dieser Inhalt ist nur im Live-Modus sichtbar   
{{ /if }}

​

Deaktivieren des globalen Testmodus

Es kann auch direkt im Onlineshop eine Option angeboten werden, um den Testmodus zu deaktivieren, um wieder in den Onlineshop zu wechseln.

{{ var $cActionTestModeOff = $wsActions.create("TestModeOff") }}
<form action="{{= $wsViews.current.url() }}" method="post">
  <input type="hidden" name="wscsrf" value="{{= $cActionTestModeOff.csrf }}">
  <input type="hidden" name="wsact" value="{{= $cActionTestModeOff.id }}">
  <input type="hidden" name="wstarget" value="/">
  <button name="wsact" value="{{= $cActionTestModeOff.id }}">Testmodus deaktivieren</button>
</form>

Weitere Praxisbeispiele zu Umsetzungen der Testmodus-Seite gibt es hier:
→ Praxisbeispiele Testmodus

---

​

Weiterführende Links

• actions - Testmodus
• Praxisbeispiele Testmodus
• Storefront API Testmodus