TestMode

TestMode-Aktionen: Testmodus im Frontend aktivieren, deaktivieren und zwischen Test- und Live-Modus wechseln, ohne Live-Betrieb zu beeinflussen.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Testmodus beschrieben. Mithilfe dieser Aktionen können Sie den Testmodus aktivieren und deaktivieren. Beim Aktivieren sowie im aktiven Testmodus können Sie außerdem das erweiterte Debugging einschalten, fehlgeschlagene Zahlungen simulieren und der Storefront signalisieren, dass sie die Test-API der WEBSALE-Suche verwenden soll. Zudem können Sie die Views bei jedem Request aus den Template-Quellen kompilieren lassen.

---

​

Aktionen im Überblick

Aktion	Beschreibung
TestModeOn	Aktiviert den Testmodus, optional mit Debugging, simulierten fehlgeschlagenen Zahlungen, dem Signal für die Test-API der WEBSALE Suche und dem Kompilieren der Views bei jedem Request.
TestModeOff	Deaktiviert den Testmodus.
TestModeChange	Ändert die Schalter des aktiven Testmodus, ohne ihn zu verlassen.

---

​

Aktionen

​

TestModeOn

Mit dieser Aktion wird der Testmodus aktiviert. Der Benutzer muss dafür das konfigurierte Testmodus-Passwort angeben.

Mit dem Parameter makePaymentFail werden Zahlungen im Testmodus zusätzlich als fehlgeschlagen simuliert. Dadurch laufen Bestellungen gezielt in den Fehlerfall, sodass die dafür vorgesehenen Templates und Abläufe geprüft werden können. Die aktuelle Konfiguration kann im Template über $wsTestMode abgefragt werden.

Mit dem Parameter searchTestApi signalisieren Sie der Storefront, dass sie statt der produktiven API die Test-API der WEBSALE-Suche verwenden soll. Am Shop selbst verändert der Schalter nichts. Dieser ruft die WEBSALE-Suche nicht selbst auf, sondern reicht den Wert über $wsTestMode.searchTestApi weiter.

Mit dem Parameter compileTemplates kompiliert der Shop die Views bei jedem Request aus den Template-Quellen, statt sie aus dem vorkompilierten Theme zu laden. Dadurch sind Änderungen an den Templates sofort sichtbar. Aufgrund der damit verbundenen Zeitkosten eignet sich diese Einstellung nur für Tests. Die aktuelle Konfiguration lässt sich über $wsTestMode.compileTemplates abfragen.

Schalter, die im Formular nicht angehakt sind, sind nach dem Aktivieren aus.

Anwendungsbeispiel
Nutzbar auf der Testmodus Seite (testMode.htm), über die Shopbetreiber oder Tester den Testmodus mit einem Passwort aktivieren können, um testspezifische Inhalte zu sehen.

Parameter

Name	Beschreibung
password	Das Passwort zur Aktivierung des Testmodus.
debug	Aktiviert das erweiterte Debugging (Wert: “on”).
makePaymentFail	Simuliert Zahlungen im Testmodus als fehlgeschlagen (Wert: “on”).
searchTestApi	Signalisiert der Storefront, dass sie die Test-API der WEBSALE Suche verwenden soll (Wert: “on”).
compileTemplates	Kompiliert die Views bei jedem Request aus den Template-Quellen statt aus dem vorkompilierten Theme (Wert: “on”).

Fehlercodes

Fehlercode	Beschreibung
noPassword	Parameter password fehlt oder ist leer.
invalidPassword	Das angegebene Passwort ist falsch.
tooManyAttempts	Der Zugang zum Testmodus ist für die IP-Adresse des Aufrufers wegen zu vieler fehlgeschlagener Passworteingaben vorübergehend gesperrt (sofern die Sperre über ipBlockEnabled aktiviert ist). Grenzwerte und Sperrdauer legen Sie unter general.testMode fest.

Zugehörige Module, Variablen & Methoden

• $wsTestMode

• $wsTestMode.active

• $wsTestMode.debug

• $wsTestMode.makePaymentFail

• $wsTestMode.searchTestApi

• $wsTestMode.compileTemplates

Beispiel das zeigt, wie der Testmodus über ein Passwortformular aktiviert wird. Optional sind Debugging, simulierte fehlgeschlagene Zahlungen und das Signal für die Test-API der WEBSALE-Suche.

