Options- und Freitext-Modul für xt:Commerce

ab 183,68 € * 199,00 € * (7,7% gespart)

zzgl. MwSt. zzgl. Versandkosten

xt:Commerce Lizenz:

Lizenz:

  • xt_product_options
  • xt_product_options
Das Options- und Freitext-Modul dient dazu, Artikel in verschiedenen Varianten darzustellen,... mehr
"Options- und Freitext-Modul für xt:Commerce"

Das Options- und Freitext-Modul dient dazu, Artikel in verschiedenen Varianten darzustellen, ohne die Varianten als einzelne Artikel anlegen zu müssen. Weiterhin können Ihre Kunden mit diesem Modul Artikel mit eigenen Texten beschriften, zum Beispiel T-Shirts, Tassen oder Taschen. Geeignet ist diese Möglichkeit für alle Artikelvarianten, die unabhängig von einem Lagerbestand benutzt werden.

Den Produktoptionen lassen sich Auf- und Abpreise zuordnen. Auch unabhängig von der Bestellmenge, zum Beispiel für einmalige Einrichtungskosten.

Für jede Optionsgruppe kann eine andere Darstellung gewählt werden (z. B. Farbauswahl als Dropdown und Größen als Checkbox). Gruppen und Werte können eigene Beschreibungen und Bilder haben.

Das Options- und Freitext-Modul ist pluginfähig für Erweiterungen des Moduls.

Die wichtigsten Neuerungen in Version 2 des Plugins:

  • Live-Berechnung der Optionspreise im Shop (automatisch oder per Button)
  • Vorauswahl für Optionswerte
  • Admin: Anzeige zugewiesener und aktiver Optionen in der Artikelübersicht.

Hinweis: Das Plugin wurde für xt:Commerce.0.x überarbeitet und dabei an das xt_responsive Template angepasst

Das Options- und Freitext-Modul kann zwar zusammen mit dem Produktkonfigurator im selben Shop aktiviert sein, funktioniert aber nicht zusammen bei ein und demselben Artikel. Konfiguratorartikel können keine Optionen erhalten.

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.

System: xt:Commerce 4, xt:Commerce 5
Kategorie: Core, Konfiguratoren
Shopversion: 4.2.x, 5.1.x
Das Options- und Freitext-Modul dient dazu, Artikel in verschiedenen Varianten darzustellen,... mehr
Downloads

Vorbereitung der Installation

Vor der Installation eines Plugins solltest Du Deine Daten sichern. Besonders wichtig: die Shopdatenbank.

Foundation-Plugin

Das Foundation-Plugin liefert für alle unsere Plugins die nötigen Grundfunktionen und unsere neue Lizenzverwaltung.

Schritt 1 - Installation des Foundation Plugins:

  • Plugin entpacken und die entpackten Ordner und Dateien per FTP in den Ordner Plugins des Shops laden.
  • Im Adminbereich des Shops das Plugin unter Inhalte → deinstallierte Plugins installieren.
  • Im Adminbereich das Plugin unter Inhalte → installierte Plugins aktivieren (auch für den jeweiligen Mandanten) und konfigurieren.
  • Nach der Installation musst Du den kompletten Adminbereich neu laden (in den meisten Browsern mit F5).

 

Schritt 2 - Lizenzen einfügen:

Du findest im Adminbereich unter Shop den neuen Menüpunkt „Module-Factory-Lizenzen“. An dieser Stelle kannst Du den von uns erhaltenen Lizenzkey mit dem „Neu“-Button abspeichern indem Du im Admin unter Shop / Module-Factory-Lizenz / Neu klickst und den von uns zugesandten Lizenzkey unter Lizenzkey (vorbelegt mit NEW) hinterlegst. Die Lizenz des eigentlichen Plugins musst Du anschliessend in der Lizenzübersicht aktivieren, indem Du die gewünschte Lizenz im Listing markierst und in der Toolbar auf „Auswahl aktivieren“ klickst. Dadurch werden dann alle benötigten Lizenzinformationen per Curl-Verbindung in das Foundation-Plugin importiert.

Kurzfassung:

Foundation-Plugin wie gewohnt installieren
Admin -> Shop -> Module-Factory-Lizenzen -> Neu -> Lizenzkey hinterlegen -> speichern -> markieren -> Auswahl aktivieren

Schritt 1 muss nur ein einziges Mal durchgeführt werden, VOR der Installation des allersten Plugin unseres Unternehmens.

Systemvoraussetzung

