Muster-Bestellung – Muster ohne und mit eigenem Artikel

Das Plugin kennt zwei Betriebsarten, die sich pro Artikel frei mischen lassen. Ein eigener Musterartikel ist nie Pflicht.

Muster ohne eigenen Artikel

Legen Sie in der JTL-Wawi am Hauptartikel das Funktionsattribut mit dem Namen aus den Plugin-Einstellungen an (Standard salepix_order_sample). Der Wert hat das Format Menge:Preis:Gewicht, wobei das Gewicht optional ist:

• 1:0.00 – 1 kostenloses Muster pro Bestellung
• 2:5.99 – maximal 2 Muster zu je 5,99 € netto pro Bestellung
• 3:2.50:1.00 – maximal 3 Muster zu je 2,50 € netto, jedes Muster wiegt 1,00 kg

Das Muster wird als eigene Warenkorbposition ohne eigenen Artikel angelegt. Der Lagerbestand des Hauptartikels bleibt unberührt. Versandklasse und Einheit stammen aus den Plugin-Einstellungen. Ist im Funktionsattribut kein Gewicht angegeben, übernimmt das Muster für die Versandkostenberechnung das reguläre Gewicht des Hauptartikels; ist ein Gewicht angegeben, gilt dieses pro Stück und ersetzt das Artikelgewicht. Der Warenkorbeintrag trägt den Namen des Hauptartikels mit vorangestelltem Zusatz „Muster" sowie dessen Artikelnummer; nach Abschluss der Bestellung wird die Artikelnummer des Hauptartikels dem Positionsnamen zusätzlich vorangestellt.

Ist der Wert im Funktionsattribut nicht als Zahl lesbar oder die Menge 0 oder kleiner, bleibt der Button für den Artikel ohne weitere Meldung deaktiviert.

Muster mit eigenem Artikel

Legen Sie stattdessen – oder zusätzlich, pro Artikel frei wählbar – das Funktionsattribut mit dem Namen aus den Plugin-Einstellungen an (Standard salepix_order_sample_article). Der Wert hat das Format Menge:Musterartikelnummer:Preis, der Preis ist optional:

• 3:MUSTER-4711 – maximal 3 Muster des Artikels mit der Artikelnummer MUSTER-4711, zum Preis dieses Artikels
• 1:MUSTER-4711:0 – 1 kostenloses Muster, obwohl der Musterartikel im Shop regulär einen Preis hat

Das Muster wird als echter Artikel in den Warenkorb gelegt. Damit wird sein Lagerbestand beim Bestellabschluss abgebucht, ein ausverkaufter Musterartikel ist nicht mehr bestellbar, und der Warenkorbeintrag trägt Name und Artikelnummer des Musterartikels selbst. Preis (sofern nicht überschrieben), Steuerklasse, Gewicht, Versandklasse und Einheit kommen ebenfalls vom Musterartikel.

Ist an einem Artikel das Funktionsattribut für ein Muster mit eigenem Artikel gepflegt, hat es Vorrang vor dem Attribut ohne eigenen Artikel. Es gibt dabei keinen stillen Rückfall: Ist die Musterartikelnummer unbekannt, mehrfach vergeben, verweist sie auf den Hauptartikel selbst, ist der Wert falsch formatiert (weder zwei noch drei durch Doppelpunkt getrennte Teile, Menge kleiner/gleich 0 oder leere Artikelnummer), oder ist der Musterartikel für die aktuelle Kundengruppe nicht sichtbar, wird kein Button angezeigt. Das Plugin schreibt in diesem Fall einen Eintrag in das Shop-Log unter Admin → System → Log, beginnend mit „SALEPIX Muster-Bestellung, Artikel …".

Ein Artikel ohne gepflegtes Attribut für einen eigenen Musterartikel nutzt automatisch die Variante ohne eigenen Artikel, sofern dafür ein Attribut gepflegt ist.

Preise, Limits und Button

• Preise im Funktionsattribut sind grundsätzlich Nettopreise; der Button zeigt den daraus berechneten Bruttopreis passend zur Steuerklasse des Artikels an.
• Ein Klick auf den Button legt jeweils 1 Muster in den Warenkorb (der Button hat kein Mengenfeld). Um mehr Muster desselben Artikels zu erhalten, muss der Button entsprechend oft geklickt werden, bis das jeweilige Limit erreicht ist.
• Die maximale Musteranzahl gilt jeweils pro Bestellung, nicht kumuliert über mehrere Bestellungen eines Kunden. Pro Artikel steuern Sie sie über die erste Zahl im Funktionsattribut, insgesamt über die Einstellung „Maximal bestellbare Muster gesamt".
• Ist die Einstellung „Dürfen mehrere Artikel Muster pro Artikel bestellt werden?" auf „Nein" gesetzt, kann ein bereits im Warenkorb liegendes Muster eines Artikels nicht ein zweites Mal hinzugefügt werden – unabhängig von der Betriebsart.
• Der Button erscheint nur, wenn für den Artikel ein gültiges Funktionsattribut gepflegt ist und eine gültige Lizenz vorliegt (siehe Artikel „Lizenz und Demo-Zeitraum"). Position und Einfügeart legen Sie über die Einstellungen „HTML Selector für 'Muster in Warenkorb'-Buttom" und „PQ-Selector" fest.

Bestellabschluss bei kostenlosen Mustern

Beträgt die Warenkorbsumme 0,00 €, zeigt das Plugin in den Checkout-Schritten „Versand" und „Zahlung" ausschließlich die Zahlungsart „Keine Zahlung erforderlich" (Modul-ID za_null_jtl) an, sodass die Bestellung ohne Auswahl einer regulären Zahlungsart abgeschlossen werden kann. Diese Zahlungsart muss im Shop vorhanden und aktiviert sein; fehlt sie, schreibt das Plugin einen Eintrag „SALEPIX Muster-Bestellung: Zahlungsart za_null_jtl fehlt, 0-EUR-Warenkorb kann nicht abgeschlossen werden." ins Shop-Log.

Kostenlose Muster im Warenkorb (Warenwert 0,00 €) werden nicht automatisch entfernt, wenn eine deaktivierte Position aus dem Warenkorb bereinigt wird – außer beim Muster mit eigenem Artikel, wenn der Musterartikel nicht mehr auf Lager ist.