# Deutsch # Dokumentation unserer Shopware 6 Plugins Herzlich Willkommen\ \ Auf unserer Seite finden Sie Anleitungen von unseren Plugins.\ Sollten Sie dennoch Fragen, Wünsche, Anregungen oder neue Ideen haben für unsere Plugins, zögern Sie nicht Uns zu kontaktieren.\ \ Wenden Sie sich dann bitte direkt an uns: **e-Mail:** **Telefon:** 02051 60 92 760 ### Allgemein / Kompatibilität Wir entwickeln ausschließlich auf Basis einer Standardinstallation von Shopware 5 / Shopware 6 ( Community Version ). Daher können wir nicht gewährleisten, dass Drittanbieter-, Premium-Plugins von Shopware, Plugins von Shopware die nicht in der Community Edition enthalten sind, Fremdanbieter-Themes oder individuell angepasste Themes kompatibel mit unseren Plugins sind. ### Plugin Support Wie bieten bei allen kostenpflichtigen Plugins Support an. Sollte aber bei einer Untersuchung festgestellt werden, dass Änderungen an unserem Plugin vorgenommen worden sind oder ein Fehler von einem anderen Plugin verursacht wird, kann eine gewünschte Behebung des Problems kostenpflichtig sein. ### Testversion Bei allen Plugins von Pixeleyes GmbH die im Shopware Community Store angeboten werden, haben Sie die Möglichkeit diese für 30 Tage ausgiebig zu testen, damit sichergestellt wird dass das Plugin Ihre Anforderungen erfüllt. Dazu müssen Sie nur die Mietversion auswählen, da diese einen Probemonat enthält. ***
Flächenberechnung für Shopware 6file6273b8a209588.jpegFlächenberechnung für Shopware 6
Artikeldesigner für Shopware 6file6435193ae4619.pngArtikeldesigner für Shopware 6
Lexikon für Shopware 6file600059da5fc69lexikon.pngLexikon / Glossar für Shopware 6
FAQ Manager für Shopware 6faq.pngFAQ Manager für Shopware 6
Zusätzliche Artikeltabstabs.pngZusätzliche Artikeltabs für Shopware 6
[^1]: # Artikeldesigner für Shopware 6 Bieten Sie Ihren Kunden die Möglichkeit, online Ihre Artikel wie z.B. Poster, T-Shirts, Banner oder Werbemittel zu gestalten und zu konfigurieren. Dazu kann Ihr Kunde auf viele Features zurückgreifen. {% hint style="info" %} **Wichtige Info:** (Support und Gewährleistung bieten wir nur für den Artikeldesigner Extended an, nicht für die zusätzlich zur Verfügung gestellten Addons wie z.b. die Bildergalerie) {% endhint %} **Funktionen:** **Texte** \- Text skalierbar \- Textarbe veränderbar \- eigene Schriftarten \- Texte rotierbar \- Textpreis einstellbar (nach Anzahl der Textobjekte oder nach Anzahl der eingegebenen Ziffern) \- Texteffekte (BETA) **Motive** \- Motivgröße skalierbar \- Motive als SVG \- Motivfarbe veränderbar (bis zu drei Farben , bei SVG ) \- Motive rotierbar \- Motivpreis einstellbar \- Motivdruckart einstellbar **Sonstiges** \- De- und Aktivieren des Designers im Adminbereich \- keine Artikelbegrenzung \- Vorschau der Konfiguration im Warenkorb \- Userupload (jpg, png) \- Druckarten und Farben \- 4 Ansichten \- Bilder-Galerie \- dynamische Preisberechnung im Konfigurator \- Druckbereich für jedes Produkt einstellbar über die Adminmaske \- Kostenloses Bildergalerie Addon (kein Support und Gewährleistung) {% hint style="warning" %} Wichtige Info: Das Plugin ist bedingt für Smartphone-, Tablet-Ansichten geeignet. Dazu erscheint in diesen Auflösungen ein Hinweis {% endhint %} **Kostenlose Addons (Artikeldesigner Extended):** Für die kostenlos zur Verfügung gestellten Zusatzaddons, bieten wir kein Support oder Gewährleistung an. Sofern die Addons auch Schnittstellen enthalten, müssen hierbei Genehmigungen bei den jeweiligen Anbietern eingeholt werden für die Nutzung der Schnittstellen. Sie als Shopbetreiber stellen Pixeleyes GmbH von allen Ansprüchen frei, die durch eine widerrechtliche Nutzung der jeweiligen Schnittstellen entstehen. Haftungsausschluss: Die Nutzung der kostenlosen Addons geschieht auf eigene Gefahr. Diese Addons werden ohne Mängelgewähr und Gewährleistung jedweder Art bereitgestellt . {% hint style="info" %} Wichtige Infos: 2\. Beim Plugin müssen alle Preise netto eingegeben werden. Die Einstellung "Bruttopreise eingeben" bei den Kundengruppen muss daher deaktiviert sein! 3\. Das Plugin generiert eine SVG und ein Screenshoot des konfigurierten Artikels, keine druckfähige Datei. 4.Die Funktion "Plattenberechnung/Zuschnittberechnung" sowie Ösenfunktion ist in der Shopware 6 Version nicht enthalten! {% endhint %} # Systemanforderungen Shopware Version min. 6.4.3.0 PHP 7.4 ImageMagick OpenSSL {% hint style="danger" %} Der Designer bzw. Shop sollte nicht über einen Iframe geladen werden. \ Dies wird nicht unterstützt! {% endhint %} # Installation {% hint style="info" %} Vor der Installation eines Plugins unbedingt eine Sicherung des Shops und der Datenbank durchführen {% endhint %} 1. Im Adminbereich des Shops das Plugin unter Erweiterungen > Meine Erweiterungen > Artikeldesigner installieren und aktivieren 2. Unter Erweiterungen > Meine Erweiterungen > Artikeldesigner auf bearbeiten klicken und das Plugin aktivieren 3. Den Shopcache gegebenenfalls leeren und die Administrationsseite erneut mit F5 neu laden. \ **Hinweis:** Bitte deinstallieren Sie das Plugin vor dem Entfernen immer über den Plugin-Manager. Ein direktes Löschen (z. B. per FTP oder „kündigen und entfernen“) kann zu Fehlern oder verbleibenden Systemeinträgen führen. # Plugineinstellungen **Folgende Einstellungen stehen Ihnen zur Verfügung:**

 **Absoluter Pfad zum Shop:** 
