> ## 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.

# WEBSALE JavaScript-Bibliothek

> Übersicht der WEBSALE JavaScript-Module: welche Datei welche Funktion mitbringt, welche Voraussetzungen gelten und wo Sie die Dateien herunterladen.

WEBSALE V8s liefert seine JavaScript-Funktionen als einzeln ladbare Dateien aus. Diese Seite listet die verfügbaren Module mit ihren Dateinamen und Voraussetzungen.

Die jeweils aktuelle Liste sehen Sie im Online-Servicebereich. Öffnen Sie dort den Tab "PageSpeed-Tool", die Module und Bibliotheken stehen in der rechten Spalte.

Referenz: [JavaScript und jQuery](https://dokumentation.websale.de/v8s/templates/javascript-und-jquery.md)

## Download

Jede Datei laden Sie unter dieser Adresse herunter:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://<ihre-domain>/$WS/ws_sysdata/js/<Dateiname>.js
```

## Drei Bauformen, eine davon aktuell

Historisch gibt es drei Wege, WEBSALE-JavaScript einzubinden. Das ist der wichtigste Punkt dieser Seite, weil die Wahl bestimmt, wie viel Sie laden.

| Bauform | Dateien | Einsatz |
| - | - | - |
| **WS-Module** | `ws-module-…` | aktuell. Sie laden nur die Module, die Sie wirklich brauchen |
| Systembibliothek | `ws-system-…` | Altbestand. Eine große Datei mit allen Modulen, jQuery und Colorbox |
| Core-Bibliothek | `ws-core-…` | Altbestand. Wie die Systembibliothek, aber ohne jQuery und Colorbox |

> [!NOTE]
>
> Die WS-Module wurden aus der Systembibliothek herausgelöst und stehen seitdem als eigenständige Dateien bereit. Für die Integration einzelner Module brauchen Sie weder die System- noch die Core-Bibliothek noch deren Design-Komponente.
>
> Für neue Shops ist deshalb der Weg über die WS-Module der richtige.

## WS-Module

### Die Basis-Komponente kommt zuerst

Modul- und Design-Basis-Komponente müssen einmalig **vor** allen übrigen WS-Modulen geladen werden.

| | Datei |
| - | - |
| Modul-Komponente | `ws-module-basics-1.8.4.js` |
| Design-Komponente | `ws-module-basics-design-1.8.4.js` |
| Voraussetzung | jQuery-Bibliothek |

Die Basis-Komponente bringt zwei Funktionen mit: `ws_showJSOnlyClass` blendet einen `div`-Bereich nur dann ein, wenn JavaScript aktiv ist, und `ws_registerLimitTextarea` zeigt die noch verfügbaren Zeichen einer Textarea an.

### Die einzelnen Module

Alle folgenden Module setzen die jQuery-Bibliothek und die Basis-Komponente voraus, sofern in der Tabelle nichts anderes steht.

| Funktion | Modul-Komponente | Design-Komponente |
| - | - | - |
| Abhängige Varianten per AJAX nachladen | `ws-module-pr-depvar-1.8.4.js` | `ws-module-pr-depvar-design-1.8.4.js` |
| Econda Cross Sell | `ws-module-econda-cs-links-1.8.4.js` | keine |
| Eingabeabhängige Adressdatensteuerung | `ws-module-multiple-data-1.8.4.js` | `ws-module-multiple-data-design-1.8.4.js` |
| Nachladen von Templates per AJAX | `ws-module-load-template-1.8.4.js` | keine |
| Produkte per AJAX auf die Merkliste setzen | `ws-module-pr-to-memolist-1.8.4.js` | `ws-module-pr-to-memolist-design-1.8.4.js` |
| Produkte per AJAX in den Warenkorb legen | `ws-module-pr-to-basket-1.8.4.js` | `ws-module-pr-to-basket-design-1.8.4.js` |
| Produktempfehlungsfunktion per AJAX | `ws-module-pr-recommendation-1.8.4.js` | `ws-module-pr-recommendation-design-1.8.4.js` |
| Produktvergleich | `ws-module-pr-comparison-1.8.4.js` | `ws-module-pr-comparison-design-1.8.3.js` |
| SEO-Content für Produkte | keine | `ws-module-seo-content-products-design-1.0.0.js` |
| Web-to-Print | `ws-module-w2p-ajaxinit-1.8.4.js` | `ws-module-w2p-ajaxinit-design-1.8.4.js` |
| Link-Shortener | keine | `ws-module-link-shortener-design-1.8.4.js` |
| Passwortchecker, die Passwortampel | `ws-module-passwordchecker-1.8.4.js` | keine |
| Einwilligung zur Datenverarbeitung | `ws-module-agreementcookies-1.8.5.js` | keine |

Drei Module weichen bei den Voraussetzungen ab:

| Modul | Abweichung |
| - | - |
| Econda Cross Sell | braucht zusätzlich das econda JavaScript SDK, siehe weiter unten |
| SEO-Content für Produkte | braucht zusätzlich das Modul zum Nachladen von Templates, alternativ die Core- oder die Systembibliothek |
| Einwilligung zur Datenverarbeitung | braucht **nur** jQuery, nicht die Basis-Komponente |

Die Design-Komponente des Produktvergleichs trägt die Versionskennung `1.8.3`, obwohl die Modul-Komponente `1.8.4` lautet. Dasselbe Bild zeigt sich beim SEO-Content, dessen Design-Komponente eigenständig bei `1.0.0` steht. Prüfen Sie im PageSpeed-Tool, welche Fassung Ihr Shop tatsächlich anbietet.

## Weitere Module

Diese Module gehören zu einzelnen Funktionen und setzen die jQuery-Bibliothek oder die WEBSALE Systembibliothek voraus.

| Funktion | Datei | Besonderheit |
| - | - | - |
| Datepicker-Widget | `ws-datepicker-creator-1.0.0.js` | zusätzlich die Sprachdatei `ws-datepicker-language-de-1.0.0.js` |
| Direktbestellung während einer Sitzung beibehalten | `ws-product-reminder-1.7.0.js` | |
| Upload einer CSV-Datei für die Direktbestellung | `ws-direct-order-1.0.0.js` | braucht zusätzlich das jQuery Form Plugin |
| Econda Cross Sell SDK | `econda-recommendations-3.0.20.js` | braucht zusätzlich `ws-module-econda-cs-links-…` |
| E-Marketing-Manager, Newsletter V3 | `ws-emarketing-manager-1.0.0.js` | |
| User Detection | `ws-user_detection-1.6.0.js` | empfohlen |
| Mobile Detection | `ws-mobile_detection-1.0.0.js` | eingestellt, siehe unten |
| IBAN-Konverter | `ws-iban-converter-1.0.3.js` | |
| Kategorie-Filter | `ws-filter-and-sort-1.2.1.js` | |
| Newsletter V2 | `ws-nllogin-1.0.0.js` | |
| PLZ-Assistent | `ws-ziphelp-1.1.0.js` | |
| Produkt-Mehrfachbilder-Anzeige | `ws-imagegroup-1.1.1.js` | |
| jQuery Form Plugin | `jquery.form.js` | rüstet HTML-Formulare auf AJAX um, nötig für den Bilder-Upload |
| Products in Action | `ws-actionimages-1.1.0.js` | braucht zusätzlich das jQuery Form Plugin |
| Upload-Modul | `ws-upload-1.0.0.js` | |

### User Detection und Mobile Detection

`ws-user_detection` enthält zwei Weiterleitungen: auf einen passenden Subshop anhand der Länderprüfung per GeoIP, und auf eine optimierte Shopvariante, wenn für das verwendete Gerät eine existiert.

`ws-mobile_detection` enthält nur die Geräteweiterleitung und wird nicht mehr weiterentwickelt. Verwenden Sie stattdessen `ws-user_detection`.

> [!WARNING]
>
> Klären Sie vor der Einrichtung einer Weiterleitung anhand des Herkunftslandes mit Ihrem Rechtsberater, ob diese zulässig ist.

### Änderungen an der Direktbestellung

Die Direktbestellung hat als einziges Modul eine dokumentierte Änderungshistorie.

| Version | Änderung |
| - | - |
| 1.7.0 | Die Standardklasse der Eingabezeilen heißt jetzt `cookie_product_reminder_data_line` statt `direct_order_productLine`. Das Modul prüft, ob eine Eingabezeile vorhanden ist. Neue Option `cookieActionParam`, die Fehler durch mehrere gleichnamige OTPX-Parameter verhindert |
| 1.6.0 | Werbemittelkennzeichen und Produktnummer lassen sich aus derselben Texteingabe trennen. Die gewählte Variantenkombination kann gespeichert werden. Neue Schaltfläche zum Löschen von Produkten aus Liste und Cookie |

> [!WARNING]
>
> Beim Sprung auf 1.7.0 ändert sich ein Klassenname. Wenn Ihr Stylesheet `direct_order_productLine` gestaltet, greift es nach dem Wechsel nicht mehr.

## Systembibliothek und Core-Bibliothek

Beide Bauformen sind Altbestand. Sie bündeln mehrere Module in einer Datei und brauchen jeweils die passende Design-Komponente `ws-design-<Version>.js`.

| Bibliothek | Aktuelle Datei | Unterschied |
| - | - | - |
| Systembibliothek | `ws-system-1.8.3.js` | enthält zusätzlich jQuery 1.7.2 und das jQuery Colorbox Plugin 1.3.19 |
| Core-Bibliothek | `ws-core-1.8.3.js` | ohne jQuery und ohne Colorbox |

Beide enthalten in der Fassung 1.8.3 dieselben Funktionen:

* Statische Seiteninhalte per AJAX nachladen
* Abhängige Varianten eines Produkts per AJAX nachladen
* Produktvergleich
* Produkte per AJAX in den Warenkorb legen
* Produkte per AJAX auf die Merkliste setzen
* Produkt weiterempfehlen per AJAX
* Eingabeabhängige Adressdatensteuerung
* `div`-Container automatisch einblenden, wenn JavaScript aktiv ist
* Verfügbare Zeichen einer Textarea dynamisch anzeigen
* econda Cross Sell
* die Funktionen `ws_AjaxLoadTemplate` und `ws_AjaxLoadTemplatePOST`

> [!NOTE]
>
> Ältere Stände beider Bibliotheken bleiben abrufbar, enthalten aber weniger Funktionen. Die Fassungen 1.8.0 und 1.1.0 bringen jQuery 1.4.2 und Colorbox 1.3.6 mit, `ws_AjaxLoadTemplatePOST` kam erst mit 1.8.3 dazu, die eingabeabhängige Adressdatensteuerung mit 1.8.2.
>
> Welche Stände Ihr Shop anbietet, sehen Sie im PageSpeed-Tool.

## Ältere Versionen

Von den meisten Modulen bleiben ältere Fassungen abrufbar. Der Dateiname folgt immer demselben Muster, die Versionskennung steht vor der Endung. Für eine bestehende Integration ändern Sie also nur die Zahl im Dateinamen.

Diese Seite nennt jeweils den aktuellen Stand. Verbindlich ist die Liste im PageSpeed-Tool.


## Related topics

- [JavaScript und jQuery](https://dokumentation.websale.de/v8s/templates/javascript-und-jquery.md)
- [FactFinder WebComponents](https://dokumentation.websale.de/v8s/integration-von-fact-finder/factfinder-webcomponents.md)
- [ProductsInAction-Modul](https://dokumentation.websale.de/v8s/interaktive-funktionen/productsinaction-modul.md)
- [Link-Shortener](https://dokumentation.websale.de/v8s/funktionen-zur-shop-optimierung/link-shortener.md)
- [Auswahl zwischen postalischer Lieferadresse und Packstation](https://dokumentation.websale.de/v8s/adressdaten/auswahl-zwischen-postalischer-lieferadresse-und-packstation.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.