Lizenz Plugin: "Zusatzartikel / Pfand"
Mit dem "Zusatzartikel / Pfand" Plugin für den JTL Shop können Sie automatisch einen weiteren Artikel in den Warenkorb legen, sobald ein entsprechender Hauptartikel in den Warenkorb gelegt wird.
Anwendungsbeispiele:
- Pfand für dieverse Produkte (Mehrwegpfand, Einwegpfand, Kaution...)
- Klischeekosten für Druckerzeignisse oder Ähnliches
- Zugaben für Artikel. Erforderliches Zubehör oder Dienstleistungen oder Gratiszugaben (zum Beispiel bei Herstelleraktionen)
- Kaufe 3 bekomme 4 - Aktionen (4. Kostenlos)
Funktion:
- Zusatzartikel so oft in den Warenkorb legen, die der Menge des Hauptartikels entspricht
- Zusatzartikel je Hauptartikel nur ein mal in den Warenkorb legen
- Zusatzartikel nur genau ein mal in den Warenkorb legen, egal wie viele Hauptartikel diesen Zusatzartikel zugewiesen haben
- Zusatzartikel nur in den Warenkorb legen, wenn eine bestimmte Mindestmenge des Hauptartikels gekauft wird
- Zusatzartikel je angefangenem Intervall der verkauften Menge des Hauptartikels in den Warenkorb legen (Beispiel: je angefangene 20 Flaschen 1x Kastenfand)
- Zusatzartikel je vollem Intervall der verkauften Menge des Hauptartikels in den Warenkorb legen (Beispiel: je volle 20 Flaschen 1x Kastenfand)
- Der Zusatzartikel am Hauptartikel kann selbst einen Zusatzartikel haben (Beispiel: 1 Flasche zieht 1 Kasten (Abhängigkeit der Intervalle möglich)
- Der Zusatzartikel kann zu einem anderen Preis in den Warenkorb gelegt werden, als er normalerweise beim Einzelkauf hat. (positiv (Aufpreis, Pfand), negativ (Rabatt), null (Geschenk, Beigabe))
- Der Zusatzartikel kann der Gleiche wie der Hauptartikel sein (Macht in Kombination mit Zusatzartikel-Preis 0 € Sinn, z.B. für "Kaufe 3 bekomme 4" Aktionen
- Zusatzartikel nur in den Warenkorb legen, wenn eine bestimmte weniger als eine bestimmte Menge des Hauptartikels gekauft wird
- Zusatzartikel nur in den Warenkorb legen, wenn beim Hauptartikel eine bestimmte Variation gewählt wurde (z.B. Klischeekosten nur bei Neukauf, nicht bei Nachbestellung (Auswahl durch Variation)
| Ion Cube Loader Version: | ab 10.4.0 (für PHP 7.2 - 7.4) kein ioncube erforderlich |
| JTL Shop Version: | JTL Shop 4 Plugins JTL Shop 5 Plugins JTL Shop 5.2.x kompatibel JTL Shop 5.3.x kompatibel |
| PHP Version: | PHP 7.1 PHP 7.2 PHP 7.3 PHP 7.4 PHP 8.0 PHP 8.1 PHP 8.2 |
| Plugin Version (Shop 4): | 105 |
| Plugin Version (Shop 5): | 5.1.3 |
Plugin Updates
Alle unsere Plugins werden als "Lifetime"-Lizenzen verkauft. Sofern innerhalb von 12 Monaten nach Installation des Plugins Updates verfügbar sind, können Sie diese kostenlos erhalten. Vor (!) Ablauf von 12 Monaten nach Installation können Sie für jeweils weitere 12 Monate eine Subscription für eventuell verfügbare Updates mit 50% Nachlass auf den vollen Versionspreis erhalten. Das Datum des Ablaufs der Updatebrechtigung können Sie in den Plugineinstellungen dem Reiter "Lizenz"/"Status" entnehmen.
07.08.2024
JTL Shop 5 Version 5.1.3:
- Bugfix: Wenn der Hauptartikel eine Variation oder Variation Kombination ist, verschwindet der Zusatzartikel bei Mengen Änderung im Warenkorb scheinbar zufällig oder wird gar nicht erst in den Warenkorb gelegt, wenn der Hauptartikel in den Warenkorb gelegt wird.
10.07.2024
JTL Shop 5 Version 5.1.2:
- Bugfix: Der Zusatzartikel wurde nicht aus dem Warenkorb entfernt, wenn der Hauptartikel durch den Shop wegen fehlendem Bestand aus dem Warenkorb entfernt wurde.
- Bugfix: 500er Fehler (weiße Seite) bei Zahlung mit Amazon Pay
22.05.2024
JTL Shop 5 Version 5.1.1:
- Bugfix: 500er Fehler wenn man von einer sehr viel früheren Plugin-Version aktualisiert hat.
08.05.2024
JTL Shop 5 Version 5.1.0:
- Anpassung, damit der persistente (gespeicherte) Warenkorb wieder genutzt werden kann, ohne dass Artikel, die nur einmal im Warenkorb vorhanden sein dürfen, mehrfach vorhanden sein könnten, nachdem sich ein Kunde eingeloggt hat.
- Neu: Einstellung, ob eine Fehlermeldung, wenn ein Artikel nicht zusätzlich in den Warenkorb gelegt werden kann, für den Kunden sichtbar oder im Log des Shops oder beides erscheint
- Bugfix: 500er Fehler (weiße Seite) wenn sich ein Kunde mit einer anderen als der Standard Kundengruppe einloggt und Artikel im persistenten Warenkorb hat, die keine gültige Steuerklasse haben. (Es wird hier aber nur die weiße Seite verhindert, eine fehlende Steuerklasse wird dabei nicht korrigiert)
- JTL Shop 5.3.x ready
07.06.2023
JTL Shop 5 Version 5.0.9:
- Bugfix: Fehlermeldung in der JTL WaWi für Artikel, die per Funktionsattribut als "einzigartig" klassifiziert werden
12.05.2023
JTL Shop 5 Version 5.0.8:
- Bugfix: Unter Umständen wurde für den ersten (und einzigen) Artikel im Warenkorb kein Zusatzartikel hinzugefügt.
28.02.2023
JTL Shop 5 Version 5.0.7:
- Bugfix: Im Zusammenhang mit dem PayPal Checkout Plugin wurden stellenweise zu viele Zusatzartikel in den Warenkorb gelegt
17.02.2023
JTL Shop 5 Version 5.0.6:
- Neu: Kompatibilität mit JTL Shop 5.2 hergestellt.
13.11.2022
JTL Shop 5 Version 5.0.5:
- Neu: Option, Freitextvariationen in eine Checkbox zu wandeln, wenn der Zusatzartikel in Abhängigkeit einer Variation in den Warenkorb gelegt werden soll
- Neu: Option zur Ergänzung der Variationsbezeichnung um den Preis des Zusatzartikels, wenn der Zusatzartikel in Abhängigkeit einer Variation in den Warenkorb gelegt werden soll
- Bugfix für Amazon Pay
08.09.2022
JTL Shop 5 Version 5.0.4:
- Bugfix: Zusatzartikel wurden falsch in den Warenkorb gelegt, wenn der Kunde sich einloggt und sich aber zuvor im Checkout anmeldet und dann die Bestellung nicht abgeschlossen oder sich dann wieder abmeldet hat. (persistenter Warenkorb)
- Refactoring: "Admin Menus" zur Vermeidung von Konflikten mit anderen Plugins
28.07.2022
JTL Shop 5 Version 5.0.3:
- Weitere Anpassung an die Amazon Pay Plugin V2
27.07.2022
JTL Shop 4 Version 105:
- Weitere Anpassung an die Amazon Pay Plugin V2
25.07.2022
JTL Shop 4 Version 104:
JTL Shop 5 Version 5.0.2:
- Anpassung an die Amazon Pay Plugins
17.11.2021
JTL Shop 5 Version 5.0.1:
- Bugfix: Bei mehrdimensionalen Zusatzartikeln (Zusatzartikel hat selbst auch einen Zusatzartikel konnte es vorkommen, dass beim Löschen des Hauptartikels eine Endlosschleife gebildet wurde, mit dem Resultat einer weißen Seite.
10.08.2021
JTL Shop 5 Version 5.0.0:
- Versionsanpassung
- Bugfixes
30.07.2021
Version 103
- Bugfix: Anzahl Zusatzartikel manchmal nicht korrekt, wenn man im Warenkorb die Anzahl des Hauptartikels ändert
26.02.2021
JTL Shop 5 Version 1.0.2:
- Zusatzartikel konnten vom Warenkorb aus aufgerufen oder auf die Wunschliste gesetzt werden
30.01.2021
JTL Shop 5 Version 1.0.1:
- Zusatzartikel wurde nicht aus dem Warenkorb gelöscht, wenn der Hauptartikel gelöscht wurde
28.01.2021
Wichtig: Ab jetzt wird eine neue Versionierung für JTL Shop 5 eingeführt. Changelogs für den JTL Shop 5 folgen der neuen Versionierung im Format 1.0.0, die für Shop 3 und 4 wie gewohnt ohne Punkte. Der Download Button enthält die Bezeichnung "Shop5" und steht nur für PHP Versionen ab 7.2 zur Verfügung!
JTL Shop 5 Version 1.0.0:
- Überführung des Plugins in die neue JTL Shop 5 Plugin Logik. Der Download Button enthält die Bezeichnung "Shop5" und steht nur für PHP Versionen ab 7.2 zur Verfügung!
01.10.2020
Version 102
- Neu: Der Zusatzartikel kann zum über Funktionsattribut bestimmten Preis (abweichend vom in der WaWi festgelegten Artikelpreis) in den Warenkorb gelegt werden. Der Preis kann positiv (Aufpreis), negativ (als Rabatt) oder Null (Geschenk) sein.
- Neu: Der Zusatzartikel kann der Gleiche wie der Hauptartikel sein (Macht in Kombination mit Zusatzartikel-Preis 0 € Sinn, z.B. für "Kaufe 3 bekommen 4" Aktionen
20.08.2020
Version 101
- Verbesserung der Zusatzartikel zum Zusatzartikel Funktion
20.09.2017
Version 100
- Plugin erstellt
Hinweis
Die Funktion des Plugins basiert auf verschiedenen Funktionsattributen / Eigenen Feldern, die Sie am Artikel, bei dem ein Zusatzartikel (zum Beispiel Pfand) hinzugefügt werden soll, hinterlegen müssen. Diese Funktionsattribute müssen auch für den Shop freigegeben sein und werden weiter unten beschrieben. Per Funktionsattribut (Wert: Artikelnummer) legen sie als Fest, welcher Artikel mit dem Hauptartikel in den Warenkorb aufgenommen werden soll. Dazu gibt es verschiedene Optionen (siehe unten). Der Artikel, der als Zusatzartikel dienen soll muss selbst im Shop vorhanden sein. Er muss also einer Kategorie des Shops zugewiesen sein.
Wenn Sie mit der Bezeichnung der Funktionsattrbute / Eigenen Felder von der Vorgabe hier im Plugin abweichen wollen, bitte folgendes beachten:
- Die Namen der Funktionsattribute / Eigene Felder werden IMMER kleingeschrieben an den Shop übertragen, auch wenn sie in der WaWi groß geschrieben sind! Also bitte die Bezeichung im Plugin dann auch in Kleinschreibung!
- Die Namen der Funktionsattribute / Eigene Felder sollten keine Leerzeichen und Sonderzeichen haben, das kann zu Problemen führen!
Weisen Sie dem Zuatzartikel nur die Wurzel-Kategorie des Shops zu, also die Kategorie, die Sie in der WaWi in der Onlineshopanbindung angegeben haben. Dann ist er in Kategorien nicht sichtbar. Er kann aber in der Suche gefunden werden. Wenn Sie das nicht wollen, empfehlen wir unsere Plugins "Artikel verstecken" oder "Von Bestseller ausschließen".
Die Optionen 540 und 1447 sollten in der Shop Administration (dort die Suche oben benutzen) auf „Nein“ gesetzt werden. Andernfalls kann es dazu kommen, dass wenn ein angemeldeter Kunde die Bestellung nicht zu Ende ausführt und das dann später nachgeholt, beim Zusammenführen des gespeicherten und des aktuellen Warenkorbs, die Zusatzartikel überzählig im Warenkorb enthalten sind und bestellt werden. Das wirkt sich besonders problematisch aus, wenn eigentlich vorgesehen ist, dass der Zusatzartikel nur einmal pro Warenkorb bestellt werden soll.
Allgemeine Einstellungen
Entscheiden Sie, ob das Plugin aktiv sein soll oder nicht.
Allgemeine Fuktionsattribute
Geben Sie hier den Namen des Funktionsattributes ein, in dem die Artikelnumemr des Zusatzartikels steht.
Geben Sie hier den Namen des Funktionsattributes ein, in dem die zu kaufende Menge steht, bei der der Zusatzartikel in den Warenkorb gelegt werden soll. (z.B. Klischeekosten werden oft nur bis zu einer bestimmten Menge erhoben, darüber sind entfallen sie.) Bei Pfandartikeln brauchen Sie das Funktionsattribut nicht.)
Geben Sie hier den Namen des Funktionsattributes ein, in dem die zu kaufende Menge steht, ab der der Zusatzartikel in den Warenkorb gelegt werden soll. (z.B. Promotionen werden oft erst ab einer bestimmten Menge zugegegben.)
Geben Sie hier den Namen des Funktionsattributes ein, in dem das Intervall für die zu kaufende Menge steht, zu dem der Zusatzartikel je angefangene oder volle Intervalmenge in den Warenkorb gelegt werden soll. (z.B. Pfand: "20" für 1 Kasten je angefangene 20 Flaschen).
Geben Sie hier den Namen des Funktionsattributes ein, das bestimmt, dass nur volle Intervalle den Zusatzartikel auslösen. Beispiel: Intervall 20, Intervall Voll auf 1 oder "Wahr" -> Pfand: 1 Kasten je volle 20 Flaschen. Am besten legen Sie das Funktionsattribut als Typ "Checkbox" an.
Geben Sie hier den Namen des Funktionsattributes ein, dass den Netto(!)preis bestimmt, mit dem der Zusatzartikel in den Warenkorb gelegt wird. Zum deaktivieren das Funktionsattribut wieder entfernen. Legen Sie dieses Funktionsattribut als Typ "Fließkommazahl" an! Es sind alle Werte möglich. Negative Werte bedeuten einen Rabatt. Sofern die Einstellung 320 im Shop auf "Preis auf Anfrage und Produkt nicht käuflich" steht geht der Wert "0.000" nicht. Für eien kostenfreies Zusatzprodukt dann "0.0001" (also fast 0) angeben! WICHTIG: Dezimalzahl mit 4(!) Nachkommastellen und mit DezimalPUNKT, nicht Komma!
Abhängigkeit von Variationen
Zusatzartikel können in Abhängigkeit von der Wahl einer bestimmten Variation in den Warenkorb gelegt werden. Zum Beispiel bei Nachbestellungen von Drucksachen werden keine Klischeekosten erhoben, bei Erstkauf schon. Geben Sie hier den Namen des Funktionsattributes ein, in dem die Variation steht, von der der Zusatzartikelabhängig sein soll. Der Wert muss so heißen, wie die Variation. Wenn Sie mehrere Sprachen nutzen, müssen die Werte des Funktionsattributes in allen SPrachen korrekt einegebene werden.
Geben Sie hier den Namen des Funktionsattributes ein, in dem der Variationswert steht, bei dem der Zusatzartikel in den Warenkorb gelegt werden soll. Der Wert muss so heißen, wie der Variationswert, bei dessen Wahl der Zusatzartikel in den Warenkorb gelegt werden soll. Der Wert muss so heißen, wie die Variation. Wenn Sie mehrere Sprachen nutzen, müssen die Werte des Funktionsattributes in allen SPrachen korrekt einegebene werden.
Wenn aktiv, dann wird eine durch (FA7) definierte Freitextvariation in eine Checkbox umgewandelt. Wenn diese dann durch den Kunden aktiviert wird, wird für diese der Wert aus (FA8) gesetzt.
Wenn aktiv, dann wird der Variationsname im Frontend um die Angabe des Preises für den Zusatzartikel ergänzt.
Optionen für das Ablegen im Warenkorb
Ein Zusatzartikel kann je Hauptartikel nur ein mal in den Warebkorb gelegt werden oder eben so oft, wie der Hauptartikel im Warebkorb ist. Geben Sie hier den Namen des Funktionsattributes ein, in dem Sie definieren, ob der in den Warenkorb zu legende Artikel entsprechend der Menge des Hauptartikels gelegt werden soll. Ist dieses Funktionsattribut mit dem Wert 1 vorhanden, so wird der Zusatzartikel in der Anzahl genauso oft in den Warenkorb gelegt, wie der Hauptartikel. Sonst nur genau ein mal.
Geben Sie hier den Namen des Funktionsattributes ein, in dem Sie definieren, ob der in den Warenkorb zu legende Artikel einzigartig im Warenkorb sein soll. Ist dieses Funktionsattribut mit dem Wert 1 vorhanden, so wird der Zusatzartikel nur dann in den Warenkorb gelegt, wenn er noch nicht vorhanden ist. Sonst so oft, wie es entsprechende Hauptartikel gibt, die diesen Zusatzartikel zugeweisen haben.
Geben Sie hier den Namen des Funktionsattributes ein, in dem Sie definieren, welchen Artikeltyp der in den Warenkorb zu legende Artikel haben soll. Mögliche Werte sind dann "Lagerartikel" und "Zusatzleistung". "Lageratikel" sind dann normale Artikel, die so auch einzeln gekauft werden könnten. Auch für Gratisartikel wäre das der richtige Wert. "Zusatzleistung" wäre passend für Artikel, die der Kunde so nicht einzeln kaufen können soll. Das könnten zum Beispiel Pfand, Klischeekosten oder auch zusätzliche artikelspezifische Gebühren für eine Identitätsprüfung sein. Wird hier nichts angegeben, so wird automatisch der Artikeltyp "Lagerartikel" gesetzt. Der Artikeltyp hat keinen Einfluss auf die Sichtbarkeit des entsprechenden Zusatzartikel im Shop. Soll dieser im Shop nicht sichtbar sein, können Sie unser Plugin "Von Boxen ausschließen" vewrwenden.
Der Zusatzartikel ist eine Position im Warenkorb. Er kann eine Anmerkung haben, die auch in der WaWi ankommt. Hier kann gewählt werden, ob der Bezug zum Hauptartikel nur mit Artikelnummer, Artikelnummer und Artikelname des Hauptartikels oder gar nicht hergestellt werden soll.
Optionen für die Artikelseite
Geben Sie hier an, ob am Hauptartikel ein Hinweis auf den Zusatzartikel eingeblendet werden soll oder nicht. Dieser erscheint dann unter dem Mehrwertsteuerhinweis, sofern der Preis für den Zusatzartikel > 0 € ist.
Tragen Sie hier den CSS Pfad für das Ziel des Hinweises ein. Mit dieser Anleitung können Sie den erforderlichen CSS Pfad leicht finden: https://www.youtube.com/watch?v=_lRlYK3TdIk
Geben Sie an, wie der Hinweis an diesem Element positioniert werden soll.
Optionen für die Warenkorbseite
Es wird versucht (abhängig vom Template) das Artikelbild des Zusatzartikels aus dem Warenkorb zu entfernen. Sollte dies nicht gelingen, kann dies über eine CSS Anweisung bewerkstelligt werden. Dazu wird im <body> Tag des Quellcodes die Klasse "ndZAHideWKImage" angelegt. Den CSS Selektor des Bildes finden Sie mit dieser Anleitung: https://www.youtube.com/watch?v=_lRlYK3TdIk. Dem gefundenen CSS Selector dann noch "body.ndZAHideWKImage " voranstellen und in Ihrer CSS Datei (zum Beispiel die custom.css Datei Ihres Template Themes) den Eintrag vornehmen: "body.ndZAHideWKImage **Ihr gefundener CSS Selektor** {display:none;}
">
Es wird versucht (abhängig vom Template) den "Entfernen" Button des Zusatzartikels aus dem Warenkorb zu entfernen. Sollte dies nicht gelingen, kann dies über eine CSS Anweisung bewerkstelligt werden. Dazu wird im <body> Tag des Quellcodes die Klasse "bHideWKDelButton" angelegt. Den CSS Selektor des Entfernen Buttons finden Sie mit dieser Anleitung: https://www.youtube.com/watch?v=_lRlYK3TdIk. Dem gefundenen CSS Selector dann noch "body.bHideWKDelButton " voranstellen und in Ihrer CSS Datei (zum Beispiel die custom.css Datei Ihres Template Themes) den Eintrag vornehmen: "body.ndZAHideWKImage **Ihr gefundener CSS Selektor** {display:none;}
">
Credits
https://ace.c9.io/#nav=about
Durchschnittliche Artikelbewertung
Einträge gesamt:
5
Einträge gesamt:
5
Vor dem Kauf testen! Pflicht! ;)
Laden Sie das für Sie passende Paket für Ihre PHP Version herunter und entpacken Sie es im Ordner includes/plugins/ auf Ihrem Server oder nutzen Sie für die .zip Datei die Upload-Funktion in der Pluginverwaltung. Installieren Sie das Plugin in der Pluginverwaltung Ihres Shops und aktivieren Sie es mit dem Lizenzschlüssel "demo". Somit können Sie das Plugin 14 Tage in Ruhe testen. Nach dem eventuellen Kauf erhalten Sie einen neuen Lizenzkey für den Tausch.
Info zu Updates
Lesen Sie VOR einem Update UNBEDINGT das Changelog (hier oder im Reiter "Lizenz" in den Plugineinstellungen) und befolgen Sie die Hinweise um Komplikationen zu vermeiden!
Generell gilt:
- Prüfen Sie in den Plugineinstellungen im Tab "Lizenz"/"Status" ob Sie updateberechtigt sind. Wenn nicht, erwerben Sie VOR einem Update eine Subscriptionsverlängerung und warten Sie Ihre Rechnung ab, erst dann ist die Subscriptionsverlängerung aktiv. Wenn Sie ein Update ohne gültige Subscription durchführen wird das Plugin nicht mehr korrekt arbeiten.
- Führen Sie VOR jedem Update eine Datensicherung Ihres Shops und Ihrer Shop Datenbank durch!
- Notieren Sie Ihre Einstellungen oder lassen Sie sie geöffnet in einem anderen Tab Ihres Browsers!
- Prüfen Sie die korrekte Funktion direkt nach dem Update, ggf. per Testbestellung!
- Bewahren Sie die heruntergeladene .zip Datei auf, es stehen immer nur die hier verfügbaren Versionen (also die Aktuellen) zur Verfügung.
Ältere Versionen können nicht mehr bereit gestellt werden!
Wie finde ich meine PHP Version auf dem JTL Shop Administration Dashboard?
Plugin für JTL Shop 4 (PHP 7.1)Plugin für JTL Shop 4 (PHP 7.2 - 7.4)Plugin für JTL Shop5 (PHP 7.2 - 8.2) OHNE ionCube
Bitte die Anforderungen beachten:
| Ion Cube Loader Version: | ab 10.4.0 (für PHP 7.2 - 7.4) kein ioncube erforderlich |
| JTL Shop Version: | JTL Shop 4 Plugins JTL Shop 5 Plugins JTL Shop 5.2.x kompatibel JTL Shop 5.3.x kompatibel |
| PHP Version: | PHP 7.1 PHP 7.2 PHP 7.3 PHP 7.4 PHP 8.0 PHP 8.1 PHP 8.2 |
| Plugin Version (Shop 4): | 105 |
| Plugin Version (Shop 5): | 5.1.3 |
