Pluginkonfiguration


Plugin für diesen Mandanten aktivieren?

  • ja - Das Plugin ist für diesen Mandanten aktiv.
  • nein - Das Plugin ist für diesen Mandanten nicht aktiv.
  • vererbt - greift auf die Einstellung des Hauptshops zurück


Standardsprache/Fallbacksprache festlegen:

  • Diese Einstellung ist wichtig, wenn Du einen oder mehrere Sprachshops verwendest. Sollte ein Textbaustein in einer Sprache nicht vorhanden sein, so wird die Sprache verwendet, die hier hinterlegt worden ist. 


Badge im Listing anzeigen:

  • ja - Es wird ein Badge (Hinweis) im Listing angezeigt, dass anzeigt, dass eine Optionsauwahl möglich ist.
  • nein - Das Badge wird nicht im Listing angezeigt. Somit ist kein Hinweis im Produktlisting erkennbar, der auf eine Optionsauswahl hinweist. vererbt - greift auf die Einstellung des Hauptshops zurück


Darstellung der Produktoptionen:

  • Normale Darstellung => alle Optionen werden aufgeklappt dargestellt (Bild 1)
  • ein Wizzard => Schritt für Schritt in einer Modalbox (Bild 2)
  • Zusammengeklappt => Anzeige abwechselnd (Bild 3)
  • Zusammengeklappt => Anzeige unabhängig (Bild 4)


Ansicht der Blacklist:

  • Option wird versteckt – die Option wird nicht ausgegeben
  • Option wird deaktiviert – die Option wird mit anzeigt, ist aber nicht wählbar


klickbare Bilder:

  • ja – Die Auswahl kann über das Bild getroffen werden (nur bei Radiobutton oder Checkbox und es muss ein Bild hinterlegt werden).
  • nein – Hier muss der Button direkt angeklickt werden. Eine Auswahl über das Bild ist nicht möglich. 
  • vererbt - greift auf die Einstellung des Hauptshops zurück


Staffelpreise (gilt nicht für Preisgruppen) 

  • Auf jede Konfiguration bezogen - Die Staffelung greift nur, wenn absolut gleich konfigurierte Artikel in den Warenkorb gelegt werden. 
  • Gruppiert nach Grundartikel - Bei dieser Einstellung ist die Konfiguration egal, es der Staffelpreis wird anhand des Grundartikels berechnet.


Dezimalgenauigkeit der Formel:

  • Wieviele Dezimalstellen nach dem Komma sollen für die Berechnung beachtet werden?


Brutto im Backend:

  • ja – die Optionspreise werden mit USt. erfasst
  • nein – die Optionspreise werden ohne USt. erfasst
  • vererbt -> greift auf die Einstellung des Hauptshops zurück

    Achtung – bei Umstellung von ja auf nein oder umgedreht muss zwingend der Cache geleert  und das Backend neu geladen werden.


Steuersatz für Optionen:

  • Wenn bei Brutto im Backend "ja" gewählt worden ist, muss an dieser Stelle der Wert hinterlegt werden, mit dem er dann bei den jeweiligen Optionen angegeben wird. Achtung, diese Berechnung ist nur im Backend relevant. Im Frontend wird der Steuersatz berücksichtigt, der für den Shop hinterlegt worden. Dies kann daher unter Umständen zu Verwirrung führen, wenn der Wert abweichend von der gültigen USt. ist.

    z. B.
    Brutto im Backend = ja
    Steuersatz für Optionen = 12

    Der Aufschlag für die Option wurde 1,20 Euro mit hinterlegt, so lautet die Ausgabe im Frontend über 1,27 Euro.

    Unsere Empfehlung lautet daher Brutto im Backend = nein und Nettowerte zu hinterlegen.


Erlaubte Dateiendungen:

  • Hier können die Dateiendungen hinterlegt werden, die bei einem Upload möglich sein sollen. Dabei ist darauf zu achten, dass diese ohne vorangehenden Punkt und durch Kommas getrennt hinterlegt werden. Sollte an dieser Stelle keine Eingabe gemacht werden, sind nahezu alle Dateitypen erlaubt. Dies kann unter Umständen zu Sicherheitslücken führen. Daher empfehlen wir die entsprechenden Dateitypen zu definieren.

Optionen allg.

Im Backend findest du unter Artikel -> Produktoptionen Sets/Gruppen die Möglichkeit deine gewünschten Optionen zu hinterlegen.

Folgende Symbolde werden wir dabei immer wieder begegnen:

Pfeil - erbt von ...
Kreuz - deaktiviert
Haken - aktiviert


Sets

Dazu beginnst du am Besten mit der Bezeichnung deines Sets indem du auf hinzufügen klickst, einen Namen vergibst und aktualisieren wählst. Damit ist der Name deines Sets gespeichert. Nun werden Optionsgruppen benötigt. 


Gruppen

Wähle als erstes wieder "hinzufügen" (Button) aus.

Gruppe Grundeinstellungen:

FeldTyp

  • Radiobutton (Einzelauswahl)
  • Checkbox (Mehrfachauswahl)
  • Dropdown (Listenauswahl)
  • Textfield (Textfeld einzeilig)
  • Datepicker (Datumauswahl)
  • Textarea (Textfeld mehrzeilig)
  • Upload (Uploadfeld)
  • Formula (Berechnung)
  • Quantitiy (Anzahl kann frei definiert werden pro Option
    -> Achtung: die Menge darf die unter Grundeinstellungen/Storefront/Warenkorb Artikeldetails/  "Max. wählbare Artikelmenge ... " hinterlegte Maximalmenge nicht übersteigen, ansonsten wird es automatisch auf diese Menge reduziert. Sobald dieser Wert jedoch 100 überschreitet, kommt es zu Performanceproblemen seitens des Shops - dies stellt keinen Pluginfehler dar.)


Interner Bezeichner:

  • Diese Eingabefeld ist zur rein internen Verwendung gedacht. Dieser kann im Frontend ausgegeben werden, er wird jedoch derzeit nicht verarbeitet.


Pflichtfeld:

  • Bei der Aktivierung durch Klick und setzten einen Hakens, legt man fest, dass bei dieser Gruppe eine Auswahl getroffen werden muss. Trifft der Kunde keine Auswahl, kann das Produkt nicht bestellt werden.


Variable:

  • --- stellt hier den Standard dar und kann so belassen werden, wenn keine Berechnung erfolgen soll. 
  • x, y, z, a, b sind mögliche Variablen, die zu einer Berechnung verwendet werden können. Mehr dazu unter ...


Aktiv:

  • aktiviert bzw. deaktiviert eine Gruppe


Bilder vergrößern:

  • ist aktuell für Gruppen ohne Funktion


Gruppe Filtereinstellungen:
Filterbar:

  • Hier wird festgelegt, ob die Gruppe im Filter (Frontend) zur Verfügung gestellt wird.


Bilder anstelle von Text:

  • Vorausgesetzt, dass man die Gruppe filterbar bereitstellt, kann statt dem Text das Optionsbild angezeigt werden.

 

Gruppe Spracheinstellungen:

Gruppenname:

  • An dieser Stelle wird die Bezeichnung für die Gruppe hinterlegt.


Beschreibung kurz:

  • Hier kann man eine kurze Beschreibung der Option hinterlegen.


Beschreibung lang:

  • Sofern eine genauere Beschreibung für die Optionsgruppe benötigt wird, kann dies an dieser Stelle dokumentiert werden.

Optionen

Wie gewohnt fügst du über den "Hinzufügen"-Button neue Optionen hinzu. Achte dabei darauf, dass die Gruppe blau unterlegt ist, zuder die Optionen gehört.

Options Grundeinstellungen

Preis Prefix:

  • + (plus) es erfolgt ein Aufschlag
  • - (minus) es wird ein Abschlag berechnet
  • * (mal) es wird der Grundpreis mit diesem Wert multipliziert (z. B. Grundpreis 10,00 € - dann kostet der Artikel mit dieser Option 20,00 €)


Nettopreis / Bruttopreis:

  • Der Wert der abweichend vom Grundpreis berechnet werden soll. Je nach Preispräfix führt dies zu einem Auf- bzw. Abschlag.


Nummer Trennzeichen:

  • Auswahl des Trennzeichens, wenn mann an die Bestellnummer weitere Zeichen (siehe Ordernummer) ergänzen möchte. Zur Auswahl stehen dafür: +, -, /, *


Ordernummer:

  • Die Zeichen, die hier hinterlegt werden (Buchstaben, Zahlen) werden an die Bestellnummer angehangen.


Vorauswahl:

  • Bei der Aktivierung (Haken) dieser Möglichkeit, ist die Option bereits vorausgewählt für den Kunden.


Aktiv:

  • geerbt von Gruppe - greift auf die Einstellung der Gruppe zurück
  • an - die Option ist aktiv
  • aus - die Option ist deaktiviert

erweiterte Einstellungen (je nach FeldTyp unterschiedlich)

interner Bezeichner:

  • nur für interne Vermerke, dieser kann im Frontend ausgegeben werden, er wird jedoch derzeit nicht verarbeitet


Single-Berechnung:

  • Wenn für die Option unabhängig von der Menge der Auf- bzw. Abpreis nur einmal berechnet werden soll.


Variablenwert:

  • Der Wert, der an dieser Stelle hinterlegt wird, kann für eine Berechnung verwendet werden. 


Einheit:

  • Die Einheit, auf die sich der Variablenwert bezieht.


Pflichtfeld:

  • geerbt von Gruppe - greift auf die Einstellung der Gruppe zurück
  • an - die Option ist aktiv
  • aus - die Option ist deaktiviert


Single:

  • aktiviert die Berechnung pro Zeichen (siehe Fragezeichen (Erklärung) im Plugin selbst)


TextRegex:

  • Definiert die Zeichen, die gezählt werden sollen (Regex-Kenntnisse vorausgesetzt)