Systemvoraussetzung für dieses Plugin ist xt:Commerce 4 ab Version 4.2. und für xt:Commerce 5.x. Die Aufwärtskompatibilität ist in der Regel gegeben, kann jedoch nicht zu jedem Zeitpunkt garantiert werden.

Installation – Schritt für Schritt

  • 1. Plugin entpacken und die entpackten Ordner und Dateien per FTP in den Ordner Plugins des Shops laden.
  • 2. Im Adminbereich des Shops das Plugin unter Inhalte → deinstallierte Plugins installieren.
  • 3. Im Adminbereich das Plugin unter Inhalte → installierte Plugins aktivieren (auch für den jeweiligen Mandanten) und konfigurieren.

Nach der Installation musst Du den kompletten Adminbereich neu laden (in den meisten Browsern mit F5).


Konfiguration

Konfiguration Plugin allgemein

Name:

  • Bitte belasse diesen Namen wie er hinterlegt ist.

Plugin Status:

  • aktiviert bzw. deaktiviert das Plugin generell

Code:

  • auch hier empfiehlt es ich die Bezeichnung unverändert zu lassen

Status:

  • aktiviert bzw. deaktiviert das Plugin für den jeweiligen Mandanten

Feld Validierung:

  • ja (true) -> prüft ob Pflichtangaben gewählt wurden sind
  • nein (false) -> es erfolgt keine Prüfung

Trenner für Artikelnummer:

  • wie die Bezeichnung erkennen lässt, ist die die Trennung zwischen Artikelnummer und Optionskürzel

Gewicht berechnen:

  • ja (true) -> legt unter den möglichen Optionswerten eine Spalte Gewicht an
  • nein (false) -> das Feld Gewicht, wird nicht bei den Optionswerten angezeigt

Optionsauswahl sortieren nach:

  • Options ID -> die Anzeige erfolgt im Frontend (Kundenansicht) sortiert nach der Options ID
  • Reihenfolge -> die Anzeige erfolgt im Frontend (Kundenansicht) sortiert nach der hinterlegten Reihnfolge
  • Name -> die Anzeige erfolgt im Frontend (Kundenansicht) sortiert alphabetisch nach dem Namen

Markierung einmalige Preise:

  • Zeichen um einmalige Preise auszuweisen, dieses kann frei gewählt werden

Optionspreise anzeigen:

  • ja (true) -> zeigt die einzelnen Optionsauf- bzw. abschläge
  • nein (false) -> zeigt diese entsprechend nicht an

Live-Kalkulation:

  • ohne -> es erfolgt keine Live-Kalkulation
  • per Button -> die Berechnung erfolgt nur durch klick auf den Button
  • Automatisch -> sobald eine Option gewählt wurde, wird der Preis nachberechnet

Live-Kalkulation inkl. Menge:

  • ja (true) -> berücksichtigt Staffelpreise bei der Berechnung
  • nein (false) -> berücksichtigt diese nicht

Live-Kalkulation inkl. Menge Template:
diese Auswahl wird nur unterschiedlich dargestellt, wenn mindest eine Option nur einmalig berechnet wird, sowohl in Kombination mit der Erweiterung "Options- und Freitextplugin - Flächenberechnung"

  • einfach (benötigt Menge) qty -> die Optionen die pro Artikel berechnet werden, werden in einer Summe ausgewiesen
  • aussführlich (benötigt Menge) (full) -> die Optionen die pro Artikel berechnet werden, werden pro Optionsaufschlag ausgewiesen

Anzeige Optionen Flag (Admin Produktübersicht):

  • ja (true) -> zeigt in der Artikelübersicht bereits an, ob einem Artikel Optionen zugewiesen wurden sind
  • nein (false) -> diese Anzeige erfolgt nicht

Anzeige Optionen Aktiv Flag (Admin Produktübersicht):

  • ja (true) -> zeigt an ob die zuwiesenen Optionen auch aktiv sind
  • nein (false) -> die Anzeige erfolgt entsprechend nicht

Debugmodus:

  • letztlich diese diese nur zur Fehleranalyse des Herstellers

Optionsgruppen anlegen

Bei den Optionsgruppen bestimmst du, wie diese im Shop dargestellt werden (Feldtyp). Unter Optionswerte kannst du die jeweiligen Werte anlegen, zum Beispiel Farben und Größen.

Du findest diese Einstellung im Admin unter

Shop
-> Produkt Optionen
----> Option Neu klicken