Geben Sie den absoluten Servierpfad zum Shop an **Bilder pro Seite
:** Wieviel Motive pro Seite angezeigt werden sollen **Grafik-Bibliothek
:** Hierbei sollte ImageMagick eingestellt werden **Link-ID zur Hilfe:** Die ID der Shopseite für die Hilfe **Upload immer als base64:** Das Upload Bild kann auch als base64 kodiertes Bild in der SVG generiert werden. Dies im Vorfeld testen, ob dann die Daten zum Warenkorb korrekt gesendet werden. Eventuell muss man dann die Größe der POST Variablen in der PHP.ini erhöhen. **Colourbox Bildergalerie:** Aktivieren von Colourbox. erfordert installiertes Colourbox Addon. **Artikelbilder im Warenkorb ändern:** Anstatt dem Produktbild, wird der generierte Screenshoot der Konfiguration angezeigt. {% hint style="danger" %} Es wird hier empfohlen das Artikelbild zu nutzen {% endhint %} **Plugin aktivieren:** Aktiviert das Plugin im Subshop **Warnhinweis:** Aktiv, wird ein Warnhinweis angezeigt wenn die Konfigurator seite verlassen wird. **Schriften per Ajax:** Zur Zeit keine Funktion **Bildbwertung:** Zeigt eine Bewertung des hochgeladenen Bildes an **Entwicklerfunktionen aktivieren:** Aktiviert z.b. das anzeigen der X,Y Koordinaten des Objekts an, wenn dieses bewegt wird. # Anlegen von Alben in der Medienverwaltung Das Plugin legt bei der Installation selbst einen Ordner an: Artikeldesigner Media # Import / Export Sie können auch Demodaten herunterladen, die Sie dann per Import / Export von Shopware 6 importieren können
[**Demodaten herunterladen**](https://dev1.pixeleyes.de/media/demodaten/artikeldesigner-demodaten.zip)\ \ Wichtige Info für das Importieren der Daten:\ \ Die Daten müssen nach folgender Reihenfolge wieder importiert werden:\ \ 1\. Importieren der Optionen\ 2\. Importieren der Optionswerte\ 3\. Importieren der Schriften\ 4\. Importieren der Druckarten\ 5\. Importieren der Farben\ 6\. Importieren der Ansichten\ 7\. Importieren der Varianten\ 8\. Importieren der Motivkategorien\ 9\. Importieren der Motive\ 10\. Importieren der Konfiguration\ \ Aufgrund dessen, dass man in Shopware 6 nicht alle Daten per Import Funktion Importieren kann,\ muss nach dem Import der Demo Daten,\ \ 1\. Bei den Varianten die Ansichten verknüpft werden\ 2\. Bei den Ansichten die Bilder der Ansichten hochgeladen werden\ 3\. Die Schriften im Ordner fonts der Zip Datei müssen in den Ordner public/fonts/ Ihres Shopware 6 Shops hochgeladen werden\ 4\. bei der Konfiguration "Shirtkonfiguration" die Varianten, Schriften verknüpfen\ 5\. bei der "Konfiguration "individuelles Maß" dann die Optionen verknüpft werden # Pluginmenu Nach der Installation und Aktivierung des Plugins, müssen Sie den Cache sowie die Themes des Shops neu kompilieren.


Nach Neuladen des Browserfenster, finden Sie unter dem Menüpunkt „Kataloge“ zusätzliche Menüpunkte auf die später näher eingegangen wird.

 **Menübaum:**

 

Artikeldesigner- Konfiguration 

Artikeldesigner - Druckarten

 

Artikeldesigner - Farben

 Artikeldesigner - Schriftarten

 

Artikeldesigner- Varianten

 

Artikeldesigner- Ansichten 

Artikeldesigner - Motive

 

Artikeldesigner - Motiv-Kategorien

 

Artikeldesigner - Optionen
 

Artikeldesigner - Optionswerte # Druckarten Unter diesen Menüpunkt können Sie Druckarten erstellen. Diese können Sie dann jedem Produkt zuweisen. Auch erstellte Farben müssen einer Druckart zugewiesen werden.


Unten sehen Sie eine Liste von angelegten Druckarten. Um eine neue Druckart anzulegen, müssen Sie oben auf Einträge hinzufügen klicken Es öffnet sich dann ein neues Detailfenster
**Name:** Name der Druckart
 **Aktiv:** Aktivieren der Druckart
 **Sortierung:** Sortierreihenfolge
 **Beschreibung:** intern
 **Bild:** Bild auswählen aus der Medienverwaltung (noch nicht genutzt) # Konfiguration Hier finden Sie eine Übersicht der schon erstellten Konfigurationen. Die erstellten Konfigurationen, können Sie dann beim Artikel unter Spezifikationen > Zusatzfelder > Artikeldesigner verknüpfen
# Tab Reiter Standard
### Tab Reiter Standard Tragen Sie hier ihre gewünschten Daten ein:\ \ **Titel:** Titel der Konfiguration \ **Seo Url:** zur Zeit ohne Funktion \ **Konfigurator Titel:** Eindeutiger Name der Konfiguration \ **Position:** Geben Sie die Position für das Anzeigen in der Liste ein \ **Beschreibung:** Interne Beschreibung \ **Zugewiesene Druckarten:** Wählen Sie aus den Dropdown Ihre gewünschten Druckarten aus \ **Zugewiesene Motive:** Wählen Sie aus den Dropdown Ihre gewünschten Motive aus **Zugewiesene Schriftarten:** Wählen Sie aus den Dropdown Ihre gewünschten Schriftarten aus \ **Zugewiesene Varianten (nicht bei Individuelle Maße):** Wählen Sie aus den Dropdown Ihre gewünschten Varianten aus \ **Verkaufskanal:** Auswählen bei welchen Verkaufskanal die Konfiguration angezeigt wird # Tab Reiter Einstellungen
### Tab Reiter Einstellungen **Aktiv:** Aktivieren der Konfiguration **0,00 Fix:** Setzt den Artikelpreis auf 0,00. Der Preis wird daher nur durch die Konfiguration kalkuliert **Einfaches Colorpanel aktivieren:** Anstatt der eingestellten Druckfarben wird lediglich ein Colorpanel angezeigt **Begrenzung aktivieren:** im Standard kann der Kunde einen Text, Motiv oder Bild auch über den Druckbereich ziehen. Durch aktivieren dieser Funktion kann er die Objekte nur im Druckbereich positionieren. **Individuelle Maße aktivieren:** Durch aktivieren, zeigt der Designer lediglich eine Möglichkeit der Eingabe von Breite und Höhe ein. Dazu muss eine Kalkulationsoption mit zwei Optionsfeldern Breite und Höhe eingestellt werden. Sie brauchen bei dieser Einstellung keine Varianten zu erstellen! **Varianten als Bilder:** Zeigt im Frontend die Varianten als Bilder an, anstatt Dropdowns **Metermass (BETA):** zeigt oberhalb und Links neben der „Gestaltungsbühne“ die Maße an. **Kaufen Button aktivieren:** Zeigt zusätzlich zum "Jetzt Gestalten" Button noch einen Kaufen Button. Hierbei kann der Kunde entweder direkt bestellen oder das Produkt konfigurieren **Automatische Anpassung:** Passt die Motive / Bilder auf der Bühne automatisch z.B. anhand der min./max. Breite und Höhe. **Bild an Container anpassen:**\ \ Passt das Bild an die Bühne an\ \ **Hintergrundfarben:**\ \ Aktiviert die Möglichkeit die Hintergrundfarbe zu ändern\ \ **Full Size Anzeige:**\ \ Zeigt den Designer in Full Mode an\ \ **Object Warnung:**\ \ Aktiviert die Warnung, wenn das Objekt ausserhalb der Bühne gezogen wird. Erfordert Aktivierung der Entwickleroptionen in den Plugineinstellungen\ \ **Abstand im Container:** Ermöglicht ein Padding im Containe **Motive aktivieren:** Aktiviert die Motive **Faktor:** Hierbei wird der Motivpreis x Faktor berechnet **max Motive:** Anzahl der Motive die auf die Bühne gesetzt werden können
Min. und Max. Schriftgrad müssen in Pixel eingestellt werden.
### Textkalkulation: **Textfunktion aktivieren:** Aktivieren der Textfunktion **Text Kalkulation:**\ \ Hier können Sie auswählen ob nach Anzahl der eingegebenen Zeichen oder nach hinzugefügten Textobjekten berechnet werden soll. **Text Zeilen Preis:**\ \ Der Preis für die Berechnung der Textkalkulation **Art des Textes:**\ \ Immer Text einstellen, Itext ist im Entwicklungsmodus
### Uploadeinstellungen: **Upload aktivieren:**\ \ Aktivieren der Möglichkeit zum hochladen eigener Bilder durch den Kunden **min.Dateigröße in Bytes:**\ \ Hier können Sie eine Untergrenze einstellen für die Dateigröße des Uploads. **max.Dateigröße in Bytes:**\ \ Hier können Sie eine Obergrenze einstellen für die Dateigröße des Uploads . {% hint style="warning" %} Wichtige Info: Stellen Sie immer die Dateigröße ein, die auch in der PHP.ini eingestellt und hochgeladen werden kann (post\_max\_size, upload\_max\_filesize, max\_execution\_time ) ansonsten kann ein Bild dann nicht hochgeladen werden, wenn es die Limits überschreitet. Auch können wir nicht gewährleisten dass Bilder die eine hohe Dateigröße haben korrekt verarbeitet werden können, da das Bild nach dem Upload gegebenfalls bearbeitet wird durch unser Plugin. Prüfen Sie daher bis zur welchen Dateigröße der Upload und die Verarbeitung korrekt abläuft da dies je Server immer verschieden ist. {% endhint %} **min. Dateibreite / min. Dateihöhe :**\ \ Sofern die Maße geändert werden z.B. bei Individuellen Maßen, wir die Mindestmaße geprüft und das Bild skaliert (In Verbindung mit "automatischer Anpassung) **max. Dateibreite / max. Dateihöhe :**\ \ Sofern die Maße geändert werden z.B. bei Individuellen Maßen, wir die Maximalmaße geprüft und das Bild skaliert(In Verbindung mit "automatischer Anpassung)
**Dateiendungen:**\ \ Geben Sie hier die gewünschten Dateiendungen kommagetrennt ein. Unterstützt werden zur Zeit JPG und PNG **Upload Preis:**\ \ Eingeben des Aufpreises für das hochgeladene Bild
### Kalkulation Die Einstellungen unter dem Tab Kalkulation sind nur für die Einstellung "Individuelles Maß"! **Kalkulationspreis:**\ \ Preis der mit der Formel multipliziert wird **Anzahl der Dezimalstellen:**\ \ Geben Sie die Dezimalstellen (Nachkommastellen) an\ \ **Formel:**\ \ Eingabe der Formel, anhand dessen berechnet wird **Unter Version 1.1.9** \ Wert: %a muss immer als Ergebnis am Anfang der Formel stehen. Folgende Variablen stehen zur Verfügung: %a als Ergebnis, %b als Breite , %c als Höhe, %calcqty als Stückzahl (nicht zu vergleichen mit der Menge von Shopware) Am Ende muss immer ein Semikolon stehen und nicht die „Prozentzeichen“ vergessen. Möchten Sie z.B. die Fläche berechnen aus Breite und Höhe, müssen Sie folgendes dann eintragen: %a = %b \* %c; Zwei Optionswerte erforderlich (Breite, Höhe)\ \ **Ab version 2.0.0**\ \ Folgende Variablen stehen zur Verfügung: b als Breite , c als Höhe, calcqty als Stückzahl (nicht zu vergleichen mit der Menge von Shopware)\ \ Möchten Sie z.B. die Fläche berechnen aus Breite und Höhe, müssen Sie folgendes dann eintragen: b \* c Zwei Optionswerte erforderlich (Breite, Höhe) # Tab Experimentiell
### Tab Experimentiell
{% hint style="danger" %} Alle Funktionen die mit BETA oder Experimentiell gekennzeichnet werden, sollten nicht in einem Livebetrieb eingesetzt werden. **Für diese Funktionen, bieten wir keine Gewährleistung oder Support an, die Nutzung geschieht auf eigene Gefahr!** {% endhint %} **Randabstand :** Fügt einen Randabstand / Linie ein (nur bei individuellen Maßen) **Schriftgrößen Feld (BETA):**\ \ Bei Ja, wird ein Schriftgrößen Feld eingefügt **Text Zeichen Begrenzung (BETA):**\ \ Aktiviert die Text Zeichen Begrenzung
**Text Effekte Aktivieren (BETA)** Aktiviert die Texteffekte\ \ **Zeichenabstand Aktivieren (Experimentiell):**\ \ Aktiviert den Zeichenabstand in der Detailseite **Zeilenhöhe Aktivieren (Experimentiell):**\ \ Aktiviert die Zeilenhöhe in der Detailseite **SVG Text Aktivieren (BETA):**\ \ Aktiviert die SVG Text Funktion **Text Skalierprüfung (BETA):**\ \ Bei Ja, wird der Text nur bis zu einer bestimmten Mindesthöhe skaliert **Schriftgröße kalkulieren (BETA):**\ \ Bei Ja wird die Schriftgröße kalkuliert. Nur in Verbindung mit Schriftgrößen Feld (BETA) einzusetzen!
### Colorbox aktivieren Aktiviert Colorbox. Dazu müssen die API Zugangsdaten von Colourbox eingetragen werden
### Metermass (BETA) Zeigt oberhalb und Links neben der „Gestaltungsbühne“ die Maße an. **Transparenz Aktivieren (Experimentell):** Aktiviert die Transparenz in der Detailseite **Skalieren in alle Richtungen Aktivieren (Experimentell):** Aktiviert das Skalieren in alle Richtungen **Tastenfunktionen (BETA):** Aktiviert die TastenfunktionenPreis ändern (keine Funktion) **Maßstab (BETA)**\ Aktiviert die Anzeige des Maßstabs. Nur bei individuellen Maßen oder einer Ansicht verwenden!Bild Filter (Experimentiell) **Zentrierlinien (BETA):**\ Bei Ja werden Horizontale und vertikale Linien angezeigt, sofern ein Objekt mittig platziert wird **Koordinaten Anzeige:**\ \ Aktiviert die Anzeige der Koordinaten. Erfordert Aktivierung der Entwickleroptionen in den Plugineinstelungen ### Malmodus (Experimentiell)
### Schatten (Experimentiell)
### Zuschnitt Berechnung
###
# Tab Reiter "Verknüpfte Optionen"
Im Tab "Verknüpfte Optionen" können Sie dann ihre erstellten Optionen und Optionswerte der Konfiguration zuweisen. Klicken Sie dazu auf Optionen hinzufügen. Es öffnet sich eine neue Maske.
###
### **Tab Standard** Wählen Sie oberhalb den gewünschten Optionswert aus. Die textfelder "Optionswertname", "Optionsname", "Formularfeld" sowie "Optionswert" werden dann nach Ihrer Auswahl automatisch befüllt und können nicht geändert werden. **Vorselektiert:** Diese Funktion ist für Optionen wie z.B. Radio, Checkboxen, Select um Optionswerte vorzuselektieren. **Aktivieren:** Aktiviert den Optionswert
### ### **Tab Konfiguration** **Preis:** Aufpreis der Option **Prefix für Wert:** Wird als Präfix bei den Kalkulationsfeldern im Frontend angezeigt z.B. m, mm, cm.\ \ **Preis Prefix:** Auswahl der Berechnung (Addieren, Subtrahieren etc.)
###
### Tab Kalkulation **Parameter:** {% hint style="info" %} Wichtige Einstellung: Hier müssen Sie bei den Optionswerten der Option „Calculator/Berechnung“ den richtigen Parameter zuweisen. Ohne diese Zuweisung kann keine Fläche berechnet werden! {% endhint %} Wenn Sie z.B. als Berechnungsgrundlage / Formel für die Flächenberechnung (a = b \* c) ausgewählt und dementsprechend Optionswerte wie z.B. Breite, Höhe, Länge erstellt haben, müssen sie hier vorgeben welcher Parameter dieser Optionswert hat. Optionswert für b = Breite auswählen Optionswert für c = Höhe auswählen
# Optionen
### Optionen - Liste Unter diesen Menüpunkt können Sie Optionen erstellen.\ \ Wenn Sie auf "Erstellen" klicken, können Sie einen neuen Eintrag erstellen.
### Optionen - Detailseite **Titel:** Name der Option **Aktiv:** Aktivieren der Option **Als Maß:** Sollten Sie beim Artikel Individuelle Maße aktiviert haben, müssen Sie eine Option Kalkulation (Komponente : calculator) und zwei Optionswerte Breite und Höhe erstellen. **Komponente:** Wählen Sie die Darstellung Ihrer Option. Dazu gibt es unterschiedliche Komponenten wie Select, Checkboxen, Radio, Imageradio, imagecheckboxen **Position:** Sortierreihenfolge **Beschreibung:** Geben Sie eine Beschreibung ein\ \ **Ösenfunktion:** Aktiviert die Ösenfunktion (BETA). **Ösenfarbe:** Geben Sie die Ösenfarbe ein, sofern Sie die Ösenfunktion aktiviert haben (BETA). **Ösenlinienfarbe:** Geben Sie die Ösenlinienfarbe ein, sofern Sie die Ösenfunktion aktiviert haben (BETA).
###
**Bild:** \ \ Wählen Sie ein Bild aus # Optionswerte
### Optionswerte Jede Option (z.B. Option Größe) besteht aus eine oder mehreren Optionswerten (z.b. S,M,L).\ \ Durch Klick auf Erstellen, können Sie einen Optionswert erstellen.
### Optionswerte - Detailseite **Kopfzeile:** Name des Optionswertes\ \ **Beschreibung:** Beschreibung des Optionswertes **Aktiv:** Aktivieren des Optionswertes **Vorselektieren:** Vorauswahl für den Optionswert **Position:** Sortierreihenfolge
**Zugewiesene Optionen:** Wählen Sie hierbei die Option, bei dem Sie den Optionswert unterordnen möchten\ \ **Bild:** Wählen SIe ein Bild aus (nur bei Checkboxen oder Radio Optionen)
### Ösen Einstellungen BETA **Ösen Aktiv:** Aktiviert die Ösen Funktion (Achtung BETA). \ Mit dieser Funktion können Sie einstellen (je nach Position der Öse) dass beim Klick auf den Optionswert (wir empfehlen hierbei die Nutzung von Checkboxen ) die jeweilige Öse dann angezeigt wird \ **Wählen Sie hierbei die Position der Öse (nur eine Position je Optionswert!)** Ösen Oben Links Ösen Oben Mitte Ösen Oben Rechts Ösen Unten Links Ösen Unten Mitte Ösen Unten Rechts Ösen Mitte Rechts Ösen Mitte Links # Schriften
### Schriften Liste Unter diesen Menüpunkt können Sie Schriften erstellen. 
Unten sehen Sie eine Liste von angelegten Schriften.
 Um eine neue Schrift anzulegen, müssen Sie oben auf Erstellen klicken
### Schriften Detailseite **Schriftenname:** Geben Sie hier den Schriftennamen ein 
 **Beschreibung:** Intern / Optional **Min. und Max Schriftgrad:** Geben Sie den Mindest und Maximal Schriftgrad in Pixel an. **Position:** Sortierreihenfolge

**Aktiv:** Aktivieren der Schrift
\ **Normal:** Normales Aussehen aktivieren\ **Kursiv:** Kursiv aktivieren sofern in der Schrift möglich\ **Fett:** Kursiv aktivieren sofern in der Schrift möglich\
{% hint style="info" %} Zur Info:\ Sofern Sie Kursiv und Fett einstellen, empfehlen wir hierbei die Schrift in drei Variationen zu erstellen, z.B. Schrift Normal, Schrift Fett, Schrift Kursiv, da im Web ein text mit einer Schrift kursiv oder Fett dargestellt wird, beim exportieren aber der text dann gegebenfalls normal angezeigt werden könnte. {% endhint %}
### CSS-Name
Geben Sie hier den Schriftennamen ohne Leerzeichen ein
 \ Die Schriften (\*.woff, \*.eot, \*.ttf) müssen in das Verzeichnis /public/fonts/ kopiert werden. Achten Sie auf die Lizenzbestimmungen des jeweiligen Schrifteninhabers! Gegebenenfalls werden nicht alle Schriften unterstützt\ \ Unter und finden Sie geeignete CSS Generatoren, um Ihre Schriften als CSS zu generieren. Achten Sie hierbei dass Sie dann die Verlinkung zu den Schriften anpassen\ Beispiel:



 {% code overflow="wrap" lineNumbers="true" %} ```css / @font-face { font-family: 'Play'; font-style: normal; font-weight: 400; src: url('#url#fonts/play-v7-latin_latin-ext_greek_cyrillic-ext_cyrillic-regular.eot'); src: local('Play'), local('Play-Regular'), url('#url#gfonts/play-v7-latin_latin-ext_greek_cyrillic-ext_cyrillic-regular.eot?#iefix') format('embedded-opentype'), url('#url#fonts/play-v7-latin_latin-ext_greek_cyrillic-ext_cyrillic-regular.woff2') format('woff2'), url('#url#fonts/play-v7-latin_latin-ext_greek_cyrillic-ext_cyrillic-regular.woff') format('woff'), url('#url#fonts/Play-Regular.ttf') format('truetype'), url('#url#fonts/play-v7-latin_latin-ext_greek_cyrillic-ext_cyrillic-regular.svg#Play') format('svg'); } ``` {% endcode %} # Varianten
### Varianten Liste Unter diesen Menüpunkt können Sie Varianten erstellen. Varianten sind im diesen Sinne Variationen eines Artikels ähnlich den Varianten von Shopware. Z.b. möchten Sie ein T-Shirt erstellen in den Varianten Grün, Gelb, Rot etc.\ \ Dazu müssen Sie dann z.B. eine Variante Rot mit bis zu 4 Ansichten erstellen.\ \ Ansichten sind in diesem Fall z.B. die Vorder-, Rück- oder Ärmelansicht, die dann einen Druckbereich beinhalten, auf dem dann die Motive, Text oder Bilder positioniert werden können Diese können Sie dann einem Artikel zuweisen. Bei den Varianten sollten maximal 4 Ansichten erstellt werden. Erstellen Sie einen neuen Eintrag in der Variantenliste.
### Varianten Detailseite **Name / Kopfzeile:** Name der Variante **Position:** Sortierreihenfolge **Beschreibung:** Intern\ \ **Preis:** Aufpreis **Zugewiesene Ansichten:** Wählen Sie die erstellten Ansichten aus ( unter Artikeldesigner Ansichten können Sie diese erstellen) Speichern Sie Ihre Einstellungen.
**Hex-Wert:** Hier können Sie einen Farbwert eingeben/auswählen **Bild der Variante:** Dieses dient als Vorschaubild # Ansichten
### Ansichten Liste Unter Kataloge > Artikeldesigner Ansichten können Sie die Ansichten (z.B. Vorder-, Rück-, Ärmelansichten) der Varianten (Z.B. Rot, Gelb etc.) erstellen und diese dann unter Artikeldesigner Varianten > gewünschte Variante verknüpfen.\ \ Erstellen Sie durch klicken auf "Erstellen" eine
**Name / Kopfzeile:** Name der Ansicht **Kurzbeschreibung:** Beschreibung der Ansicht (Intern)
### Position: Festlegen der Reihenfolge
**Hexfarbe:** Farbe der Ansicht **Aktiv:** Aktivieren der Ansicht **Vorselektiert:** Die Variante als selektiert markieren. Eine Variante muss vorselektiert sein **Randabstand:** Festlegen eines Abstands beim Druckbereich
Sofern Sie ein Hintergrundbild einfügen z.B. ein T-Shirt und Sie möchten aber dass der Druckbereich nicht das ganze T-Shirt „umhüllt“, können Sie hier die Positionen bestimmen. Diese können Sie auch unter Druckbereich festlegen. Der Druckbereich erscheint nur dann wenn Sie im Vorfeld die Ansicht gespeichert haben. Dann erst wird dieser aktiviert. **Links:** Position links **Rechts:** Position rechts **Oben:** Position oben **Unten:** Position unten Breite und Höhe: Tragen Sie hier die Breite und Höhe in Pixel ein von Ihrer Variante. Das Hintergrundbild und die Maske müssen auch in den gleichen Maßen hochgeladen werden.
{% hint style="danger" %} Bitte nur Bilder mit den maximalen Maßen bis 600x600 Pixel benutzen! {% endhint %}
Hier haben Sie die Möglichkeit den Druckbereich mittels Anfasser durch ziehen festzulegen oder manuell durch Eingabe der Positionen.
###
Wählen Sie Ihr gewünschtes Hintergrundbild aus. Ein Hintergrundbild wird hinter der „Gestaltungsebene“ platziert Siehe auch Beispiel „UHR“ in unserer Demo. Hierbei haben wir einen weissen Kreis als PNG (Transparent) benutzt. Das Hintergrundbild muss exakt die gleiche Breite und Höhe haben wie unter Inhalte > Breite und Höhe!\ \ Wählen Sie ihre gewünschte Maske aus die über den Bearbeitungsbereich im Frontend positioniert wird. Siehe auch Beispiel „UHR“ in unserer Demo. Hierbei haben wir ein Zifferblatt einer Uhr als PNG (Transparent) benutzt. Die Maske muss exakt die gleiche Breite und Höhe haben wie unter Inhalte > Breite und Höhe! # Motive
### Motiv Liste Unter diesen Menüpunkt können Sie Motive erstellen. Diese müssen einer Kategorie untergeordnet werden. Erstellen Sie einen neuen Eintrag in der Motivliste.
### Motive - Detailseite **Motivname:** Name des Motifs **Kurz und Langbeschreibung:** Intern
###
**Aktiv:** Aktivieren des Motifs **Preis:** Aufpreis des Motifs\ \ **Position:** Reihenfolge Bei der Position muss unbedingt eine durchlaufende Nummerierung erfolgen! **SVG:** Ist das Motiv eine SVG Datei {% hint style="info" %} **Tip:** Es empfiehlt sich Motive im SVG Format zu nutzen, da beim Skalieren die Qualität nicht vermindert wird. {% endhint %}
###
{% hint style="info" %} Unser Designer unterstützt bis zu drei Ebenen einer SVG {% endhint %} **Anzahl der Pfade:** Geben Sie hier die Anzahl der Ebenen bei SVG. Bei normalen Bildern Anzahl 1 eingeben. **Zugewiesene Kategorie:** Zuordnen des Motifs zu einer Motivkategorie **Farbe 1-3:** Unser Designer unterstützt bis zu drei Ebenen , so dass diese vom Kunden eingefärbt werden können. Tragen Sie hier dann die gewünschten Farben ein.\ \ **Zugehörige Druckarten**\ \ Wie auch bei den Farben, müssen Sie hierbei auch den Motiven Druckarten zuweisen.
###
**Bild**\ \ Wählen Sie hier das Bild aus der Medienverwaltung. Bei SVG dient dieses als Vorschau in der Motivliste. \ **SVG**\ \ Wählen Sie hier das SVG aus der Medienverwaltung. {% hint style="info" %} Achten Sie darauf, dass die Motive in einem Album der Medienverwaltung sind, in dem mindestens drei Thumbnails generiert werden {% endhint %} # Motiv-Kategorien
### Motiv-Kategorien Unter diesen Menüpunkt können Sie Motiv Kategorien erstellen. \ \ Diesen Kategorien können Sie dann Motive unterordnen.
### Motiv-Kategorien Detailseite **Titel:** Name der Kategorie **Aktiv:** Aktivieren der Kategorie **Position:** Sortierreihenfolge **Beschreibung:** Intern # Farben
### Farben Unter diesen Menüpunkt können Sie Farben erstellen. Diese dienen dazu, Texte sowie Motive zu färben. \ \ Wenn Sie auf "Erstellen" klicken, können Sie einen neuen Farbeintrag erstellen.
### Farben - Detailseite **Kopfzeile:** Name der Farbe **Kurzbeschreibung:** Interne Beschreibung
**Position:** Reihenfolge der Farbe **Aktiv:** Aktivieren der Farbe **Farben-Pattern:** Ohne Funktion **Vorausgewählt:** Damit wird die Farbe bei den Druckarten vorausgewählt **Als Hintergrundfarbe:** Sofern bei der Konfiguration, Hintergrundfarben angelegt sind, wird diese Farbe auch darunter angezeigt **Farbe auswählen:** Hexadezimaler Code oder Farbauswahl aus den Colorpicker **Zugewiesene Druckarten:** Zuweisung der Farbe bei den angelegten Druckarten # Individuelles Maß oder Varianten benutzen? Der Unterschied ist folgender:\ \ Varianten:\ \ Beim Einsatz von Varianten und Ansichten, müssen im Vorfeld Designer Varianten (T-Shirt BLAU) mit bis zu 4 Ansichten (Vorder-, Rück-,Ärmel-rechts-, Ärmel-Links-Ansicht) erstellt werden. Empfohlen für Produkte wie T-Shirts, Tassen oder Merchandise Artikel bei denen ein Bild als Hintergrund positioniert ist und der Kunde nur im angelegten Druckbereich die Objekte (Texte, Motive, Bilder) einfügen kann.\ \ **Beispiele:**\ \ [Individueller-Kugelschreiber](https://dev1.pixeleyes.de/Individueller-Kugelschreiber/SW10002)\ \ [Individuelles-Feuerzeug](https://dev1.pixeleyes.de/Individuelles-Feuerzeug/SW10003)\ \ [Individuelles-Shirt](https://dev1.pixeleyes.de/Individuelles-Shirt/SWDEMO10001)\
#### **Individuelles Maß:**
\ Beim Individuellen Maß muss man eine Option "Als Maß" erstellen und zwei Optionswerte "Breite" und "Höhe" und keine Varianten.\ \ Anhand der eingegebenen Breite und Höhe durch den Kunden wird hierbei der Druckbereich automatisch berechnet und generiert. Diese Funktion ist empfohlen bei allen Artikeln bei dem man den Kunden die Möglichkeit geben möchte, sein Produkt in seinen gewünschten Maßen zu konfigurieren und zu bestellen. Als Beispiel Banner, Poster etc.\ \ **Beispielartikel:** \ \ [Individuelles-Mass](https://dev1.pixeleyes.de/Individuelles-Mass/SW10001)
# Schriften generieren **Beispiel** \ \ 1\. Wählen Sie links im Menü ihre gewünschte Schrift aus\ \ \ 2\. Wählen Sie nur einen Style aus z.B. Regular
3\. Geben Sie unter „Customize folder Prefix“ das Schriftenverzeichnis ein. In diesem Fall\ \ \#url#fonts/ \ 4\. unter Download Files wird Ihnen die Schrift als Download dann angeboten.\ \ 5\. Laden Sie dann die darin enthaltenen Schriften (eot,svg, ttf, woff,woff2) in das Verzeichnis /public/fonts/ hoch. Wenn der Ordner public fonts nicht vorhanden ist, erstellen Sie diesen.\ \ 6\. Fügen Sie dann den CSS Code bei der Schrift ein.
7\. Tragen Sie bei CSS Name dann den Schriftnamen ein der im Code unter "font-family: 'xxx''" steht. im Beispiel oben wäre es "Oswald". Achten Sie darauf dass sofern der Schriftname Leerzeichen (font-family: 'xxx') enthält, diese dann entfernt werden müssen.\ Zum Beispiel heisst eine Schrift "Oswald Regular" so muss der CSS Name dann "OswaldRegular" oder "Oswald-Regular" heissen (Bindestriche sind erlaubt).\ 8\. Tragen Sie dann beim Schriftenname das gleiche wie unter (font-family: 'xxx') ein.\ 9\. Prüfen Sie dann diese Schrift im Frontend.\ \ \ \ Sollte die Schrift nicht korrekt dargestellt werden (Schriftenmenü, Text etc.) wird die Schrift entweder nicht unterstützt, der CSS Name enthält Leerzeichen / Sonderzeichen oder der Schriftenname weicht von (font-family: 'xxx') ab {% hint style="warning" %} Wir möchten Sie darauf hinweisen, dass Sie nur Schriften nutzen sollten, für die Sie eine Berechtigung haben diese online zur nutzen, da Schriften generell urheberrechtlich geschützt sind.\ \ Bei sehr vielen Schriften Anbietern ist das Einbinden Ihrer Schriften als Webfonts untersagt. Wir empfehlen hierbei sich Rat bei Ihren Rechtsbeistand zu holen und bei den jeweiligen Anbieter von dem Sie die Schrift nutzen möchten anzufragen ob Sie dies dürfen. **Auch können wir nicht gewährleisten dass alle Schriften mit unserem Designer einwandfrei funktionieren können.** Wir empfehlen darüber hinaus nicht zu viele Schriften einzubinden, da dies zu Performance Problemen führen kann. {% endhint %} # Konfiguration eines Artikels
Um einen Designer / Konfigurator Artikel zu erstellen, muss im Vorfeld eine Konfiguration erstellt werden mitsamt Schriften, Motiven, Druckarten, Farben und Varianten bzw. Individuelles Maß.\ \ Die Konfiguration muss dann mit dem Artikel verknüpft werden unter Spezifikation > Zusatzfelder > Artikeldesigner. Wählen Sie dann aus dem Dropdown ihre gewünschte Konfiguration die Sie beim Produkt einsetzen möchten # Flächenberechnung für Shopware 6 ### Unser top bewerteter Artikel Konfigurator, Produkt Konfigurator von Shopware 5 jetzt auch für Shopware 6 \ Mit diesem Plugin unseres erfolgreichen und top bewerteten Shopware 5 Plugins "Flächenberechnung mit individuellen Optionen", ist es Ihnen möglich in Ihrem Shopware 6 Shop, bei jedem Produkt Optionen und Optionswerte unterzuordnen und anhand von Formeln Flächen zu berechnen. \ Erstelle mit unserem Produktkonfigurator einfache oder komplexe konfigurierte Artikel mit Berechnungen von Flächen und/ oder Gewichten, Zusammenstellen von Optionen. Sie können Konfigurationen auch ohne eine Berechnungen von Flächen erstellen. Jede Konfiguration ist mehrmals bei Produkten anwendbar ohne ein mühseliges Erstellen von Varianten.
Dabei stehen Ihnen auch unterschiedliche Formularfelder / Komponenten zur Verfügung. \ \ **Die Komponenten werden stets erweitert und Sie brauchen keine weiteren kostenpflichtigen Addons wie bei anderen Konfiguratoren zu erwerben!**
### **Verfügbare Formularfelder** * Selektfelder (Dropdownliste) * Selektfelder Mehrfachauswahl (Dropdownliste) * Textfelder * Datumsfeld * Farbfeld * Berechnung / Kalkulation * Kontrollkästchen * Kontrollkästchen als Buttons * Optionsschalter * Optionsschalter als Buttons * Image Checkboxen * Image Radio * Image Select * Numerische Inputfelder * einfaches Uploadfeld ( nicht für größere Dateien geeignet!) ### **Zusätzliche Funktionen** * Einstellen von Berechnungseinheiten (m, mm, cm, l) * Einstellen von Preis Prefix je Formularfeld * \+ Addieren des Aufpreises auf den Preis des Artikels * \- Subtrahieren des Aufpreises auf den Preis des Artikels * Einstellen von Berechnungseinheiten für das Kalkulationsergebnis(m², mm², cm², m³…) * Vordefinierte Optionswerte möglich * Dynamische Preiskalkulation * 0,00 Warenkorb Fix * Mindestwert Berechnung * Import und Export Profile \ Damit können Sie die Daten aus dem Shopware 5 Plugin von uns importieren (Version > 3.0.7) * Einstellen der Mobilen Ansicht, Tablet Ansicht sowie Desktop Ansicht * Einstellen von komplexen Formeln möglich bei der Kalkulation * Einstellen von komplexen Formeln möglich bei den Optionswerten * Hochladen von Bildern bei Optionen wie Checkboxen, Radio, Image Radio, Image Checkboxen, Image Select * Sticky Zusammenfassung * Je Variante eine andere Konfiguration möglich * Plattenberechnung\ (siehe ) * Berechnung anhand eingegebener Zeichen, ideal für Folienbeschriftungen * Matrix (Beta) * Blacklist (Beta) * Diverse Rules / Regeln für den Versand enthalten * Gurtmass * maximale Länge * maximale Breite * maximale Höhe * maximale Maße # Changelog #### 2.0.6 #### 28. November 2024 Anpassen des Mindestwertpreises (Währungsfaktor) Anpassen des Checkouts Diverse Anpassungen
{% hint style="danger" %} **Wichtig:** Berechnungsmethode in den Einstellungen auf "Neue Methode" setzen {% endhint %} #### 2.0.5 #### 25. November 2024 Anpassen an Shopware 6.6.8.2 #### 2.0.4 #### 5. November 2024 Diverse Anpassungen für Shopware 6.6.\* #### 2.0.3 #### 21. Oktober 2024 Kompatibel zu 6.6.7.0 #### 2.0.2 #### 27. September 2024 Anpassen der Zusammenfassung (Textfelder, Numerische Felder) #### 2.0.126. September 2024 \- Einbinden einer Funktion, wenn output\_buffering nicht aktiv ist. \- Beheben eines Problems wenn Numerischer Wert x Preis berechnet werden soll. Please change to "new Method" on plugin configuration
#### 1.9.9 #### 26. September 2024 Kompatibel zu 6.6.6.1 #### 1.9.8 #### 17. September 2024 Beheben eines Währungsproblems #### 1.9.7 #### 10. September 2024 beheben eines Problems mit Shopware 6.6.6.0 #### 1.9.6 #### 5. August 2024 beheben eines Problems mit dem Währungsfaktor (Shopware 6.6.x) #### 1.7.9 #### 5. August 2024 beheben eines Problems mit dem WährungsFaktor #### 1.7.8 #### 19. Juli 2024 Anpassen diverser Bootstrap Funktionen
Anpassen der Berechnung durch den Artikelpreis #### 1.9.5 #### 19. Juli 2024 Anpassen diverser Bootstrap Funktionen\ Anpassen der Berechnung durch den Artikelpreis #### 1.7.7 #### 2. Juli 2024 Behebung eines Problems mit Warenkorbrabatten #### 1.9.4 #### 2. Juli 2024 Beheben eines Problems mit Warenkorb Rabatten #### 1.9.3 #### 24. Mai 2024 Anpassen einer Twig Datei (Frontend, Backend ) #### 1.9.2 #### 23. Mai 2024 Anpassen diverser Twig Dateien im Backend #### 1.9.1 #### 8. Mai 2024 beheben diverser Twig Dateien im Frontend #### 1.9.0 #### 26. April 2024 Beheben eines Bugs im Checkout. Update für Shopware über 6.6. #### 1.7.6 #### 26. April 2024 Beheben eines Bugs im Checkout. Update für Shopware unter 6.6. #### 1.8.6 #### 23. April 2024 Anpassen der Customfields unter Spezifikationen des Artikels #### 1.8.5 #### 22. April 2024 fixen diverser Funktionen für 6.6.0.2 Anpassen des Customfields #### 1.7.5 #### 15. April 2024 fixen diverser Funktionen für 6.6.0.2 #### 1.7.4 #### 2. April 2024 Kompatibel zu Shopware 1.7.4 #### 1.7.3 #### 29. Februar 2024 \- Anpassen diverser Twig Dateien \- Beheben eines Fehlers bei Letterselect #### 1.7.2 #### 5. Februar 2024 Einbinden einer Möglichkeit zum Eintragen von einer globalen CSS Klasse Beheben eines Problems bei Netto/Brutto Preisen bei Staffeln #### 1.7.1 #### 4. Dezember 2023 \- Customize various functions \- Incorporate sorting in the shopping cart based on item numbers #### 1.7.0 #### 13. November 2023 \- Einbinden einer Möglichkeit zum Hinzufügen von Zubehör \- Anpassen der Blacklist bei boxradio, boxcheckboxen #### 1.6.8 #### 9. November 2023 Kompatibel zu 6.5.6.1 beheben eines Fehlers bei Blacklist #### 1.6.5 #### 20. September 2023 Diverse Anpassungen ( Übersetzungen , CSS ) #### 1.6.3 #### 20. September 2023 \- Einfügen einer Datumfeld Komponente \- Einfügen einer Farbfelde Komponente \- Einfügen einer Multiselect Komponente \- Einfügen einer Button (Mehrfachauswahl) Komponente \- Einfügen einer Button (Einfachauswahl) Komponente #### 1.6.2 #### 17. September 2023 anpassen von media queries #### 1.6.1 #### 17. September 2023 Kompatibel zu 6.5.5.1 #### 1.6.0 #### 29. August 2023 \- Diverse Anpassungen für Bootstrap 5 \- Diverse Anpassungen für Meteor Kit \- Diverse Anpassungen für die Gewichtsberechnung #### 1.5.9 #### 11. August 2023 Beheben eines Problems bei der Berechnung der Stückzahl (Als Optionswert) #### 1.5.8 #### 26. Juli 2023 \- Anpassen des Warenkorbs sowie Offcanvas\ \- Anpassen des Uploads\ \- Anpassen der Zusammenfassung\ \- Einbinden der Möglichkeit, festzulegen ab welcher Auflösung die Zusammenfassung Links und rechts angezeigt werden soll\ \- Diverse Anpassungen für Bootstrap 5 #### 1.5.7 #### 17. Juli 2023 Beheben eines Problems beim Upload #### 1.5.6 #### 16. Juli 2023 Beheben von Netto/Brutto beim Kalkulieren mit dem Artikelpreis\ Anpassen diverser Bootstrap 4 Komponenten zu Bootstrap 5 Komponenten\ Beheben eines Fehlers beim Kalkulieren mit der Stückzahl (Optionswert) #### 1.5.5 #### 26. Juni 2023 Beheben einer Inkompatibilität von Bootstrap 4 zu 5 #### 1.5.4 #### 13. Juni 2023 Beheben diverser Fehler (Bootstrap CSS) bei 6.5 #### 1.5.3 #### 25. Mai 2023 Kompatibel zu 6.5.0.0\ \ Beheben von Netto/Brutto bei der Matrix (Beta) Wichtige Information: Diese Version ist lediglich eine Übergangsversion für 6.4.20.2 auf 6.5. Um von 6.4.20.2 auf 6.5.0.0 zu aktualisieren, müssen/können Sie diese Version in der 6.4.20.2 hochladen und dann das Update auf 6.5.0.0 durchzuführen. #### 1.5.2 #### 15. Mai 2023 Kompatibel zu 6.5.0.0
Wichtige Information: Diese Version ist lediglich eine Übergangsversion für 6.4.20.2 auf 6.5.\
Um von 6.4.20.2 auf 6.5.0.0 zu aktualisieren, müssen/können Sie diese Version in der 6.4.20.2 hochladen und dann das Update auf 6.5.0.0 durchzuführen. #### 1.5.1 #### 2. Mai 2023 Beheben eines Problems bei den Dateiendungen > Komponente "Upload" #### 1.5.0 #### 25. April 2023 Anpassen diverser Funktionen für > 6.4.20 #### 1.4.9 #### 31. März 2023 \- Beheben eines Problems bei den Optionsformeln - Anpassen des Textfeldes #### 1.4.7 #### 27. März 2023 Einbinden von Breite , Höhe und Länge des Artikels als Formelvariablen #### 1.4.8 #### 27. März 2023 Beheben eines Problems bei den Optionsstaffeln #### 1.4.6 #### 3. März 2023 \- Einfügen einer Funktion zum Berechnen von Platten \- Aktuallisieren der Import/Export Profile #### 1.4.2 #### 13. Februar 2023 Einfügen eines Dropdowns inkl. textfeldes zum Berechnen von Textzeichen #### 1.4.0 #### 27. Januar 2023 Beheben eines Problems bei einer Entity #### 1.3.9 #### 17. Januar 2023 \- Einbinden einer Funktion zum Berechnen von mehreren Numerischen Feldern zu einem Kalkulationsfeld oder vorgegebenen Wertes \- Beheben eines Fehlers beim Textfeld \- Einbinden der Breite, Höhe und Länge aus den Spezifikationen des Artikels für die Formel #### 1.3.6 #### 6. Januar 2023 Ändern der Migration beim Import, sofern die Englische Sprache gelöscht wurde vom Shopbetreiber. #### 1.3.5 #### 2. Januar 2023 Einbinden eines numerischen Feldes #### 1.3.3 #### 9. Dezember 2022 Anpassen des Ergebnisses im Checkout #### 1.3.0 #### 20. Oktober 2022 Beheben eines Fehlers beim Anzeigen des Gesamtpreises #### 1.3.2 #### 20. Oktober 2022 Beheben eines Problems bei der Matrix #### 1.3.1 #### 28. September 2022 * Beheben eines Fehlers im Template /custom/plugins/PixelAreacalculator/src/Resources/views/storefront/page/checkout/checkout-item.html.twig * Beheben eines Problems bei der Matrix #### 1.2.9 #### 6. September 2022 Beheben eines Kalkulationsfehlers #### 1.2.7 #### 19. August 2022 Einbinden zweier Einstellungen für Image Select Einbinden einer Einstellung zum Ändern der CSS Klasse der Listing Buttons #### 1.2.6 #### 18. August 2022 Einbinden einer neuen Komponente "ImageSelect" #### 1.2.5 #### 17. August 2022 \- Einbinden eines Customfields "AB". Zeigt bei Aktivierung ein "ab" beim Preis\ \- Anpassen des Listings sowie der Detailseite #### 1.2.3 #### 17. August 2022 \- Anpassen einer Javascript Funktion (Safari Kompatibilität)\ \- Anpassen der Zusammenfassung\ \- Anpassen des Styles\ \- Einbinden einer Konfigurationsmöglichkeit zum Aktivieren von Anzeigen von fortaufenden Nummerierungen #### 1.2.2 #### 12. August 2022 Kompatibilität zum Plugin " Cookie Menü Popup mit "Alle akzeptieren" Button" #### 1.2.1 #### 10. August 2022 \- anpassen des Accounts\ \- anpassen des PDF Dokuments #### 1.2.0 #### 5. August 2022 Anpassen der Matrix Einbinden einer Anzeige (Gesamt qm x Qm Preis) in der Zusammenfassung
#### 1.1.9 #### 30. Juni 2022 erhöhen der einzugebenden Zeichen in der Formel #### 1.1.8 #### 28. Juni 2022 Anpassen des Checkouts #### 1.1.7 #### 27. Juni 2022 Einbinden zusätzlicher Variablen in der Formelberechnung #### 1.1.623. Juni 2022 Beheben eines Problems im Checkout
#### 1.1.5 #### 15. Juni 2022 Anpassen der Formelausgabe #### 1.1.4 #### 10. Juni 2022 \- Beheben eines Problems beim Startwert für Länge \- Einbinden von Buttons bei der Formeleingabe #### 1.1.3 #### 7. Juni 2022 Einbinden von Blacklists bei den verknüpften Optionen #### 1.1.2 #### 25. Mai 2022 Einbinden einer Kalkulationsart "Staffelbezogen".\ Dies bewirkt dass je berechnete QUadratmeter der Staffelpreis als Gsamtpreis dient #### 1.1.1 #### 25. Mai 2022 \- Beheben eines Fehlers, der unter PHP8 auftritt
\- Anpassen der Quadratmeter Preisstaffeln (Netto / Brutto) #### 1.1.0 #### 4. Mai 2022 Erstveröffentlichung des Plugins für Shopware 6 6.4.10.1 # Systemvoraussetzungen * Shopware Version min. 6.6.9.0 * PHP 8.1 * ImageMagick * OpenSSL * output\_buffering = 4096 * # Installation / Updates ### Installation Wir empfehlen Updates im Vorfeld immer in einer Entwicklungsumgebung in einem Unterverzeichnis des Shops zu testen z.B. Ihredomain.de /dev/. \ \ Die Installation des Plugins geschieht wie bei allen anderen Plugins, über den Administrationsbereich Ihres Shops, unter Erweiterungen > Store. Suchen Sie dann nach "Flchenberechnung für Shopware 6". Klicken Sie dann auf den Eintrag und im daraufolgenden Fenster dann auf "Erweiterung hinzufügen".\ \ Sie können das Plugin auch über den Store von Shopware erwerben. ### Aktualisierung des Plugins 1\. Entpacken Sie die Zip des Plugins und laden Sie dann den Inhalt des Ordners PixelmultioptionenSW6 in das Verzeichnis custom/plugins/PixelmultioptionenSW6 und dessen Inhalt überschreiben (Vorher Sicherung anlegen) 2\. Melden Sie sich im Backend an\ 3\. Öffnen Sie den Pluginmanager unter Erweiterungen > Meine Erweiterungen\ 4\. Beim Eintrag des Plugins "Flächenberechnung SW6" sollte dann neben dem Eintrag der Versionsnummer, ein Link "Aktualisierung" angezeigt werden. \ 5\. Klicken Sie auf diesen Link um das Update des Plugins zu starten. Es kann einige Zeit dauern bis das Plugin aktualisiert wird, daher nicht die Seite verlassen. \ \ Mehr Informationen zur Installation und Aktualisierung von Erweiterungen bei Shopware 6, finden Sie unter\ \ [Zur Shopware 6 Dokumentation](https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen) Bei Problemen oder Fehlern, können Sie sich jederzeit an uns wenden. Um Fehler zu analysieren und zu beheben, senden Sie uns FTP sowie Backend Zugang zu (Gegebenenfalls PHPMYADMIN Zugang um eventuell das Plugin per Datenbankbefehl zu deaktivieren). Hinweis: Bitte deinstallieren Sie das Plugin vor dem Entfernen immer über den Plugin-Manager. Ein direktes Löschen (z. B. per FTP oder „kündigen und entfernen“) kann zu Fehlern oder verbleibenden Systemeinträgen führen. # Pluginkonfiguration ### Pluginkonfiguration Wichtige Einstellungen (bei allen anderen erhalten Sie die Erklärung durch Mouseover bei den blauen Icons) A**bsoluter Pfad:** Tragen Sie hier den absoluten Pfad des Shops ein, sofern dieser nicht automatisch durch unser Plugin bei der Installation ausgefüllt wurde **Shopdomain:** Tragen Sie hier die Domain ein, mit http bzw. https ein **Serverpfad Upload:** Tragen Sie hier den absoluten Pfad zum Ordner public/media/pixelmultioptionenupload ein, sofern dieser nicht automatisch durch unser Plugin bei der Installation ausgefüllt wurde. Vergewissern Sie sich ob dieser Ordner angelegt ist unter public/media/pixelmultioptionenupload/. **Versandberechnung aktivieren (zur Zeit ohne Funktion):** Kalkuliert auch das Gesamtgewicht im Warenkorb **Gurtmassberechnung (zur Zeit ohne Funktion):** Berechnung das Gurtmass im Warenkorb **Preisdarstellung in der Artikeldetailseite:** Diverse Einstellungen für die Anzeige der Preise **Art des Requests:** Einstellen ob die Berechnung via AJAX oder Javascriptbasierend (BETA) oder Kalkulationsberechnung via Konfiguration sein soll. Bei Kalkulationsberechnung via Konfiguration entscheiden Sie je Konfiguration (Flächenberechnung > Area Konfiguration) wie die Berechnung sein muss.\ Beispiel: Bei Matrix Berechnungen schalten Sie in der Konfiguration (Flächenberechnung > Area Konfiguration) dann auf "Berechnung via Ajax ein", denn Matrix Berechnung funktioniert nur per Ajax. **Optionswertpreise im Checkout anzeigen:** Zeigt die Preise der Optionen im Warenkorb an

# Quick Start Nachdem Sie das Plugin installiert und aktiviert haben, können Sie Ihre gewünschte Konfiguration, anhand dieser Anleitung vornehmen, oder auch Demodaten von Uns importieren. #### **Import der Konfiguration** [ **Download der Demodaten** ](https://www.pixeleyes.de/sw/import_sw6_pixelareacalculator.zip)\ \ Nach dem Entpacken der Zip Datei, finden Sie folgende \*.csv Dateien:
1-Flächenberechnung-Optionen.csv > Beinhaltet den Export der Optionen\ \ Muss mit dem Import Profil **"Flächenberechnung Optionen"** importiert werden 2-Flächenberechnung-Optionswerte.csv > Beinhaltet den Export der Optionswerte Muss mit dem Import Profil **"Flächenberechnung Optionswerte"** importiert werden 3-Flächenberechnung-Konfiguration.csv > Beinhaltet den Export der Konfiguration Muss mit dem Import Profil **"Flächenberechnung Konfiguration"** importiert werden 4-Flächenberechnung-Verknüpfte-Optionen.csv > Beinhaltet den Export der verknüpften Optionen Muss mit dem Import Profil **"Flächenberechnung Verknüpfte Optionen"** importiert werden 5-Flächenberechnung-Optionsstaffeln.csv > Beinhaltet den Export der Optionsstaffeln Muss mit dem Import Profil **"Flächenberechnung Optionsstaffeln"** importiert werden 6-Flächenberechnung-Qm-Staffeln.csv > Beinhaltet den Export der Qm-Staffeln Muss mit dem Import Profil **"Flächenberechnung Qm Staffeln"** importiert werden {% hint style="success" %} Wichtige Info: Der Import muss nach der unten stehenden Reihenfolge erfolgen {% endhint %} 1. Optionen 2. Optionswerte 3. Konfigurationen 4. Verknüpfte Optionen 5. Qm Staffeln 6. Optionswertstaffeln Um die obenstehenden Daten zu importieren, stellt unser Plugin sogenannte Import und Export Profile bereit unter Einstellungen > Shop > Import/Export.\
# Optionen Wenn Sie auf Kataloge > Optionen klicken erscheint eine Übersicht ihrer hinterlegten Optionen. Optionen sind Gruppen von Eigenschaften wie z.B. Farbe, Größe etc.
Klicken Sie oben auf Erstellen um eine neue Option zu hinterlegen
### Optionen bearbeiten Sofern Sie in der Liste oben auf Erstellen oder rechts bei den Aktionen der hinterlegten Optionen auf "bearbeiten" klicken erscheint die Bearbeitungsmaske der Optionen. **Titel:** Geben Sie der Optionsgruppe einen Namen, wählen Sie ihr gewünschtes Optionsfeld (Menu, Liste, Optionsschalter, Checkbox..) aus. **Aktiv:** Aktivieren der Option, Optionen müssen bei Verknüpfte Optionen unter Kataloge > Konfiguration auch aktiviert werden. **Beschreibung:** Hinterlegen Sie hier eine Beschreibung der Option. **Feld validieren:** Aktiv, werden Textfelder, Textareas beim Hinzufügen in den Warenkorb geprüft. Sind diese leer, kann der Artikel nicht in den Warenkorb gelegt werden. (Ohne Funktion zur Zeit) **Feld:** Wählen Sie (unbedingt) aus der Liste ihr gewünschtes Formularfeld aus **Informationen aktiv:** Beschreibung anzeigen bei der Option {% hint style="info" %} Eine Option mit Kalkulationsfeldern muss immer am Anfang der Konfiguration positioniert sein. {% endhint %} {% hint style="warning" %} Es kann nur ein Uploadfeld pro Konfiguration eingebunden werden! {% endhint %}
# Optionswerte Unter Kataloge > Optionswerte können Sie Optionswerte erstellen und diese den Optionen zuweisen. Optionswerte sind die Eigenschaften der hinterlegten Optionen z.B. Rot, Weiss, S, M, L die Sie Optionen zuweisen können. Klicken Sie oben auf Erstellen um einen neuen Optionswert zu hinterlegen
### Optionswerte bearbeiten **Kopfzeile / Titel:** Geben Sie hier einen Namen ein für den Optionswert. **Position:** Festlegen der Sortierung der Optionswerte der jeweiligen Option **Sortierung überschreiben:** überschreibt die Sortierung bei den gesetzten Optionswert der Artikel **Zugewiesene Optionen:** Wählen Sie aus dem Dropdown die Optionsgruppe der Sie die Optionswerte unterordnen möchten. **Aktiv:** Aktivieren des Optionswertes , Optionswerte müssen bei Katalog > Konfiguration > Verknüpfte Optionen auch aktiviert werden. **Bild:** Unter Bildverwaltung können Sie dann auch ein Bild aus der Medienverwaltung von Shopware für den Optionswert auswählen (nicht bei Dropdownfelder).
# Konfiguration Bei der Konfiguration haben Sie die Möglichkeit spezifische Einstellungen vorzunehmen wie z.b. Formeln, Kalkulationspreise zu hinterlegen sowie Optionen mit der Kalkulation zu verknüpfen. # Tab Standard **Titel:** Geben Sie der Konfiguration einen Namen **Position:** Die Reihenfolge der Konfiguration **Beschreibung:** Interner Kommentar
# Tab Einstellungen **Aktivieren:** Durch setzen des Häkchens aktivieren Sie die Konfiguration. **Kalkulation mit Artikelpreis:**\ Die Kalkulation einer Fläche wird mittels Artikelpreis ( keine Erweiterten Preise ) berechnet. Ist diese Funktion aktiv, ist eine Quadratmeterstaffelberechnung nicht möglich. Beim Artikelpreis muss der Brutto sowie Nettopreis eingeben werden im backend. **0 EUR Fix Aktivieren:**\ Shopware lässt bei einem Artikel kein 0,00 EUR Preis zu, sofern Sie aber diese Funktion aktivieren, wird im Frontend der Artikelpreis mit 0,00 EUR ausgegeben. Achten Sie aber darauf, dass Sie trotzdem bei den Stammdaten einen Preis angeben und das Sie Optionen hinterlegen, die beim Laden des Artikels kein Preis mit 0,00 EUR erzeugen!\ \ Beim nicht aktivieren des 0 EUR Fixes muss dann Berechnung per Ajax aktiviert werden **Quadratmeter im Warenkorb anzeigen:**\ Sofern aktiviert, werden die Berechnungen Quadratmeter im Warenkorb angezeigt **Gesamtgewicht anzeigen :**\ Aktiviert, wird das berechnete Gesamtgewicht im Warenkorb angezeigt **Menge bei den Staffeln berücksichtigen:**\ Normalerweise wird anhand der berechneten Fläche geprüft, welcher Staffelpreis für die Berechnung benutzt wird. Ist aber diese Checkbox aktiviert, wird dann anhand ( Ergebnis \* Menge) der dementsprechende Staffelpreis genommen **Berechnungsart bei den Optionsstaffeln:**\ Hier können Sie auswählen wie die Optionsstaffeln Berechnung werden sollen (z.B. anhand der eingegebenen Menge, Quadratmeterergebnis etc.) ### **Definitionen:** #### **Nach Menge** Wenn Menge >= "von" ist , dann berechne mit dem dazugehörenden Staffelpreis #### Nach Quadratmeter Wenn Ergebnis der Kalkulation >= "von" ist dann berechne mit dem dazugehörenden Staffelpreis Wenn aber ein "Mindestpreis" enthalten ist und der größer 0 ist, dann prüfe \= Wenn Staffelpreis < Mindestpreis dann berechne mit dem dazugehörenden Mindestpreis #### Nach Quadratmeter (Preis \* Stueckzahl) Wenn Ergebnis der Kalkulation >= "von" ist dann berechne mit dem dazugehörenden Staffelpreis Wenn aber ein "Mindestpreis" enthalten ist und der größer 0 ist, dann prüfe \= Wenn (Staffelpreis \* Stückzahl) < Mindestpreis dann berechne mit dem dazugehörenden Mindestpreis #### Quadratmeter (Preis \* Menge) Wenn Ergebnis der Kalkulation >= "von" ist dann berechne mit dem dazugehörenden Staffelpreis Menge (Preis \* Menge) Wenn Menge >= "von" ist , dann berechne mit dem dazugehörenden Staffelpreis \* Menge #### Quadratmeter (Preis \* Ergebnis) Wenn Ergebnis der Kalkulation >= "von" ist dann berechne mit dem dazugehörenden Staffelpreis Nach Quadratmeter dividiert durch Stk (Preis \* Stueckzahl) Wenn Ergebnis der Kalkulation dividiert durch Stückzahl >= "von" ist dann berechne mit dem dazugehörenden Staffelpreis \* Stückzahl #### Nach Stk Wenn Stückzahl >= "von" ist , dann berechne mit dem dazugehörenden Staffelpreis #### Nach Stk , Preis dividiert durch Stk Wenn Stückzahl >= "von" ist , dann berechne mit dem dazugehörenden Staffelpreis dividiert durch Stückzahl **Optionsstaffelberechnung aktivieren:**\ Aktivieren der Optionsstaffelberechnung bei den Optionen **Gurtmassberechnung aktivieren (BETA):**\ Hiermit wird ein Aufschlag zum Artikel Berechnung **Maximaler Gurtmass:**\ Angabe eines Maximalen Werts **Maximaler Gurtmassaufpreis:**\ Maximaler Preis für das Berechnen **Berechnung bei dem Gurtmass:**\ Wählen Sie hier die gewünschte Berechnung aus **Mindestwertberechnung aktivieren:**\ Im aktivierten Zustand, wird anhand des hinterlegten Mindestwerts bei der Berechnung im Frontend geprüft, ob dieser niedriger ist als das Ergebnis der Flächenberechnung. Ist dies der Fall so wird der Mindestkalkulationspreis als Gesamtpreis der Flächenberechnung genommen. **Mindest-Kalkulationspreis:**\ Geben Sie hier den Preis (Brutto) ein, der als Gesamtpreis der Berechnung dienen soll, sofern der Mindestwert unterschritten wird bei der Kalkulation im Frontend. **Spezieller Aufschlag (Ohne Funktion in Shopware 6):** Sofern der Kunde einen Wert eingibt der Dezimalstellen enthält, wird ein Aufschlag erhoben **Speziellen Aufschlag aktivieren (Ohne Funktion in Shopware 6):** Aktiviert die Funktion **Spezieller Aufschlag (Ohne Funktion in Shopware 6):** Eingabe des Speziellen Aufschlags (netto)
# Tab Kalkulation **Kalkulationspreis:**\ Sofern Sie dem Produkt eine Optionsgruppe Calculator und Optionswerte untergeordnet haben, müssen Sie hier den Basis-Kalkulationspreis (Netto) angeben **Anzahl der Dezimalstellen:**\ Anzahl der auszugebenden Dezimalstellen\ \ **Anzahl der Dezimalstellen beim Ergebnis:**\ Anzahl der auszugebenden Dezimalstellen beim Ergebnis sowie bei den Ergebnissen der Kalkulationsfelder bei der Zusammenfassung
**Anzahl der Dezimalstellen bei Qm Staffeln:**\ Anzahl der anzuzeigenden Dezimalstellen bei den Quadratmeterstaffeln **Formel für die Berechnung:**\ Geben Sie hier die gewünschte Formel ein. Wert: %a muss immer als Ergebnis am Anfang der Formel stehen. **Folgende Variablen stehen zur Verfügung:** | Variable | Erklärung | | -------- | ------------------------------------ | | %a | Ergebnis | | %b | Breite | | %c | Höhe | | %d | Länge | | %bb | Breite 2 | | %bc | Breite 3 | | %cb | Höhe 1 | | %cc | Höhe 2 | | %calcqty | Stückzahl (Nicht Menge von Shopware) | | %bd | Breite 4 | | %be | Breite 5 | | %bf | Breite 6 | | %bg | Breite 7 | | %bh | Breite 8 | | %bi | Breite 9 | | %cd | Höhe 3 | | %ce | Höhe 4 | | %cf | Höhe 5 | | %cg | Höhe 6 | | %ch | Höhe 7 | | %ci | Höhe 8 | {% hint style="info" %} Die Benennungen z.b. Breite 2 etc. sind generell nur damit Sie wissen welche Variable sie gerade einsetzen in der Formel. die Variable z.b. %cc die intern "Höhe 2" benannt wird, kann z.b. auch in ihrer Formel als Breite genutzt werden {% endhint %} Am Ende muss immer ein Semikolon stehen und nicht die „Prozentzeichen“ vergessen. Möchten Sie z.B. die Fläche berechnen aus Breite und Höhe, müssen Sie folgendes dann eintragen: ```javascript %a = %b * %c; ``` #### Beispiele: **Berechnen der Fläche aus Breite und Höhe** Zwei Optionswerte erforderlich Optionswert mit Parameter Breite Optionswert mit Parameter Höhe Möchten Sie z.B. die Fläche aus Breite und Höhe berechnen und diese dann mit der Stückzahl (neuer Optionwert , nicht zu vergleichen mit dem Mengen-Dropdown von Shopware ) multiplizieren, müssen Sie folgendes dann eintragen: ```javascript %a = %b * %c * %calcqty; ``` Drei Optionswerte erforderlich (Optionswert mit Parameter Breite, Optionswert mit Parameter Höhe, Optionswert mit Parameter Stückzahl ) V**olumen berechnen (Breite x Höhe x Länge):** ```javascript %a = %b * %c * %d; ``` Drei Optionswerte erforderlich Optionswert mit Parameter Breite Optionswert mit Parameter Höhe Optionswert mit Parameter Länge **Länge berechnen:** ```javascript %a = %d; ``` Ein Optionswert erforderlich Optionswert mit Parameter Länge *** **Berechnungseinheit (Gesamt):** Einstellen der Einheit für das Gesamtergebnis der Kalkulation z.B. m2, mm2, cm2. **Art der Flächenberechnung:** Standard: Hierbei wird das Ergebnis mit dem Kalkulationspreis multipliziert **Staffelpreisbezogen:** Hierbei wird der Staffelpreis für die weitere Berechnung genutzt **Quadratmeter Staffeln:** Hier haben Sie die Möglichkeit Staffeln für die Berechnung festzulegen. {% hint style="info" %} Die Werte „von“ und „bis“ beziehen sich auf m2. \ \ **Wichtige Info:** Immer vom ersten Tab anfangen die Staffeln zu erstellen und dann zu speichern . {% endhint %} Die darauffolgende Zeile muss dann bei "Von" nicht den gleichen Wert haben wie die vorherige Zeile "Bis". **Beispiel:** Die erste Zeile lautet von 0 bis 10. Dann muss die zweite Zeile mit 10.01 anfangen. Achten Sie darauf dass der nächste Wert immer mit .01 anfängt. \ \ **Beispiel:** 0 - 10\ 10.01 - 20\ 20.01 -30
# Tab Verknüpfte Optionen Im Tab "Verknüpfte Optionen" können Sie dann ihre erstellten Optionen und Optionswerte der Konfiguration zuweisen. Klicken Sie dazu auf Optionen hinzufügen.\ \ Verknüpfte Optionen können erst dann angelegt werden, wenn die Konfiguration gespeichert wurde. Es öffnet sich eine neue Maske. {% hint style="warning" %} Die Funktionalität "Blacklist" ist Experimentiell und sollte nicht in einem Livebetrieb eingesetzt werden. **Für diese Funktionen, bieten wir keine Gewährleistung oder Support an, die Nutzung geschieht auf eigene Gefahr!** {% endhint %}
# Tab Standard Wählen Sie oberhalb den gewünschten Optionswert aus. Die Textfelder "Optionswertname", "Optionsname", "Formularfeld" sowie "Optionswert" werden dann nach Ihrer Auswahl automatisch befüllt und können nicht geändert werden. Vorselektiert: Diese Funktion ist für Optionen wie z.B. Radio, Checkboxen, Select, Imageradio, Imagecheckbox um einen Optionswert (Radio, Imageradio, Select) oder mehrere Optionswerte (Checkboxen, Imagecheckboxen) vorzuselektieren. **Aktivieren:**\ Aktiviert den Optionswert **Preise anzeigen:**\ Einstellen ob der Aufpreis bei der Option angezeigt werden soll **Fixer Wert:** \ für Kalkulator Optionen gedacht (Breite, Höhe, Länge, Stückzahl). Wenn diese Funktion aktiviert wird bei einer Option, hat der Kunde keine Möglichkeit den Wert zu ändern, siehe unteres Beispiel „Breite“.
# Tab Konfiguration **Preis:**\ Aufpreis der Option **Preis Prefix:**\ Auswahl der Berechnung (Addieren, Subtrahieren etc.) **Berechnungseinheit:**\ Wird als Präfix bei den Kalkulationsfeldern im Frontend angezeigt z.B. m, mm, cm. **Preis/Faktor:**\ Aufpreis des Optionswertes Bei der Auswahl vom Präfix „Prozent vom Qm-Preis“ und „\* Qm-Preis“ dient der eingegebener Preis als Faktor (zur Zeit eine Funktion) **Stepwise Aktivieren (nur Kalkulationsfelder Breite und Höhe):**\ Sofern aktiviert, kann der Kunde nur Werte eingeben die sich mit dem Stepwise Wert dividieren. (zur Zeit eine Funktion) **Stepwise Wert:**\ Eingabe des Stepwise Werts (zur Zeit eine Funktion) **Gewicht:**\ Eingabe eines Gewichts **Anzeigen im Checkout:**\ Anzeigen des Optionswerts im Checkout. **Berechnen des Gewichts:**\ Auswahl der Berechnung des Gewichts (zur Zeit eine Funktion)
# Tab Kalkulation **Parameter:**\ Wichtige Einstellung: Hier müssen Sie bei den Optionswerten der Option „Calculator/Berechnung“ den richtigen Parameter zuweisen. Ohne diese Zuweisung kann keine Fläche berechnet werden! Wenn Sie z.B. als Berechnungsgrundlage / Formel für die Flächenberechnung (a = b \* c) ausgewählt und dementsprechend Optionswerte wie z.B. Breite, Höhe, Länge erstellt haben, müssen sie hier vorgeben welcher Parameter dieser Optionswert hat. Optionswert für b = Breite auswählen Optionswert für c = Höhe auswählen Optionswert für d = Länge auswählen Optionswert für calcqty (Stückzahl) = Stückzahl auswählen\ \ Startwert Breite, Startwert Höhe, Startwert Länge sind ab der Version 1.1.0 nicht mehr Dropdowns sondern Numerische Felder. Diese müssen stets eingestellt werden! Dazu dann die Einstellungen bei Minimal und maximal einstellen.
Z.B. bei ausgewählten Parameter Breite, müssen Sie unter "Einstellungen für Parameter Breite" die Werte einstellen
**Berechnungseinheit:** \ Eingeben der Berechnungseinheit des Optionswerts z.B. cm, m, mm etc. Eigene Formel nutzen (Nur für normale Optionen, keine Kalkulationsfelder): Unter Präfix müssen Sie dann auch "Eigene Formel" auswählen **Folgende Werte stehen Ihnen für die Berechnung zur Verfügung:** | Variable | Erklärung | | ------------- | ------------------------------------------------------------------- | | %a | Ergebnis | | %b | Breite | | %c | Höhe | | %d | Länge | | %bb | Breite 2 | | %bc | Breite 3 | | %cb | Höhe 1 | | %cc | Höhe 2 | | %calcqty | Stückzahl | | %bd | Breite 4 | | %be | Breite 5 | | %bf | Breite 6 | | %bg | Breite 7 | | %bh | Breite 8 | | %bi | Breite 9 | | %cd | Höhe 3 | | %ce | Höhe 4 | | %cf | Höhe 5 | | %cg | Höhe 6 | | %ch | Höhe 7 | | %ci | Höhe 8 | | %optionspreis | Preis der Option | | %ergebnis | Kalkulationsergebnis der Flächenberechnung z.b. 12m2 | | %calcergebnis | Summe des Kalkulationsergebnisses der Flächenberechnung z.b. 12 EUR | | %quantity | Anzahl von Menge (Shopware) | %formel = Dieser Wert muss immer am Anfang stehen inkl. Gleichzeichen und der Formel. \ \ Am Ende immer ein Semikolon. zb. %formel = Ihre Formel; **Beispiel:** Sie möchten bei einem Optionswert definieren dass anhand des Ergebnisses der Flächenberechnung, dieser dann mit dem hinterlegten Optionswertpreis berechnet werden soll Formel = Ergebnis der Flächenberechnung \* Optionswertpreis; **Interne Formel:** ```javascript %formel = %ergebnis * %optionspreis; ```
# Tab Sonstiges Zur Zeit ohne Funktion
# Tab Upload **Erlaubte Dateiendungen:** \ Geben Sie hier die Dateiendungen für den Upload, die Sie erlauben möchten. Diese müssen komma getrennt eingegeben werden z.B. jpg,png,jpeg **min. Dateigröße in Bytes:** Geben Sie die Mindestgröße der hochzuladenden Datei ein **max. Dateigröße in Bytes:** Geben Sie die Maximalgröße der hochzuladenden Datei ein {% hint style="info" %} Die Maximalgröße die ein User hochladen kann, ist auch abhängig von dem eingestellten Wert ([**post\_max\_size**](https://www.php.net/manual/en/ini.core.php#ini.post-max-size) , [**upload\_max\_filesize**](https://www.php.net/manual/en/ini.core.php#ini.upload-max-filesize) ) in Ihrer PHP.ini {% endhint %} Sofern Sie alle Ihre Optionen verknüpft haben, müssen Sie dann die Konfiguration speichern # Matrix Unter Kataloge > Matrix können Sie auch eine Berechnung mittels einer Matrix erstellen.
Die Berechnung nach einer Preismatrix steht ab der Version 1.0.9 zur Verfügung.Beispiel einer Matrix (erste Spalte dient als Höhe, erste Zeile als Breite).Sinn und Zweck dieser Berechnung ist, dass hierbei nicht nach Quadratmeter berechnet wird sondern nach der eingegebenen Breite und Höhe wird der hinterlegte Preis als weitere Berechnungsgrundlage genutzt. Bei dieser Berechnung können daher keine Berechnungen nach Quadratmeter bei den Optionswerten genutzt werden. Auch funktioniert diese Berechnung nur mit den Kalkulationsfeldern Breite und Höhe. Gibt der Kunde bei Höhe 500 und bei Breite 800 ein, wird nach den dementsprechenden Preis gesucht (in diesem Fall wäre dies 168 EUR (grüne Markierung).Berechnungsgrundlage wäre: Suche den Preis bei der die Höhe größer gleich 500 ist und Breite größer gleich 800.\ Beispieldatei finden Sie unter\ \ [**Musterdatei herunterladen (rechtsklick > speichern)**](https://www.pixeleyes.de/sw/muster_xml.zip)
| | 500 | 600 | 700 | 800 | 900 | 1000 | 1250 | 1550 | | ---- | ------- | ------- | ------- | ------- | ------- | ------- | ------- | ------- | | 400 | 104 EUR | 115 EUR | 119 EUR | 130 EUR | 146 EUR | 154 EUR | 162 EUR | 174 EUR | | 500 | 128 EUR | 155 EUR | 141 EUR | 168 EUR | 192 EUR | 197 EUR | 206 EUR | 210 EUR | | 600 | 155 EUR | 176 EUR | 149 EUR | 182 EUR | 202 EUR | 209 EUR | 216 EUR | 226 EUR | | 700 | 141 EUR | 149 EUR | 158 EUR | 186 EUR | 200 EUR | 221 EUR | 231 EUR | 240 EUR | | 800 | 168 EUR | 182 EUR | 186 EUR | 225 EUR | 234 EUR | 243 EUR | 261 EUR | 278 EUR | | 900 | 192 EUR | 202 EUR | 200 EUR | 234 EUR | 268 EUR | 276 EUR | 286 EUR | 292 EUR | | 1000 | 197 EUR | 209 EUR | 221 EUR | 243 EUR | 276 EUR | 282 EUR | 288 EUR | 306 EUR | | 1100 | 200 EUR | 212 EUR | 224 EUR | 245 EUR | 281 EUR | 286 EUR | 291 EUR | 344 EUR | | 1300 | 207 EUR | 218 EUR | 233 EUR | 263 EUR | 288 EUR | 291 EUR | 316 EUR | 395 EUR | | 1400 | 209 EUR | 222 EUR | 236 EUR | 266 EUR | 293 EUR | 305 EUR | 347 EUR | 410 EUR | | 1600 | 214 EUR | 234 EUR | 244 EUR | 284 EUR | 297 EUR | 312 EUR | 390 EUR | 461 EUR | | 1700 | 250 EUR | 272 EUR | 290 EUR | 293 EUR | 308 EUR | 323 EUR | 402 EUR | 476 EUR | | 1800 | 257 EUR | 280 EUR | 299 EUR | 344 EUR | 360 EUR | 375 EUR | 432 EUR | 513 EUR | | 1900 | 274 EUR | 296 EUR | 308 EUR | 365 EUR | 383 EUR | 400 EUR | 446 EUR | 527 EUR | | 2000 | 281 EUR | 304 EUR | 317 EUR | 375 EUR | 393 EUR | 412 EUR | 458 EUR | 542 EUR | # Matrix erstellen Um eine neue Matrix zu erstellen, müssen Sie unter Kataloge > Matrix auf erstellen / Create klicken. Es öffnet sich ein neues Fenster.
### Matrix - Detailseite Im neuen Fenster können Sie dann nach dem Vergeben eines Titels und Speichern der Matrix, ein sogenanntes Excel Arbeitsblatt im XML Format hochladen.\ \
### Manuelles Bearbeiten der Matrixwerte Sofern Sie die gespeicherten Einträge manuell bearbeiten wollen, müssen SIe in der Liste der gespeicherten Matrixe, rechts auf Werte bearbeiten klicken. ### Matrixwerte Die Werte der Matrix können Sie in der Liste dann manuell bearbeiten (Breite, Höhe und Preis)
### Matrixzuweisung > Konfiguration Um eine Matrix mit einem Artikel zu verknüpfen müssen Sie die Konfiguration bei der Sie die matrix zuweisen möchten öffnen/bearbeiten.\ \ Es müssen eine Option (Kalkulation / Berechnung) sowie zwei Optionswerte (Breite und Höhe) mit Parameter Breite und Höhe (verknüpfte Optionen) erstellt werden! 1\. Wählen Sie unter Art der Berechnung, „Berechnung über die Matrix“ aus.\ Formel muss auf %a = %b \* %c; eingestellt sein. 2\. Aktivieren Sie unter dem Tab Einstellungen die „Matrixberechnung“.
### Einstellungen **Matrixberechnung aktivieren:** Aktiviert die Matrixberechnung **Aktivieren der Formel:** Aktivieren der Formelberechnung Formel: Einstellen der Formel (unbedingt erforderlich!) Folgende Werte stehen Ihnen zur Verfügung: %matrixwidth = Breite (dieser Wert wird anhand der Preismatrix übernommen) %matrixheight = Höhe (dieser Wert wird anhand der Preismatrix übernommen) %matrixformel = Ergebnis Die Struktur muss folgendermaßen sein: %matrixformel = (%matrixwidth \* %matrixheight); *** **Beispiel 1:** Kunde gibt Breite = 2 , Höhe = 1 gefundene Daten in der Matrix: \ Breite : 2m Höhe: 1m Preis: 10 EUR Berechnungseinheit der Kalkulationsfelder = m Berechnungseinheit Gesamt = m²
Berechnen der Breite x Höhe (Werte liegen in m vor) %matrixformel = (%matrixwidth \* %matrixheight) Ergebnis = 2 x 1 = 2m² Der Preis (10EUR) wird dann durch das Ergebnis dividiert errechneter Preis: 10 / 2 = 5 EUR *** **Beispiel 2:** Kunde gibt Breite = 2000 , Höhe = 1800
gefundene Daten in der Matrix:
Breite : 2000mm Höhe: 1800mm Preis: 32,40 EUR
Berechnungseinheit der Kalkulationsfelder = mm Berechnungseinheit Gesamt = m2 (bzw. das Ergebnis soll in m2 angezeigt werden) *** **Beispiel 3:**\ \ Berechnen der Breite x Höhe (Werte liegen in mm vor) und umwandeln in m (daher dividiert durch 1000000) %matrixformel = (%matrixwidth \* %matrixheight) / 1000000;
Ergebnis = 2000 x 1800 / 1000000 = 3,6m² Der Preis (10EUR) wird dann durch das Ergebnis dividiert
errechneter Preis: 32,40 / 3,6 = 9 EUR # Email Templates Um die Konfiguration auch in der Email anzeigen zu lassen, müssen Sie untenstehenden Code (HTML TEXT) im Email-Template "Bestellbestätigung unter Mail Text > HTML Text hinzufügen

Laden Sie folgendes Email Template herunter , entpacken Sie die Zip Datei.\ Mit dem Code unter Mailtext > HTML Text ersetzen (Vorher Sicherung durchführen des vorhandenen Codes)\ \ Die Zip Datei enthält zwei Dateien:\ \ **bestellbestatigung.twig:**\ \ Hier ist der komplette Code des "bestellbestätigung" Email Templates {% hint style="warning" %} Vorher den vorhandenen Code sichern!! {% endhint %} 
  <div style="font-family:arial; font-size:12px;">

    {% set currencyIsoCode = order.currency.isoCode %}

    Hallo {% if order.orderCustomer.salutation %}{{ order.orderCustomer.salutation.translated.letterName ~ ' ' }}{% endif %}{{ order.orderCustomer.firstName }} {{ order.orderCustomer.lastName }},<br>
    <br>
    Ihre Bestellung ist am {{ order.orderDateTime|format_datetime('medium', 'short', locale='de-DE') }} bei uns eingegangen.<br>
    <br>
    Bestellnummer: {{ order.orderNumber }}<br>
    <br>
    Sobald ein Zahlungseingang erfolgt ist, erhalten Sie eine separate Benachrichtigung und Ihre Bestellung wird verarbeitet.<br>
    <br>
    Den aktuellen Status Ihrer Bestellung können Sie jederzeit über diesen Link abrufen: {{ rawUrl('frontend.account.order.single.page', { 'deepLinkCode': order.deepLinkCode }, salesChannel.domains|first.url) }}<br>
    Über diesen Link können Sie auch die Bestellung bearbeiten, die Zahlungsart wechseln oder nachträglich eine Zahlung durchführen.<br>
    <br>
    <strong>Informationen zu Ihrer Bestellung:</strong><br>
    <br>

    <table border="0" style="font-family:Arial, Helvetica, sans-serif; font-size:12px;">
        <tr>
            <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Produkt-Nr.</strong></td>
            <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Produktbild</strong></td>
            <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Bezeichnung</strong></td>
            <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Menge</strong></td>
            <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Preis</strong></td>
            <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Summe</strong></td>
        </tr>

        {% for lineItem in order.nestedLineItems %}
            {% set nestingLevel = 0 %}
            {% set nestedItem = lineItem %}
            {% block lineItem %}
                <tr>
                    <td>{% if nestedItem.payload.productNumber is defined %}{{ nestedItem.payload.productNumber|u.wordwrap(80) }}{% endif %}</td>
                    <td>{% if nestedItem.cover is defined and nestedItem.cover is not null %}<img src="{{ nestedItem.cover.url }}" width="75" height="auto"/>{% endif %}</td>
                    <td>
                        {% if nestingLevel > 0 %}
                            {% for i in 1..nestingLevel %}
                                <span style="position: relative;">
                                <span style="display: inline-block;
                                        position: absolute;
                                        width: 6px;
                                        height: 20px;
                                        top: 0;
                                        border-left:  2px solid rgba(0, 0, 0, 0.15);
                                        margin-left: {{ i * 10 }}px;"></span>
                            </span>
                            {% endfor %}
                        {% endif %}

                        <div{% if nestingLevel > 0 %} style="padding-left: {{ (nestingLevel + 1) * 10 }}px"{% endif %}>
                            {{ nestedItem.label|u.wordwrap(80) }}
                        </div>

                        {% if nestedItem.payload.options is defined and nestedItem.payload.options|length >= 1 %}
                            <div>
                                {% for option in nestedItem.payload.options %}
                                    {{ option.group }}: {{ option.option }}
                                    {% if nestedItem.payload.options|last != option %}
                                        {{ " | " }}
                                    {% endif %}
                                {% endfor %}
                            </div>
                        {% endif %}

                        {# AREA CALCULATOR START #}
                        {% if nestedItem.payload.pixelAreaHash is defined %}
                            {% if nestedItem.payload.pixelAreaHash %}
                                <br>

                                {% if nestedItem.payload.pixAreaOptionsData is defined %}
                                    {% if nestedItem.payload.pixAreaOptionsData %}
                                        <ul class="pixelmulti-checkout-itemlist">
                                            {% set pixelOrderItem = nestedItem.payload.pixAreaOptionsData %}
                                            {% if nestedItem.payload.pixAreaOptionsData.calc is defined and nestedItem.payload.pixAreaOptionsData.calc|length >= 1 %}
                                                {% if nestedItem.payload.pixAreaOptionsData.calc %}

                                                    {% for item in pixelOrderItem.calc %}



                                                        {% if item.CALCULATED is defined %}
                                                            {% if item.SHOWTOTALQM %}
                                                                <li class="pixelmulti-checkout-item-total"><b>Gesamt (m²):</b> {{ item.optionvalue }} {{ item.suffix }}</li>
                                                            {% endif %}
                                                            {% if item.SHOWTOTALPRICE %}
                                                                {% if item.price %}<li class="pixelmulti-checkout-item-totalprice"><b>Gesamtpreis (m²) :</b>  {{ item.price|currency(currencyIsoCode) }}</li>
                                                                {% endif %}
                                                            {% endif %}
                                                            {% if item.SHOWTOTALWEIGHT %}
                                                                {% if item.weight %}
                                                                    <li class="pixelmulti-checkout-item-totalweight"><b>Gewicht:</b>  {{ item.weight }}kg</li>
                                                                {% endif %}
                                                            {% endif %}
                                                        {% else %}
                                                            <li class="pixelmulti-checkout-item-{{ item.calcfield }}"><b>{{ item.optionlabel }}:</b> {{ item.optionvalue }} {{ item.suffix }}</li>
                                                        {% endif %}
                                                    {% endfor %}

                                                {% endif %}
                                            {% endif %}
                                            {% if nestedItem.payload.pixAreaOptionsData.options is defined %}
                                                {% if nestedItem.payload.pixAreaOptionsData.options %}



                                                    {% for item in pixelOrderItem.options|sort %}
                                                        <li class="pixelmulti-checkout-item-option"><b>{{ item.optionlabel }}:</b> {{ item.optionvalue }}{% if item.field == 'numberfield' %} {{ item.numericprefix }} , {% endif %} {% if item.itemspriceactive  is defined   %} {% if item.itemspriceactive  %}{% if item.priceactive %}{% if item.price %}<span class="pixel-multi-checkout-item-price">{{ item.price|currency(currencyIsoCode) }}</span> {% endif %}{% endif %}{% endif %}{% endif %}</li>
                                                        {% if item.uploadfile %}
                                                            <li><a href="{{ item.uploadfile }}" target="_blank" />Upload, {{ item.uploadfiletype }}</a></li>
                                                        {% endif %}
                                                    {% endfor %}

                                                {% endif %}
                                            {% endif %}
                                        </ul>
                                    {% endif %}
                                {% endif %}

                            {% endif %}
                        {% endif %}

                        {# AREA CALCULATOR END #}

                        {% if nestedItem.payload.features is defined and nestedItem.payload.features|length >= 1 %}
                            {% set referencePriceFeatures = nestedItem.payload.features|filter(feature => feature.type == 'referencePrice') %}
                            {% if referencePriceFeatures|length >= 1 %}
                                {% set referencePriceFeature = referencePriceFeatures|first %}
                                <div>
                                    {{ referencePriceFeature.value.purchaseUnit }} {{ referencePriceFeature.value.unitName }}
                                    ({{ referencePriceFeature.value.price|currency(currencyIsoCode) }}* / {{ referencePriceFeature.value.referenceUnit }} {{ referencePriceFeature.value.unitName }})
                                </div>
                            {% endif %}
                        {% endif %}
                    </td>
                    <td style="text-align: center">{{ nestedItem.quantity }}</td>
                    <td>{{ nestedItem.unitPrice|currency(currencyIsoCode) }}</td>
                    <td>{{ nestedItem.totalPrice|currency(currencyIsoCode) }}</td>
                </tr>

                {% if nestedItem.children.count > 0 %}
                    {% set nestingLevel = nestingLevel + 1 %}
                    {% for lineItem in nestedItem.children %}
                        {% set nestedItem = lineItem %}
                        {{ block('lineItem') }}
                    {% endfor %}
                {% endif %}
            {% endblock %}
        {% endfor %}
    </table>

    {% set delivery = order.deliveries.first %}

    {% set displayRounded = order.totalRounding.interval != 0.01 or order.totalRounding.decimals != order.itemRounding.decimals %}
    {% set decimals = order.totalRounding.decimals %}
    {% set total = order.price.totalPrice %}
    {% if displayRounded %}
        {% set total = order.price.rawTotal %}
        {% set decimals = order.itemRounding.decimals %}
    {% endif %}
    <p>
        <br>
        <br>
        {% for shippingCost in order.deliveries %}
            Versandkosten: {{ shippingCost.shippingCosts.totalPrice|currency(currencyIsoCode) }}<br>
        {% endfor %}
        Gesamtkosten Netto: {{ order.amountNet|currency(currencyIsoCode) }}<br>
        {% for calculatedTax in order.price.calculatedTaxes %}
            {% if order.taxStatus is same as('net') %}zzgl.{% else %}inkl.{% endif %} {{ calculatedTax.taxRate }}% MwSt. {{ calculatedTax.tax|currency(currencyIsoCode) }}<br>
        {% endfor %}
        {% if not displayRounded %}<strong>{% endif %}Gesamtkosten Brutto: {{ total|currency(currencyIsoCode,decimals=decimals) }}{% if not displayRounded %}</strong>{% endif %}<br>
        {% if displayRounded %}
            <strong>Gesamtkosten Brutto gerundet: {{ order.price.totalPrice|currency(currencyIsoCode,decimals=order.totalRounding.decimals) }}</strong><br>
        {% endif %}
        <br>

        {% if delivery %}
            <strong>Gewählte Versandart:</strong> {{ delivery.shippingMethod.translated.name }}<br>
            {{ delivery.shippingMethod.translated.description }}<br>
            <br>
        {% endif %}

        {% set billingAddress = order.addresses.get(order.billingAddressId) %}
        <strong>Rechnungsadresse:</strong><br>
        {{ billingAddress.company }}<br>
        {{ billingAddress.firstName }} {{ billingAddress.lastName }}<br>
        {{ billingAddress.street }} <br>
        {{ billingAddress.zipcode }} {{ billingAddress.city }}<br>
        {{ billingAddress.country.translated.name }}<br>
        <br>

        {% if delivery %}
            <strong>Lieferadresse:</strong><br>
            {{ delivery.shippingOrderAddress.company }}<br>
            {{ delivery.shippingOrderAddress.firstName }} {{ delivery.shippingOrderAddress.lastName }}<br>
            {{ delivery.shippingOrderAddress.street }} <br>
            {{ delivery.shippingOrderAddress.zipcode}} {{ delivery.shippingOrderAddress.city }}<br>
            {{ delivery.shippingOrderAddress.country.translated.name }}<br>
            <br>
        {% endif %}
        {% if order.orderCustomer.vatIds %}
            Ihre Umsatzsteuer-ID: {{ order.orderCustomer.vatIds|first }}
            Bei erfolgreicher Prüfung und sofern Sie aus dem EU-Ausland
            bestellen, erhalten Sie Ihre Ware umsatzsteuerbefreit. <br>
        {% endif %}
        <br/>
        Den aktuellen Status Ihrer Bestellung können Sie auch jederzeit auf unserer Webseite im  Bereich "Mein Konto" - "Meine Bestellungen" abrufen: {{ rawUrl('frontend.account.order.single.page', { 'deepLinkCode': order.deepLinkCode }, salesChannel.domains|first.url) }}
        </br>
        Für Rückfragen stehen wir Ihnen jederzeit gerne zur Verfügung.
    </p>
    <br>
</div>
\ \ \ Hier können Sie auch eine Zip-Datei herunterladen.\ Darin sind zwei Dateien enthalten:\ \ 1\. email.html.twig\ \ Darin ist der komplette Code ( HTML ) enthalten\ \ 2\. email\_code\_only.html.twig\ \ Darin ist nur der Code ( HTML ) vom Plugin enthalten.\ \ Nach: ```twig {% if nestedItem.payload.options is defined and nestedItem.payload.options|length >= 1 %}
{% for option in nestedItem.payload.options %} {{ option.group }}: {{ option.option }} {% if nestedItem.payload.options|last != option %} {{ " | " }} {% endif %} {% endfor %}
{% endif %} ``` den Code von email\_code\_only.html.twig einfügen.\ \ [Download Email Template](https://www.pixeleyes.de/sw/email_code.zip) {% hint style="warning" %} Auch hier: Vorher den zu überschreibenden Code sichern!! {% endhint %}
# Import und Export Profile Das Plugin erstellt bei der Installation auch Import und Export Profile für
1. Optionen 2. Optionswerte 3. Konfigurationen 4. Verknüpfte Optionen 5. Qm Staffeln 6. Optionswertstaffeln Wichtige Info: Der Import muss nach der oben stehenden Reihenfolge erfolgen!\
### Optionen | Definition | Erklärung | # | | ----------- | ---------------------------------- | ------- | | id | ID | string | | active | Aktiv | boolean | | position | Position | integer | | formfield | Formularfeld | string | | infoactive | Informationen aktiv | boolean | | isletter | Letter Funktion | boolean | | isplates | Plattenberechnungsfunktion | boolean | | validate | Feld validieren | boolean | | gridmobile | Anzahl Spalten (Mobile Auflösung) | integer | | gridtablet | Anzahl Spalten (Tablet Auflösung) | integer | | griddesktop | Anzahl Spalten (Desktop Auflösung) | integer | | name | Name | string | | description | Beschreibung | string | | createdAt | Erstellt am | | ### Optionswerte | Definition | Erklärung | # | | ----------- | ------------- | ------- | | id | ID | String | | optionsid | ID der Option | String | | active | Aktiv | Boolean | | position | Position | Integer | | name | Name | String | | description | Beschreibung | String | | createdAt | Erstellt am | | ### Konfigurationen | Definition | Erklärung | | ------------------- | ------------------------------------------------------------------------------------------------ | | id | ID | | active | Aktiv | | position | Position | | nformat | Anzahl der Dezimalstellen | | mincalcart | Art der Mindestwertberechnung | | qmSuffix | Anzahl der Dezimalstellen bei Qm Staffeln | | cmformat | Anzahl der Dezimalstellen beim Ergebnis | | calcprice | Kalkulationspreis | | mincalcprice | Mindest-Kalkulationspreis/Aufschlag | | specialPrice | Spezieller Aufschlag | | minwert | Mindestwert | | materialMax | Maximaler Gurtmassaufpreis | | materialMaxprice | Maximaler Gurtmass | | matrixcalcprice | Aufschlag | | matrixwert | Matrix Aufschlag | | calculation | Formel fuer die Berechnung | | calctype | Berechnungeinheit (Gesamt) | | name | Name der Konfiguration | | description | Beschreibung der Konfiguration | | staffelStatus | Berechnungsart bei den Optionsstaffeln | | mincalcart | Art der Mindestwertberechnung | | materialCalcmodus | Berechnungsart bei den Gurtmass | | matrixFormula | Matrix Formel | | qmshow | Quadratmeter im Warenkorb anzeigen | | allowZero | 0 EUR Fix Aktivieren | | matrixStatus | Matrixberechnung aktivieren | | matrixformulaActive | Aktivieren der Matrix Formel | | spActive | Speziellen Aufschlag aktivieren | | staffelActive | Optionsstaffelberechnung aktivieren | | anfrageActivate | not available | | calcart | Art der Flaechenerechnung | | lengthmodus | Spezielle Laengenberechnung aktivieren, nur im Zusammenhang mit dem Freitextfeld | | showWeight | Gesamtgewicht anzeigen | | calcWeight | Gewicht kalkulieren | | minwertstatus | Mindestwertberechnung aktivieren | | staffelqty | Menge bei den Staffeln beruecksichtigen | | cfg | Not available | | afc | Kalkulation mit Artikelpreis | | staffelShow | Optionsstaffeln unterhalb anzeigen | | weightCalc | Berechnung des Optionsgewichts | | materialModus | Gurtmassberechnung aktivieren (BETA) | | formMatrix | Anzeigen der Pseudogrundpreisberechnung | | matrixwertstatus | Mindestwert aktivieren | | matrixqmstatus | Matrix Quadratmeterberechnung aktivieren | | configurator | Konfigurator Funktion | | createdAt | Erstellt am | | checktotalqm | Anzeige der Gesamtfläche im Checkout | | checktotalprice | Anzeige des Berechnungspreises im Checkout | | checktotalweight | Anzeige des Gesamtgewichts im Checkout | | callitajax | Berechnung per Ajax ( Nicht bei Matrix oder wenn Sie Imageselect Optionen nutzen, deaktivieren!) | | showdetailqm | Anzeigen der Qm-Berechnung | | showdetailbottom | Anzeigen der Gesamtsumme, Zwischensumme unten | | showdetailinfo | Anzeigen der Zusammenfassung | | stickyshow | Aktiviert das Mitscrollen bei der Zusammenfassung | | calcmaxvalue | Aktivieren zum Überprüfen des Wertes | | maxofvalue | Wert der berechnet werden muss | | calcmaxprefix | Einheit des Wertes (mm,cm,m..) | | calcmaxvalueart | Prüfen des eingegebenen Wertes | | calcinputs | Kalkulationsfeld | ### Verknüpfte Optionen
| Definition | Erklärung | # | | ------------------- | -------------------------------------------------------------- | - | | id | ID | | | optionsName | Optionsname | | | optionsid | Options ID | | | valuesLabel | Optionswert | | | valuesDescription | Optionswert Beschreibung | | | valuesField | Formularfeld | | | valuesPrice | Aufpreis | | | valuesPricePrefix | Preis Prefix | | | valuesMaxwidth | Max. Breite | | | valuesMaxheight | Max. Höhe | | | valuesMaxlength | Max. Länge | | | sWidth | Breite (Startwert) | | | sHeight | Höhe (Startwert) | | | sLength | Länge (Startwert) | | | valuesMinwidth | Min. Breite | | | valuesMinheight | Min. Höhe | | | valuesMinlength | Min. Länge | | | valuesMincalcqty | Min. Stkzahl | | | valuesMaxcalcqty | Max. Stkzahl | | | valuesQvalue | Not Available | | | valuesMvalue | Berechnungseinheit | | | valuesPriceCalc | Not Available | | | valuesCalcParameter | Parameter | | | valuesExtensions | Erlaubte Dateiendungen | | | valuesPreselected | Vorselektiert | | | position | Position | | | optionOrder | Not Available | | | active | Aktiv | | | valuesFixed | Fixer Wert | | | valuesCalcqty | Stk-Zahl berechnen | | | valuesLetterselect | Not Available | | | valuesLetternoempty | Not Available | | | valuesStepwise | Stepwise Aktivieren | | | valuesStepvalue | Stepwise-Wert | | | valuesWeight | Gewicht | | | sac | Anzeigen im Checkout | | | canvasfactor | Faktor | | | canvasfield | Wert des Faktors | | | weightCalc | Eigene Gewichtsformel | | | fromcanvas | Kalkulationsfeld | | | calc | Eigene Formel nutzen | | | calctext | Eigene Formel | | | notload | Not available | | | prefixtext | Präfixtext für Formel | | | pricesactive | Preise anzeigen | | | unvisible | Verstecken des Fixen Werts | | | onumber | Interne SKU | | | porp | Porpotional | | | porpval | Porpotional | | | porpParameter | Zuordnung | | | valuesStepart | Stepwise Art (Ganzzahlen, Dezimal) | | | weightcalctext | Not available | | | configuratorId | ID der Konfiguration | | | pixOptionsItemsId | Generierte ID der Zeile | | | createdAt | Erstellt am | | | textmaxsize | Maximale Anzahl der Zeichen | | | allowcalcmax | Optionswert bei der Prüfung des eingegebenen Werts einbeziehen | | | platesWidth | Plattenbreite | | | platesMinwidth | Platten-Mindest-Breite | | | platesMaxwidth | Platten-Maximal-Breite | | | uploadminsize | min. Dateigröße in Bytes | | | uploadmaxsize | max. Dateigröße in Bytes | | ### Export der Daten für Shopware 6 vom Shopware 5 Plugin "Flächenberechnung mit individuellen Optionen" {% hint style="info" %} Sytemvoraussetzungen:
Aktuell installierte Version des Plugins (min 3.1.3) Aktuelle Version von Shopware min. 5.7.16 {% endhint %} {% hint style="warning" %} **Wichtige Info:**\ \ Nicht alle Daten des Shopware 5 Plugins, können in das neue Plugin für Shopware 6 importiert werden können.\ Bei Shopware 6 handelt es sich um eine Neuntwicklung, genauso so wie bei unseren Plugin "**Flächenberechnung für Shopware 6**". {% endhint %} 1. Erstellen Sie einen Ordner **pixelmulti\_import\_export** im Ordner media ihrer Shopware 5 Installation 2. Melden Sie sich im Backend an 3. Führen Sie dann folgende Urls aus, in der unten stehenden Reihenfolge #### Exportiert die Optionen \ URL: #### Exportiert die Optionswerte \ URL: #### Exportiert die Konfiguration der Artikel \ URL: #### Exportiert die verknüpften Optionswerte \ URL: #### Exportiert die verknüpften Optionswerte \ URL: {% hint style="danger" %} **Das Importieren der Staffeln ist Beta** Da es sich bei Shopware 6 um ein Neuentwickeltes System handelt, können die Staffelpreise sowie die Quadratmeter Preise nicht ohne weiteres importiert werden. Zumindest die Zuordnung anhand der Kundengruppen ist nicht gegeben. {% endhint %} #### Exportiert die Staffeln der verknüpften Optionswerte {% hint style="danger" %} nur für eine Kundengruppe, da es in Shopware 6 diese Funktionalität nicht mehr gibt {% endhint %} URL: **folgende Requestparameter können am Ende noch hinzugefügt werden:** customerGroupKey = Kundengruppe von Shopware 5 (EK, H..) beliebig = Beliebig steht in Shopware 5 bei den Staffeln immer für unendlich z.B. 0 bis Beliebig. {% hint style="danger" %} "Beliebig" gibt es in Shopware 6 nicht mehr (technisch bedingt) bei den Staffelpreisen des Plugins. Daher muss hierbei ein numerischer Wert eingestellt sein für die Staffelpreise.\ \ Beispiel:\ \ Shopware 5: ![](https://2061240942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2bDXNnc5DRWPvagpuhf1%2Fuploads%2FtU2DOq2FDFbBUA6Ox3sz%2Fimage.png?alt=media\&token=67033a51-53b6-4db5-9431-47c1ba295167)\ \ 1-1000\ 1001-2000\ 2001-Beliebig\ \ Shopware 6: ![](https://2061240942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2bDXNnc5DRWPvagpuhf1%2Fuploads%2FqxA7wRI3zBiqG42rUgxw%2Fimage.png?alt=media\&token=2f65d269-5704-4184-8ba3-748796f55bf0)\ \ 1-1000\ 1001-2000\ 2001-10000\ ... {% endhint %} Beispiel : #### Exportiert die Qm Staffeln der Konfiguration {% hint style="danger" %} (nur für eine Kundengruppe, da es in Shopware 6 diese Funktionalität nicht mehr gibt) {% endhint %} URL: **folgende Request parameter können am Ende noch hinzugefügt werden:** customerGroupKey = Kundengruppe von Shopware 5 (EK, H..) beliebig = Beliebig steht in Shopware 5 bei den Staffeln immer für unendlich z.B. 0 bis Beliebig. {% hint style="danger" %} "Beliebig" gibt es in Shopware 6 nicht mehr (technisch bedingt) bei den Staffelpreisen des Plugins. Daher muss hierbei ein numerischer Wert eingestellt sein für die Staffelpreise.\ \ Beispiel:\ \ Shopware 5:\ \ 1-1000\ 1001-2000\ 2001-Beliebig\ \ \ \ Shopware 6: \ \ 1-1000\ 1001-2000\ 2001-10000\ ... {% endhint %} Beispiel : Im Ordner **pixelmulti\_import\_export** finden Sie dann die exportierten Dateien, die Sie mit den jeweiligen Profilen des Plugins in Shopware 6 importieren können. Gehen Sie bei dem Import nach der obengenannten Reihenfolge (Punkt 3) vor. # Erstellen einer Konfiguration #### **1. Erstellen der Konfiguration** Setzen Sie einen Haken bei „Aktivieren“.\ Geben Sie den Kalkulationspreis ein z.B. 10.00 EUR (Netto), mit dem die berechnete Formel multipliziert wird werden soll.\ \ (Breite \* Höhe) \* 10 EUR (Preis für Berechnung) Wählen Sie die Berechnungseinheit, die beim Gesamtergebnis angezeigt soll ein (m², cm² oder mm²).\ \ Geben Sie die Formel für die Berechnung ein. Da wir Breite und Höhe berechnen möchten, wäre dies folgende Formel: ```javascript %a = %b * %c; ``` \ Geben Sie einen Titel ein z.B. "Fläche berechnen" Speichern Sie jetzt die Konfiguration "Fläche berechnen". Jetzt gilt es die Optionsgruppen und Werte für den Artikel zu erstellen.
**Berechnung per Ajax** sollte generell nicht aktiviert sein, ausser bei Benutzung der Matrix sowie Imageselect Feldern. Achten Sie auch darauf dass in der Plugineinstellungen unter "Art des requests" auf via Konfiguration eingestellt ist. \ \ Für die weiteren Einstellungen der Screens, können Sie sich im Handbuch unter Konfiguration informieren
#### **2. Erstellen der Option für die Berechnung** Klicken Sie dazu links im Menu unter Kataloge > Flächenberechnung > Optionen\ \ In der Übersicht der Optionsgruppen klicken Sie oberhalb auf den Button „Erstellen“. 1.Wählen Sie hier im Feld den Eintrag „Berechnung“. 2\. Setzen Sie ein Häkchen bei Aktiv 3\. Geben Sie einen Namen für diese Gruppe ein z.B. „Berechnung „ 4\. Speichern Sie die Option #### **3. Erstellen der Optionswerte für die Option** Wenn Sie die Option gespeichert haben, sehen Sie diese in der Übersicht\ Klicken Sie dazu links im Menu unter Kataloge > Flächenberechnung > Optionswerte\ 1\. In der Übersicht klicken Sie auf „Erstellen“. 2\. Geben Sie jetzt beim Namen „Breite“ ein und setzen ein Häkchen bei Aktiv 3\. Wählen Sie bei Zugewiesene Option dann die davor erstellte Option "Berechnung" 4\. Speichern Sie den Eintrag 5\. Erstellen Sie dann einen Zweiten Eintrag mit dem Namen „Höhe“. Nehmen Sie die gleichen Einstellungen vor wie bei Breite. 6\. In der Übersicht finden Sie jetzt die Beiden Optionswerte „Breite“ und „Höhe“.
#### **4. Verknüpfen der erstellten Optionsgruppen und Werte in der Konfiguration "Fläche berechnen"** Die erstellten Optionsgruppen und Werte müssen jetzt mit dem erstellten Konfiguration "Fläche berechnen" verknüpft werden um zusätzliche Einstellungen vorzunehmen. Gehen Sie dazu, zu Katalog > Flächenberechnung > Konfiguration > "Fläche berechnen" und klicken Sie dann auf den Karteireiter „Verknüpfte Optionen“. \ \ Klicken Sie auf "Optionen hinzufügen".\ \ Es öffnet sich ein neues Fenster. **Einstellungen Tab Standard:**\ \ Wählen Sie unter "Bitte wählen Sie einen Optionswert aus" erst die Breite aus. Sie können in diesem Feld "Breite" eingeben, automatisch wird dann der davor erstellte Optionswert "Breite" angezeigt. \ Klicken Sie auf "Aktivieren"\ \ **Einstellungen Tab Konfiguration:**
Aktivieren Sie die Anzeige "Anzeigen im Checkout". Einstellungen Tab Kalkulation:\ \ Wählen Sie unter Parameter "Breite" aus.\ Geben Sie ihre gewünschten Werte bei maximale Breite , minimale Breite und Startwert Breite ein.\ Geben Sie bei Berechnungseinheit ihre gewünschte Masseinheit ein z.b. cm, m, mm etc. Klicken Sie dann auf Speichern.
Gehen Sie gleichermaßen auch beim Optionswert "Höhe" vor. Klicken Sie auf "Optionen hinzufügen". Es öffnet sich ein neues Fenster. **Einstellungen Tab Standard:** Wählen Sie unter "Bitte wählen Sie einen Optionswert aus" die Höhe aus. Sie können in diesem Feld "Höhe" eingeben, automatisch wird dann der davor erstellte Optionswert "Höhe" angezeigt. Klicken Sie auf "Aktivieren" **Einstellungen Tab Konfiguration:** Aktivieren Sie die Anzeige "Anzeigen im Checkout". **Einstellungen Tab Kalkulation:** Wählen Sie unter Parameter "Höhe" aus. Geben Sie ihre gewünschten Werte bei maximale Höhe , minimale Höhe und StartwertHöhe ein. Geben Sie bei Berechnungseinheit ihre gewünschte Masseinheit ein z.b. cm, m, mm etc. Klicken Sie dann auf Speichern.
Speichern Sie dann die Konfiguration dann sicherheitshalber ab.
**Verknüpfen der Konfiguration mit dem Artikel:** Öffnen Sie das Produkt mit dem Sie die Konfiguration verknüpfen möchten. Gehen Sie zu Spezifikationen > Flächenberechnung und wählen Sie dann die davor erstellte Konfiguration "Fläche berechnen" aus. Gegebenfalls wählen Sie beim Layout des Artikels dann dann "Standard-Produktseite-Layout" aus. Leeren Sie dann sicherheitshalber noch den Cache . # FAQ Häufig gestellte Fragen (FAQ)
Es fehlt eine wichtige Funktion Sinnvolle Verbesserungsvorschläge werden in der Regel umgesetzt, soweit es möglich ist
Können Warenkorb Rabatte angewendet / genutzt werden? Nein, das Plugin unterstützt keine Warenkorb Rabatte, da Shopware 6 die Preise des eigentlichen Produkts für die Berechnung nutzt, anstatt mit dem Gesamtbetrag
Können Sie mir eine gewünschte Konfiguration erstellen? Auf Wunsch können wir eine Konfiguration gerne erstellen. Haben Sie aber dafür Verständnis dass diese kostenpflichtig ist.
Kann das Layout des Plugins angepasst werden? CSS können Sie mittels des Plugins "Custom CSS / JS" anpassen.
Welche Rabatte können eingesetzt werden Nur Rabatt auf den gesamten Warenkorb! \ Keine produktspeifischen Rabatte!
Kann man ein Angebot einen Kunden zusenden? Ab der Version 2.0.9 kann eine Angebotsfunktion aktiviert werden
Welche Artikel werden unterstützt Normale Artikel werden unterstützt. Artikel mit Cross Selling Artikel aber nicht
Beim Hinzufügen eines Artikels in den Warenkorb wird zum OffCanvas weitergeleitet Das geschieht eventuell, weil output\_buffering nicht aktiviert ist.\ Normalerweise ist output\_buffering konfiguriert und aktiviert ( Einstellung in der PHP.ini als Beispiel: output\_buffering="4096". Fragen Sie eventuell Ihren Provider diese Einstellung vorzunehmen. \ \ Ansonsten muss hier die Einstellung aktiviert werden. \ Ob die Einstellung bei Ihnen funktioniert, können wir nicht gewährleisten
Diverse Anpassungen beim Select Field Höhe des Dropdowns anpassen ``` // Anpassen der Höhe hier auf 300px .pixelareaoptionen--box .ddcommon ul { max-height: 300px; overflow: scroll; } // ANpassen der Bilderbreite hier auf 77px .pixelareaoptionen--box .ddcommon .ddChild li img { border: 0 none; position: relative; vertical-align: middle; float: left; max-width: 77px; } ```
# Lexikon / Glossar für Shopware 6 ### Beschreibung Mit Hilfe dieses Plugins, können Sie Ihren Kunden die Möglichkeit geben, Fachbegriffe die Sie im Backend eingepflegt haben, über eine separate Seite zu erklären. Darüber hinaus haben Sie auch die Möglichkeit unter den Plugineinstellungen einzustellen, ob Akronyme generiert werden für Artikelbeschreibungen, Eigenschaften. \ **Beispiel von generierten Akronymen in der Artikelbeschreibung:**\ \ **Demo:** [**http://dev1.pixeleyes.de/Hauptprodukt-mit-Eigenschaften/SWDEMO10007.1**](https://dev1.pixeleyes.de/Hauptprodukt-mit-Eigenschaften/SWDEMO10007.1) {% hint style="warning" %} **Wichtige Info:**\ \ Sofern Sie die Funktion zum generieren der Akronyme für Kategoriebeschreibungen, Artikelbeschreibungen, Inhaltsbeschreibungen\ aktivieren, kann sich dies bei sehr vielen eingetragenen Lexikoneinträgen negativ auf die Perfomance auswirken.\ \ Es empfiehlt sich immer der Einsatz von reinen Textbeschreibungen, da das Plugin bei jedem Vorkommen eines Lexikoneintrags diese ersetzt (z.b. alt-, title-tags von eingefügten Links und Bildern) {% endhint %} {% hint style="info" %} **Wichtiger Hinweis:** \ \ Wir entwickeln ausschliesslich auf Basis einer Standardinstallation von Shopware. Sofern Sie Plugins von Fremdanbieter (darunter fallen auch Shopware Premium Plugins) in Ihrem Shop einsetzen, empfehlen wir Ihnen unsere Plugins vor dem Erwerb ausgiebig zu testen, um auch zu prüfen ob eventuell Konflikte unter den eingesetzten Plugins auftreten . Dazu bieten wir Testlizenzen an, die Sie im Shopware Store herunterladen können. {% endhint %} # Funktionsbeschreibung ### Produktinformationen ### Highlights * Einfügen eines Beschreibungstexts oder einer Erlebniswelt (Shopseite), für die Startseite des Lexikon Plugins * Einfügen einer SEO Url bei jedem Eintrag möglich * Ändern der SEO Urls unter Einstellungen Shop > SEO * Einstellen der Verlinkung der Einträge auf der Artikelbeschreibung (Popup/Modal oder Link) * Bilder Einpflegen je Lexikon Artikel * Zusätzliche Artikel je Lexikoneintrag * Sitemap Generierung der Lexikoneinträge ### Features * Schnelle Anzeige der Einträge mittels Popup oder Link (neue Seite) * Kategorien (A,B,C,D...) der Lexikoneinträge erweiterbar * SEO Urls der Lexikoneinträge * Import / Export von Einträgen via Shopware Import/Export * SEO Daten (Meta-Titel, Meta-Keywords, Meta-Description)
# Installation Die Installation des Plugins geschieht wie bei allen anderen Plugins, über den Administrationsbereich Ihres Shops, unter Erweiterungen > Store. Suchen Sie dann nach "Lexikon / Glossar für Shopware 6". Klicken Sie dann auf den Eintrag und im darauf folgenden Fenster dann auf "Erweiterung hinzufügen". # Pluginkonfiguration **Aktiv:**\ Aktivieren des Plugins **Art des Ladens der Einträge ( ab Version 1.4.4)** Anhand des Indexs: \ Bei den Einträgen haben Sie die Möglichkeit ab der Version 1.4.4, einen Anfangsbuchstaben einzugeben z.B. F für Farbe
Wird im Frontend auf die Kategorie "F" geklickt, werden alle Einträge geladen die den Anfangsbuchstaben "F" haben. Anhand der Kategorie: Bei dieser Einstellung werden im Frontend alle Einträge geladen die der zugewiesenen Kategorie untergeordnet sind.\ \ Wird im Frontend auf die Kategorie "F" geklickt, werden alle Einträge geladen die der Kategorie "F" zugewiesen sind. **Lexikon in den Kategoriebeschreibungen:** Nein: Es werden keine Akronyme erzeugt Ja: Es werden Akronyme erzeugt **Lexikon in den Artikelbeschreibungen:** Nein: Es werden keine Akronyme erzeugt Ja: Es werden Akronyme erzeugt **Lexikon in den Shopseiten:** Nein: Es werden keine Akronyme erzeugt Ja: Es werden Akronyme erzeugt \ \ **Einstellungen zu den Artikeleigenschaften:** keine Lexikon Einträge: Es werden keine Akronyme erzeugt Eigenschaften Werte: Es werden Akronyme bei Eigenschaften und Werte erzeugt Eigenschaften: Es werden Akronyme bei Eigenschaften erzeugt Nur Werte: Es werden Akronyme bei Werte erzeugt \ \ **Einstellungen zu den Varianten:** keine Lexikon Einträge: Es werden keine Akronyme erzeugt Nur Gruppen: Es werden Akronyme bei Gruppen der Varianten erzeugt **Der Startseitentext Ihres Lexikons:** Hier geben Sie einen Beschreibungstext ein, der dann auf der Startseite des Lexikon Plugins erscheint **Link Methode:** Modal: Beim Klicken wird ein Popup mit den Informationen geöffnet Als Link: Beim Klicken werden die Informationen in einem neuen Fenster geöffnet\ \ **Zusatzfelder:** Geben Sie hier Ihre Zusatzfelder ein , z.b. vom Artikel bei denen auch Akronyme erzeugt werden sollen **CMS Seite für die Lexikonstartseite** Sie können anstatt eines Textes auf der Startseite auch eine Landingpage einer Erlebniswelt zuweisen **Lexikon Kategorien Template**\ \ Boxed Template: Ein Eintrag pro Zeile **Einträge pro Seite** Wieviel Einträge pro Seite angezeigt werden sollen
\ **Suchmethode:** {% hint style="danger" %} Ab Version 1.3.7 (bei Shopware < 6.6) und ab Version 1.4.8 (bis Shopware 6.5.8.11)\ Die Möglichkeit nach Keywords zu suchen ist BETA! {% endhint %} Hier hat man die Möglichkeit einzustellen wie gesucht werden soll:\ \ Nach Suchwort: Dabei muss im Lexikoneintrag nur ein Suchwort eingegeben werden\ Nach Keywords: Dabei können unter "Suchwort" im Lexikoneintrag mehrere Suchwörter getrennt durch :: eingegeben werden. Diese Möglichkeit ist **BETA** und es sollten nicht zu viele Einträge eingegeben werden, da sich dabei die Perfomance im Frontend verschlechtern könnte.
# Menüeinstellungen Nach der Installation und Aktivierung des Plugins, finden Sie unter Inhalte einen neuen Eintrag "Lexikon" mit zwei Untermenüs "Lexikon Kategorien" und "Lexikon Einträge" # Lexikon Kategorien Unter Lexikon Kategorien finden Sie eine Auflistung des Alphabets (A - Z ) sowie (0 - 9 ) als Kategorien. Sie können auch eigene Kategorien zuweisen\ \

Liste der Kategorien

### Neue Kategorie anlegen **Titel:** Titel / Name der Kategorie **Beschreibung:** Beschreibung der Kategorie **Position:** Reihenfolge des Eintrags **Aktiv:** Aktivieren des Eintrags **Nicht Anzeigen in der Top Navigation:** Nicht Anzeigen in der Top Navigation der Kategorien
# Lexikon Einträge Unter Lexikon Einträge finden Sie eine Übersicht aller erstellten Einträge von Ihnen
Um neue Einträge zu erstellen, klicken oben auf den Button „Erstellen“.\ Es öffnet sich dann folgende Bearbeitungsmaske in 4 Tabs (Stammdaten, Bilder, SEO, Zugehörige Artikel ) eingeteilt, die auf den nächsten Seiten ausführlich erklärt werden
# Stammdaten **Titel:** Der Titel des Eintrags **Kopfzeile:** Die Kopfzeile des Eintrags **Keywords / Suchwort:** Tragen Sie hier **das Suchwort** des Eintrags. \ \ AB Version 1.3.7 ( Shopware 6.5.8.x) und ab Version 1.4.7 (Shopware 6.6.x.x)\ \ Zusätzliche (BETA) Funktion:\ \ Sie können auch mehrere Suchwörter mittels "::" trennen und eingeben. Bedenken Sie dass Sie nicht zu viele Suchwörter eingeben, da sich ansonsten die Perfomance im Frontend verringern könnte.
**Kurzbeschreibung:** Eine Beschreibung in Kurzfassung z.b. für das Listing **Beschreibung:** Eine Beschreibung des Eintrags **Position:** Festlegen der Reihenfolge des Eintrags **Anfangsbuchstabe (Index) :**\ *(ab Version 1.4.4)* **Eingeben des ersten Buchstaben zwecks Laden der Einträge anhand des Indexes.**\ \ Beispiel: \ \ Kunde klickt im Frontend oberhalb auf "F" dann werden alle Einträge geladen die als Anfangsbuchstaben "F" enthalten.\ \ Bei SEO Einstellungen muss dann folgendes bei "Lexikon Detailseite" eingebunden werden: ```twig lexikon/{{ lexikon.translated.letter }}/{% if lexikon.translated.seoUrl %}{{ lexikon.translated.seoUrl }}{% else %}{{ lexikon.translated.title }}{% endif %} ``` **Zugewiesene Kategorien:** Auswahl der Lexikon Kategorie für den Eintrag\ \ Beispiel: \ \ Kunde klickt im Frontend oberhalb auf "F" dann werden alle Einträge geladen die Kategorie "F" zugewiesen haben {% hint style="warning" %} Ein Eintrag kann nur einer Kategorie zugewiesen werden. Wenn Sie unterschiedliche Sprachen nutzen und der Eintrag ist in einigen Sprachen mit einem anderen anfangsbuchstaben (Beispiel: Deutsch > Farbe, Englisch > Color ) dann kann das nur durch einen zusätzlichen Verkaufskanal als Sprachenshop gelöst werden. {% endhint %} **CMS Seite:** Festlegen einer CMS Seite für den Eintrag **Sichtbarkeit:** Festlegen in welchen Verkaufskanal / Shop der Eintrag angezeigt wird Screen des Backends bis Version 1.3.6
Screen ab Version 1.3.7
Screen ab Version 1.4.4 - 1.4.8
# Bilder Unter den Tab "Bilder" können Sie für den Lexikon Eintrag ein Bild hochladen
# Seo Unter dem Seo, können Sie SEO spezifische Einstellungen vornehmen.\ Darüber hinaus eine spezifische SEO Url festlegen. {% hint style="info" %} Generell werden SEO Urls der Lexikon Kategorien sowie Einträgen über Einstellungen > Seo generiert. Sollten Sie hier aber eine SEO Url festlegen, wird diese als SEO Url genommen {% endhint %}

Screen von Einstellungen > SEO > SEO Vorlage für Lexikon

Ab Version 1.4.4\ \ Sofern Sie bei den Plugineinstellungen bei Art des Ladens der Einträge folgendes eingestellt haben, müssen die SEO Variablen gegebenfalls geändert werden: Anhand des Indexs Bei SEO Einstellungen muss dann folgendes bei "Lexikon Detailseite" eingebunden werden: ```twig lexikon/{{ lexikon.translated.letter }}/{% if lexikon.translated.seoUrl %}{{ lexikon.translated.seoUrl }}{% else %}{{ lexikon.translated.title }}{% endif %} ``` Anhand der Kategorie Bei SEO Einstellungen muss dann folgendes bei "Lexikon Detailseite" eingebunden werden: ```twig lexikon/{{ lexikon.category.title }}/{% if lexikon.translated.seoUrl %}{{ lexikon.translated.seoUrl }}{% else %}{{ lexikon.translated.title }}{% endif %} ``` Sofern Sie dann unter Seo Url z.B. "Milch" eingeben, wie auf den untenstehenden Screen, wird diese Seo Url dann für den EIntrag generiert anstatt der Standard SEO Url unter Einstellungen > SEO

Screen von Tab SEO

# Zugehörige Artikel **Titel:** Eingabe eines Titels, der dann als Überschrift dient **Artikel:** Mehrfachauswahl von Artikeln
**Layout:** Hier können Sie das Erscheinungsbild einstellen
Siehe unter Bilder\ \ **Anzeige Modus:** Hier entscheidest Du, wie das Bild dargestellt werden soll. \ \ Siehe unter Slider\ \ **Navigation:** Anzeige der Navigation **Automatischer Wechsel:** Hier kannst Du einstellen, ob die Elemente automatisch sliden sollen. **Rahmen:** Anzeige eines Rahmens **Minimale Breite:** Mindestbreite des Elements **Produkt Limit:** Ohne Funktion
# Lexikon veröffentlichen Sofern Sie das Lexikon nach Einstellen ihrer Lexikon Einträge veröffentlichen möchten, müssen Sie dazu eine neue Kategorie z.b. in der Footer Navigation erstellen.
### **Vorgehensweise** 1. Geben Sie einen Namen ein, z.b. **Lexikon** oder **Glossar** 2. Wählen Sie als Kategorietyp **Link** aus 3. Wählen Sie Linktyp **Extern** aus 4. Geben Sie bei Linkziel **/lexikon** ein
# FAQ Manager für Shopware 6 ### Beschreibung Mit diesem Plugin ist es relativ einfach Ihren Kunden Fragen und Antworten zu den wichtigsten Themen Ihres Shops anzubieten. ### Features: * Einfaches Einstellen von FAQ-Kategorien * Erstellen von Fragen * Erstellen von Antworten * Verknüpfen von Faq's mit Artikeln * Seo URL Generierung der FAQ Kategorien und Einträge * Sitemap Generierung {% hint style="info" %} **Wichtig bei Updates:** \ Erstellen Sie vor dem Einspielen von Updates ein Backup ihres Shops\ bzw. des Pluginordners, da Shopware beim Updaten den Inhalt des Pluginordners überschreibt und somit Anpassungen an den Templates verloren gehen. {% endhint %} {% hint style="info" %} **Wichtiger Hinweis:** \ \ Wir entwickeln ausschliesslich auf Basis einer Standardinstallation von Shopware. Sofern Sie Plugins von Fremdanbieter (darunter fallen auch Shopware Premium Plugins) in Ihrem Shop einsetzen, empfehlen wir Ihnen unsere Plugins vor dem Erwerb ausgiebig zu testen, um auch zu prüfen ob eventuell Konflikte unter den eingesetzten Plugins auftreten . Dazu bieten wir Testlizenzen an, die Sie im Shopware Store herunterladen können. {% endhint %} **Hinweis:** Bitte deinstallieren Sie das Plugin vor dem Entfernen immer über den Plugin-Manager. Ein direktes Löschen (z. B. per FTP oder „kündigen und entfernen“) kann zu Fehlern oder verbleibenden Systemeinträgen führen.
# Funktionsbeschreibung ### Produktinformationen ### Highlights * Strukturierte Daten (Rich Snippets) * SEO-URLs (Faq Kategorien, Faq Seiten, Faq Detailseiten) * SEO-Optimierung * Sitemap Generierung * FAQ Startseite als Erlebniswelt ### Features * Einfache Installation und Einrichtung * Responsive Design * FAQ Erlebniswelten-Element * Hinzufügen von Bildern bei den FAQ Einträgen {% hint style="danger" %} Die Startseite des Plugins lautet immer /faq. Diese SEO URL kann nicht geändert werden {% endhint %} # Installation Die Installation des Plugins geschieht wie bei allen anderen Plugins, über den Administrationsbereich Ihres Shops, unter Erweiterungen > Store. Suchen Sie dann nach "FAQ Manager für Shopware 6". Klicken Sie dann auf den Eintrag und im darauf folgenden Fenster dann auf "Erweiterung hinzufügen". # Plugin Konfiguration **CMS Seite für die FAQ Startseite** Sie können anstatt eines Textes auf der Startseite auch eine Landingpage einer Erlebniswelt zuweisen **Der Startseitentext Ihres Faq:** Hier geben Sie einen Beschreibungstext ein, der dann auf der Startseite des Faq Plugins erscheint **Einträge pro Seite** Wieviel Einträge pro Seite angezeigt werden sollen **Anzeige der Faq's im Artikel**\ Hier können Sie festlegen welche FAQ Einträge bei den Artikel angezeigt werden sollen.\ Entweder anhand der FAQ'S oder anhand der FAQKategorien
# Menueinstellungen Nach der Installation und Aktivierung des Plugins, finden Sie unter Inhalte einen neuen Eintrag "FAQ Manager" mit drei Untermenüs "FAQ Kategorien" , "FAQ Einträge" sowie FAQ Seiten\ \ ![](https://2061240942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2bDXNnc5DRWPvagpuhf1%2Fuploads%2FMXimDox6LMhHFbaMWghk%2Fimage.png?alt=media\&token=b97376ed-5a1d-44dc-aed5-f5e09e8dd204) Beim Plugin werden Daten folgendermaßen erstellt\
1. FAQ Seiten \ \ *( siehe Screen > Linke Menuführung >Flächenberechnung - Shopware 6, Artikeldesigner - Shopware 6)* 2. FAQ Kategorien die den FAQ Seiten zugewiesen werden\ \ *( siehe Screen > Mittlere Menuführung > Fragen und Antworten zum Produktdesigner)* 3. 4. FAQ EInträge die den FAQ Kategorien zugewiesen werden\ \ ( siehe Screen > Mittlere Menuführung > Accordion ) {% hint style="danger" %} Unbedingt wichtig ist, dass diese Zuweisungen durchgeführt werden müssen, da ansonsten Eintrag X nicht angezeigt werden kann da es keiner Kategorie zugewiesen ist, oder Kategorie XY nicht angezeigt werden kann da diese keiner Seite zugewiesen ist.\ Darüber hinaus kann es auch zu Fehlermeldungen kommen! {% endhint %}
# FAQ Seiten Unter Inhalte > Faq Manager > FAQ Seiten können Sie Seite des FAQ's anlegen ### Liste: \ Über den Button "Erstellen" können Sie einen neuen Eintrag erstellen
### Detailseite #### Titel: Geben Sie ihren gewünschten Titel ein **Beschreibung:** Beschreibung der Kategorie
**Seo Url:** Sofern Sie dann unter Seo Url was eingeben, wie auf den unten stehenden Screen, wird diese Seo Url dann für den Eintrag generiert anstatt der Standard SEO Url unter Einstellungen > SEO **Position:** Reihenfolge des Eintrags festlegen
Seo Spezifische Einträge\
# FAQ Kategorien Unter Inhalte > Faq Manager > FAQ Kategorien können Sie Kategorien des FAQ's anlegen ### Liste: Über den Button "Erstellen" können Sie einen neuen Eintrag erstellen
### Detailseite #### Titel: Geben Sie ihren gewünschten Titel ein **Beschreibung:** Beschreibung der Kategorie
**Seo Url:** Sofern Sie dann unter Seo Url was eingeben, wie auf den unten stehenden Screen, wird diese Seo Url dann für den Eintrag generiert anstatt der Standard SEO Url unter Einstellungen > SEO {% hint style="info" %} Achten Sie darauf eine korrekte SEO Url einzugeben. \ \ **Beispiel:** \ \ Korrekt:\ \ fragen-und-antworten-zum-Plugin\ \ Falsch: 1. Fragen und Antworten zum Plugin? 2. faq/fragen-und-antworten-zum-Plugin (faq/ wird bei den SEO Variablen schon am Anfang deklariert ) {% endhint %} {% hint style="info" %} Sie können die SEO Variable der Kategorien auch unter Einstellungen > SEO festlegen\ \ Beispiel:\ \ wenn SEO Url in der Kategorie gesetzt, dann soll die SEO Url faq/SEO Url heissen , ansonsten faq/KATEGORIENNAME {% endhint %} {% code title="SEO Variable " overflow="wrap" %} ```twig faq/{% if faqcategory.translated.seoUrl %}{{ faqcategory.translated.seoUrl }}{% else %}{{ faqcategory.translated.name }}{% endif %} ``` {% endcode %} {% hint style="info" %} 2 Beispiel:\ \ SEO anhand des Kategoriennamens {% endhint %} ```twig faq/{{ faqcategory.translated.name }} ``` **Position:** Reihenfolge des Eintrags festlegen **Aktiv:** Aktivieren des Eintrags **In Erlebniswelten eingebunden:** Sofern dieser Haken gesetzt wird, wird der Eintrag den Erlebniswelten Zur Auswahl gestellt {% hint style="danger" %} Wichtige Info:\ \ Um in den Erlebniswelten, die FAQ's einzubinden, müssen diese dann bei der jeweiligen FAQ Kategorie auch angehakt sein. Fügen Sie nicht ein FAQ CMS Element ohne Kategorie hinzu! {% endhint %} **Zugewiesene Seiten:** Zuweisen von FAQ Seiten {% hint style="danger" %} Jede FAQ Kategorie muss einer FAQ Seite zugewiesen werden {% endhint %}
# FAQ Einträge Unter Inhalte > Faq Manager > FAQ Einträge können Sie Einträge des FAQ's anlegen ### Liste: Über den Button "Erstellen" können Sie einen neuen Eintrag erstellen
### Detailseite #### Titel: Geben Sie ihren gewünschten Titel ein **Frage:** Frage des Eintrags **Anwort:** Antwort des Eintrags
**Zugewiesene Kategorien:** Kategorien dem Eintrag zuweisen {% hint style="danger" %} Jeder FAQ Eintrag muss einer FAQ Kategorie zugewiesen werden {% endhint %} Unter dem Tab Seo, können Sie SEO spezifische Einstellungen vornehmen.\ Darüber hinaus eine spezifische SEO Url festlegen. {% hint style="info" %} Generell werden SEO Urls der FAQ EInträge sowie Einträgen über Einstellungen > Seo generiert. Sollten Sie hier aber eine SEO Url festlegen, wird diese als SEO Url genommen.\ Achten Sie darauf eine korrekte SEO Url einzugeben. \ \ **Beispiel:** \ \ Korrekt:\ \ fragen-und-antworten-zum-Plugin\ \ Falsch: 1. Fragen und Antworten zum Plugin? {% endhint %}
Seo Spezifische Einträge des Eintrags
Hochladen von Bildern
# FAQ veröffentlichen Sofern Sie das Lexikon nach Einstellen ihrer Lexikon Einträge veröffentlichen möchten, müssen Sie dazu eine neue Kategorie z.b. in der Footer Navigation erstellen.
### **Vorgehensweise** 1. Geben Sie einen Namen ein, z.b. **FAQ** oder **Fragen und Antworten** 2. Wählen Sie als Kategorietyp **Link** aus 3. Wählen Sie Linktyp **Extern** aus 4. Geben Sie bei Linkziel **/faq** ein
# Zusätzliche Artikeltabs für Shopware 6 Mit Hilfe dieses Plugins, können Sie bei jedem Artikel Tab Reiter hinzufügen.
Die Tabreiter können global angelegt werden und jedem Artikel dann zugeordnet werden.\ \ **Demo:** # Funktionsbeschreibung ### Produktinformationen ### Highlights * Sortierreihenfolge einstellbar * Titel und Beschreibung übersetzbar * Aktivieren/Deaktivieren des Tabreiters * Aktivieren des Plugins je Subshop * Hinzufügen von Bildern (Slider / Carousel) ### Features * Zentrale Verwaltung der Tabs * Neue Tabs hinzufügen * Vorhandene Tabs löschen * PDF Erstellung der Tabbeschreibungen * Slider oder Carousel Funktion der Bilder * Einstellen der Schrift-, Hintergrund- sowie Linienfarbe des Tabs * Einstellen von eigenen CSS Klasse je Tab # Installation Die Installation des Plugins geschieht wie bei allen anderen Plugins, über den Administrationsbereich Ihres Shops, unter Erweiterungen > Store. Suchen Sie dann nach "**Zusätzliche Artikeltabs für Shopware 6**". Klicken Sie dann auf den Eintrag und im darauf folgenden Fenster dann auf "Erweiterung hinzufügen" # Pluginkonfiguration **Aktiv:** Aktivieren des Plugins **PDF Logo:** EInbinden ihres Logos für die PDF Vorschau
# Menueinstellungen Nach der Installation und Aktivierung des Plugins, finden Sie unter **Kataloge** einen neuen Eintrag "**Tabs**" # Tabs Unter Inhalte > Tabs können Sie Seite des Tabs anlegen ### Liste: \ Über den Button "Erstellen" können Sie einen neuen Eintrag erstellen
### Detailseite #### Aktiv: Aktivieren des Eintrags **PDF Button Anzeigen:** Zeigt unterhalb einen Button zum Erzeugen einer PDF des Tab Inhalts.
{% hint style="info" %} Das Plugin nutzt hierbei eine PDF Bibliothek die in Shopware integriert ist. Wir empfehlen daher dass Sie sofern Sie den PDF Button aktivieren, dass Sie nicht zu aufwendiges HTML nutzen, da dies gegebenenfalls zu Darstellungsproblemen in der PDF führen kann, da einige HTML Komponenten nicht unterstützt werden.\ \ Prüfen Sie daher nach dem Erstellen des Eintrags und Zuweisen zu einem Artikel, ob die PDF dann nach Ihrem Wunsch korrekt angezeigt wird.\ \ ***Wir können daher nicht gewährleisten dass Ihr EIntrag als PDF korrekt dargestellt wird.*** {% endhint %} #### Slider aktivieren: Aktivieren des Sliders bei Anzeige der Bilder **Schriftfarbe:** Farbe der Tab Überschrift **Farbe der untereren Tablinie:** Im Shopware Standard Theme wird unterhalb der Tab Überschrift, eine Linie erzeugt. Diese kann dann eingefärbt werden, sofern SIe hierbei einen Hexadezimalen Farbcode einsetzen oder anhand des Color Pickers eine Farbe auswählen
#### **Hintergrundfarbe:** Hintergrundfarbe der Tab Überschrift **CSS Class:** Hier können Sie eine eigene CSS Klasse definieren **Position:** Reihenfolge des Eintrags **Titel:** Geben Sie ihren gewünschten Titel ein **Beschreibung:** Beschreibung der Kategorie **Bilder:** Fügen Sie ihre gewünschte Bilder ein
# Zuweisen der Tabs Die erstellten Tabs können Sie bei jedem Artikel unter Spezifikationen > Zusatzfelder > Zusätzliche Artikeltabs zuweisen. Jeder Eintrga kann xbeliebigen Artikeln xbeliebig zugewiesen werden
# Formular Manager für Shopware 6 Mit unserem Plugin Formular Manager für Shopware 6, können Sie Formulare in Shopware 6 erstellen.\ \ Dazu können Sie unterschiedliche Formularfelder dem Formular zuweisen: * Email * Telefon * Datum * Checkboxen (Mehrfachauswahl) * Radio Buttons (einfache Auswahl) * Dropdown / Select * Textfeld * Textarea * Farbfeld * Passwort
# Systemvoraussetzungen * Shopware Version min. 6.6.9.0 * PHP 8.1 * Captcha "Honeypot" * Die Funktionalität wird ausschließlich bei Verwendung des lokalen E-Mail-Agenten gewährleistet. # Plugin Installation / Updates ### Installation Wir empfehlen Updates im Vorfeld immer in einer Entwicklungsumgebung in einem Unterverzeichnis des Shops zu testen z.B. Ihredomain.de /dev/. \ \ Die Installation des Plugins geschieht wie bei allen anderen Plugins, über den Administrationsbereich Ihres Shops, unter Erweiterungen > Store. Suchen Sie dann nach "**Formular Manager für Shopware 6**". Klicken Sie dann auf den Eintrag und im daraufolgenden Fenster dann auf "Erweiterung hinzufügen".\ \ Sie können das Plugin auch über den Store von Shopware erwerben. ### Aktualisierung des Plugins 1\. Entpacken Sie die Zip des Plugins und laden Sie dann den Inhalt des Ordners PixelForms in das Verzeichnis custom/plugins/PixelForms und dessen Inhalt überschreiben (Vorher Sicherung anlegen) 2\. Melden Sie sich im Backend an\ 3\. Öffnen Sie den Pluginmanager unter Erweiterungen > Meine Erweiterungen\ 4\. Beim Eintrag des Plugins "**Formular Manager für Shopware 6**" sollte dann neben dem Eintrag der Versionsnummer, ein Link "Aktualisierung" angezeigt werden. \ 5\. Klicken Sie auf diesen Link um das Update des Plugins zu starten. Es kann einige Zeit dauern bis das Plugin aktualisiert wird, daher nicht die Seite verlassen. \ \ Mehr Informationen zur Installation und Aktualisierung von Erweiterungen bei Shopware 6, finden Sie unter\ \ [Zur Shopware 6 Dokumentation](https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen) Bei Problemen oder Fehlern, können Sie sich jederzeit an uns wenden. Um Fehler zu analysieren und zu beheben, senden Sie uns FTP sowie Backend Zugang zu (Gegebenenfalls PHPMYADMIN Zugang um eventuell das Plugin per Datenbankbefehl zu deaktivieren). ### Plugineinstellungen
\ \ In den Formulareinstellungen kann in der jeweiligen Formularkonfiguration festgelegt werden, ob die Kunden-E-Mail als Reply-To gesetzt werden soll.
Zusätzlich stehen in den Plugineinstellungen zwei alternative Versandmethoden zur Verfügung, die dieses Verhalten beeinflussen können. Diese Optionen sollten mit Bedacht eingesetzt werden und sind insbesondere für spezielle Mailserver-Konfigurationen (z. B. Microsoft 365) vorgesehen und sollten mit Vorsicht verwendet werden und nur dann aktiviert werden. Wenn es beim E-Mail-Versand zu Problemen kommt sollte diese Funktion deaktiviert werden. Sie haben dabei folgende Möglichkeiten: **Kunden-E-Mail als Reply-To setzen** aktivieren und zusätzlich in den Plugineinstellungen die Option „**Andere ReplyTo Sendemethode**“ verwenden.\ \ Damit wird die Kundenemail als ReplyTo gesetzt \ **Kunden-E-Mail als Reply-To setzen** aktivieren und zusätzlich in den Plugineinstellungen die Option „**Andere ReplyTo Sendemethode**“ deaktivieren.\ \ Damit wird die Kundenemail als Absender gesetzt {% hint style="danger" %} Diese Funktion nicht nutzen, siehe Hinweis unter Wichtige Info {% endhint %} **Kunden-E-Mail als Reply-To setzen** deaktivieren und stattdessen in den Plugineinstellungen die Option „**Andere zusätzliche Empfänger E-Mail Sendemethode**“ verwenden.\ \ Damit wird die Zusätzliche Empfänger E-Mail als ReplyTo gesetzt **Kunden-E-Mail als Reply-To setzen** deaktivieren und stattdessen in den Plugineinstellungen die Option „**Andere zusätzliche Empfänger E-Mail Sendemethode**“ deaktivieren.\ \ Damit wird die Zusätzliche Empfänger E-Mail als Absender gesetzt {% hint style="danger" %} Diese Funktion nicht nutzen, siehe Hinweis unter Wichtige Info {% endhint %} Welche Variante für Ihre Umgebung geeignet ist, hängt von der jeweiligen Mailserver-Konfiguration ab. Es wird empfohlen, die Einstellungen nach einer Änderung sorgfältig zu testen. {% hint style="danger" %} **WICHTIGE INFO**\ \ Das Setzen der Kunden-E-Mail als Reply-To oder Absender kann – abhängig von der jeweiligen Mailserver-Konfiguration – gegen gängige Sicherheitsmechanismen im E-Mail-Versand (SPF, DKIM, DMARC) verstoßen. Moderne E-Mail-Provider können E-Mails mit solchen Einstellungen ablehnen oder als Spam einstufen. Die in den Plugineinstellungen angebotenen alternativen Versandmethoden sind daher nur für spezielle Anwendungsfälle vorgesehen und sollten mit Bedacht eingesetzt werden. Vor allem in Umgebungen mit strikten Sicherheitsrichtlinien (z. B. Microsoft 365, Google Workspace) kann es bei Aktivierung dieser Optionen zu Versandproblemen kommen.
Wir empfehlen, Änderungen an diesen Einstellungen nach Möglichkeit zunächst in einer Testumgebung zu prüfen.\ \ **Hinweis:**
Bitte deinstallieren Sie das Plugin vor dem Entfernen immer über den Plugin-Manager. Ein direktes Löschen (z. B. per FTP oder „kündigen und entfernen“) kann zu Fehlern oder verbleibenden Systemeinträgen führen. {% endhint %} # Pluginmenu Nach der Installation und Aktivierung des Plugins, müssen Sie den Cache sowie die Themes des Shops neu kompilieren.

 Nach Neuladen des Browserfenster, finden Sie unter dem Menüpunkt „Inhalte“ zusätzliche Menüpunkte auf die später näher eingegangen wird.

\ \ \ \ **Menübaum:**


**Formular Manager >**\ \ **Formular Konfiguration**\ \ **Formular Gruppen**\ \ **Formularfelder** # Formular Konfiguration Hier finden Sie eine Übersicht der schon erstellten Konfigurationen Ihrer Formulare.\ \ Durch klicken auf den Button "Erstellen" können Sie eine neue Konfiguration erstellen.\ \
Es öffnet sich dann ein Fenster mit unten stehenden Einstellmöglichkeiten **Aktiv:** Aktivieren der Formular Konfiguration **Blacklist Aktiv:** Aktiviert die Blacklist **EMail nicht an Kunden senden:** Aktiviert: EMail nicht an Kunden senden sondern nur an den Shopbetreiber ( nicht mehr möglich ab 6.7.x)\ Deaktiviert: EMail nur an den Shopbetreiber **Kundenemail als ReplyTo setzen:** Setzt eine Kundenemail als Reply-To-Header {% hint style="info" %} Im Standard wird die Shopbetreiber E-Mail als Reply-To-Header gesetzt. Dies führt aber dazu dass sofern man auf die E-mail antworten möchte, nicht die E-Mail Adresse des Kunden als "Antwort-Email" gesetzt wird. {% endhint %} {% hint style="danger" %} **WICHTIGE INFO**\ \ **Wir empfehlen generell diese Funktion nicht einzusetzen** **SIehe auch Informationen unter** [**Plugin Einstellungen**](/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/formular-manager-fur-shopware-6/plugin-installation-updates)\ \ Kundenemail als ReplyTo zu setzen, funktioniert nicht bei allen Email Providern, zum Beispiel Microsoft 365. \ \ Das Setzen der Kunden-E-Mail als Reply-To oder Absender kann – abhängig von der jeweiligen Mailserver-Konfiguration – gegen gängige Sicherheitsmechanismen im E-Mail-Versand (SPF, DKIM, DMARC) verstoßen. Moderne E-Mail-Provider können E-Mails mit solchen Einstellungen ablehnen oder als Spam einstufen.
Diese Funktion ist daher nur für spezielle Anwendungsfälle vorgesehen und sollte mit Bedacht eingesetzt werden. Vor allem in Umgebungen mit strikten Sicherheitsrichtlinien (z. B. Microsoft 365, Google Workspace) kann es bei Aktivierung dieser Optionen zu Versandproblemen kommen.
Wir empfehlen, Änderungen an diesen Einstellungen nach Möglichkeit zunächst in einer Testumgebung zu prüfen {% endhint %} {% hint style="info" %} Erforderlich ist aber dass bei den Formularfeldern zwei Formularfelder (Vorname und Nachname) erstellt werden müssen oder sofern diese schon vorhanden sind, untenstehende Einstellungen vorgenommen werden müssen\ \ 1 x beim Formularfeld "Vorname" die Checkbox **"Dieses Feld wird als Vorname genutzt (erforderlich für Reply To)"** \ \ 1 x beim Formularfeld "Nachname" die Checkbox **"Dieses Feld wird als Nachname genutzt (erforderlich für Reply To)"** {% endhint %} **Weiterleitung aktivieren:** Aktiv, wird nachdem das Formular gesendet wird, auf die gewünschte Url weitergeleitet Weiterleitungsurl: Wenn "**Weiterleitung aktivieren"** aktiviert ist, muss eine Url eingegeben werden\ \ **E-Mail Template:**\ \ Bei der Installation des Plugins, wird ein **Email Template** *"Formular Manager"* und **Email Typ** *"Formular Manager"* erstellt . Dieses können Sie dann jederzeit anpassen und/oder auch duplizieren. Möchten Sie ein neues Email Template erstellen, so müssen Sie unbedingt den **Typ "Formular Manager"** auswählen.
[**Mehr Informationen**](/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/formular-manager-fur-shopware-6/email-template)

Screen von den Einstellungen beim Email Template erstellen

**Titel:** Geben Sie hier die Überschrift des Formulars ein **Globaler Betreff:** Geben Sie hier das "Globale Betreff" an für den Mailversand, sofern Sie kein Formularfeld dazu erstellen möchten. {% hint style="info" %} Manchmal möchte man nicht dass der Betreff des Kunden im Mailversand steht, sondern ein globaler Betreff wie z.B. Musterbestellung, Widerruf einer Bestellung, Angebotsanfrage etc. steht {% endhint %} **Globales Betreff nutzen:** Aktivierung der Nutzung des "Globalen Betreffs". {% hint style="warning" %} Bei deaktivierten Zustand, muss dann ein Formular Feld als Betreff eingebunden sein {% endhint %} **Art der Formular Überschrift** Wählen Sie hier ihre gewünschte Art der Überschrift aus. Sie können hierbei folgende HTML Elemente auswählen:\ \ H1, H2, H3, H4, H5, H6 oder div.\ \ **Button Typ:**\ \ Legen Sie fest, welche Farbe der Absenden Button des Formulars haben soll. Unter finden Sie eine Übersicht der Farben\ \ **Button Größe** Unter / Size finden Sie Informationen dazu\ \ **Button Text des Formulars** Geben Sie hier ihren gewünschten Text des Absende Buttons ein **Zusätzliche Empfänger e-Mail:** Geben Sie hier die e-Mail an, die auch die e-Mail erhalten soll {% hint style="warning" %} Nur eine EMail Adressse eingeben. Nach dem Speichern dringend das Formular testen, da es gegebenfalls zu Fehlern kommen kann und das Formular nicht gesendet werden kann {% endhint %} **Beschreibung:** Geben Sie die Beschreibung ein, die unterhalb des Titels angezeigt werden soll **Mitteilung beim erfolgreichen Versand:** Geben Sie hier ihre gewünschte Mitteilung ein, die nach dem Versenden erscheinen soll **Mitteilung bei Fehlern:** Geben Sie hier ihre gewünschte Mitteilung ein, die bei einem Fehler erscheinen soll
**Tab Verknüpfte Formular Gruppen** Jedes Formular das Sie erstellen, besteht aus einen Formular und deren verknüpften Formulargruppen. Diese Formulargruppen enthalten dann die erstellten Formular Felder.
# Formular Gruppen Hier finden Sie eine Übersicht der schon erstellten Formular Gruppen. Formular Gruppen dienen dazu, Formularfelder zu gruppieren und diese dann je nach Einstellung einspaltig oder mehrspaltig anzuzeigen. Siehe unsere Demo unter . Bei der ersten Gruppe "Persönliche Daten" wurde die Anzeige des Titels aktiviert und die Anzahl der Spalten auf der Desktop Auflösung beträgt **drei Spalten**\ \ Bei der zweiten Gruppe "Zweite Gruppe (2 Spalten )" wurde die Anzeige des Titels deaktiviert und die Anzahl der Spalten auf der Desktop Auflösung beträgt **zwei Spalten**\ \ Bei der dritten Gruppe "Dritte Gruppe (1 Spalte )" wurde die Anzeige des Titels auch deaktiviert und die Anzahl der Spalten auf der Desktop Auflösung beträgt **eine Spalte**
Durch klicken auf den Button "Erstellen" können Sie eine neue Gruppe erstellen.
Es öffnet sich dann ein Fenster mit untenstehenden Einstellmöglichkeiten\ \ **Titel:** Die Überschrift der Gruppe **Beschreibung:** Beschreibung der Gruppe **CSS Klasse:** Hier können Sie eine eigene CSS Klasse angeben, damit Sie sofern gewünscht das Aussehen der Gruppe via CSS beeinflussen können **Titel aktivieren:** Anzeigen der Überschrift **Beschreibung aktivieren:** Anzeigen der Beschreibung **Aktivieren:** Aktivieren der Gruppe **Position:** Reihenfolge der Gruppe **Anzahl Spalten (Mobile-, Tablet- und Desktop-Auflösung)** Je Auflösung können Sie die Anzahl der Spalten einstellen\ \ **Beschreibung anzeigen (ab Version 2.3.9 )**\ \ Damit können Sie auswählen wie die Beschreibung angezeigt werden soll von der Formular Gruppe, vorausgesetzt dass **Beschreibung aktivieren** gesetzt ist\ \ Normal: Die Beschreibung wird unterhalb der Gruppe angezeigt\ Per Icon: Die Beschreibung wird als Modal Fenster angezeigt, wenn der Kunde auf das Icon klickt\ \ **Icon Größe:** \ \ SIe können die Größe des Icons bestimmen ( Klein , Medium, Gross )\ \ **Auswahl des Icons:**\ \ Wählen Sie ein Shopware Icon aus. Eine Übersicht finden Sie unter \ \ \ \ \ **Auswahl der Icon Farbe:**\ \ Wählen SIe per Color Picker ihre gewünschte Farbe aus
# Formular Felder Wenn Sie auf Inhalte > Formular Manager > Formular Felder klicken, erscheint eine Übersicht ihrer hinterlegten Formular Felder. {% hint style="danger" %} **Sehr wichtig:**\ \ **Erstellen Sie unbedingt zwei Felder "E-Mail" und "Betreff" und aktivieren Sie dann durch die unten stehenden beiden Einstellungen.** **1 x Email mit Aktivierung von "Dieses Feld wird als e-Mail genutzt" und Feld "E-Mail"** **1 x Betreff mit Aktivierung von "Dieses Feld wird als Betreff genutzt" und Feld "Textfeld"** **Ohne diese beiden Felder ( Betreff, email ) sowie mindestens ein anderes Formularfeld kann das Formular nicht versendet werden!** {% endhint %}
Durch klicken auf den Button "Erstellen" können Sie ein neues Formular Feld zu erstellen. Es öffnet sich dann ein Fenster mit unten stehenden Einstellmöglichkeiten ### Tab Standard: #### Kopfzeile: Überschrift des Feldes **Kurzbeschreibung:** Beschreibung erscheint unterhalb des Feldes **CSS Klasse:** Hier können Sie eine eigene CSS Klasse angeben, damit Sie sofern gewünscht das Aussehen der Gruppe via CSS beeinflussen können **ID:** Hier können Sie eine eigene CSS ID angeben, damit Sie sofern gewünscht das Aussehen der Gruppe via CSS beeinflussen können
**Position:** Festlegen der Reihenfolge **Aktiv:** Aktivieren des Formular Feldes **Titel aktivieren:** Anzeigen der Überschrift **Beschreibung aktivieren:** Anzeigen der Beschreibung **Feld:** Unter Feld können Sie aus folgenden Elementen auswählen: **DropDown / Select Feld**
Bei der Auswahl von Dropdown, erscheint eine Möglichkeit festzulegen dass am Anfang des Dropdowns eine deaktivierte Option erscheint. Sie können hierbei dann einen Platzhalter festlegen der angezeigt wird z.B. "Bitte eine Anrede auswählen". Diese Option wird nicht gesendet.
**Textfeld**
**Email**
**Passwort**
**Telefon**
**Textarea**
**Checkboxen**
**Radio-Buttons**
**Textfeld zum Generieren von Datumsfeldern**
**Einfache Farbauswahl**
**Farbfeld ( ab Version 2.7.8 )**\ \ ![](https://2061240942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2bDXNnc5DRWPvagpuhf1%2Fuploads%2FrO4I0Ns1bGwzrQoSQcsX%2Fimage.png?alt=media\&token=4a56e6cd-e722-4085-b909-d2b03575e18a)\ \ **Nummernfeld**
Uploadfeld
{% hint style="danger" %} Ein Uploadfeld kann nur **einmal pro Formular** eingesetzt werden {% endhint %} **Bildfeld** Hinzufügen eines Bildes dass im Formular angezeigt wird {% hint style="warning" %} **Sehr wichtig:**\ \ **Erstellen Sie unbedingt zwei Felder "E-Mail" und "Betreff" und aktivieren Sie dann durch die unten stehenden beiden Einstellungen.** **1 x Email mit Aktivierung von "Dieses Feld wird als e-Mail genutzt" und Feld "Email"** **1 x Betreff mit Aktivierung von "Dieses Feld wird als Betreff genutzt" und Feld "Textfeld"** **Ohne diese beiden Felder ( Betreff, email ) sowie mindestens ein anderes Formularfeld kann das Formular nicht versendet werden!** {% endhint %} **Dieses Feld wird als e-Mail genutzt:** Zuweisen eines Textfeldes als e-Mail Feld. Dazu muss der Feldtyp auf e-Mail gesetzt werden **Dieses Feld wird als Betreff genutzt:** Zuweisen eines Textfeldes als Betreff **Dieses Feld wird als Vorname genutzt (erforderlich für Reply To)**\ Setzt dieses Formularfeld als Vorname bei der Nutzung des ReplyTo Headers **Dieses Feld wird als Nachname genutzt (erforderlich für Reply To)**\ Setzt dieses Formularfeld als Nachname bei der Nutzung des ReplyTo Headers\ \ SIehe auch "Kundenemail als ReplyTo setzen" unter **Validieren:** Validieren des Formularfeldes (Textfelder, Textarea, Email, Passwort, Farbfeld, Datumsfeld, Numerisches Feld ). {% hint style="danger" %} Nur Textfelder, Textarea's, Email-Felder, Passwort-Felder, Farbfeld-Felder, Datumsfeld-Felder, Numerische-Felder können validiert werden. \ \ **Radio-Buttons, Checkboxen, DropDown's können nicht validiert werden!**\ \ **Unser Plugin fügt in jedem Formular sofern eingestellt, auch die Standard Captchas ein.** \ **Wenn Sie andere Plugins oder Captchas einsetzen, können wir nicht gewährleisten, dass diese dann einwandfrei funktionieren.**\
{% endhint %} **Zugewiesene Gruppen:** Zuweisen des Formularfeldes zu einer Gruppe
{% hint style="info" %} Das Zuweisen zu einer Formulargruppe, ist bei Formularfelder unbedingt notwendig {% endhint %} # Tab Textfelder **Maximale Textlänge (maxlength)** Das Attribut „maxlength“ definiert die maximale Zeichenfolgenlänge, die der Benutzer in einen Textfeld oder Textarea eingeben kann. Das Attribut muss einen ganzzahligen Wert von 0 oder größer haben. **Platzhalter** Das Platzhalterattribut definiert den Text, der in einem Textfeld angezeigt wird, wenn dieses keinen Wert hat. Der Platzhaltertext sollte dem Benutzer einen kurzen Hinweis auf den erwarteten Wert geben, der in das Textfeld eingegeben werden sollte.
{% hint style="info" %} Platzhalter können angewendet werden bei Textfelder, Textarea, Email, Passwort, Farbfeld, Datumsfeld, Numerisches Feld. {% endhint %}
# Tab Numerische Felder **Mindestwert (min):** Minimaler Wert der eingegeben werden kann Siehe **Maximalwert (max):** Maximaler Wert der eingegeben werden kann **Schritte (step):** Geben Sie die Schrittweite ein Siehe
{% hint style="info" %} Platzhalter für Numerische Felder können unter dem Tab Textfelder eingefügt werden {% endhint %} # Tab Datumsfelder Unter den Datumsfelder gibt es zwei Varianten die eingestellt werden können. **Variante 1:** Aktiviert, wird beim Datumsfeld ein Startdatum und Enddatum gesetzt.Der Kunde kann dann lediglich innerhalb vom Startdatum und Enddatum ein Datum auswählen Beispiel:\ \ Startdatum: 2023-10-06 12:00 Enddatum: 2023-10-26 12:00 **Variante 2:** Aktiviert, wird beim Datumsfeld ein Startdatum und Enddatum gesetzt, aber anhand der gesetzten Tage (Startdatum in Tagen und Enddatum in Tagen). Dabei werden immer beim aktuellen Datum die Tage addiert Aktuelles Datum: 10-08-2023 Startdatum in Tagen: 0 Enddatum in Tagen: 10 Das bedeutet dass anhand des aktuellen Datums am Anfang +0 gesetzt wird und als Enddatum dann +10 Sie können auch alle beiden Varianten deaktiviert lassen, so dass der Kunde ein xbeliebiges Datum auswählen kann
{% hint style="info" %} Platzhalter für Datumsfelder können unter dem Tab Textfelder eingefügt werden {% endhint %} # Tab Sonstiges Bei Formularfeldern wie Dropdown, Checkboxen, Radio Buttons müssen Elemente hinzugefügt werden. Unter diesen Tab können Sie Elemente diesen Formularfeldern hinzufügen.
Beispiel **Das Formularfeld "Farbe" als Farbfeld (ab Version 2.7.8 ) hat 7 Elemente.**\ \ Rot ist vorselektiert als Farbe. \ \ Bei der Komponente "Farbfeld" können Sie auch die Farbe als hexadezimalen Wert einfügen oder per Farbpicker auswählen. Bei allen anderen Komponenten hat das Feld Farbe keine Wirkung **Das Formularfeld "Checkboxes" hat auch drei Elemente.** Checkbox 1 als vorselektierten Wert Checkbox 2 Checkbox 3
Die Elemente müssen je Sprache angelegt werden, ansonsten kommt ein Fehler! Radio Buttons und Dropdown Felder müssen **ein Element** als vorselektiert haben Bei Checkboxen **können** mehrere Elemente sofern gewünscht vorselektiert sein # Tab Uploadfeld Unter diesem Tab können Sie Einstellungen vornehmen zu den Uploadfeld **Dateiendungen:** Geben Sie hier kommagetrennt, alle Dateiendungen ein die Sie zulassen möchten. **Multiple Uploads möglich (BETA):** Sofern Sie mehrere Dateiuploads Ihren Kunden ermöglichen möchten, aktivieren Sie hier dann das multiple Hochladen von Dateien\ \ **Wichtig: Zur Zeit nur ein Upload möglich und nur ein Anhang per e-Mail** **Maximale Anzahl der Dateien beim multiplen Upload:**\ \ Geben Sie die Anzahl der hochzuladenen Dateien an beim multiplen Upload\ \ **Wichtig: Zur Zeit nur ein Upload möglich und nur ein Anhang per e-Mail** **Maximale Dateigröße die hochgeladen werden kann:** Maximale Dateigröße die hochgeladen werden kann, in Bytes.\ Hier ein [Link](https://www.google.com/search?client=firefox-b-e\&q=bytes+in+mb#cobssid=s) zu einer Umrechnung
{% hint style="danger" %} **Wichtige Info zu den Upload** \ \ **Wichtig: Zur Zeit nur ein Upload möglich und nur ein Anhang per e-Mail**\ \ 1\. Stellen Sie immer die Dateigröße ein, die auch in der PHP.ini eingestellt und hochgeladen werden kann ([post\_max\_size](https://www.php.net/manual/en/ini.core.php#ini.post-max-size), [upload\_max\_filesize](https://www.php.net/manual/en/ini.core.php#ini.upload-max-filesize), [max\_execution\_time](https://www.php.net/manual/en/info.configuration.php#ini.max-execution-time) ) ansonsten kann eine Datei dann nicht hochgeladen werden, wenn es die Limits überschreitet. \ \ 2\. Auch können wir nicht gewährleisten dass Dateien die eine hohe Dateigröße haben korrekt hochgeladen werden können. Dies liegt immer an den Einstellungen bzw. Limitierungen Ihres Servers.\ \ 3\. Prüfen Sie daher bis zur welchen Dateigröße der Upload und die Verarbeitung korrekt abläuft da dies je Server immer verschieden ist.\
{% endhint %} # Formular in Erlebniswelt einbinden Die von Ihnen erstellten Formulare können Sie dann in einer Erlebniswelt einbinden. Siehe auch {% hint style="danger" %} Veröffentlichen Sie eine Erlebniswelt mit einem FOrmular nur dann, wenn dieses Formular komplett fertig konfiguriert ist und folgende Punkte aufweist:\ \ Ein Formularfeld muss als EMail eingestellt werden Ein Formularfeld muss als Betreff eingestellt werden Mindestens ein Formularfeld (Kein EMail oder Betreff Feld) muss eingebunden werden\ \ **Ein Formular per Erlebniswelt einstellen!** {% endhint %} Rechts finden Sie in der Block Kategorie einen neuen Eintrag "Formular Manager" und "Formular Manager Links"\ \ **Formular Manager:**\ Wenn Sie diesen Eintrag auswählen wird auf Ihrer Erlebniswelt das komplette Formular angezeigt **Formular Manager Links:** Hierbei wird eine Box mit Titel, Beschreibung und einen Button (Verlinkung zum Formular) angezeigt
### Variante Formular Manager Wenn Sie diesen Eintrag auswählen, wird unterhalb ein Vorschaubild angezeigt.\ Durch Drag und Drop können Sie dann dieses auf die Erlebniswelt bzw. Bühne platzieren.
Durch klicken auf das Platzierte Element, können Sie dieses bearbeiten, indem Sie auf das Zahnrad klicken
Es öffnet sich folgendes Fenster. Wählen Sie dann ihr gewünschtes erstelltes Formular
### Variante Formular Manager Links Wenn Sie diesen Eintrag auswählen, wird unterhalb eine Vorschau angezeigt.\ Durch Drag und Drop können Sie dann diese auf die Erlebniswelt bzw. Bühne platzieren.
Durch klicken auf das Platzierte Element, können Sie dieses bearbeiten, indem Sie auf das Zahnrad klicken **Überschrift:** Anzuzeigende Überschrift in der Erlebniswelt **Beschreibung** Anzuzeigende Beschreibung in der Erlebniswelt **Wählen Sie das gewünschte Formular** Hierbei können Sie ihr gewünschtes Formular auswählen **Art der Ausführung** Modal: Beim Modal öffnet sich ein Modal bzw. Popup Fenster mit dem Formular. Neues Fenster / Link: Bei dieser Variante wird der Link zum Formular ausgeführt **In einem neuen Fenster öffnen:** Wenn Sie unter Art der Ausführung "Neues Fenster" ausgewählt haben, können Sie zusätzlich einstellen dass beim Klick auf den Button, das Formular in einem neuen Fenster bzw. Browser Tab geöffnet wird.
**Button Typ:** hier können Sie das Button Style vom Button einstellen. Siehe **Button Größe:** Größe des Buttons, siehe unter **Sizes** **Button Text (des Formulars)** Text des Buttons unterhalb der Beschreibung **Vertikale Ausrichtung** Diese Einstellung legt fest, wie die Elemente innerhalb des CMS Elements platziert werden soll. **Art der (Formular) Überschrift:** Wählen Sie hier ihre gewünschte Art der Überschrift aus. Sie können hierbei folgende HTML Elemente auswählen:\ \ H1, H2, H3, H4, H5, H6 oder div. **Text Ausrichtung:** Wählen Sie ob die Überschrift und Beschreibung links-, rechtsbündig oder mittig angezeigt wird **Button Ausrichtung:** Wählen Sie ob der Button links-, rechtsbündig oder mittig angezeigt wird **Farbe des Titels:** Festlegen der Textfarbe der Überschrift **Farbe der Beschreibung:** Festlegen der Textfarbe der Beschreibung **Zusätzliche CSS Klasse:** Festlegen einer eigenen CSS Klasse
{% hint style="info" %} Speichern Sie die Erlebniswelt und leeren Sie gegebenfalls den Cache {% endhint %} # FAQ's
Wo finde ich die hochgeladenen Dateien? **Ab der Version 2.0.3 wird ein Album "Form\_upload\_Data" erstellt.**\ **Darin finden Sie alle hochgeladenen Dateien.** Den Ordner nicht umbenennen oder löschen! **Kann ich auch das Formular via Url einbinden?** Ja, das können Sie entweder als Url oder auch als Modal Fenster ### Methoden ### per Twig ID wäre dann die ID des Formulars. Diese können Sie schnell rausfinden, indem Sie in der administration auf die Detailseite der Formular Konfiguration gehen Die Url in Ihrem Browser lautet dann zum Beispiel wie folgt {% code overflow="wrap" lineNumbers="true" %} ``` /admin#/pixelforms/config/detail/00000000000000000000000000000000 ``` {% endcode %} Der String am Ende (**00000000000000000000000000000000**) wäre dann die ID des Formular Damit das Formular als Modal geöffnet werden soll, muss am Ende noch **"?modal=true"** eingesetzt werden #### **Beispiel als Link der ein Modal (Popup ) öffnet** {% code overflow="wrap" lineNumbers="true" %} ```twig Kontaktformular ``` {% endcode %} #### **Beispiel als Link der das Formular in einem neuen Fenster öffnet** {% code overflow="wrap" lineNumbers="true" %} ``` Kontaktformular ``` {% endcode %} ### Oder per HTML #### **Aufbau:** /forms/Formular?modal=true Am Anfang kommt immer "**/forms/"** Dann die Überschrift des Formulars "**Formular"** Damit das Formular als Modal geöffnet werden soll, muss am Ende noch **"?modal=true"** eingesetzt werden #### **Beispiel als Link der ein Modal (Popup ) öffnet** {% code overflow="wrap" lineNumbers="true" %} ```html Kontaktformular ``` {% endcode %} #### **Beispiel als Link der das Formular in einem neuen Fenster öffnet** {% code overflow="wrap" lineNumbers="true" %} ``` Kontaktformular ``` {% endcode %}
Sind mehrere Upload-Felder möglich pro Formular? Nein, das ist nicht möglich. Es kann nur ein Upload Feld eingebunden werden pro Formular
Können alle Felder validiert werden? **Nein,** nur Textfelder, Textarea's, Email-Felder, Passwort-Felder, Farbfeld-Felder, Datumsfeld-Felder, Numerische-Felder können validiert werden. \ \ **Radio-Buttons, Checkboxen, DropDown's können nicht validiert werden!**
# Email Template **E-Mail Template:**\ \ Bei der Installation des Plugins, wird ein **Email Template** *"Formular Manager"* und **Email Typ** *"Formular Manager"* erstellt . Dieses können Sie dann jederzeit anpassen und/oder auch duplizieren. Möchten Sie ein neues Email Template erstellen, so müssen Sie unbedingt den **Typ "Formular Manager"** auswählen {% hint style="warning" %} Header und Footer werden noch nicht unterstützt, daher müssten Sie im Formular selbst den Header einsetzen {% endhint %} Mehr Informationen über Email Templates finden Sie auf\
Achten Sie darauf unter Mail-Text auch den erforderlichen Code für **Text** und **HTML** einzugeben **TEXT** {% code lineNumbers="true" %} ```twig Folgende Nachricht wurde an Sie via Kontakt-Formular Shop {{ salesChannel.name }} gesendet. {{ pixforData.config.translated.name }} {% if pixforData.email is defined %} e-Mail:{{ pixforData.email }} {% endif %} {% if pixforData.subject is defined %} Betreff:{{ pixforData.subject }} {% endif %} {% for item in pixforData.form %} {{ item.label }}:{{ item.value }} {% endfor %} ``` {% endcode %} **HTML** {% code overflow="wrap" lineNumbers="true" %} ```twig

Folgende Nachricht wurde an Sie via Kontakt-Formular vom Shop {{ salesChannel.name }} gesendet.

<< {% if pixforData.firstname is defined %} {{ pixforData.firstname }} {% endif %} {% if pixforData.lastname is defined %} {{ pixforData.lastname }} {% endif %}>> {{ pixforData.uri }}

{{ pixforData.config.translated.name }}

{% if pixforData.email is defined %} e-Mail:{{ pixforData.email }}
{% endif %} {% if pixforData.subject is defined %} Betreff:{{ pixforData.subject }}
{% endif %} {% for item in pixforData.form %} {{ item.label }}: {{ item.value }}
{% endfor %} sales: {{ salesChannel.name }} {% if pixforData.upload is defined and pixforData.upload|length >= 1 %} {% if pixforData.upload %} Folgende Dateien haben Sie hochgeladen:
{% for uitem in pixforData.upload %} {{ uitem.realname }}
{% endfor %} {% endif %} {% endif %}

``` {% endcode %}
# Fehlercodes beim E-Mail-Versand ## Fehlercodes beim E-Mail-Versand Schlägt der Versand eines Formulars fehl, liefert PixelForms einen eindeutigen Fehlercode statt einer allgemeinen Meldung. Der Code benennt die Ursache und lässt sich gefahrlos weitergeben — er enthält keine Hosts, E-Mail-Adressen, IP-Adressen oder Zugangsdaten. {% hint style="info" %} Der Besucher des Shops sieht den Code **nicht**. Im Storefront erscheint weiterhin ausschließlich der Fehlertext, den Sie in der Formularkonfiguration hinterlegt haben. {% endhint %} ### Wo der Code erscheint **Im Log** unter `var/log/` — die vollständige Diagnose: ```bash grep -a "PIXELFORMS MAIL FAILED" var/log/*.log | tail -20 ``` Beispielzeile: ``` PIXELFORMS MAIL FAILED {"code":"PXF-MAIL-101","smtp":"5.7.8","formId":"018f…","exception":"TransportException","detail":"Expected response code \"250\" but got code \"535\", with message \"535 5.7.8 Authentication credentials invalid\"."} ``` | Feld | Bedeutung | | ----------- | -------------------------------------------------------- | | `code` | Fehlercode aus der Tabelle unten | | `smtp` | Statuscode des Mailservers, sofern übermittelt | | `formId` | ID des betroffenen Formulars | | `exception` | technische Fehlerklasse | | `detail` | Meldung des Mailservers, um Hosts und Adressen bereinigt | **In der Server-Antwort** des Formulars im Feld `message`: ```json { "success": true, "type": "danger", "message": "PXF-MAIL-101" } ``` ### Übersicht | Code | Bedeutung | Typische Serverantwort | | -------------- | --------------------------------------------- | ---------------------- | | `PXF-MAIL-101` | Authentifizierung fehlgeschlagen | 535, 534, 530 | | `PXF-MAIL-102` | Absenderadresse abgelehnt | 550 5.7.60, 553 | | `PXF-MAIL-103` | Empfängeradresse abgelehnt | 550 5.1.1 | | `PXF-MAIL-104` | Keine Verbindung zum Mailserver | — | | `PXF-MAIL-105` | TLS/SSL-Fehler | — | | `PXF-MAIL-106` | Sendelimit erreicht | 421, 450, 4.7.0 | | `PXF-MAIL-107` | Relaying verweigert | 554 5.7.1 | | `PXF-MAIL-108` | Nachricht abgelehnt | 552 | | `PXF-MAIL-109` | Ungültige E-Mail-Adresse in der Konfiguration | — | | `PXF-MAIL-110` | E-Mail-Vorlage nicht gefunden | — | | `PXF-MAIL-111` | Keine Vorlagen-ID übergeben | — | | `PXF-MAIL-199` | Unbekannter Fehler | — | ### Die Codes im Einzelnen #### PXF-MAIL-101 — Authentifizierung fehlgeschlagen Der Mailserver hat Benutzername oder Passwort abgelehnt. **Prüfen:** Zugangsdaten unter *Einstellungen → System → Mailer*. Der Benutzername ist bei den meisten Providern die vollständige E-Mail-Adresse, nicht der Kontoname. Bei Microsoft 365 und Google Workspace mit aktivierter Zwei-Faktor-Authentifizierung wird ein eigenes App-Passwort benötigt. Bei OAuth2: Token abgelaufen oder die erteilte Berechtigung reicht für den Mailversand nicht aus. #### PXF-MAIL-102 — Absenderadresse abgelehnt Der Mailserver akzeptiert die verwendete Absenderadresse nicht. Authentifizierte SMTP-Server lassen in der Regel nur die Adresse als Absender zu, mit der sich der Shop angemeldet hat. Der Fehler tritt auf, wenn das Formular die Adresse des Formularausfüllers oder eine abweichende Empfängeradresse als Absender verwendet. **Lösung:** In der Plugin-Konfiguration die Option **„Andere ReplyTo Sendemethode"** aktivieren. Die Besucheradresse wird dann als *Reply-To* gesetzt statt als Absender; Antworten gehen weiterhin an den Besucher. Verwenden Sie zusätzliche Empfänger, aktivieren Sie ebenso **„Andere Zusätzliche Empfänger E-Mail Sendemethode"**. {% hint style="warning" %} Bei Microsoft 365, Google Workspace und beim Versand über OAuth2 sind diese beiden Optionen zwingend erforderlich. Diese Anbieter lassen eine fremde Absenderadresse grundsätzlich nicht zu. {% endhint %} #### PXF-MAIL-103 — Empfängeradresse abgelehnt Der Mailserver kennt eine der Empfängeradressen nicht oder verweigert die Zustellung. **Prüfen:** das Feld „Zusätzliche Empfänger" in der Formularkonfiguration sowie die Shop-E-Mail-Adresse unter *Einstellungen → Shop → Grundeinstellungen*. #### PXF-MAIL-104 — Keine Verbindung zum Mailserver Der Shop erreicht den Mailserver nicht. Es kommt keine Serverantwort zustande. **Prüfen:** Servername und Port unter *Einstellungen → System → Mailer*. Übliche Ports sind 587 (STARTTLS) und 465 (SSL). Blockiert die Firewall des Hosters ausgehende Verbindungen auf diesem Port? Ist der Hostname korrekt geschrieben und per DNS auflösbar? #### PXF-MAIL-105 — TLS/SSL-Fehler Die Verbindung kommt zustande, die Verschlüsselung schlägt fehl. **Prüfen:** Passt die eingestellte Verschlüsselung zum Port? Port 465 erwartet SSL, Port 587 erwartet STARTTLS. Weitere Ursachen sind abgelaufene oder selbstsignierte Zertifikate auf dem Mailserver. #### PXF-MAIL-106 — Sendelimit erreicht Der Mailserver drosselt den Versand oder das Kontingent des Kontos ist ausgeschöpft. Der Fehler ist vorübergehend. **Prüfen:** Sendelimits des Providers. Bei wiederholtem Auftreten das Kontingent erhöhen oder den Versand über einen dedizierten Mailservice abwickeln. #### PXF-MAIL-107 — Relaying verweigert Der Mailserver erlaubt dem Konto nicht, an die angegebene Empfängeradresse zuzustellen. **Prüfen:** Ist die Authentifizierung in den Mailer-Einstellungen aktiviert? Ohne Anmeldung verweigern die meisten Server die Weiterleitung an externe Adressen. Zusätzlich beim Provider prüfen, ob das Konto zum Versand freigeschaltet ist. #### PXF-MAIL-108 — Nachricht abgelehnt Der Mailserver hat die Nachricht selbst zurückgewiesen, meist wegen Größe oder Inhalt. **Prüfen:** Größe der hochgeladenen Dateien gegen die Maximalgröße des Mailservers. Bei Spam-Verdacht den Inhalt der E-Mail-Vorlage prüfen. #### PXF-MAIL-109 — Ungültige E-Mail-Adresse in der Konfiguration Eine der verwendeten Adressen ist leer oder syntaktisch fehlerhaft. **Prüfen:** Das Feld „Zusätzliche Empfänger" darf nicht leer bleiben, wenn die ReplyTo-Option deaktiviert ist. Ebenso die Shop-E-Mail-Adresse unter *Einstellungen → Shop → Grundeinstellungen*. #### PXF-MAIL-110 — E-Mail-Vorlage nicht gefunden Die im Formular hinterlegte E-Mail-Vorlage existiert nicht mehr, etwa weil sie gelöscht wurde. **Prüfen:** Formular öffnen und die E-Mail-Vorlage neu zuweisen. #### PXF-MAIL-111 — Keine Vorlagen-ID übergeben Das Formular hat beim Absenden keine E-Mail-Vorlage mitgeschickt. **Prüfen:** Formularkonfiguration auf eine zugewiesene Vorlage prüfen, anschließend den Shop-Cache leeren. #### PXF-MAIL-199 — Unbekannter Fehler Der Fehler ließ sich keiner bekannten Ursache zuordnen. **Prüfen:** Das Feld `detail` der Log-Zeile enthält die Originalmeldung des Mailservers. ### Zusätzliche Fehlerquelle im Log Shopware protokolliert Versandfehler unabhängig vom Plugin. Diese Zeilen enthalten die unbereinigte Originalmeldung: ```bash grep -a "Could not send mail with error message" var/log/*.log | tail -20 ``` {% hint style="danger" %} Diese Zeilen können Hostnamen und E-Mail-Adressen enthalten. Vor der Weitergabe an Dritte prüfen. {% endhint %} ### Hinweis zur Zuordnung Die Zuordnung erfolgt anhand der Klartextmeldung des Mailservers, nicht allein anhand der SMTP-Nummer: Der Code 550 steht je nach Server sowohl für eine abgelehnte Absender- als auch für eine abgelehnte Empfängeradresse. Formuliert ein Mailserver seine Antwort ungewöhnlich, kann die Meldung als `PXF-MAIL-199` eingestuft werden. Das Feld `detail` enthält in diesem Fall den Originaltext. # Blog für Shopware 6 Mit unserem Plugin "Blog für Shopware 6" fügen Sie Ihren Online Shop einen Blog zu.
Folgende Vorteile bietet unser Plugin:
* Einfaches Erstellen von Blog Kategorien und Beiträgen * EInfügen von SEO Urls, META Daten die dazu beitragen die SEO Ihres Onlineshops erheblich zu verbessern * ständige Updates und Hinzufügen von Features (siehe auch unsere anderen Plugins) * Export und Import der Daten mittels Shopware Import/Export # Systemvoraussetzungen * Shopware Version min. 6.5.5.0 * PHP 8.1 # Plugin Konfiguration ### Plugin Konfigurationseinstellungen {% hint style="danger" %} Wichtige Info: Das Plugin erstellt bei der Installation einen Medien Ordner "Blog Images) Dieser sollte nicht gelöscht werden {% endhint %}
**CMS Seite für Blog Startseite:** Festlegen einer Erlebniswelt die auf der Startseite des Blogs angezeigt wird **Der Startseitentext ihres Blogs** Sofern SIe keine Erlebniswelt einstellen, wird der Text den Sie hier eingeben angezeigt **Einträge pro Seite:** Geben Sie ein, wieviel Einträge pro Seite im Frontend angezeigt werden sollen **Anzeige der Blog's im Artikel:** Festlegen ob die Blogs angezeigt werden sollen, die mit dem Artikel verknüpft sind **Anzeige der Blog's im Artikel** Anzeigen / Nicht Anzeigen der Blog Artikel beim Produkt **Sortierung der Blog Einträge** Sortierung der EInträge im Frontend **Wie sollen Erlebniswelten geladen werden?** Position der Erlebniswelten festlegen oder alleine anzeigen lassen **Aktivieren der Vorherigen und Nächste Seite Funktion (Experimentiell)** Vorherige oder Nachfolgende Blog Artikel anzeigen ### EInstellen des Blogs im Frontend Um den Blog im Frontend anzeigen zu lassen, müssen Sie eine Shopware 6 Kategorie erstellen und als Kategorien Typ "Link" einstellen. Tragen Sie dann wie auf dem Screen zu sehen, dann als Linkziel "blog" oder "blog/" ein. (Bitte testen)
### Social Media Icons (Shariff Funktion von Heise ) **Aktivieren der Funktion** Aktiviert die Social Media Funktion **Aktivieren der Shariff Social Media Funktion wenn ein CMS Layout eingebunden ist** Sofern ein Blog Beitrag ein Layout enthält, werden unterhalb dessen dann die Social Media Icons angezeigt **Button Style:** Hier haben Sie drei Möglichkeiten die Icons anzuzeigen **Shariff Theme:** Weiss, Grau oder Standard **Ausrichtung:** Vertikal oder Horizontal **Position:** Bestimmen an welcher Stelle die Icons angezeigt werden. Über oder Unter der Beschreibung, Rechts in der Box unterhalb der Kategorien. Je nach Design ist die Positionierung immer unteschiedlich \
# Installation / Updates ### Installation Wir empfehlen Updates im Vorfeld immer in einer Entwicklungsumgebung in einem Unterverzeichnis des Shops zu testen z.B. Ihredomain.de /dev/. \ \ Die Installation des Plugins geschieht wie bei allen anderen Plugins, über den Administrationsbereich Ihres Shops, unter Erweiterungen > Store. Suchen Sie dann nach "**Blog für Shopware 6**". Klicken Sie dann auf den Eintrag und im darauf folgenden Fenster dann auf "Erweiterung hinzufügen".\ \ Sie können das Plugin auch über den Store von Shopware erwerben. ### Aktualisierung des Plugins 1\. Entpacken Sie die Zip des Plugins und laden Sie dann den Inhalt des Ordners PixelForms in das Verzeichnis custom/plugins/PixelForms und dessen Inhalt überschreiben (Vorher Sicherung anlegen) 2\. Melden Sie sich im Backend an\ 3\. Öffnen Sie den Pluginmanager unter Erweiterungen > Meine Erweiterungen\ 4\. Beim Eintrag des Plugins "Blog **für Shopware 6**" sollte dann neben dem Eintrag der Versionsnummer, ein Link "Aktualisierung" angezeigt werden. \ 5\. Klicken Sie auf diesen Link um das Update des Plugins zu starten. Es kann einige Zeit dauern bis das Plugin aktualisiert wird, daher nicht die Seite verlassen. \ \ Mehr Informationen zur Installation und Aktualisierung von Erweiterungen bei Shopware 6, finden Sie unter\ \ [Zur Shopware 6 Dokumentation](https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen) Bei Problemen oder Fehlern, können Sie sich jederzeit an uns wenden. Um Fehler zu analysieren und zu beheben, senden Sie uns FTP sowie Backend Zugang zu (Gegebenenfalls PHPMYADMIN Zugang um eventuell das Plugin per Datenbankbefehl zu deaktivieren).\ \ **Hinweis:** Bitte deinstallieren Sie das Plugin vor dem Entfernen immer über den Plugin-Manager. Ein direktes Löschen (z. B. per FTP oder „kündigen und entfernen“) kann zu Fehlern oder verbleibenden Systemeinträgen führen. # Pluginmenu Nach der Installation und Aktivierung des Plugins, müssen Sie den Cache sowie die Themes des Shops neu kompilieren.

 Nach Neuladen des Browserfenster, finden Sie unter dem Menüpunkt „Inhalte“ zusätzliche Menüpunkte auf die später näher eingegangen wird.


# Blog Kategorien Unter diesen Menüpunkt können Sie Blog Kategorien erstellen. \ \ Diesen Kategorien können Sie dann Blog Einträge unterordnen.
Wenn Sie auf "Erstellen" klicken, können Sie eine neue Kategorie hinzufügen {% hint style="danger" %} Wichtige Info:
1. Füllen Sie Felder wie Titel, Sub Headline, Beschreibung, SEO aus. Ohne diese Felder wird eine Blog Kategorie nicht korrekt im Frontend angezeigt. 2. keine Subkategorien möglich {% endhint %}
**Titel:** Name der Kategorie **Sub Headline:** Untertitel der Kategorie **Beschreibung** Beschreibung der Kategorie
**Aktiv:** Aktivieren der Kategorie **Seo Url:** Unter dem Tab Seo, können Sie SEO spezifische Einstellungen vornehmen.\ Darüber hinaus eine spezifische SEO Url festlegen. {% hint style="info" %} Generell werden SEO Urls der Blog Kategorien sowie Einträgen über Einstellungen > Seo generiert. Sollten Sie hier aber eine SEO Url festlegen, wird diese als SEO Url genommen.\ Achten Sie darauf eine korrekte SEO Url einzugeben. \ {% endhint %} **Position:** Sortierreihenfolge **Bildgröße:** Diese Einstellung ist für die Kategorien templates Parallax, Cover und Bild und Text **Maximale Höhe** Diese Einstellung ist für die Kategorien templates Parallax, Cover und Bild und Text **Eigene CSS:** Sofern Sie das Aussehen der Blogkategorie verändern möchten und dabei auf eigene CSS Klassen zurückgreifen möchten, können Sie hier eine CSS Klasse angeben **Kategorie Teaser:** Hochladen eines Teasers ( Parallax, Cover und Bild und Text )
**Template für die Kategorien Infos:** Hier können Sie unter unterschiedlichen Templates das Erscheinungsbild jeder Kategorie beeinflussen ( Parallax, Cover und Bild und Text benötigen ein Teaser Bild )\ Die Templates werden durch uns stetig erweitert **Template für das Listing** Hier können Sie unter unterschiedlichen Templates das Erscheinungsbild der Blog Einträge jeder Kategorie beeinflussen.\ Die Templates werden durch uns stetig erweitert **Styles für das Listing** **Button Typ:**\ \ Legen Sie fest, welche Farbe der Button des Blog Beitrags haben soll. Unter finden Sie eine Übersicht der Farben\ \ **Button Größe** Unter / Size finden Sie Informationen dazu **Bild Animation:** Hierbei können Sie einstellen dass das Bild des Blog Beitrags, eine Animation haben soll. Wählen Sie dann eine Animation aus der Liste
**Sichtbarkeit:** Legen Sie fest, in welchen Verkaufskanal die Kategorie angezeigt werden soll {% hint style="warning" %} Es ist wichtig einem Blog Eintrag, einen Verkaufskanal zuzuweisen, sonst wird der Eintrag im Frontend angezeigt {% endhint %} **SEO-Urls und SEO:** SEO EInstellungen {% hint style="info" %} Wichtige Info: Wenn beim Speichern, "Fehler Ein Fehler ist aufgetreten." erscheint, dann liegt es daran das wichtige Felder nicht ausgewählt oder ausgefüllt sind, zum Beispiel "Position". Scrollen Sie daher runter und prüfen Sie nach ob irgendwelche Felder "Rosa" markiert sind ![](https://2061240942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2bDXNnc5DRWPvagpuhf1%2Fuploads%2FpILra9fmbDogpUkRhCqs%2Fimage.png?alt=media\&token=d34d322e-134d-47cc-8283-cc81a9a8496e) {% endhint %}
--- [Next Page](/llms-full.txt/1)