{{ var $cActionTestModeOn = $wsActions.create("TestModeOn") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $cActionTestModeOn.csrf }}">
    <input type="hidden" name="wsact" value="{{= $cActionTestModeOn.id }}">
    <input type="hidden" name="wstarget" value="/">
    <input type="password" name="password">
    <input type="checkbox" name="debug" value="on"{{ if $wsTestMode.debug }} checked{{ /if }}>
    <input type="checkbox" name="makePaymentFail" value="on"{{ if $wsTestMode.makePaymentFail }} checked{{ /if }}>
    <input type="checkbox" name="searchTestApi" value="on"{{ if $wsTestMode.searchTestApi }} checked{{ /if }}>
    <input type="checkbox" name="compileTemplates" value="on"{{ if $wsTestMode.compileTemplates }} checked{{ /if }}>
    <button type="submit">Testmodus aktivieren.</button>
</form>

---

​

TestModeOff

Mit dieser Aktion wird der Testmodus deaktiviert und der Shop kehrt in den normalen Live-Betrieb zurück.

Anwendungsbeispiel
Nutzbar auf der Testmodus-Seite oder im Shop-Header, um den Testmodus direkt im Shop zu deaktivieren.

Zugehörige Module, Variablen & Methoden

• $wsTestMode
• $wsTestMode.active

Beispiel das zeigt, wie der Testmodus über einen Button deaktiviert wird.

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

---

​

TestModeChange

Mit dieser Aktion können Sie die Schalter des aktiven Testmodus ändern, ohne den Testmodus zu verlassen. Voraussetzung dafür ist, dass der Testmodus zuvor mit dem Passwort aktiviert wurde.

Die Aktion setzt beim Speichern über das Formular immer alle Schalter. Eine nicht angehakte Checkbox schickt der Browser gar nicht erst mit. Ein Schalter, der im Formular fehlt oder nicht angehakt ist, ist nach dem Speichern also aus. Bilden Sie deshalb alle Schalter im Formular ab. Über die Storefront API gilt das nicht. Dort ändert testMode/update nur die mitgesendeten Schalter.

Anwendungsbeispiel
Nutzbar auf der Testmodus-Seite, um im aktiven Testmodus beispielsweise das Debugging auszuschalten, ohne den Testmodus zu beenden.

Parameter

Name	Beschreibung
debug	Aktiviert das erweiterte Debugging (Wert: “on”). Fehlt der Parameter, wird das Debugging ausgeschaltet.
makePaymentFail	Simuliert Zahlungen im Testmodus als fehlgeschlagen (Wert: “on”). Fehlt der Parameter, wird die Simulation ausgeschaltet.
searchTestApi	Signalisiert der Storefront, dass sie die Test-API der WEBSALE Suche verwenden soll (Wert: “on”). Fehlt der Parameter, wird der Schalter ausgeschaltet.
compileTemplates	Kompiliert die Views bei jedem Request aus den Template-Quellen statt aus dem vorkompilierten Theme (Wert: “on”). Fehlt der Parameter, wird der Schalter ausgeschaltet.

Fehlercodes

Fehlercode	Beschreibung
notAllowed	Der Testmodus ist für die Session nicht aktiv. Aktivieren Sie ihn zuerst über TestModeOn.

Zugehörige Module, Variablen & Methoden

• $wsTestMode
• $wsTestMode.active
• $wsTestMode.debug
• $wsTestMode.makePaymentFail
• $wsTestMode.searchTestApi
• $wsTestMode.compileTemplates

Beispiel das zeigt, wie die Schalter des aktiven Testmodus geändert werden.

{{ var $myActionTestModeChange = $wsActions.create("TestModeChange") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionTestModeChange.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionTestModeChange.id }}">
    <input type="hidden" name="wstarget" value="/">
    <input type="checkbox" name="debug" value="on"{{ if $wsTestMode.debug }} checked{{ /if }}>
    <input type="checkbox" name="makePaymentFail" value="on"{{ if $wsTestMode.makePaymentFail }} checked{{ /if }}>
    <input type="checkbox" name="searchTestApi" value="on"{{ if $wsTestMode.searchTestApi }} checked{{ /if }}>
    <input type="checkbox" name="compileTemplates" value="on"{{ if $wsTestMode.compileTemplates }} checked{{ /if }}>
    <button type="submit">Einstellungen speichern</button>
</form>