Feld-Typ:

  • wähle zwischen den nachfolgenden Anzeige- bzw. Auswahlmöglichkeiten

    Select - Dropdown (Auswahlliste)
    Radio - Einfachauswahl
    Checkbox - Mehrfachauswahl
    Text - einzeilige Eingabe
    Textarea: mehrzeilige Eingaben

Reihenfolge:

  • Falls die Optionswerte anders sortiert werden sollen, als das im Plugin-Bearbeitungsfenster vorgegeben wurde, trägst Du hier einen numerischen Wert ein.

Status:

  • aktiviert die Optionsgruppe

Gruppen Name:

  • Bezeichnung der Gruppe (z. B. Farbe)

Gruppen Beschreibung:

  • beschreibt die Optionsgruppe näher
    Die Gruppen-Beschreibung wird vom Standard-Template nicht ausgegeben. Du kannst jedoch dein Template entsprechend erweitern und die Gruppen-Beschreibung mit folgender Variable aufrufen: {$options_data.option_group_desc}

Vorgabewert:

  • Falls du bereits Optionswerte angelegt hast, kannst Du hier festlegen, welcher Wert im Frontend (Kundenansicht) vorausgewählt sein soll. Das Feld Vorgabewert erscheint erst beim Bearbeiten, nachdem ein Feldtyp ausgewählt und die Optionsgruppe gespeichert wurde.

 


Optionswerte anlegen

Shop
-> Produkt Optionen
----> jeweilige Optionsgruppe -> Actions -> 1. Symbol
------> Neu

Feld Typ:

  • Sofern es gewünscht ist, kann man den Feld-Typ für eine oder mehrere Optionswerte in "text" oder "textfield" ändern. Sofern dies nicht benötigt wird, bleibt die Angabe leer.

Standard Artikelnummer:

  • Für den jeweiligen Optionswert kann eine gesonderte Artikelnummer hinterlegt werden. Bleibt diese Feld leer, wird die Artikelnummer des Produktes verwendet.

Standard Preis (NETTO!):

  • Sollte der Preis für diesen Optionswert abweichend zum Hauptartikel sein, kann der Auf- oder Abschlag an dieser Stelle als Nettopreis (ohne USt.) hinterlegt werden. Ob es sich um einen Auf- oder Abschlag handelt, wird mit Standard Preis Prefix festgelegt.

Standard Preis Prefix:

  • keine Auswahl - kein Aufschlag
  • + - Aufschlag
  • - - Abschlag

Standard Berechnung nach Anzahl:

  • Sollte ein Optionswert mehrfach berechnet werden, muss diese Anzahl entsprechend erhöht werden. 2 erzeugt eine doppelte Berechnung, 3 - die dreifache.

Standard Berechnung:

  • Mehrfach Berechnung (multi) - Der unter Standard Preis (NETTO!) festgelegte Auf- oder Abschlag wird pro Artikelanzahl berechnet.
  • Einzel Berechnung (single) - - Der unter Standard Preis (NETTO!) festgelegte Auf- oder Abschlag wird einmalig pro Proudkt berechnet.

Pflichtfeld (Standard):

  • ja (true) - eine Eingabe ist zwingend notwendig
  • nein (false) - es muss keine Auswahl erfolgen

    Achtung: In der Pluginkonfiguration muss "Feld Validierung" auf ja (true) lauten und alle Werte dieser Gruppe müssen Pflichtfelder sein oder nicht. Ein Mix ist nicht möglich und führt zu Fehlern.

Reihenfolge:

  • Falls die Optionswerte anders sortiert werden sollen, als das im Plugin-Bearbeitungsfenster vorgegeben wurde, trägst Du hier einen numerischen Wert ein.

Status:

  • aktiviert / deaktiviert den Optionswert

Name:

  • bezeichnet den Optionswert namentlich

Beschreibung:

  • beschreibt den Optionswert näher

    Die Beschreibung wird vom Standard-Template nicht ausgegeben. Du kannst jedoch Dein Template entsprechend erweitern und die Beschreibung der Optionswerte mit folgender Variable aufrufen: {$options_data.option_value_desc}

Optionen zuweisen

Bei der Neuanlage bzw. auch bei der Nachbearbeitung von Artikeln habst du die Möglichkeit über drei verschiedene Möglichkeiten Optionen dem gewünschten Produkt zuzuweisen.

