Einleitung
Das s360_quantity_calculation_shop5 Plugin für JTL-Shop 5 bietet die Möglichkeit dem Kunden die benötigte Anzahl von einem Produkt zu berechnen.
Installation / Update
Systemvoraussetzungen
JTL-Shop 5.1.5+ und dessen Voraussetzungen
Plugin-Installation
Die Installation des Plugins erfolgt nach JTL-Standard, wie es hier beschrieben ist oder sie können Ihre vorhandene ZIP-Datei des Plugins auch über den Reiter “Upload“ in der Pluginverwaltung bereitstellen und anschließend im Reiter “Vorhanden“ die Installation starten.
Plugin-Update
Bei einem Update auf eine neuere Version können Sie der allgemeinen Installation folgen mit dem Unterschied, dass Sie direkt in der Pluginverwaltung den Update-Button zur Aktualisierung betätigen müssen.
Konfiguration
Einstellungen
Das Plugin verfügt über folgende Einstellungen
Einstellung | Optionen | Beschreibung |
|---|---|---|
Aktivieren |
| Steuert für wen das Plugin aktiviert ist oder ob es inaktiv ist |
Aufschlag optional |
| Steuert, ob der gewählte Aufschlag optional für den Kunden wählbar ist |
Selektor | Ist der Selektor an dem das Plugin im Frontend eingebunden werden soll | |
Einfüge-Methode |
| Steuert, wo genau das Frontend am Selektor eingefügt werden soll |
Button Farbe |
| Steuert die Farbe des Buttons (Bootstrap Button Klassen) |
Button Größe |
| Regelt die Größe des Buttons |
CSS-Klassen | Können mehrere CSS Klassen verwendet werden um das Styling etc. anzupassen |
Betrieb
Wawi Funktionsattribute
Das Plugin benötigt für jedes Produkt, welches den Rechner anbieten soll die folgenden vier Funktionsattribute.
Funktionsattribut | Inhalt | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
s360_berechnung_einheit | Syntax: Beispiel: | Freitext | ja | Gibt die Einheit an, die beim Input Feld stehen soll. (Farbe: Hellblau) |
s360_berechnung_faktor | Beispiel: | Fließkommazahl | Optional | Gibt den Faktor an, wie oft das Produkt benötigt wird. Bsp. Hantelstange. Für eine Hantelstange werden zwei Gewichte benötigt |
s360_berechnung_aufschlag_prozent | Beispiel: | Ganzzahl | Optional | Gibt einen benötigten Aufschlag in Prozent an (Zusätzlich zum Absoluten) (Farbe: Rosa) |
s360_berechnung_aufschlag_absolut | Beispiel: | Fließkommazahl | Optional | Gibt einen benötigten absoluten Aufschlag an (Zusätzlich zum Prozent) (Farbe: Gelb) |
Ausschnitt Wawi
Zusätzlich verwendet das Plugin die folgenden Werte aus der Wawi. Den Inhalt, die Mindestbestellmenge und den Abnahmeintervall
Artikel anlegen
Wawi
Damit der Bedarfsrechner auf der Artikeldetailseite angezeigt wird, benötigt der Artikel bestimmte Attribute und Werte in der Wawi, die für die Berechnung benötigt werden. In der folgenden Tabelle werden die benötigten Einstellungen erklärt und was sie machen, die Funktionsattribute finden sie dazu ebenfalls hier.
Einstellung | Inhalt | Pflichtfeld | Beschreibung |
|---|---|---|---|
Inhalt/Menge | ja | Beinhaltet die Menge vom Artikel  | |
Mindestabnahme | Optional | Gibt die Mindestabnahme von dem Artikel an, wie viel mindestens gekauft werden müssen  | |
Abnahmeintervall | Optional | Gibt den Abnahmeintervall des Artikels an, | |
s360_berechnung_einheit (Funktionsattribut) | Syntax: Beispiel: | ja | Gibt die Einheit an, die beim Input Feld stehen soll. |
s360_berechnung_faktor (Funktionsattribut) | Beispiel: | Optional | Gibt den Faktor an, wie oft das Produkt benötigt wird. Bsp. Hantelstange. Für eine Hantelstange werden zwei Gewichte benötigt |
s360_berechnung_aufschlag_prozent (Funktionsattribut) | Beispiel: | Optional | Gibt einen benötigten Aufschlag in Prozent an (Zusätzlich zum Absoluten) |
s360_berechnung_aufschlag_absolut (Funktionsattribut) | Beispiel: | Optional | Gibt einen benötigten absoluten Aufschlag an (Zusätzlich zum Prozent) |
Troubleshooting
Logs prüfen
Um herauszufinden, wo ein Problem liegt, helfen Ihnen und uns die Logs. Je nach Fehlerbild ist eines der folgenden 3 Logs dafür mehr oder weniger relevant.
Browser-Log
Das Browser-Log ist meist relevant, wenn irgendwas im Frontend des Shops sich merkwürdig verhält oder nicht reagiert. (Beispiel: Sie klicken einen Button und augenscheinlich passiert gar nichts.)
Das Browser-Log sehen Sie, wenn Sie im Browser F12 drücken und dort dann auf Konsole (oder Console) wechseln.
Shop-Log
Das Shop-Log ist immer dann interessant, wenn im Frontend unerwartete Fehlermeldungen ausgegeben werden oder das Plugin zwar auf Eingaben im Frontend reagiert, aber nicht das Ergebnis liefert, was erwartet wurde. Manchmal ergibt sich auch durch das Browser-Log, dass die Informationen eher im Shop-Log zu suchen sind.
Das Shop-Log finden Sie im JTL-Adminbereich unter System → Wartung → Log.
Das JTL-Log arbeitet mit Log-Levels, um nicht die Datenbank unbegrenzt mit Logdaten zu befüllen. Im Umkehrschluss heißt das, dass Sie Logmeldungen aber auch erst dann sehen, wenn diese nach der Änderung des Loglevels erzeugt worden sind.
Das Plugin loggt außer kritischer Fehler fast ausschließlich im Debug-Log-Level. Wenn also etwas nicht klappt, sollten Sie zunächst das Debug-Loglevel aktivieren, dann eine Testbestellung durchführen, dann das Debug-Loglevel wieder deaktivieren und die zwischenzeitlich geloggten Meldungen zurate ziehen.
Webserver-Log
Das Webserver-Log wird dann relevant, wenn Sie irgendwo auf einen Error 500 (= weiße Seite) stoßen.
Das Webserver-Log kann Ihnen Ihr Hoster zur Verfügung stellen.
In der Standardkonfiguration loggt der JTL-Shop überhaupt nichts in das Webserverlog, nicht mal kritische Fehler wie einen Error 500.
Damit der Shop diese Fehler loggt, müssen in der /includes/config.JTL-Shop.ini.php die einzelnen *_LOG_LEVEL Werte von 0 auf E_ERROR geändert werden.
Achtung: Editieren Sie die Config-Datei des Shops nur, wenn Sie wissen, was Sie tun! Fehlerhafte Anpassungen hier können Ihren Shop unerreichbar oder (verschlüsselte) Daten unbrauchbar machen. Im Zweifelsfall sollten Sie Ihren Hoster oder Servicepartner um Hilfe fragen.