min:

  • Minimalwert (ohne Eingabe keine Grenze)


max:

  • Maximalwert (ohne Eingabe keine Grenze)


Variable:

  • Nur für Berechnungen muss eine Auswahl getroffen werden. Standardmäßig ist --- hinterlegt. Dies bedeutet, dass keine Variable hinterlegt ist. Als Variablen stehen zur Verfügung: x, y, z, a, b


Formelfeld:

  • An dieser Stelle muss die Formel hinterlegt werden, anhand derer berechnet werden soll. Q stellt dabei den Grundpreis dar und muss in die Berechnung einbezogen werden.

 

Reiter Bilder:
um Optionen Bilder zuzweisen

Reiter Artikel:
Es gibt die Möglichkeit, Optionen reale Artikel zuzweisen. 

Artikelpreise benutzen:

  • Bei Aktivierung wird der Artikelpreis als Optionspreis verwendet. Dazu ist es notwendig im Reiter Option den Preis Präfix (siehe Options Grundeinstellungen) festzulegen.


Suche nach:

  • An dieser Stelle erfolgt die Zuweisung, welcher Artikel für diese Option verwendet werden soll.

Artikelzuweisung

Lege deinen Artikel wie gewohnt an. Unter dem Reiter Produktoptionen kannst du die gewünschten Optionssets zuweisen. Wähle dazu unter "Wähle Options Set" das entsprechende Set aus und klicke auf "Set hinzufügen" um es hinzuzufügen. An dieser Stelle kannst du das hinterlegte Set später auch wieder entfernen, wenn es nicht mehr benötigt werden sollte. In diesem Fall wählst du wieder das Set aus und klickst auf  "Set entfernen" um es zu entfernen.

Mehrfachänderung

  • mehrere Artikel können mit einmal bearbeitet werden (Auswahl erfolgt über Markierung links welche Optionen bearbeitet werden sollen)


Markierte Optionen entfernen

  • entfernt einzelne Optionen


Auf Artikel kopieren

  • kopiert die vorliegende Optionszuweisung auf einen weiteren Artikel


Gruppen bearbeiten

  • um komplette Gruppen zu löschen


Suche

  • sucht nach Gruppenbezeichnung


Trenner, Ordernummer, Preis Prefix und Netto(Brutto)preis, Single-Berechnung, Pflichtfeld, Aktiv können pro Artikel überschrieben werden


Hinweis

Diese Anleitung wurde mit der Pluginversion 5.05.20 und Shopversion 5.5.9 erstellt. Bei älteren und jüngeren Versionen sowohl des Shopsystem als auch des Plugin kann es zu Abweichungen kommen.

Das Plugin-Design und Funktionalität ist auf das Shop-Standard Template angepasst. Sollten Abweichungen in eigenen oder Dritthersteller-Templates bestehen, müssen ggf. entsprechende Anpassungen zur Plugin-Nutzung vorgenommen werden.

Tips und Tricks / FAQ

Optionspreis wird am Artikel hinterlegt und es erfolgt keine Berechnung
Bitte achte darauf, dass wenn der Optionspreis am Artikel direkt hinterlegt wird oder überschrieben, muss auch der Preis-Präfix hinterlegt werden. Beides ist als Einheit zu sehen.

Bestellbestätigungs-E-Mail fehlerhaft:
Ein Blueprint des Templates liegt im Mofa(Swp)ProductOptions/Resources/views/install/mails/. Dort findet man beide Templates, einmal für html und für text. Du musst diese nach Ihren Wünschen anpassen, mit einem Editor Ihrer Wahl, damit die zusätzlichen Informationen wie
z. B. die Mehrwertsteuer und Kontaktdaten zur Verfügung stehen. Anschließend hinterlegst du dieses angepassten Templates im Backend unter sOrder. Also kopieren und einfügen. Zur Sicherheit eine Kopie Ihres Templates abspeichern.

Eine andere Möglichkeit wäre das Mailtemplate gleich im Shop abzuändern. Wichtig ist der Part zwischen <table> und </table>. Dort wird die Tabelle mit den Produkten erzeugt.

Wir haben bewusst darauf verzichtet, die originalen Mail-Template zu überschreiben, falls individuelle Anpassungen vorgenommen worden sind. 

Sortierung ist durcheinander
Leider ist dies bei einem so großem und umfangreichen Updateschritt nicht zu verhindern, dass die Optionen neu sortiert werden müssen bei dem Update auf Version 5.05.20 (sofern sie dies vorher waren). 

Badge - konfigurierbar
Wir haben bereits bemerkt, dass die Schriftfarbe in den meisten Fälle unglücklich gewählt ist. Mit dem Update auf 5.05.21 wird dies angepasst sein. Bis dahin kann dies in der Datei custom/plugins/MofaProductOptions/Resources/frontend/less/all.less 

// Listingbadge

.product--box .product--badges .badge--product-options {

    color: @text-color; => mit color: @btn-primary-text-color; angepasst werden

    background: @brand-primary;
}