1. aus der Artikelübersicht heraus
Symbol klicken und es öffnet sich ein Fenster. Darin enthalten sind alle möglichen Optionsgruppen und - werte. Jetzt musst du nur noch die gewünschten Werte oder Gruppen auswählen und speichern. Wenn du alle Werte eine Optionsgruppe auswählen möchtest, reicht es die Gruppe auszuwählen. Möchtest du nur einzelne Werte aus einer Gruppe müssten diese einzeln ausgwählt werden.

2. über Bearbeiten in der Artikelbearbeitung
Optionsauswahl auswählen, Auswahlfenster öffnet sich, auswählen, speichern, Artikel speichern - fertig.

3. über den Button im Footer
Optionsauswahl auswählen, Auswahlfenster öffnet sich, auswählen, speichern, Artikel speichern - fertig. (Hiweis - je nach Bildschirmgröße ist dieser nicht immer sichtbar)


Templateanpassungen (nicht zwingend nötig)

Die im Folgenden beschriebenen Templateanpassungen sind nicht immer notwendig. Möglicherweise enthält dein Template bereits alle Anzeigeoptionen. Um das herauszufinden, kannst du dein eigenes Template mit dem Template xt_responsiv vergleichen. Wenn du alles richtig konfiguriert hast und dennoch beim Produkt keine Optionen dargestellt werden, müsst du dein Template anpassen. Dein Template sollte jQuery ab Version 1.2.6 benutzen.

Verzeichnis: …/templates/xt_responsive/xtCore/pages/product/product.html

Ab der xt:Commerce Version 5.0.04 muss in der in der Datei product.html folgender Code in die erste Zeile eingetragen werden, um Fehlermeldungen des Plugins ausgeben zu lassen. {$message}

Produktdetails

In die Datei …/templates/IHRTEMPLATE/xtCore/pages/product/product.html fügst du bitte folgendes an gewünschter Stelle ein: {$products_information}

Warenkorb

In die Datei …/templates/IHRTEMPLATE/xtCore/pages/cart.html fügst du bitte folgendes an gewünschter Stelle ein: {$data.products_information}

Checkout Bestätigung

In die Datei …/templates/IHRTEMPLATE/xtCore/pages/checkout/subpage_confirmation.html fügst du bitte folgendes an gewünschter Stelle ein: {$data.products_information}

Kundenkonto Bestellhistorie

In die Datei …/templates/IHRTEMPLATE/xtCore/pages/account_history_info.html fügst du bitte folgendes an gewünschter Stelle ein: {$order_values.products_information.content}

E-Mails

Sieh bitte im Admin unter: Inhalte → E-Mail-Manager
 Type: send_order 
HTML-Mail: {$order_values.products_information.html_content}
Text-Mail: {$order_values.products_information.txt_content}


Zusätzliche Variablen

Optionsbilder anzeigen

Um die Bilder anzuzeigen, welche Optionswerten (nur radio und checkbox) zugewiesen sind, muss folgender Variablenaufruf an die gewünschte Stelle des Plugin-Templates gesetzt werden:
{if $item_data.option_value_image!=“}{img img=$item_data.option_value_image type=m_thumb alt=$item_data.option_value_name}{/if}

Gruppenbilder anzeigen

Gruppenbilder rufen du in der Datei /plugins/xt_product_options/templates/options/xt_product_options.html mit folgender Variable auf:
{if $options_data.option_group_image}{img img= $options_data.option_group_image type=m_thumb alt= $options_data.option_group_name}{/if}

Beschreibungen der Optionsgruppen und Optionswerte ausgeben

Beim Anlegen der Optionsgruppen und -werte kannst du eine Beschreibung hinterlegen. Um den Beschreibungstext im Shop-Frontend anzuzeigen, kannst du die folgende Variable nutzen:

für die Optionsgruppen: {$options_data.option_group_desc}
für die Optionswerte: {$options_data.option_value_desc}


Kompatibilität mit anderen Plugin

Grundlegend können nur Aussagen zur Kompatibiltität mit anderen Plugin gegenüber eigenen Plugin getroffen werden. Für das Zusammenspiel mit Fremdplugins können keine Aussagen getroffen werden bzw. keine Funktionzusammenspiel garantiert werden.

Produktkonfigurator

Das Options- und Freitext-Modul kann zwar zusammen mit dem Produktkonfigurator im selben Shop aktiviert sein, funktioniert aber nicht zusammen beim ein und demselben Artikel. Konfiguratorartikel können keine Optionen erhalten.


Hinweis

Diese Anleitung wurde für die neueste Pluginversion für xt:Commerce 5.1.x in Kombination mit der aktuellsten Pluginversion erstellt.

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.