> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# $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. In diesem Abschnitt erfahren Sie, wie Sie den Testmodus abfragen und testspezifische Inhalte anzeigen können.

***

## Modulübersicht

**Beispiel / Ausschnitt über** `$wsTestMode`

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{= $wsTestMode | json }}
```

**JSON-Ausgabe**

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "active": false,
  "debug": 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. |

***

## Templates

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

Für die Passwort-Eingabe zur Aktivierung des Testmodus wird ein spezielles View-Template benötigt. Standardmäßig lautet der Name `testMode.htm`, das sich im Verzeichnis `views` befindet.

Das Template kann umbenannt werden. Der neue Template-Name muss dann jedoch in den Konfigurationseinstellungen im [Admin Interface](/admin-interface) hinterlegt werden. Die Konfigurationsoption befindet sich an der Stelle, an der auch das Passwort für den Testmodus hinterlegt und geändert werden kann.

***

## Variablen

### \$wsTestMode.active

Gibt aus, ob der Testmodus aktiviert ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ 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 wie Variablenwerte oder Ladezeiten angezeigt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ if $wsTestMode.debug }}
    // Debugging ist aktiv
{{ /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:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.beispielshop.de/?wsvc=View&view=testMode.htm
```

### Prüfen, ob der Testmodus aktiv ist

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ 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.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<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](/frontend/praxisbeispiele/testmodus)

***

## Weiterführende Links

* [actions - Testmodus](/konfiguration/actions-fehlertexte-e-mails/actions-testmodus)
* [Testmodus](/frontend/praxisbeispiele/testmodus)