Konfigurator Shop5

    1. Installation auf dem FTP

    1. Entpacken Sie das Plugin auf Ihren Desktop und laden es anschließend in das Pluginverzeichnis auf dem FTP Ihres Shops
    2. Navigieren Sie zu dem Installationspfad für Plugins, dieser befindet sich in aller Regel hier: FTP → Shopverzeichnis/plugins
    3. Achten Sie darauf bei der Übertragung Binär als Modus ausgewählt zu haben

    2. Installation im Shop

    1. Melden Sie sich in Ihrem Shopbackend an, diese URL könnte in etwa so aussehen: https://IHRSHOP.de/admin
      - Sollten Sie die Zugangsdaten nicht haben, wenden Sie sich an Ihren Systembetreuer
    2. Navigieren Sie im Backend über die Menüleiste zum Reiter Plugins und wählen das Untermenü Plugin-Manager aus
    3. Hier finden Sie unter anderem den Reiter Verfügbar, wählen Sie diesen aus:
    4. Scrollen Sie bis zu dem Eintrag: Konfigurator X, markieren diesen und klicken anschließend auf Installieren

    6. Sollte der Eintrag hier nicht vorhanden sein, prüfen Sie bitte den Upload via FTP ob hier Dateien nicht übertragen worden:
      - Wiederholen Sie den Upload
      - Der Upload lief ohne Fehler durch, was nun: Prüfen Sie bitte den Pfad, befindet sich das Plugin an dem richtigen Ort?
      - Ich habe alles so gemacht wie beschrieben, es ist kein Plugin zu sehen: Nehmen Sie bitte Kontakt mit uns auf, wir schauen uns die Sache an (service@obme.de)

    3. Plugin verwalten und konfigurieren

    3.a Shopbackend

    1. Nachdem das Plugin installiert worden ist, finden Sie es im Reiter Aktiviert in der Pluginverwaltung wieder
    2. Kllicken Sie bitte auf den Button Aktionen um in die Pluginverwaltung zu gelangen
      - ALTERNATIV: Navigieren Sie über das Menü Plugins → Installierte Plugins → Konfigurator X, direkt in die Pluginverwaltung

      - Bevor Sie beginnen: Tragen Sie bei Lizenzschlüssel, die beim Erwerb unseres Plugins erhaltene Lizenz ein

    3.b Erläuterungen der unterschiedlichen Felder



    1. Hier legen wir das Funktionsattribut fest, welches die Varkombi erhalten soll, dieals Einstieg für die Konfiguration dient.
    2. Hier legen wir das Funktionsattribut fest, und weisen dieses dem Artikel zu, der zum Konfigurationsartikel werden soll
      2.1 Als Werte benutzen Sie bitte folgenden Syntax:
      - gruppe[ArtikelNr:Menge]
      - hierbei können Sie auch beliebig kombinieren, Siehe Screenshots
      2.2 Wie setzt sich dieser Syntax zusammen?
      - Gruppe = Ist die Sprachvariable welche Sie später noch im Shop einrichten, hier zum leichteren Verständnis haben wir den Gruppennamen auf „Variable“ mit Fortlaufender Nummer gewählt.
      - ArtikelNr = Ist die Artikelnummer des Artikels, welcher zum Konfigurationsartikel werden soll ( Es kann auch hier wieder ein Variationsartikel benutzt werden, es muss dann entsprechend die Artikelnummer des Kindes anstelle des Vaters platziert werden. Beispiel dazu Artikel1 hat 3 Variationen, Artikel1 soll samt der Kinder Bestandteil der Konfiguration werden. Somit hat angenommen Artikel1 die ArtNr. 001 und die Kinder des Artikel1 erhalten die ArtNr. 001-001 bis 001-003. Also geben Sie hier in den Syntax den Wert 001-003 an
      - Menge = Hier setzen Sie die Menge der Artikel fest, welche vorausgewählt zu dem Konfigurationsartikel gehören sollen.
      - Mehrere Gruppen mit Semikolon, ohne Leerzeichen trennen. Mehrere Artikel-Mengen-Kombinationen innerhalb einer Gruppe mit Komma, ohne Leerzeichen trennen.
      Beispiele dazu:

      Beispiel 1 enthält einen Artikel (Vaterartikel) und wird mit der Anzahl 2 dem Konfigurationsartikel zugewiesen

      Beispiel 2 enthält einen Variationsartikel (erste Varkombi) und wird mit der Anzahl 4 dem Konfigurationsartikel zugewiesen

      Beispiel 3 enthält den gleichen Variationsartikel wie Beispiel 2 nur das hier die 2. Varkombi mit der Anzahl 4 dem Konfigurationsartikel zugewiesen wird.

    3. Weisen Sie dieses Funktonsattribut den Komponenten zu, die mit anderen Komponenten inkompatibel sind. Als Wert tragen Sie die Artikelnummern der inkompatiblen Komponenten ein. Mehrere mit Komma, ohne Leerzeichen trennen.
    4. Soll ein Bild für die Konfigurationsgruppe angezeigt werden
    5. Weisen Sie dieses FunktionsAttribut dem Hauptartikel zu, wenn ein separates Produktbild aus den Artikelnummern der einzelnen Komponenten zusammengesetzt werden soll. Als Wert des Attributs geben Sie lediglich den relativen Pfad zum Bildverzeichnis an, unter dem sich die einzelnen Bilder befinden. Für jede Kombination muss eine entsprechende Bilddatei existieren. Die Bildnamen setzen sich dabei aus den Artikelnummer jeweils mit einem Bindestrich getrennt und der Dateiendung zusammen. Bsp: H1-M1-V1-E1.jpg
    6. Welche Dateiendung haben die unter Punkt5 gewählten Bilder
      - png | jpg | gif
    7. Setzen Sie dieses Zeichen/diesen String vor die Artikelnummer der Komponente oder den Gruppenbezeichner um einzelne Artikel oder die ganze Komponentengruppe in der Ausgabe zu unterbinden. Die Artikel werden dennoch in der Konfiguration im Warenkorb und im Auftrag berücksichtigt. Somit können Sie Komponenten des Konfigurationsartikels in eine separate Kategorie packen die zwar für den Shop aktiv ist, jedoch für die Kundengruppen „nicht sichtbar“ machen. Somit können die Kunden die Komponenten einzeln nicht aufrufen und kaufen jedoch werden diese trotzdem dem Warenkorb hinzugefügt und sind dann Bestandteil des Auftrages
    8. Geben Sie hier den Selektor an, wo das Template des Konfigurators eingebunden werden soll.
    9. Geben Sie hier die Methode ein, wo das Template des Konfigurators eingebunden werden soll.
    10. Hier können Sie den Selektor angeben, mit dem Sie nachträglich Elemente aus der Ansicht wieder entfernen können.

    4. Konfigartikel in der Wawi einrichten

    4.a Kurzform der Konfiguration

    1. Wawi öffnen
    2. - Attributverwaltung öffnen
    3. - FktsAttribut mit Freitext hinzufügen
      - konfiguratorx_vorauswahl
      - konfiguratorx_komponenten
    4. -Vaterartikel erhält FktsAttribut: konfiguratorx_vorauswahl mit dem Wert: Artikelnummer der Varkombi (welche als Einstieg definiert werden soll) Bsp.: konfiguratorx_vorauswahl : 0001-003
    5. - Entsprechende Varkombi erhält dann die Komponenten die zur Konfiguration gehören:
    6. FktsAttribut: konfiguratorx_komponenten mit den Werten nach Syntaxschema unter 3.b variable[Artikelnummer:Anzahl]
    7. Bsp.: konfiguratorx_komponenten : variable1[m01-002:5]

    4.b Einrichten der Konfigurationsartikel in der Wawi (Anhand eines Beipieles, Schritt für Schritt)

    Zuerst legen wir in der Wawi die Funktionsattribute mit den Werten Freitext an
    1. In unserem Fall konfiguratorx_vorauswahl (oder entsprechend das was Sie in den Plugineinstellungen eingetragen haben)
    2. Funktionsattribut mit Freitext: konfiguratorx_komponenten


    Es wird ein Vaterartikel angelegt mit Variationen im Beispiel Müsli (ArtikelNr: 0001)
    1. Daraus erstellen wir VarKombis mit den Variationen in Inhalt (500g, 750g, 1250g) (ArtNr.0001-001 bis 0001-003)
    2. Wir möchten das der Artikel mit dem Größten Inhalt das Einstiegsprodukt der Konfiguration werden soll
      - Wir öffnen den Vaterartikel (Müsli)
      - Tragen hier bei Attribute/Merkmale das Funktionsattribut konfiguratorx_vorauswahl mit dem Wert 0001-003 ein (0001-003 ist die Artikelnummer des Müsli-1250g) Somit haben wir definiert das beim Aufruf des Artikels, IMMER die Varkombi Müsli-1250g vorausgewählt ist und sichtbar für den Kunden

    Nun möchten wir Konfigurationsartikel erstellen die Bestandteil der Konfiguration werden sollen. Hierbei vergessen wir Grundsätzlich die Logik die von JTL Konfigurator ausgeht. Sie müssen keine Konfigurationsgruppen erstellen und mühsam die Artikel hinzufügen
    1. Wir erstellen einen Artikel ohne Variationen der im Konfigurationsartikel vorhanden sein soll
      - Beispiel Artikel: Schokoflocken ArtNr:m04
      - Wir erstellen einen weiteren Artikel mit Variationen der im Konfigurationsartikel vorhanden sein soll
        1. 2. Beispiel Vaterartikel: Früchte Art.Nr: m02
          - Variation des Artikels Früchte-Banane Art.Nr: m02-001
          - Variation des Artikels Früchte-Apfel Art.Nr: m02-002
          - Variation des Artikels Früchte-Erdbeer Art.Nr: m02-003


    Wir haben nun alles was wir brauchen um den Konfigurationsartikel anzulegen und zu konfigurieren
    Varkombi des Vaterartikels der als Einstiegsprodukt dient (konfiguratorx_vorauswahl)
    - unterschiedliche Artikel (mit und ohne Variation) die Bestandteil des Konfigurationsartikels werden
    Nun muss der Varkombi (Vorauswahl) das Funktionsattribut hinzugefügt: konfiguratorx_komponenten
    1. Bedenken Sie die korrekte Syntax (siehe Tabelle in 3.b)
    2. Syntax in unserem Beispiel wie folgt: variable1[m04:1]
      - Hier haben wir dem Auwahlartikel die Konfiguration Schokoflocken zugewiesen mit Anzahl 1
    3. Erweitern wir die Konfiguration: variable1[m04:1];variable2[m02-001:2]
      - Hier haben wir nun 2 Gruppen zugewiesen, Schokoflocken und 2 Einheiten Früchte-Banane
    4. Erweitern wir die Konfiguration: variable1[m04:1];variable2[m02-001:2,m02-002:5]
      - Nun haben wir der Früchtegruppe (variable2) zusätzlich 5 Einheiten Äpfel hinzugefügt


    Dieses Schema kann nun individuell erweitert werden.

    Im Frontend erhalten Sie dann eine ähnliche Ausgabe wie folgt:




    5. Sprachvariablen

    5.a Wozu Sprachvariablen

    Der KonfiguratorX ist so aufgebaut, das Sie eigens die Variablen vergeben können, sowohl die Betitelung der Funktionsattribute wie auch die Gruppennamen der Konfigurationsartikel (was Sie zu einer Gruppe zusammenfassen können). In unserem Beispiel waren die Gruppennamen variable1 und variable2 für die Komponenten vergeben. Diese werden im Frontend noch als #custom.konfiguratorx_variable2# ausgegeben da wir die Sprachvariable im Shopbackend dafür noch nicht hinzugefügt haben. In unserem Beispiel war die variable2 der Gruppenname für die Früchte, demnach fügen wir die Sprachvariable konfiguratorx_variable2 in der Sektion Custom hinzu und benennen diese als „Früchtesammlung für dein perfektes Müsli“. Daraus ergibt sich die Variable die wir für den Gruppennamen im Syntax der Komponenten angeben, die Sprachvariable im Shopbackend und zugleich der Selektor ist, die Artikel zu einer Gruppe zusammen zuführen.




    5.b Warum muss die Sprachvariable so aussehen

    In unserem Fall haben die Variablen den festen vorgegeben Wert des Pluginnamens als Präfix der Variablen, somit ist auch gewährleistet immer eine eindeutige Zuordnung zu erhalten

    6 Speicherlimit des Servers

    Im besten Fall sollten Sie memory_limit auf mindestens 512 erhöhen wenn Sie mehr wie 200 Variationen haben, andernfalls kann sich der Konfigurator in einen Timeout laufen und die Seite reagiert dann nicht mehr. Sollte dies der Fall sein wenn Sie eine Gruppe im Frontend aufrufen wollen, erhöhen Sie den entsprechenden Wert der php-Einstellungen.

    7. Ausschließen von Komponenten (ab Version 1.05)

    Wenn Sie Beispielsweise Komponenten zur Auswahl stellen, die nicht immer mit allem kompatibel wären, können Sie mit dieser Funktion entsprechende Artikel unterbinden. Die Komponenten welche zu anderen inkompatibel sind, bekommen ein separates FunktionsAttribut, welches in den Plugineinstellungen definiert werden kann. Als Wert werden die Artikelnummern der Komponenten hinterlegt, zu denen diese Komponente inkomatibel ist.

    8. Min. und Max. Menge (ab Version 1.05)

    Wenn Sie Beispielsweise Komponenten zur Auswahl stellen, die eine Mindestmenge voraussetzen oder eine Maximalmenge benötigen (Bsp.: Gratisgeschenke) kommt die Funktion hier zum Einsatz.

    Dabei ist zu beachten, dass wenn eine Min- oder Maxmenge verwendet werden soll, dass dann alle drei Werte gesetzt werden müssen. Syntax dazu bleibt wie auch Standard nur das hier die Ergänzung hinzukommt der Min./Max-Menge

    Gruppe[Artikel-001:{X|Y|Z}]

    Legende
    X = Wert der Menge Standard
    Y = Wert der Menge Min
    Z = Wert der Menge Max

    Komponenten welche nur einen Wert für Menge Standard benötigen, werde mit der aktuellen Syntax weiterhin definiert:

    Gruppe[Artikel-001:X]


    9. Eigenes Konfigurationsbild für den Vorausgewählten Artikel (könnte als Beispiel dienen wie eine Konfiguration fertig aussehen würde)

    Wawi:

    - legen Sie das Funktionsattribut (Funktionsattribut was in der Pluginverwaltung dafür vorgesehen ist) an mit dem Wert als Freitext

    - Geben Sie dem dem Hauptartikel/Einstiegsartikel das Funktionsattribut und als Wert geben Sie einen relativen Pfad für das Bildverzeichnis an worin sich die entsprechenden Bilder befinden.

    Bsp.:

    <code>https://ihre-domain/mediafiles/Bilder/ oder ähnlich </file>

    - Das Bild für den Artikel muss sich in dem o.g. Verzeichnis befinden und namentlich alle Artikelnummern enthalten die in der Konfiguration vorhanden sind.

    Bsp.: m01-001-m01-002-m02-001-m02-002-m02-003-m03-001-m04-001-m05-001-m05-002.jpg

    Veröffentlicht