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.12.50+ 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

Betrieb

Darstellung

Wawi Funktionsattribute

Das Plugin benötigt für jedes Produkt, welches den Rechner anbieten soll, die folgenden Funktionsattribute.

Funktionsattribut	Inhalt	Typ	Pflichtfeld	Beschreibung
s360_berechnung_einheit	Syntax: ISO:Wert|ISO:Wert… Beispiel: ger:Kilogramm|eng:kilogram	Freitext	ja	Gibt die Einheit an, die beim Input Feld stehen soll.
s360_berechnung_faktor	Beispiel: 2,0	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: 5	Ganzzahl	Optional	Gibt einen benötigten Aufschlag in Prozent an (Zusätzlich zum Absoluten)
s360_berechnung_aufschlag_absolut	Beispiel: 5,5	Fließkommazahl	Optional	Gibt einen benötigten absoluten Aufschlag an (Zusätzlich zum Prozent)
s360_berechnung_aufschlag_text	Syntax: ISO:Wert|ISO:Wert… Beispiel: ger:Aufschlag zum Gewicht|eng:Weight surcharge	Freitext	Optional	Gibt die Möglichkeit einen eigenen Text für “Verschnitt hinzufügen?“ für einzelne Artikel. Wenn das Attribut nicht vorhanden ist, wird die Sprachvariable “clipping“ genutzt

Zusätzlich verwendet das Plugin die folgenden Werte aus der Wawi. Den Inhalt, die Mindestbestellmenge und den Abnahmeintervall

Berechnung

1. Ergebnis = Eingegebene Zahl im Eingabefeld

2. Wenn Aufschlag berechnet werden soll:

   1. Wenn s360_berechnung_aufschlag_prozent gesetzt ist:
      Ergebnis = Ergebnis + Eingegebene Zahl im Eingabefeld * (s360_berechnung_aufschlag_prozent/100)

   2. Wenn s360_berechnung_aufschlag_absolut gesetzt ist:
      Ergebnis = Ergebnis + s360_berechnung_aufschlag_absolut

3. Wenn Faktor gesetzt ist und größer als 0 ist
   Ergebnis = Ergebnis * Faktor

4. Ergebnis = Ergebnis durch Inhalt/Menge

5. Wenn Ergebnis kleiner als die Mindestabnahme ist:
   Ergebnis = Mindestabnahme

6. immer aufrunden vom Ergebnis

7. Wenn Ergebnis mod Abnahmeintervall größer als 0 ist
   Ergebnis = Ergebnis + (Abnahmeintervall - (Ergebnis mod 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: ISO:Wert|ISO:Wert… Beispiel: ger:Gramm|eng:gram	ja	Gibt die Einheit an, die beim Input Feld stehen soll.
s360_berechnung_faktor (Funktionsattribut)	Beispiel: 2,0	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: 5	Optional	Gibt einen benötigten Aufschlag in Prozent an (Zusätzlich zum Absoluten)
s360_berechnung_aufschlag_absolut (Funktionsattribut)	Beispiel: 5,5	Optional	Gibt einen benötigten absoluten Aufschlag an (Zusätzlich zum Prozent)
s360_berechnung_aufschlag_text (Funktionsattribut)	Syntax: ISO:Wert|ISO:Wert… Beispiel: ger:Aufschlag hinzufügen?|eng:add surcharge?	Optional	Gibt den Text nach dem Aufschlag an, wenn ein anderer Text gewählt werden soll, wie in der Plugin Sprachvariable clipping

Sprachvariablen

NameInhalt	Beschreibung
title	Gibt den “Titel“ an
result	Text vor dem Ergebnis
clipping	Standardtext nach den Aufschlagswerten. Kann für einzelne Artikel mit Hilfe vom Funktionsattribut s360_berechnung_aufschlag_text überschrieben werden.
button_calculate	Text vom Button
product_unit_default	Gibt die Produkteinheit an, die angezeigt werden soll, wenn keine Verkaufseinheit in der Wawi keine angegeben wurde. Bsp.: als Standardeinheit wird x
error_msg_empty_quantity	Fehlermeldung, wenn das Eingabefeld leer oder 0 ist.

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.

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.

Changelog

v1.0.1 (November 2024)

• Verbesserung: Javascript wird async geladen

• Fixed: Beim Variationswechel berechnen Button ohne Funktion

v1.0.0 (Oktober 2024)

• Initiales Release