# Changelog
Source: https://docs.dreizack-medien.de/CLP-Gefahrenhinweise/changelog
Alle Updates und Änderungen für CLP Gefahrenhinweise
### Features
* **Eigene CLP-Kodierungen:** Du kannst eigene Codes anlegen, die sich am Artikel wie die fest hinterlegten verhalten – mit Satztext je Sprache und Platzhaltern, Signalwort, Piktogrammen aus dem GHS-Set und Kategorie. Neu ist die vierte Kategorie „Weitere Hinweise" mit eigenem Ausgabeblock. Die Texte überleben ein Plugin-Update; im Admin gibt es einen Reparatur-Knopf, der sie bei Bedarf neu schreibt
* **Gefahrenhinweise in QuickView und QuickBuy.** Wer über QuickBuy kauft, sieht die Artikelseite nie – die Hinweise fehlten dort. Je ein Schalter für QuickView und QuickBuy, Darstellung als Container oder Akkordeon, Piktogramm-Höhe einstellbar. Beide Schalter sind nach dem Update aus. Braucht NIU Plus ab der 57x-Linie
* **H222 und H229** ergänzt, mit Piktogramm
* **Neue Admin-Oberfläche** mit Dark Mode
### Verbesserungen
* Kompatibilität mit JTL-Shop 5.8
### Bugfixes
* Artikel, deren Sätze ausschließlich das Signalwort „Achtung" tragen (zum Beispiel H319), zeigten im Frontend „Gefahr"
* Unter NIU Plus wurden die Hinweise doppelt ausgegeben, wenn Custom Box und Injection beide aktiv waren. Der Schalter „Ich verwende NIU Plus" ist entfallen, das Plugin erkennt selbst, ob im Companion eine CLP-Box eingerichtet ist
* Platzhalterwerte werden jetzt escaped; ein Satztext mit mehreren Platzhaltern riss die Artikelseite nicht mehr ab
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
* Das Update bringt eine Datenbank-Migration und neue Sprachvariablen mit; die Sprachvariablen eigener Kodierungen werden nach dem Update automatisch neu geschrieben
* Die Mindestversion des Shops steigt von 5.3.3 auf 5.5.0
### Kompatibilität
* JTL-Shop ab 5.5.0
* PHP 8.2 - 8.5
* Benötigt mindestens DZM Resources & Health 1.11.17
### Neue Features
* Automatische Ausgabe von H-, P- und EUH-Sätzen
* GHS-Symbole und Signalworte
* Inhaltsstoffe-Pflege
* Sprachvariablen für alle Sätze
* NIU Plus Integration und Custom Template Support
### Kompatibilität
* JTL-Shop 5
# Datenpflege
Source: https://docs.dreizack-medien.de/CLP-Gefahrenhinweise/datenpflege
So pflegst du H-, P- und EUH-Sätze sowie Inhaltsstoffe an deinen Produkten
## Sätze pflegen
Eine vollständige Übersicht aller verfügbaren H-, P- und EUH-Codes findest du in der [Referenz](/CLP-Gefahrenhinweise/referenz).
Lege ein Funktionsattribut vom Typ **Freitext** mit der ID und dem Namen `dzm_clp` an
Trage die H-, P- und EUH-Sätze getrennt per **Semikolon** (`;`) am Produkt ein
### Syntax
* Sätze werden mit `;` (Semikolon) getrennt
* Bei **Kombinationen** ersetze das `+` (Plus) gegen einen `_` (Unterstrich)
```
H200
H300_H310;P308_P310;EUH201A
```
### Platzhalter-Texte
Es gibt Sätze, bei denen du die Lücken im Text füllen musst (in der [Referenz](/CLP-Gefahrenhinweise/referenz) fett markiert). Hierfür sind in den Sprachvariablen Platzhalter eingebaut.
Trage den Text per `:` (Doppelpunkt) nach dem Satz mit in die Liste ein:
```
H200:Hier ist mein Text;H300:Hier ist anderer Text
```
Du kannst einen Satz **mehrfach** in der Liste führen – er wird dann auch mehrfach ausgegeben.
Wenn du Text ergänzen bzw. variablen Text einfügen musst, nutze `%s` in der Sprachvariablen als Platzhalter und arbeite mit dem Text hinter den Hinweisen wie oben beschrieben.
### Sprachvariablen anpassen
Passe die Sprachvariablen an, damit sie auf deine Produkte passen.
Die Liste ist nach bestem Gewissen gepflegt, es liegt aber in **deiner Verantwortung**, den richtigen Wortlaut zu treffen!
***
## Inhaltsstoffe
Lege ein Funktionsattribut vom Typ **Freitext** mit der ID `dzm_clp_ingredients` an
Trage die Inhaltsstoffe getrennt per **Semikolon** (`;`) am Produkt ein
# Einführung
Source: https://docs.dreizack-medien.de/CLP-Gefahrenhinweise/einfuehrung
Erfahre, was DZM CLP ist und wie es dir die Pflege von Gefahrenhinweisen nach CLP-Verordnung erleichtert
## Was ist DZM CLP?
DZM CLP ist ein Plugin, welches dir die Pflege der Sicherheitshinweise nach CLP erleichtert. Du musst lediglich die H-, P- und EUH-Sätze in ein Attribut eintragen. Zusätzlich kannst du Inhaltsstoffe über ein Attribut pflegen.
Anhand der Sätze werden Symbol, Signalwort, Gefahrenhinweistext (bei H-Sätzen), Sicherheitshinweistext (bei P-Sätzen) und EUH-Erklärungssätze in einer übersichtlichen Liste aufgeführt.
Das Plugin bringt für alle Sätze passende Sprachvariablen mit, die du einfach über die Sprachvariablen-Verwaltung anpassen kannst, falls nötig.
## Funktionsumfang
Automatische Ausgabe der Gefahrenhinweistexte anhand der eingetragenen H-Sätze
Automatische Ausgabe der Sicherheitshinweistexte anhand der eingetragenen P-Sätze
Automatische Ausgabe der EUH-Erklärungstexte anhand der eingetragenen EUH-Sätze
Passende GHS-Symbole und Signalworte werden automatisch ermittelt und angezeigt
Pflege von Inhaltsstoffen über ein separates Funktionsattribut
Alle Texte sind über Sprachvariablen anpassbar – volle Kontrolle über den Wortlaut
## Voraussetzungen
Bevor du mit der Installation beginnst, stelle sicher, dass du Folgendes hast:
* Einen aktiven JTL Shop (Version 5)
* Administratorzugang zu deinem JTL Shop
* Das Plugin **Resources & Health** (wird vor DZM CLP installiert)
Resources & Health ist unser kostenloses Basisplugin und muss immer vor allen anderen DZM Plugins installiert werden.
# Installation
Source: https://docs.dreizack-medien.de/CLP-Gefahrenhinweise/installation
Schritt-für-Schritt Anleitung zur Installation von DZM CLP
**BEVOR DU BEGINNST**
Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
## Schnellübersicht
Stelle sicher, dass Resources & Health installiert und auf dem neuesten Stand ist
Installiere das Plugin über den Pluginmanager oder den JTL Extension Store unter "Meine Käufe"
Trage den Lizenzschlüssel in den Pluginsettings ein
Diese Installationsbeschreibung richtet sich an die Installation über unseren Store. Du kannst auch die JTL Extension Store Versionen in unserem Store herunterladen und diese manuell über den Pluginmanager installieren. Ansonsten halte dich einfach an die Installation über den Extension Store unter "Meine Käufe".
***
## Installation abgeschlossen
DZM CLP ist installiert! Als nächstes richtest du die Datenpflege für deine Produkte ein.
Weiter geht's mit der [Datenpflege](/CLP-Gefahrenhinweise/datenpflege).
# Referenz
Source: https://docs.dreizack-medien.de/CLP-Gefahrenhinweise/referenz
Vollständige Übersicht aller Symbole, Signalworte, H-Sätze, P-Sätze und EUH-Erklärungen
## Symbole
Die folgenden GHS-Symbole werden automatisch anhand der eingetragenen Sätze ermittelt und angezeigt:
## Signalworte
| Signalwort | Beschreibung |
| ----------- | --------------------------------------------- |
| **Gefahr** | Für schwerwiegendere Gefahrenkategorien |
| **Achtung** | Für weniger schwerwiegende Gefahrenkategorien |
***
## Sätze-Übersicht
| Code | Text |
| ---- | ----------------------------------------------------------------------------------------------------------------------------- |
| H200 | Instabil, explosiv |
| H201 | Explosiv, Gefahr der Massenexplosion. |
| H202 | Explosiv; große Gefahr durch Splitter, Spreng- und Wurfstücke. |
| H203 | Explosiv; Gefahr durch Feuer, Luftdruck oder Splitter, Spreng- und Wurfstücke. |
| H204 | Gefahr durch Feuer oder Splitter, Spreng- und Wurfstücke. |
| H205 | Gefahr der Massenexplosion bei Feuer. |
| H206 | Gefahr durch Feuer, Druckstoß oder Sprengstücke; erhöhte Explosionsgefahr, wenn das Desensibilisierungsmittel reduziert wird. |
| H207 | Gefahr durch Feuer oder Sprengstücke; erhöhte Explosionsgefahr, wenn das Desensibilisierungsmittel reduziert wird. |
| H208 | Gefahr durch Feuer; erhöhte Explosionsgefahr, wenn das Desensibilisierungsmittel reduziert wird. |
| H210 | Sehr empfindlich. |
| H220 | Extrem entzündbares Gas. |
| H221 | Entzündbares Gas. |
| H222 | Extrem entzündbares Aerosol. |
| H223 | Entzündbares Aerosol. |
| H224 | Flüssigkeit und Dampf extrem entzündbar. |
| H225 | Flüssigkeit und Dampf leicht entzündbar. |
| H226 | Flüssigkeit und Dampf entzündbar. |
| H228 | Entzündbarer Feststoff. |
| H229 | Behälter steht unter Druck: kann bei Erwärmung bersten. |
| H230 | Kann auch in Abwesenheit von Luft explosionsartig reagieren. |
| H231 | Kann auch in Abwesenheit von Luft bei erhöhtem Druck und/oder erhöhter Temperatur explosionsartig reagieren. |
| H232 | Kann sich bei Kontakt mit Luft spontan entzünden. |
| H240 | Erwärmung kann Explosion verursachen. |
| H241 | Erwärmung kann Brand oder Explosion verursachen. |
| H242 | Erwärmung kann Brand verursachen. |
| H250 | Entzündet sich in Berührung mit Luft von selbst. |
| H251 | Selbstentzündlich; kann in Brand geraten. |
| H252 | In großen Mengen selbstentzündlich; kann in Brand geraten. |
| H260 | In Berührung mit Wasser entstehen entzündbare Gase, die sich spontan entzünden können. |
| H261 | In Berührung mit Wasser entstehen entzündbare Gase. |
| H270 | Kann Brand verursachen oder verstärken; Oxidationsmittel. |
| H271 | Kann Brand oder Explosion verursachen; starkes Oxidationsmittel. |
| H272 | Kann Brand verstärken; Oxidationsmittel. |
| H280 | Enthält Gas unter Druck; kann bei Erwärmung explodieren. |
| H281 | Enthält tiefgekühltes Gas; kann Kälteverbrennungen oder -verletzungen verursachen. |
| H290 | Kann gegenüber Metallen korrosiv sein. |
| H300 | Lebensgefahr bei Verschlucken. |
| H301 | Giftig bei Verschlucken. |
| H302 | Gesundheitsschädlich bei Verschlucken. |
| H304 | Kann bei Verschlucken und Eindringen in die Atemwege tödlich sein. |
| H305 | Kann bei Verschlucken und Eindringen in die Atemwege gesundheitsschädlich sein. |
| H310 | Lebensgefahr bei Hautkontakt. |
| H311 | Giftig bei Hautkontakt. |
| H312 | Gesundheitsschädlich bei Hautkontakt. |
| H314 | Verursacht schwere Verätzungen der Haut und schwere Augenschäden. |
| H315 | Verursacht Hautreizungen. |
| H317 | Kann allergische Hautreaktionen verursachen. |
| H318 | Verursacht schwere Augenschäden. |
| H319 | Verursacht schwere Augenreizung. |
| H320 | Verursacht Augenreizung. |
| H330 | Lebensgefahr bei Einatmen. |
| H331 | Giftig bei Einatmen. |
| H332 | Gesundheitsschädlich bei Einatmen. |
| H333 | Kann bei Einatmen gesundheitsschädlich sein. |
| H334 | Kann bei Einatmen Allergie, asthmaartige Symptome oder Atembeschwerden verursachen. |
| H335 | Kann die Atemwege reizen. |
| H336 | Kann Schläfrigkeit und Benommenheit verursachen. |
| H340 | Kann genetische Defekte verursachen. |
| H341 | Kann vermutlich genetische Defekte verursachen. |
| H350 | Kann Krebs erzeugen. |
| H351 | Kann vermutlich Krebs erzeugen. |
| H360 | Kann die Fruchtbarkeit beeinträchtigen oder das Kind im Mutterleib schädigen. |
| H361 | Kann vermutlich die Fruchtbarkeit beeinträchtigen oder das Kind im Mutterleib schädigen. |
| H362 | Kann Säuglinge über die Muttermilch schädigen. |
| H370 | Schädigt die Organe. |
| H371 | Kann die Organe schädigen. |
| H372 | Schädigt die Organe bei längerer oder wiederholter Exposition. |
| H373 | Kann die Organe schädigen bei längerer oder wiederholter Exposition. |
| H400 | Sehr giftig für Wasserorganismen. |
| H401 | Giftig für Wasserorganismen. |
| H402 | Schädlich für Wasserorganismen. |
| H410 | Sehr giftig für Wasserorganismen mit langfristiger Wirkung. |
| H411 | Giftig für Wasserorganismen, mit langfristiger Wirkung. |
| H412 | Schädlich für Wasserorganismen, mit langfristiger Wirkung. |
| H413 | Kann für Wasserorganismen schädlich sein, mit langfristiger Wirkung. |
| H420 | Schädigt die öffentliche Gesundheit und die Umwelt durch Ozonabbau in der äußeren Atmosphäre. |
**Kombinationen:**
| Code | Text |
| -------------- | ----------------------------------------------------------------- |
| H300+H310 | Lebensgefahr bei Verschlucken oder Hautkontakt. |
| H300+H330 | Lebensgefahr bei Verschlucken oder Einatmen. |
| H310+H330 | Lebensgefahr bei Hautkontakt oder Einatmen. |
| H300+H310+H330 | Lebensgefahr bei Verschlucken, Hautkontakt oder Einatmen. |
| H301+H311 | Giftig bei Verschlucken oder Hautkontakt. |
| H301+H331 | Giftig bei Verschlucken oder Einatmen. |
| H311+H331 | Giftig bei Hautkontakt oder Einatmen. |
| H301+H311+H331 | Giftig bei Verschlucken, Hautkontakt oder Einatmen. |
| H302+H312 | Gesundheitsschädlich bei Verschlucken oder Hautkontakt. |
| H302+H332 | Gesundheitsschädlich bei Verschlucken oder Einatmen. |
| H312+H332 | Gesundheitsschädlich bei Hautkontakt oder Einatmen. |
| H302+H312+H332 | Gesundheitsschädlich bei Verschlucken, Hautkontakt oder Einatmen. |
| Code | Text |
| ---- | ---------------------------------------------------------------------------------------------------------------- |
| P101 | Ist ärztlicher Rat erforderlich, Verpackung oder Kennzeichnungsetikett bereithalten. |
| P102 | Darf nicht in die Hände von Kindern gelangen. |
| P103 | Vor Gebrauch Kennzeichnungsetikett lesen. |
| P201 | Vor Gebrauch besondere Anweisungen einholen. |
| P202 | Vor Gebrauch alle Sicherheitshinweise lesen und verstehen. |
| P210 | Von Hitze, heißen Oberflächen, Funken, offenen Flammen sowie anderen Zündquellenarten fernhalten. Nicht rauchen. |
| P211 | Nicht gegen offene Flamme oder andere Zündquelle sprühen. |
| P220 | Von Kleidung und anderen brennbaren Materialien fernhalten. |
| P221 | Erhitzen unter Einschluss und Reduzierung des Desensibilisierungsmittels vermeiden. |
| P222 | Keinen Kontakt mit Luft zulassen. |
| P223 | Keinen Kontakt mit Wasser zulassen. |
| P231 | Inhalt unter inertem Gas ... handhaben und aufbewahren. |
| P232 | Vor Feuchtigkeit schützen. |
| P233 | Behälter dicht verschlossen halten. |
| P234 | Nur in Originalverpackung aufbewahren. |
| P235 | Kühl halten. |
| P240 | Behälter und zu befüllende Anlage erden. |
| P241 | Explosionsgeschützte \[elektrische ... / Lüftungs- ... / Beleuchtungs- ... / ...] Geräte verwenden. |
| P242 | Funkenarmes Werkzeug verwenden. |
| P243 | Maßnahmen gegen elektrostatische Entladungen treffen. |
| P244 | Druckminderer frei von Fett und Öl halten. |
| P250 | Nicht schleifen / stoßen / reiben / ... |
| P251 | Nicht durchstechen oder verbrennen, auch nicht nach der Verwendung. |
| P260 | Staub / Rauch / Gas / Nebel / Dampf / Aerosol nicht einatmen. |
| P261 | Einatmen von Staub / Rauch / Gas / Nebel / Dampf / Aerosol vermeiden. |
| P262 | Nicht in die Augen, auf die Haut oder auf die Kleidung gelangen lassen. |
| P263 | Berührung während der Schwangerschaft und Stillzeit vermeiden. |
| P264 | Nach Gebrauch ... gründlich waschen. |
| P270 | Bei Gebrauch nicht essen, trinken oder rauchen. |
| P271 | Nur im Freien oder in gut belüfteten Räumen verwenden. |
| P272 | Kontaminierte Arbeitskleidung nicht außerhalb des Arbeitsplatzes tragen. |
| P273 | Freisetzung in die Umwelt vermeiden. |
| P280 | Schutzhandschuhe / Schutzkleidung / Augenschutz / Gesichtsschutz tragen. |
| P281 | Vorgeschriebene persönliche Schutzausrüstung verwenden. |
| P282 | Schutzhandschuhe mit Kälteisolierung und zusätzlich Gesichtsschild oder Augenschutz tragen. |
| P283 | Schwer entflammbare oder flammhemmende Kleidung tragen. |
| P284 | Bei unzureichender Belüftung Atemschutz tragen. |
| P285 | Bei unzureichender Belüftung Atemschutz verwenden. |
| P301 | Bei Verschlucken: |
| P302 | Bei Berührung mit der Haut: |
| P303 | Bei Berührung mit der Haut (oder dem Haar): |
| P304 | Bei Einatmen: |
| P305 | Bei Kontakt mit den Augen: |
| P306 | Bei kontaminierter Kleidung: |
| P307 | Bei Exposition oder falls betroffen: |
| P308 | Bei Exposition oder falls betroffen: Ärztlichen Rat einholen. |
| P309 | Bei Exposition oder falls betroffen: |
| P310 | Sofort Giftinformationszentrum, Arzt oder ... anrufen. |
| P311 | Giftinformationszentrum, Arzt oder ... anrufen. |
| P312 | Bei Unwohlsein Giftinformationszentrum / Arzt ... anrufen. |
| P313 | Ärztlichen Rat einholen. |
| P314 | Bei Unwohlsein ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P315 | Ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P320 | Besondere Behandlung dringend erforderlich. |
| P321 | Besondere Behandlung (siehe ... auf diesem Kennzeichnungsetikett). |
| P322 | Besondere Behandlung (siehe ... auf diesem Kennzeichnungsetikett). |
| P330 | Mund ausspülen. |
| P331 | Kein Erbrechen herbeiführen. |
| P332 | Bei Hautreizung: |
| P333 | Bei Hautreizung oder -ausschlag: |
| P334 | In kaltes Wasser tauchen (oder nassen Verband anlegen). |
| P335 | Lose Partikel von der Haut abstoßen. |
| P336 | Verschüttete Bereiche mit lauwarmem Wasser abwaschen. Betroffenen Bereich nicht reiben. |
| P337 | Eventuell vorhandene Kontaktlinsen nach Möglichkeit entfernen. Weiter ausspülen. |
| P338 | Betroffene Augenpartie ausspülen. |
| P340 | Die betroffene Person an die frische Luft bringen und für ungehinderte Atmung sorgen. |
| P341 | Bei Atembeschwerden an die frische Luft bringen und in einer Position ruhigstellen, die das Atmen erleichtert. |
| P342 | Bei Symptomen der Atemwege: |
| P350 | Behutsam mit viel Wasser und Seife waschen. |
| P351 | Einige Minuten lang behutsam mit Wasser ausspülen. |
| P352 | Mit viel Wasser / ... waschen. |
| P353 | Betroffene Hautpartien abwaschen (oder duschen). |
| P360 | Kontaminierte Kleidung und Haut sofort mit viel Wasser abwaschen und danach Kleidung ausziehen. |
| P361 | Alle kontaminierten Kleidungsstücke sofort ausziehen. |
| P362 | Kontaminierte Kleidung ausziehen. |
| P363 | Kontaminierte Kleidung vor erneutem Tragen waschen. |
| P364 | Und vor erneutem Tragen waschen. |
| P370 | Bei Brand: |
| P371 | Bei Großbrand und großen Mengen: |
| P372 | Explosionsgefahr bei Brand. |
| P373 | Keine Brandbekämpfung, wenn das Feuer explosive Stoffe / Gemische / Erzeugnisse erreicht. |
| P374 | Wegen Explosionsgefahr nicht gegen Brand ankämpfen. |
| P375 | Undichtigkeit beseitigen, wenn gefahrlos möglich. |
| P376 | Brand an undichten Stellen bekämpfen. |
| P377 | Explosionsgeschütztes Gerät benutzen. |
| P378 | Zum Löschen ... verwenden. |
| P380 | Bei Undichtigkeit alle Zündquellen entfernen. |
| P381 | Alle Zündquellen entfernen, um Materialschäden zu vermeiden. |
| P390 | Verschüttete Mengen aufnehmen. |
| P391 | Verschüttete Mengen aufnehmen. |
| P401 | Aufbewahren gemäß … |
| P402 | An einem trockenen Ort aufbewahren. |
| P403 | An einem gut belüfteten Ort aufbewahren. |
| P404 | In einem geschlossenen Behälter aufbewahren. |
| P405 | Unter Verschluss aufbewahren. |
| P406 | In korrosionsbeständigem / … Behälter mit korrosionsbeständiger Innenauskleidung aufbewahren. |
| P407 | Luftspalt zwischen Stapeln / Paletten lassen. |
| P410 | Vor Sonnenbestrahlung schützen. |
| P411 | Bei Temperaturen nicht über … °C / … °F aufbewahren. |
| P412 | Nicht Temperaturen über 50 °C / 122 °F aussetzen. |
| P413 | Schüttgut in Mengen von mehr als … kg / … lbs bei Temperaturen nicht über … °C / … °F aufbewahren. |
| P420 | Getrennt aufbewahren. |
| P501 | Inhalt / Behälter ... zuführen. |
| P502 | Informationen zur Wiederverwendung oder Wiederverwertung bei Hersteller oder Lieferant erfragen. |
| P503 | Informationen zur Entsorgung/Wiederverwertung beim Hersteller/Lieferanten/… erfragen. |
**Kombinationen:**
| Code | Text |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| P231+P232 | Inhalt unter inertem Gas/… handhaben und aufbewahren. Vor Feuchtigkeit schützen. |
| P301+P310 | Bei Verschlucken: Sofort Giftinformationszentrum, Arzt oder ... anrufen. |
| P301+P330+P331+P310 | Bei Verschlucken: Mund ausspülen. Kein Erbrechen herbeiführen. Sofort Giftinformationszentrum, Arzt oder ... anrufen. |
| P301+P312 | Bei Verschlucken: Bei Unwohlsein Giftinformationszentrum / Arzt / ... anrufen. |
| P301+P330+P331 | Bei Verschlucken: Mund ausspülen. Kein Erbrechen herbeiführen. |
| P302+P334 | Bei Berührung mit der Haut: In kaltes Wasser tauchen (oder nassen Verband anlegen). |
| P302+P353+P334 | Bei Berührung mit der Haut: Lose Partikel von der Haut abstoßen. In kaltes Wasser tauchen (oder nassen Verband anlegen). |
| P302+P362 | Bei Berührung mit der Haut: Kontaminierte Kleidung ausziehen. |
| P302+P352 | Bei Berührung mit der Haut: Mit viel Wasser / ... waschen. |
| P302+P352+P310 | Bei Berührung mit der Haut: Mit viel Wasser / ... waschen. Sofort Giftinformationszentrum, Arzt oder ... anrufen. |
| P302+P352+P312 | Bei Berührung mit der Haut: Mit viel Wasser / ... waschen. Bei Unwohlsein Giftinformationszentrum / Arzt ... anrufen. |
| P303+P361+P353 | Bei Berührung mit der Haut (oder dem Haar): Alle beschmutzten, getränkten Kleidungsstücke sofort ausziehen. Haut mit Wasser abwaschen / duschen. |
| P303+P361+P353+P315 | Bei Berührung mit der Haut (oder dem Haar): Alle beschmutzten, getränkten Kleidungsstücke sofort ausziehen. Haut mit Wasser abwaschen / duschen. Ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P304+P340 | Bei Einatmen: Die Person an die frische Luft bringen und für ungehinderte Atmung sorgen. |
| P304+P340+P310 | Bei Einatmen: Die Person an die frische Luft bringen und für ungehinderte Atmung sorgen. Sofort Giftinformationszentrum oder Arzt anrufen. |
| P304+P340+P311 | Bei Einatmen: Die Person an die frische Luft bringen und für ungehinderte Atmung sorgen. Giftinformationszentrum, Arzt oder … anrufen. |
| P305+P351+P338 | Bei Kontakt mit den Augen: Einige Minuten lang behutsam mit Wasser spülen. Eventuell vorhandene Kontaktlinsen nach Möglichkeit entfernen. Weiter spülen. |
| P305+P351+P338+P315 | Bei Kontakt mit den Augen: Einige Minuten lang behutsam mit Wasser spülen. Eventuell vorhandene Kontaktlinsen nach Möglichkeit entfernen. Weiter spülen. Sofort ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P306+P360 | Bei Kontakt mit der Kleidung: Kontaminierte Kleidung und Haut sofort mit viel Wasser abwaschen und danach Kleidung ausziehen. |
| P306+P311 | Bei Exposition oder falls betroffen: Giftinformationszentrum, Arzt oder ... anrufen. |
| P307+P310 | Bei Exposition: Sofort Giftinformationszentrum, Arzt oder … anrufen. |
| P308+P310 | Bei Exposition oder falls betroffen: Giftinformationszentrum, Arzt oder … anrufen. |
| P308+P311 | Bei Exposition oder falls betroffen: Giftinformationszentrum, Arzt oder ... anrufen. |
| P309+P310 | Bei Exposition oder Unwohlsein: Giftinformationszentrum, Arzt oder … anrufen. |
| P332+P313 | Bei Hautreizung: Ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P333+P313 | Bei Hautreizung oder -ausschlag: Ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P336+P315 | Vereiste Bereiche mit lauwarmem Wasser auftauen. Betroffenen Bereich nicht reiben. Sofort ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P337+P313 | Bei anhaltender Augenreizung: Ärztlichen Rat einholen / ärztliche Hilfe hinzuziehen. |
| P342+P311 | Bei Symptomen der Atemwege: Giftinformationszentrum, Arzt oder ... anrufen. |
| P361+P364 | Alle kontaminierten Kleidungsstücke sofort ausziehen. Und vor erneutem Tragen waschen. |
| P362+P364 | Kontaminierte Kleidung ausziehen. Und vor erneutem Tragen waschen. |
| P370+P376 | Bei Brand: Undichtigkeit beseitigen, wenn gefahrlos möglich. |
| P370+P378 | Bei Brand: ... zum Löschen ... verwenden. |
| P370+P380 | Bei Brand: Umgebung räumen. |
| P370+P380+P375 | Bei Brand: Umgebung räumen. Wegen Explosionsgefahr Brand aus der Entfernung bekämpfen. |
| P370+P380+P375+P378 | Bei Brand: Umgebung räumen. Wegen Explosionsgefahr Brand aus der Entfernung bekämpfen. ... zum Löschen verwenden. |
| P402+P404 | In einem geschlossenen Behälter an einem trockenen Ort aufbewahren. |
| P403+P233 | An einem gut belüfteten Ort aufbewahren. Behälter dicht verschlossen halten. |
| P403+P235 | An einem gut belüfteten Ort aufbewahren. Kühl halten. |
| P410+P403 | Vor Sonnenbestrahlung schützen. An einem gut belüfteten Ort aufbewahren. |
| P410+P412 | Vor Sonnenbestrahlung schützen. Nicht Temperaturen über 50 °C / 122 °F aussetzen. |
| Code | Text |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| EUH001 | In trockenem Zustand explosiv. |
| EUH006 | Mit und ohne Luft explosionsfähig. |
| EUH014 | Reagiert heftig mit Wasser. |
| EUH018 | Kann bei Verwendung explosionsfähige / entzündbare Dampf/Luft-Gemische bilden. |
| EUH019 | Kann explosionsfähige Peroxide bilden. |
| EUH029 | Entwickelt bei Berührung mit Wasser giftige Gase. |
| EUH031 | Entwickelt bei Berührung mit Säure giftige Gase. |
| EUH032 | Entwickelt bei Berührung mit Säure sehr giftige Gase. |
| EUH044 | Explosionsgefahr bei Erhitzen unter Einschluss. |
| EUH059 | Die Ozonschicht schädigend. |
| EUH066 | Wiederholter Kontakt kann zu spröder oder rissiger Haut führen. |
| EUH070 | Giftig bei Berührung mit den Augen. |
| EUH071 | Wirkt ätzend auf die Atemwege. |
| EUH201 | Enthält Blei. Nicht für den Anstrich von Gegenständen verwenden, die von Kindern gekaut oder gelutscht werden könnten. |
| EUH201A | Achtung! Enthält Blei. |
| EUH202 | Cyanacrylat. Gefahr. Klebt innerhalb von Sekunden Haut und Augenlider zusammen. Darf nicht in die Hände von Kindern gelangen. |
| EUH203 | Enthält Chrom(VI). Kann allergische Reaktionen hervorrufen. |
| EUH204 | Enthält Isocyanate. Kann allergische Reaktionen hervorrufen. |
| EUH205 | Enthält epoxidhaltige Verbindungen. Kann allergische Reaktionen hervorrufen. |
| EUH206 | Achtung! Nicht zusammen mit anderen Produkten verwenden, da gefährliche Gase (Chlor) freigesetzt werden können. |
| EUH207 | Achtung! Enthält Cadmium. Bei der Verwendung entstehen gefährliche Dämpfe. Hinweise des Herstellers beachten. Sicherheitsanweisungen einhalten. |
| EUH208 | Enthält (Name des sensibilisierenden Stoffes). Kann allergische Reaktionen hervorrufen. |
| EUH209 | Kann bei Verwendung leicht entzündbar werden. |
| EUH209A | Kann bei Verwendung entzündbar werden. |
| EUH210 | Sicherheitsdatenblatt auf Anfrage erhältlich. |
| EUH211 | Achtung! Beim Sprühen können gefährliche lungengängige Tröpfchen entstehen. Aerosol oder Nebel nicht einatmen. |
| EUH212 | Achtung! Bei der Verwendung kann gefährlicher lungengängiger Staub entstehen. Staub nicht einatmen. |
| EUH380 | Kann beim Menschen endokrine Störungen verursachen. |
| EUH381 | Steht in dem Verdacht, beim Menschen endokrine Störungen zu verursachen. |
| EUH401 | Zur Vermeidung von Risiken für Mensch und Umwelt die Gebrauchsanleitung einhalten. |
| EUH430 | Kann endokrine Störungen in der Umwelt verursachen. |
| EUH431 | Steht in dem Verdacht, endokrine Störungen in der Umwelt zu verursachen. |
| EUH440 | Reichert sich in der Umwelt und in lebenden Organismen, einschließlich Menschen, an. |
| EUH441 | Reichert sich stark in der Umwelt und in lebenden Organismen, einschließlich Menschen, an. |
| EUH450 | Kann lang anhaltende und diffuse Verschmutzung von Wasserressourcen verursachen. |
| EUH451 | Kann sehr lang anhaltende und diffuse Verschmutzung von Wasserressourcen verursachen. |
# Template-Einrichtung
Source: https://docs.dreizack-medien.de/CLP-Gefahrenhinweise/template-einrichtung
So richtest du die Anzeige der CLP-Hinweise in deinem Template ein
## Template konfigurieren
Wenn du **NIU Plus** verwendest, musst du lediglich die **Custom Box "CLP Hinweise"** in den Einstellungen zu den Produktdetails ergänzen.
Das war's – NIU Plus übernimmt die Darstellung automatisch.
Für alle anderen Templates gehe wie folgt vor:
Deaktiviere in den Plugineinstellungen die Option **"Ich verwende NIU Plus"**
Wähle einen geeigneten CSS-Selektor aus, wo die Hinweise injiziert werden sollen
### Custom Template verwenden
Du kannst auch ein ganz eigenes Template verwenden:
Nutze die Vorlage unter:
```
plugins/dzm_clp/frontend/injections/clp_content_custom.ini.tpl
```
Baue dir hier dein Template wie du es benötigst
Entferne das `.ini` aus dem Dateinamen, sodass die Datei `clp_content_custom.tpl` heißt
Nun wird das Custom TPL File verwendet
# AI-Feed
Source: https://docs.dreizack-medien.de/DZM-Agentic-Plus/ai-feed
Produkt-Feed für KI- und Shopping-Agenten
## AI-Feed (/feed.jsonl)
Ein schlanker Produkt-Feed als JSONL (eine Zeile pro Produkt, ACP-/Google-Merchant-nah) für KI-/Shopping-Agenten, die den ganzen Katalog kompakt einlesen. Paginiert über `?offset` & `?limit`; nutzt dieselben Preise/Sichtbarkeit wie der Shop.
Wenn deaktiviert, liefert `/feed.jsonl` einen 404-Fehler.
Link zu `/feed.jsonl`. Änderung erst speichern, dann öffnen.
# Changelog
Source: https://docs.dreizack-medien.de/DZM-Agentic-Plus/changelog
Alle Updates und Änderungen für DZM Agentic Plus
### Features
* KI-Lesbarkeit: Die Maschinen-Endpunkte (.md und .json) liefern wahlweise text/plain oder ihren nativen Content-Type, mit bereinigten Antwort-Headern (nachgetragen aus 1.0.2)
### Verbesserungen
* Kompatibilität mit JTL-Shop 5.8 bis 5.8.1
### Bugfixes
* Die mitgelieferte robots.txt-Vorlage sperrte KI-Agenten aus, obwohl das Plugin sie einladen soll (nachgetragen aus 1.0.3)
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.0 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Bugfix
* Plugin-Titel korrigiert
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.9
### Erstveröffentlichung
* Maschinenlesbare Ausgabe jeder Seite als Markdown (`.md`) und als schema.org-JSON-LD (`.json`), einfach als Endung an die bestehende URL angehängt. Unterstützt werden Produkte, Kategorien, Content-Seiten, Blogbeiträge, die Blog-Übersicht und die Startseite
* Preise, Verfügbarkeit, Varianten, Kategorien und Sichtbarkeit kommen unverändert aus dem Shop, inklusive Netto- oder Bruttodarstellung je Kundengruppe, Preisspanne bei Vaterartikeln und „Preis auf Anfrage"
* Inhalte aus dem OnPageComposer werden mit ausgegeben, sodass auch im OPC gebaute Landingpages vollständig lesbar sind
* Kuratierbare `llms.txt` mit Eckdaten, empfohlenen Produkten, wichtigen Seiten, FAQ und AI-Usage-Policy, komplett im Backend redigierbar und bei jedem Abruf live erzeugt
* Ausführliche `llms-full.txt` mit eingebetteten Volltexten von Content-Seiten, Rechtstexten und Top-Produkten
* Read-only MCP-Server unter `/mcp` mit fünf Werkzeugen: Produktsuche, Produktdetails, Kategorien auflisten, Kategoriedetails und Content-Seiten. Direkt als Connector in Claude oder ChatGPT einbindbar, auf Wunsch mit Token-Schutz
* AI-Produkt-Feed unter `/feed.jsonl`, paginiert, mit denselben Preisen und Sichtbarkeiten wie der Shop
* Automatische Auffindbarkeit über einen HTTP-Link-Header auf jeder Seite, Verweise im Seitenkopf, den Spiegel `/.well-known/llms.txt` und einen fertigen robots.txt-Baustein zum Kopieren
* Jeder Ausgabeweg lässt sich einzeln abschalten, dazu ein Projektions-Cache für Shops mit hoher Crawler-Last
* WebMCP als experimentelle Vorbereitung für Browser-Agenten, standardmäßig deaktiviert
* Durchgehend read-only: keine Schreibzugriffe, keine personenbezogenen Daten, keine Template-Anpassung nötig
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.9
# Einführung
Source: https://docs.dreizack-medien.de/DZM-Agentic-Plus/einfuehrung
Was DZM Agentic Plus macht und wofür du es brauchst
**DZM Agentic Plus** macht deinen JTL-Shop für KI-Agenten lesbar und nutzbar, von Chatbots wie ChatGPT und Claude über Shopping-Agenten bis hin zu klassischen KI-Crawlern. Immer mehr Menschen suchen Produkte nicht mehr über Google, sondern lassen sich direkt von einer KI beraten, und die KI entscheidet dann, welcher Shop empfohlen wird. Agentic Plus sorgt dafür, dass deine Produkte dabei überhaupt erst gefunden und richtig verstanden werden.
Im JTL-Backend erscheint das Plugin unter dem Namen **DZM Agent Ready**.
**Kein offizieller Standard, noch nicht.** Die hier verwendeten Formate, allen voran `llms.txt`, sind aktuell (Stand Mitte 2026) Vorschläge aus der Community und kein offizieller Industriestandard, ähnlich wie es die `robots.txt` früher einmal war. Das kann sich mit der Zeit ändern, muss es aber nicht. Schon heute lesen viele KI-Agenten diese Formate und honorieren sie. Vorbereitet zu sein schadet also in jedem Fall nicht.
## Video: So funktioniert DZM Agentic Plus
## Warum das nötig ist
KI-Agenten arbeiten token-basiert, jedes eingelesene Bisschen kostet sie quasi bares Geld. Der Quelltext einer normalen Shopseite besteht aber größtenteils aus Skripten, Stylesheets und Layout und nur zu einem kleinen Teil aus eigentlichem Inhalt. Eine saubere Seitenstruktur mit sinnvollen Überschriften (Stichwort SEO) hilft der KI zwar ein Stück weit, ändert am Grundproblem aber wenig: HTML ist für Menschen gebaut, nicht für Maschinen. Genau hier setzt Agentic Plus an.
## Was das Plugin bietet
* **Maschinenlesbare Formate (Markdown & JSON-LD)**: Jede Produkt-, Kategorie-, CMS- und Blogseite steht zusätzlich als token-effizientes Markdown (`.md`) und als strukturiertes JSON-LD (`.json`) zur Verfügung. Du hängst einfach die Endung an eine bestehende Seiten-URL an, Agentic Plus erzeugt die Version live, ganz ohne Template-Anpassung. Über Alternate-Links im Seitenkopf und einen HTTP-Link-Header weiß die KI sogar schon vor dem Laden der Seite, dass es diese sparsamere Version gibt.
* **AI-Feed (`/feed.jsonl`)**: Ein schlanker Produkt-Feed, eine Zeile pro Produkt, im selben Grundprinzip wie ein Google-Shopping-Feed. Er nutzt dieselben Preise und Sichtbarkeiten wie dein Shop, ist paginiert und lässt KI- und Shopping-Agenten deinen gesamten Katalog auf einen Blick erfassen.
* **llms.txt**: Das Gegenstück zur `robots.txt`, nur dass du der KI hier nicht nur sagst, was sie darf, sondern ihr direkt Inhalte mitgibst: Eckdaten, empfohlene Produkte, wichtige Seiten, FAQ und eine AI-Usage-Policy. Sie wird bei jedem Abruf live neu erzeugt, ist also immer aktuell, und füllt sich größtenteils automatisch aus deinen Shop-Daten. Für noch mehr Detailtiefe gibt es zusätzlich die ausführlichere `llms-full.txt`.
Die AI-Usage-Policy ist eine Absichtserklärung, keine technische Sperre: ein Schild an der Tür, kein Schloss.
* **MCP-Server**: Ein read-only Model-Context-Protocol-Server unter `/mcp`, den du direkt als Connector in Claude oder ChatGPT hinterlegen kannst, für Live-Zugriff auf Produkte, Kategorien und Seiten deines Shops in Echtzeit. Die KI kann dabei ausschließlich lesen: nichts kaufen, nichts ändern, keine Kundendaten.
* **WebMCP (experimentell)**: Ein zusätzlicher, noch sehr junger Standard, an dem aktuell u. a. Google arbeitet (in Chrome bislang nur hinter einem Feature-Flag). Er würde Browser-Agenten erlauben, deinen Shop aktiv zu bedienen, selbst suchen, Artikel in den Warenkorb legen und mehr. Der Schalter dafür ist bereits vorbereitet und standardmäßig deaktiviert, da es sich noch um kein fertiges Kundenfeature handelt.
Der eigentliche Nutzen von Agentic Plus ist unspektakulär, aber wirkungsvoll: Dein Shop wird automatisch für KI lesbar, auffindbar und abfragbar, ohne dass du dein Template anfasst oder etwas zusätzlich pflegen musst.
# Grundeinstellungen
Source: https://docs.dreizack-medien.de/DZM-Agentic-Plus/grundeinstellungen
Maschinenlesbare Formate und Performance-Einstellungen
## Maschinenlesbare Formate
Deine Seiten (Produkt, Kategorie, CMS, Blog) werden zusätzlich zur normalen HTML-Ausgabe an derselben Seiten-URL als `.md` und `.json` ausgeliefert. Deaktivierte Formate werden weder ausgeliefert (dann nur normales HTML) noch in den Signposts (HTTP-Link-Header) beworben.
Token-effizientes Markdown je Seite (Produkt/Kategorie/CMS/Blog).
schema.org-JSON-LD (Product/CollectionPage/... + WebSite/SearchAction).
Artikel mit Preis 0 € (gratis/Demo) werden ohne Preis ausgeliefert – zusätzlich zur Shop-Einstellung. Vaterartikel mit Preisspanne (AggregateOffer) bleiben unberührt.
Bei Vaterartikeln mit Gratis-Variante wird die Untergrenze auf den kleinsten Preis > 0 gesetzt – z. B. „895 – 2595 €" statt „0 – 2595 €".
## Performance
Caching der `.md`/`.json`-Ausgaben. Bei häufigen Crawler-/Agenten-Zugriffen spart das die aufwändige Neuberechnung je Seite.
`0` = aus. Empfehlung: `30`. Produkt- und Kategorie-Änderungen invalidieren den Cache sofort (Zeitstempel im Schlüssel); nur Lagerbestand/Verfügbarkeit können bis zum Ablauf der Dauer verzögert sein.
# llms.txt
Source: https://docs.dreizack-medien.de/DZM-Agentic-Plus/llms-txt
llms.txt für KI-Agenten kuratieren
Auf dieser Seite kuratierst du die `llms.txt` deines Shops – eine strukturierte Zusammenfassung speziell für KI-Agenten, die deinen Shop verstehen und zitieren sollen.
## Kopf & Zusammenfassung
Kuratierter Einstieg in die llms.txt. Leer lässt automatisch (Überschrift → Shopname, Zusammenfassung → Meta-Beschreibung) das übernehmen, was den Agent zuerst interessiert.
Erscheint als `#` ganz oben. Leer = Shopname (automatisch).
Blockzitat direkt unter der Überschrift. Empfehlung: ein Satz, der DEINEN Shop beschreibt (Sortiment, Region) – das liest ein Agent zuerst. Leer = Meta-Beschreibung (automatisch).
Optionaler Freitext-Absatz für Agenten (z. B. Alleinstellungsmerkmale, Zielgruppe). Leer = weggelassen.
## Eckdaten
Kommerzielle Fakten, damit ein Agent sofort bekannt ist, ohne Versand-/Zahlungsseiten nachzuladen. Empfehlung: alles ausfüllen. Währung/Steuer/Sprachen kommen automatisch aus dem Shop.
Automatisch aus der Shop-Standardwährung.
Automatisch: „Preise inkl. MwSt" bzw. „exkl. MwSt" je nach Kundengruppe.
Automatisch (nur bei mehr als einer Shop-Sprache sinnvoll).
Kurz: Region, Kosten, Lieferzeit. Empfehlen – lässt sich nicht zuverlässig automatisch ableiten. Leer = weggelassen. Beispiel: „DE & AT, ab 4,90 €, 2–4 Werktage".
Kurz: akzeptierte Zahlungsarten. Empfehlen. Leer = weggelassen. Beispiel: „PayPal, Kreditkarte, Kauf auf Rechnung".
Kurz: Widerrufsfrist. Empfehlen. Leer = weggelassen. Beispiel: „14 Tage Widerrufsrecht".
Beliebiger eigener Hinweis, erscheint unformatiert direkt vor Stand-Datum. Leer = weggelassen. Beispiel: „Rein digitale Produkte, keine physische Lieferung."
„Stand: JJJJ-MM-TT" signalisiert Agenten die Aktualität.
## Kategorien
Top-Level-Kategorien als Linkliste (automatisch aus dem Shop).
Listet die Top-Level-Kategorien deines Shops mit Link auf.
## Empfohlene Produkte
Gibt dem Agenten sofort greifbare Produkte mit Preis. Zuerst deine manuell gewählten, danach – falls aktiviert – automatisch mit Bestsellern aufgefüllt.
Blendet den gesamten Abschnitt „Empfohlene Produkte" ein oder aus.
Füllt die Liste bis zur eingestellten Anzahl mit aktuellen Bestsellern auf (rotiert, immer aktuell).
Obergrenze der gelisteten Produkte. Empfehlung: `5`.
Per Suche auswählen – diese erscheinen zuerst, danach folgt (falls aktiviert) die Bestseller-Auffüllung. Leer = die Liste wird sonst mit Bestsellern gefüllt (falls aktiviert).
## Wichtige Seiten
Deine wichtigsten Info-/Landingpages, die ein Agent kennen sollte (z. B. Über uns, FAQ-Seite, Größenberatung).
Wähle vorhandene Shop-Seiten aus oder trage einen freien Link ein. Noch keine Seiten ausgewählt = Abschnitt weggelassen.
## Ratgeber & Inhalte
Content-/Ratgeber-Seiten, Blog, Guides – alles, was den Shop und seine Kompetenz zeigt.
Wähle vorhandene Shop-Seiten aus oder trage einen freien Link ein. Noch keine Seiten ausgewählt = Abschnitt weggelassen.
## FAQ
Eigene Frage/Antwort-Paare – für Agenten besonders wertvoll, weil sie daraus direkt zitieren können (z. B. Versandkosten, Retoure, Pflegehinweise).
Fügt ein weiteres Frage/Antwort-Paar hinzu. Noch keine Fragen hinterlegt.
## Zugriff für Agenten
Hinweise auf die maschinenlesbaren Formate. Der MCP-Server-Block steht immer dabei (sofern der MCP-Server aktiv ist).
Verweis auf die `.md`-/`.json`-Varianten und den Produkt-Feed (`/feed.jsonl`).
## Nutzung (AI-Usage-Policy)
Absichtserklärung gegenüber KI-Agenten. Die llms.txt kann Zugriff technisch nicht erzwingen – dafür ist die `robots.txt` zuständig (Snippet unten spiegelt deine Wahl).
Dürfen KI-Agenten deine Inhalte lesen und zitieren?
Dürfen deine Inhalte zum Training von KI-Modellen verwendet werden?
Sollen Agenten direkt auf Produktseiten verlinken?
Dürfen Agenten eigenständig einen Kauf abschließen?
Ergänzender Freitext, erscheint unter den Punkten. Beispiel: „Nutzung nur mit Quellenangabe."
## Sitemap
Verweis auf die `sitemap_index.xml`.
## Optional (Rechtstexte)
AGB, Datenschutz, Widerruf, Impressum ... Erscheinen als „## Optional" ganz unten – ein Agent darf sie bei Kontextknappheit überspringen.
Wähle vorhandene Rechtstexte aus oder trage einen freien Link ein. Noch keine Seiten ausgewählt.
## Ausführliche Variante & Cache
Die `llms-full.txt` bettet die kuratierten Seiten und Produktinhalte als Markdown ein.
Stellt `llms-full.txt` bereit (sonst nur ein Hinweistext).
Obergrenze der eingebetteten Produkte in der `llms-full.txt`.
`0` = kein Cache. Beim Speichern der Einstellungen wird der Cache automatisch neu erzeugt.
## Vorschau
Öffnet die generierte Ausgabe in einem neuen Tab. Änderungen erst speichern, dann aktualisieren.
Links zu `llms.txt` und `llms-full.txt`.
## robots.txt-Hinweise (optional)
Diese Zeilen in die `robots.txt` aufnehmen, damit Crawler die llms.txt finden – und deine Nutzungs-Policy technisch durchgesetzt wird. Fail-safe: kein automatisches Schreiben, einfach kopieren.
Passt sich automatisch an die Policy-Schalter oben an. Enthält Hinweise auf die `llms.txt` sowie `Disallow`-Regeln für einzelne KI-Crawler (z. B. GPTBot, Google-Extended, CCBot, ClaudeBot, anthropic-ai, Bytespider), abhängig davon ob du Lesen/Zitieren bzw. KI-Training erlaubt hast.
Nutze **Kopieren**, um das Snippet direkt in deine `robots.txt` zu übernehmen.
# MCP-Server
Source: https://docs.dreizack-medien.de/DZM-Agentic-Plus/mcp-server
Live-Zugriff für KI-Agenten per Model Context Protocol
## MCP-Server aktivieren
Schaltet den read-only MCP-Endpunkt (`/mcp`) samt Signpost-Bewerbung ein/aus.
Standard: an. Deaktiviert = `/mcp` liefert einen 404-Fehler.
## MCP-Server (Live-Zugriff für KI-Agenten)
Read-only Model-Context-Protocol-Server (JSON-RPC 2.0). Diese URL trägst du in Claude (Custom Connector) bzw. ChatGPT (Developer Mode) als Remote-MCP-Server ein.
Immer aktiv. Verfügbare Tools: `search_products`, `get_product`, `list_categories`, `get_category`, `get_page`.
## Suchspalten (search\_products)
Welche Artikelspalten die Produktsuche durchsucht. Mindestens eine sollte aktiv sein.
Durchsucht `cName`.
Durchsucht `cSuchbegriffe`.
Durchsucht `cArtNr`.
Durchsucht `cBarcode`.
Durchsucht `cKurzBeschreibung`.
Durchsucht `cBeschreibung`. Kann Rauschen erzeugen, daher standardmäßig deaktiviert.
## Zugriffsschutz (optional)
Standard: öffentlich (read-only, keine personenbezogenen Daten). Optional per Shared-Secret absichern.
Wenn aktiv, muss jede Anfrage das Secret mitsenden.
Das Shared Secret. Über **Generieren** lässt sich ein zufälliges Secret erzeugen.
Fertiger Befehl zum Kopieren (read-only). Enthält bei aktivem Token-Schutz automatisch das Secret. Beispiel:
```bash theme={null}
claude mcp add --transport http dzm-shop https://dein-shop.de/mcp
```
## WebMCP (experimentell)
Bietet Browser-Agenten (heute v.a. „Gemini in Chrome" hinter Flag) In-Page-Tools an. Sehr junger Standard – als Zukunfts-/Demo-Basis gedacht, kein produktives Kundenfeature. Standardmäßig aus.
Standard: aus.
# Start
Source: https://docs.dreizack-medien.de/DZM-Agentic-Plus/start
Übersichtsseite des Plugins im JTL-Backend
Beim Öffnen der Plugineinstellungen landest du zuerst auf der Übersichtsseite. Von hier aus gelangst du mit einem Klick zu allen Bereichen des Plugins.
Lizenzschlüssel eintragen und verwalten
Maschinenlesbare Formate (.md/.json) an- und ausschalten
Produkt-Feed (/feed.jsonl) aktivieren
llms.txt für KI-Agenten kuratieren
Suchspalten, Zugriffsschutz, Endpunkt-URL
Vollständige Dokumentation
# Changelog
Source: https://docs.dreizack-medien.de/DZM-Bonus-Plus/changelog
Alle Updates und Änderungen für DZM Bonus Plus
### Features
* Templatefreies Markup als wählbarer Skin für Einlöse-Box und Kontobilanz, für Shops mit eigenem oder fremdem Template. Standardklassen wie `form-control` und `btn` bleiben, Grid- und Kartenklassen fallen weg, die BEM-Klassen `dzm-bonus-redeem` und `dzm-bonus-account` sind der Styling-Vertrag
* Platzierung und Optik getrennt einstellbar: wo die Kontobilanz erscheint (Automatisch, Nova-Karte, NIUplus-Tab oder eigener Selektor) und wie sie aussieht (Bootstrap oder Neutral). „Automatisch" erkennt das aktive Template, Neuinstallationen starten damit
* NIU Plus Theme v2: Punkte-Snippets und Einlöse-Box folgen dem Dark Mode, das Bonus-Gold bleibt als Signalfarbe erhalten
### Verbesserungen
* Kontobilanz unter NOVA als Kachel im Konto-Raster neben Wunschzettel und Vergleichsliste, im Kartenstil der Nachbarn – statt oben vor der Begrüßung
* Einlöse-Box im Checkout: in NIUplus in voller Breite unter dem Kuponfeld statt in halber Breite, in NOVA sauber in der Bestätigungszeile. Im neutralen Skin ohne doppelte Überschrift, Eingabefeld und Knopf stehen in einer Reihe
* Backend: Farbfelder, Setup-Assistent und Navigationsleiste folgen dem Dark Mode
### Bugfixes
* Das Punkte-Badge in nachgeladenen Inhalten wie OPC-Produktstrom oder Produktberater war ungestylt und zeigte ein riesiges Icon
* Unter NIUplus stand der Bonuspunkte-Tab im Kundenkonto hinter dem Abmelden-Button
### Hinweise
* Ein NOVA-Shop, der noch nie Bonus-Einstellungen gespeichert hat, sieht nach dem Update erstmals die Kontokarte im Kundenkonto. Shops mit gespeicherten Einstellungen verhalten sich wie bisher
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.3 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Features
* Punkte-Verfall mit jährlichem Stichtag: Punkte laufen erst ihre Mindestgültigkeit und verfallen dann gesammelt zu einem festen Termin im Jahr. Eingelöst werden immer die ältesten Punkte zuerst
* Erinnerungsmail vor dem Verfall, mit mehreren Vorwarnstufen. Text und Betreff im Backend anpassbar
* Artikel von der Punktevergabe ausschließen – über Kategorien inklusive Unterkategorien und über einzelne Artikelnummern, zum Beispiel für Gutscheine
* Testmodus: das Programm im Live-Shop erproben, ohne dass Kunden etwas merken. Sichtbar nur für angemeldete Administratoren, gesammelt wird nur für eingetragene Testkunden
* Import bestehender Punktestände aus einem Altsystem per CSV, mit Vorschau vor dem Buchen und Schutz gegen doppelten Import
* Teilnehmende Kundengruppen sind jetzt im Backend auswählbar
* Einlöse-Box im Checkout frei platzierbar und in NOVA optisch integriert
### Verbesserungen
* Fremdwährungen werden korrekt angezeigt: alle Beträge erscheinen in der Standardwährung des Shops beziehungsweise in der vom Kunden gewählten Währung
* Kundenübersicht zeigt Name und E-Mail statt der internen Datenbank-ID, dazu eine Suche und einen Klick auf die Zeile, der die vollständige Punktehistorie öffnet
* Manuelle Buchung mit Kundensuche statt Eingabe einer Datenbank-ID
* Bestellnummer und Kommentar in der Liste der letzten Buchungen
* Neue Kennzahl „Bereits verfallen" in der Übersicht
* Das Kundenkonto zeigt, wie viele Punkte wann verfallen
* CSV-Export enthält Name und E-Mail je Kunde
### Bugfixes
* Die Punkte-Vorschau im Checkout rechnete auf alle Artikel im Warenkorb, auch auf ausgeschlossene. Gebucht wurde immer korrekt, angezeigt zu viel
* Der Hinweis „Du hast X Punkte erhalten" erschien auf der Danke-Seite nicht
* Ein Punkte-Verfall wurde im Kundenkonto als „Einlösung" bezeichnet
* Stornierungen zeigten in der Übersicht einen technischen Bezeichner statt „Storno"
* Die Kachel „Kunden mit Saldo" zählte anders als die Tabelle darunter
### Hinweise
* Der Punkte-Verfall ist standardmäßig ausgeschaltet – bestehende Shops ändern sich durch das Update nicht von selbst
* Für den Verfall und die Erinnerungsmail wird ein Cronjob benötigt. Er wird nicht automatisch angelegt: unter System → Cronjobs den Typ „DZM Bonus Plus: Punkte-Verfall" mit Frequenz 24 Stunden anlegen
* Beim Einschalten des Verfalls gilt eine Schutzfrist: Bestandspunkte verfallen frühestens zum ersten Stichtag nach dieser Frist
### Kompatibilität
* JTL-Shop 5.5.3 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.13
### Erstveröffentlichung
* Bonuspunkte-Gutschrift beim Kauf mit konfigurierbarer Berechnungsbasis, Rundung und Freigabezeitpunkt
* Einmal-Boni für Registrierung, Erstbestellung und Newsletter-Anmeldung
* Punkteinlösung im Checkout mit Obergrenze, Mindestschwelle und Schrittweite
* Einlösung als Entgeltminderung nach §17 UStG, steuersatz-anteilig aufgeteilt
* Revisionssichere Buchungen per Hash-Kette mit Integritätsprüfung (Zero-Config über BLOWFISH\_KEY, optional eigener Schlüssel)
* Übersicht mit Punkteschuld, Kundensalden und Buchungshistorie inkl. CSV-Export
* Manuelle Gut- und Lastschriften mit Begründungspflicht und Admin-Protokollierung
* Punkte-Anzeige im Frontend mit anpassbarer Optik, Icon, Akzentfarbe und Animation
* Bonuspunkte-Karte im Kundenkonto
* Teilnahme-Steuerung nach Kundengruppen inkl. optionaler DSGVO-Opt-in-Checkbox
### Kompatibilität
* JTL-Shop 5.5.3 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.13
### Kompatibilität mit NIU Plus
* NIU Plus Companion ab 4.10.7
* JTL-Shop 5.7.0 - 5.7.2
# Darstellung
Source: https://docs.dreizack-medien.de/DZM-Bonus-Plus/darstellung
Optik und Animation der Punkte-Anzeige im Frontend anpassen
Auf der Seite **Darstellung** legst du fest, wo und wie die erzielbaren Punkte im Shop angezeigt werden. Rechts siehst du bei jeder Änderung eine Live-Vorschau für Produktdetailseite und Artikelkarte.
## Punkte-Anzeige
Wo und für wen die erzielbaren Punkte unter dem Preis erscheinen.
Blendet die erzielbaren Punkte unter dem Preis ein (Produktdetail + Artikelkarte).
Punkte-Anzeige nur zeigen, wenn ein Kunde angemeldet ist.
Anzeige nur für angemeldete Kunden mit Programm-Teilnahme (greift nur bei aktiver Opt-in-Pflicht).
Anzeige bei Vaterartikeln mit unterschiedlichen Variantenpreisen: **Bereich anzeigen (von bis)**, **Bis zu (Maximalpreis)** oder **Auf Variantenartikeln ausblenden**.
## Optik
Aussehen der Punkte-Anzeige.
Stil der Punkte-Anzeige.
**Minimal**: dezenter Text ohne Hervorhebung.
**Badge / Pill**: fällt als abgerundetes Badge stärker auf.
**Akzent-Linie**: farbiger Text mit vertikalem Balken.
Symbol neben der Punktzahl.
**Stern**
**Münze**
**Geschenk**
**Funkeln**
**Plus**
**Kein Icon**
Farbe von Icon und Akzenten. Standard ist ein dezentes Gold, du kannst aber eine eigene Farbe passend zu deinem Shop-Design setzen.
## Animation
Bewegung der Anzeige. Alle Animationen respektieren die System-Einstellung zum Reduzieren von Bewegung.
Die Punktzahl zählt beim Sichtbarwerden von 0 hoch, nur auf der Produktdetailseite (nicht in Artikellisten). Gilt für alle Stile.
Wiederkehrender Effekt in entspanntem Abstand (zusätzlich zum Count-up).
Art des wiederkehrenden Effekts.
**Pop**: Icon pulsiert.
**Shine-Sweep**: Lichtstreif.
**Sparkle**: Funken.
# Einführung
Source: https://docs.dreizack-medien.de/DZM-Bonus-Plus/einfuehrung
Bonuspunkteprogramm für deinen JTL Shop 5: Punkte sammeln beim Kauf, einlösen im Checkout
## Was ist DZM Bonus Plus?
DZM Bonus Plus bringt ein vollständiges Bonuspunkteprogramm in deinen JTL Shop 5. Deine Kunden sammeln bei jedem Kauf Punkte, die sie später im Checkout gegen einen Rabatt einlösen können.
Bei jedem Kauf werden automatisch Punkte auf Basis des Warenwerts gutgeschrieben. Berechnungsgrundlage, Rundung und Gegenwert legst du selbst fest.
Vergib zusätzlich einmalige Punkte-Boni für bestimmte Kundenaktionen.
Kunden lösen ihre gesammelten Punkte direkt im Checkout gegen einen Rabatt ein, mit konfigurierbaren Grenzen.
Zeige die erzielbaren Punkte direkt unter dem Preis an, auf Produktdetailseite und Artikelkarte, individuell gestaltbar.
Alle Punktebuchungen werden per HMAC gegen nachträgliche Manipulation abgesichert.
## Bereiche im Plugin
Das Plugin gliedert sich in vier Bereiche:
Punkteschuld, Salden pro Kunde und die letzten Buchungen im Überblick
Gutschrift, Einmal-Boni, Einlösung, Teilnahme und Integrität konfigurieren
Optik und Animation der Punkte-Anzeige im Frontend anpassen
Trage hier deinen Lizenzschlüssel ein, wie bei allen anderen DZM Plugins.
Punktebuchungen sind rückstellungsrelevant, sobald sie wirksam werden. Die Euro-Werte in der [Übersicht](/DZM-Bonus-Plus/uebersicht) basieren auf dem gebuchten Punktwert zum Zeitpunkt der Buchung, nicht auf dem aktuellen Kurs.
# Einstellungen
Source: https://docs.dreizack-medien.de/DZM-Bonus-Plus/einstellungen
Gutschrift, Einmal-Boni, Einlösung, Teilnahme und Integrität konfigurieren
## Gutschrift
Legt fest, wie Bonuspunkte beim Kauf vergeben werden.
Punkte pro Euro Warenwert.
Ob Punkte auf den Brutto- oder Nettopreis gerechnet werden (gilt für Gutschrift und Anzeige).
Wie Punktebeträge gerundet werden (gilt für Gutschrift und Anzeige): **Abrunden**, **Kaufmännisch runden** oder **Aufrunden**.
Fester Einlösewert eines Punktes.
Nur änderbar, solange keine Punkte im Umlauf sind (Restschuld = 0). Bereits ausgegebene Punkte würden sonst rückwirkend um- oder abgewertet. Wie großzügig das Programm ist, steuerst du über das Feld **Punkte je Euro**.
Wann gutgeschriebene Punkte wirksam werden.
**Sofort**: bei Bestelleingang. **Bei Zahlungseingang / Versand**: erst wenn bezahlt bzw. versandt. **Nach Widerrufsfrist**: bei Zahlung gutgeschrieben, aber erst nach der eingestellten Frist einlösbar (empfohlen, bilanzsicher).
Pending-Fenster, bevor Punkte einlösbar werden.
Diese Option ist nur sichtbar, wenn als Freigabezeitpunkt **Nach Widerrufsfrist** gewählt ist.
Für rabattierte Artikel (Sonderpreis) keine Punkte vergeben.
## Punkte-Verfall
Punkte laufen erst ihre Mindestgültigkeit und verfallen dann gesammelt zu einem festen Stichtag im Jahr. Eingelöst werden immer die ältesten Punkte zuerst, damit Kunden so wenig wie möglich verlieren.
Aus: Punkte sind unbegrenzt gültig.
Ohne eingerichteten Cronjob wird nichts ausgebucht und der Verfall bliebe wirkungslos. Lege ihn unter **Administration → System → Cron → Queue-Eintrag erstellen** an, Typ **DZM Bonus Plus: Punkte-Verfall**, Frequenz 24 Stunden.
So lange sind Punkte auf jeden Fall gültig, gerechnet ab dem Tag der Gutschrift. Danach verfallen sie zum nächsten Stichtag.
Der jährlich wiederkehrende Tag (Tag und Monat), an dem abgelaufene Punkte ausgebucht werden. Punkte sind bis einschließlich zu diesem Tag einlösbar.
Das Modell entspricht dem, was Kunden von großen Bonusprogrammen kennen: Nicht jeder Punkt hat sein eigenes Verfallsdatum, sondern es gibt einen gemeinsamen Stichtag pro Jahr. Ein Punkt verfällt zum ersten Stichtag, der nach seiner Mindestgültigkeit liegt – die tatsächliche Laufzeit ist damit immer mindestens so lang wie eingestellt, im Schnitt ein halbes Jahr länger. Bei einem Jahr Mindestgültigkeit und Stichtag 30.09. verfallen Punkte vom 01.01.2026 am 30.09.2027, Punkte vom 01.12.2026 aber erst am 30.09.2028.
Unter **Was das konkret bedeutet** zeigt dir das Backend live eine Vorschau mit der aktuellen Einstellung, anhand derer du das Ergebnis für unterschiedliche Buchungsdaten nachvollziehen kannst.
Gilt nur für Punkte, die es beim Einschalten des Verfalls schon gibt: Sie verfallen frühestens zum ersten Stichtag nach dieser Frist, auch wenn sie rechnerisch längst abgelaufen wären.
Beim Einschalten bekommen alle Bestandspunkte ein Verfallsdatum – frühestens jedoch nach dieser Schutzfrist, damit niemand über Nacht sein Guthaben verliert. Das Datum wird pro Gutschrift beim Buchen eingefroren: Eine spätere Änderung von Frist oder Stichtag wirkt nur auf neue Punkte, nie rückwirkend.
Benachrichtigt Kunden rechtzeitig, wie viele Punkte wann verfallen.
Die Mail geht nur an Kunden, die zum jeweiligen Stichtag tatsächlich noch offene Punkte haben – bereits eingelöste Punkte werden nicht angekündigt. Jede Stufe wird pro Kunde und Stichtag genau einmal verschickt, auch wenn der Cronjob mehrmals täglich läuft.
Wann vor dem Stichtag erinnert wird. Mehrere Stufen möglich, jede Stufe wird einmal verschickt.
Ist die zugehörige E-Mail-Vorlage deaktiviert, geht keine Erinnerung raus. JTL markiert die Vorlage automatisch als fehlerhaft, wenn der Shop mehr Sprachen hat, als die Vorlage mitbringt. Text, Betreff und Aktivierung bearbeitest du unter **Administration → E-Mail → Vorlagen → Plugin-Vorlagen** in der Vorlage "Bonuspunkte verfallen bald". Anpassungen an der Vorlage überstehen ein Plugin-Update.
## Einmal-Boni
Punkte für einmalige Aktionen (0 = deaktiviert).
Punkte-Bonus bei Registrierung eines neuen Kunden.
Punkte-Bonus bei der ersten Bestellung eines Kunden.
Punkte-Bonus bei Double-Opt-in-Freischaltung des Newsletters.
## Einlösung
Regeln für das Einlösen von Punkten im Checkout.
Maximaler Anteil des Bestellwerts, der per Punkten bezahlt werden darf.
Punkte, ab denen eingelöst werden darf (0 = keine).
Einzulösende Punkte müssen ein Vielfaches davon sein.
### Checkout-Box
Wo die Einlöse-Box im Checkout erscheint.
Legt fest, wie die Einlöse-Box im Checkout platziert wird.
**Optionen:**
* **Automatisch (empfohlen):** Die Box wird an einer sinnvollen Standardposition im Checkout eingefügt, ohne dass du einen Selektor angeben musst.
* **Custom – eigener Selektor:** Du bestimmst per CSS-Selektor und Einfüge-Methode selbst, wo die Box eingefügt wird.
CSS-Selektor des Elements, relativ zu dem die Box eingefügt wird.
Nur relevant, wenn bei **Platzierung** die Option **Custom – eigener Selektor** gewählt ist.
Legt fest, wie die Box relativ zum gewählten Selektor eingefügt wird.
**Optionen:**
* **Davor (before):** Fügt die Box vor dem Element ein.
* **Danach (after):** Fügt die Box nach dem Element ein.
* **Als erstes Kind (prepend):** Fügt die Box als erstes Kindelement in das Element ein.
* **Als letztes Kind (append):** Fügt die Box als letztes Kindelement in das Element ein.
### Checkout-Hinweise
Kurze Punkte-Hinweise im Warenkorb, Checkout und auf der Bestellbestätigung.
Zeigt im Checkout die erzielbaren Punkte und auf der Danke-Seite "Du hast X Punkte erhalten" (inkl. Hinweis, wann sie gutgeschrieben werden).
Weist Kunden mit Guthaben darauf hin, dass sie Punkte am Ende des Checkouts einlösen können.
## Teilnahme
Teilnahme am Bonusprogramm.
Leer = alle Kundengruppen nehmen teil. Sonst sammeln und sehen nur Kunden der ausgewählten Gruppen Punkte.
Zur Auswahl stehen die in deinem Shop angelegten Kundengruppen (z. B. Endkunden, B2B, Händler).
Standard: aus. Alle registrierten Kunden nehmen automatisch teil (Programm in der Datenschutzerklärung abdecken). An: Kunden müssen bei der Registrierung über eine Checkbox zustimmen, bevor Punkte verarbeitet werden.
Für ein rein shop-internes Punkteprogramm ist eine separate Einwilligung meist nicht zwingend, ein Hinweis in Datenschutzerklärung/AGB genügt. Nötig wird sie, wenn Daten an Dritte fließen oder du den dokumentierten Consent-Nachweis (mit Logging) willst. Bei aktiver Pflicht brauchst du die Teilnahme-Checkbox.
Zustimmungs-Checkbox bei der Registrierung (Anzeigeort Registrierung, mit DSGVO-Logging). Nach dem Anlegen frei in der JTL-Checkboxverwaltung anpassbar (Text, Pflicht, Kundengruppen).
Sobald die Checkbox angelegt ist, zeigt das Feld **Angelegt** an.
## Kundenkonto-Bilanz
Wo die Punktebilanz im Kundenkonto des Kunden erscheint.
Legt fest, wie und wo die Punktebilanz im Kundenkonto eingebunden wird.
**Optionen:**
* **Nova – zusätzliche Karte:** Fügt eine zusätzliche Karte auf der Konto-Übersicht des Nova-Templates ein.
* **NIUplus – eigener Tab:** Fügt einen eigenen Tab in der Konto-Navigation des NIU-Plus-Templates ein.
* **Custom – eigener Selektor:** Du bestimmst per CSS-Selektor und Einfüge-Methode selbst, wo die Bilanz eingefügt wird.
CSS-Selektor des Zielelements, an dem die Bilanz eingefügt wird (z. B. `#mein-konto`).
Nur relevant, wenn bei **Anzeige-Modus** die Option **Custom – eigener Selektor** gewählt ist.
Wie relativ zum Zielelement eingefügt wird.
**Optionen:**
* **Davor (before):** Fügt die Bilanz vor dem Element ein.
* **Danach (after):** Fügt die Bilanz nach dem Element ein.
* **Als erstes Kind (prepend):** Fügt die Bilanz als erstes Kindelement in das Element ein.
* **Als letztes Kind (append):** Fügt die Bilanz als letztes Kindelement in das Element ein.
## Testmodus
Das Programm im Live-Shop erproben, ohne dass Kunden etwas davon merken.
An: Kunden sehen keine Punkte und sammeln keine. Sichtbar ist alles nur für im Backend angemeldete Admins.
Die Sichtbarkeit hängt an der Session – öffne den Shop aus dem Backend heraus (Link "Shop ansehen"), damit deine Frontend-Session als Admin erkannt wird. Ein direkt aufgerufener Shop-Tab zählt nicht.
Kundennummern, die im Testmodus wirklich Punkte sammeln und einlösen dürfen. Leer = niemand sammelt, reine Vorschau.
Gebucht wird ausschließlich für die hier eingetragenen Testkunden. Bleibt die Liste leer, ist der Testmodus eine reine Vorschau – es entsteht keine Punkteschuld in der Bilanz.
## Integrität & Sicherheit
Der Integritätsschlüssel (HMAC) sichert die Revisionssicherheit der Punktebuchungen gegen nachträgliche Manipulation.
**Zero-Config aktiv:** Der Integritätsschlüssel wird standardmäßig aus dem `BLOWFISH_KEY` abgeleitet, kein Setup nötig.
Wird der `BLOWFISH_KEY` rotiert (z. B. über `dzm_blowfish_rekey`), ist die bestehende Hash-Kette nicht mehr verifizierbar, denn der alte Schlüssel lässt sich nicht reproduzieren. Für maximale Revisionssicherheit setze einen eigenen Schlüssel.
Empfehlung: einen eigenen HMAC-Schlüssel setzen (überlebt eine BLOWFISH-Rotation). Schlüssel generieren, die zwei Zeilen in `includes/config.JTL-Shop.ini.php` einfügen (in der Regel per FTP, da die Datei meist nicht beschreibbar ist), dann den Shop-Cache leeren.
# Import
Source: https://docs.dreizack-medien.de/DZM-Bonus-Plus/import
Bestehende Punktestände per CSV in DZM Bonus Plus übernehmen
## Punktestände aus einem anderen System übernehmen
Einmaliger Start-Import. Jeder Kunde kann nur einmal importiert werden – ein zweiter Lauf mit derselben Datei bucht nichts doppelt.
Erwartet wird eine CSV mit Kopfzeile. Trennzeichen (Semikolon oder Komma) und Zeichenkodierung (UTF-8) werden automatisch erkannt.
```
kundennr;punkte;grund
K-10023;1500;Uebernahme Altsystem
K-10024;320;Uebernahme Altsystem
mail@kunde.de;80;Kulanz-Restpunkte
```
Die erste Spalte nimmt Kundennummer *oder* E-Mail – enthält der Wert ein "@", wird über die E-Mail gesucht. **grund** ist optional und wird in der Buchung mitgeführt.
Wähle über **CSV wählen** die Import-Datei mit den Spalten `kundennr`, `punkte` und optional `grund` aus.
Der Import läuft zweistufig: Vor der eigentlichen Buchung zeigt dir eine Vorschau, welche Zeilen erkannt wurden und welche Kunden zugeordnet werden konnten.
Nach der Bestätigung werden die Punkte für die gefundenen Kunden gebucht.
Jeder Kunde kann nur einmal importiert werden. Ein erneuter Import derselben Datei (oder einer Datei mit denselben Kundennummern) bucht die Punkte nicht ein zweites Mal.
# Übersicht
Source: https://docs.dreizack-medien.de/DZM-Bonus-Plus/uebersicht
Punkteschuld, Kundensalden und Buchungshistorie im Überblick
Die **Übersicht** zeigt dir jederzeit, wie viele Punkte aktuell im Umlauf sind, welchen Euro-Gegenwert sie darstellen und wer davon profitiert.
## Offene Punkteschuld
Die vier Kennzahlen oben sind rückstellungsrelevant. Die Euro-Werte basieren auf dem gebuchten Punktwert zum Zeitpunkt der Buchung, nicht auf dem aktuellen Kurs.
* **Wirksam (einlösbar)**: Punktwert, der bereits eingelöst werden kann.
* **Pending (noch nicht wirksam)**: Punktwert, der noch innerhalb der Widerrufsfrist liegt.
* **Gesamt-Schuld**: Summe aus wirksamen und pending Punkten.
* **Kunden mit Saldo**: Anzahl der Kunden mit Punkten im Umlauf.
## Saldo pro Kunde
Die aktuelle Punktebilanz je Kunde, inklusive wirksamer und pending Punkte sowie Zeitpunkt der letzten Aktivität. Ein Klick auf eine Zeile öffnet die Buchungshistorie des jeweiligen Kunden. Über **Manuelle Buchung** kannst du einem Kunden direkt Punkte gutschreiben oder abziehen.
Über das Suchfeld findest du Kunden nach Name, E-Mail oder Kundennummer.
Die Suche berücksichtigt Kundennummer, Vorname und E-Mail. Nachname und Firma liegen im Shop verschlüsselt und sind nicht durchsuchbar – dieselbe Grenze gilt auch im JTL-Backend selbst.
Die Tabelle lässt sich exportieren. Den CSV-Export findest du in der Leiste unterhalb der Tabelle.
## Letzte Buchungen
Die 50 jüngsten Ledger-Bewegungen, inklusive Kunde, Punktewert, zugehöriger Bestellnummer und Kommentar.
* **Kauf**: Punkte-Gutschrift aus einer Bestellung.
* **Einlösung**: Abzug durch Einlösen von Punkten im Checkout.
* **Manuell**: Buchung, die du selbst über **Manuelle Buchung** vorgenommen hast (siehe [Saldo pro Kunde](#saldo-pro-kunde)), inklusive deines Kommentars.
# Artikel (Artikel-Pool)
Source: https://docs.dreizack-medien.de/DZM-Email-Plus/artikel
Test-Artikel anlegen und verwalten für die E-Mail-Vorschau
Im **Artikel-Pool** verwaltest du Artikel-Fixtures für die Vorschau von Mails, die einen Artikel referenzieren – z. B. Verfügbarkeits-Benachrichtigung, Wunschliste, Produkt-Anfrage oder Artikel-Empfehlung. Du kannst entweder einen Shop-Artikel per Suche referenzieren (**Live aus Shop**) oder Demo-Daten manuell pflegen (**Dummy**).
## Übersicht
Die Tabelle listet alle angelegten Test-Artikel mit folgenden Spalten:
| Spalte | Beschreibung |
| ---------------- | -------------------------------------------------------------------------------- |
| **Label** | Frei wählbarer Name zur Identifikation (z. B. „Demo-Hauptartikel") |
| **Modus** | `Dummy` für manuell gepflegte Demo-Daten, `Live aus Shop` für echte Artikeldaten |
| **Quelle** | Name des referenzierten Artikels |
| **Shop-Version** | JTL-Shop-Version, für die dieser Artikel gedacht ist |
Mit dem **Stift-Symbol** bearbeitest du einen bestehenden Eintrag, mit dem **Papierkorb-Symbol** löschst du ihn. Über **+ Artikel anlegen** erstellst du einen neuen Eintrag.
## Artikel anlegen / bearbeiten
Beim Klick auf **+ Artikel anlegen** oder das Stift-Symbol öffnet sich das Formular. Über den Schalter **Modus** wählst du zwischen zwei Varianten:
Im Dummy-Modus pflegst du die Artikeldaten manuell. Die eingetragenen Werte werden direkt in der Vorschau verwendet.
Bezeichnung des Artikels – wird in der Übersicht und beim Auswählen von Fixtures angezeigt.
JTL-Shop-Version, für die dieser Artikel konfiguriert ist (z. B. `5.5.3`).
Name des Demo-Artikels (z. B. „Beispielartikel").
Artikelnummer des Demo-Artikels (z. B. `DEMO-001`).
URL-freundlicher Bezeichner des Artikels (z. B. `beispielartikel`).
Mengeneinheit des Artikels (z. B. `Stk.`).
Verkaufspreis inkl. MwSt. (z. B. `19,99 EUR`).
Preis exkl. MwSt. (z. B. `16,80 EUR`).
Mehrwertsteuersatz in Prozent (z. B. `19`).
Lieferzeitraum des Artikels (z. B. „3-4 Tage").
Optionaler Kurztext zum Artikel.
Im Live-Modus verlinkst du einen echten Artikel aus deinem Shop. Beim Rendern der Vorschau wird der Artikel direkt aus der Datenbank geladen – mit echten Variationen, Preisen und Bildern.
Bezeichnung des Artikels – wird in der Übersicht und beim Auswählen von Fixtures angezeigt.
JTL-Shop-Version, für die dieser Artikel konfiguriert ist (z. B. `5.5.3`).
Suche nach Artikelname oder Artikelnummer. Der gefundene Artikel wird beim Rendern via `Artikel::fuelleArtikel()` live aus der Datenbank geladen.
# Einstellungen
Source: https://docs.dreizack-medien.de/DZM-Email-Plus/einstellungen
Konfiguration und Einstellungen von DZM E-Mail Plus
## Grundkonfiguration
Alle Haupteinstellungen des Plugins.
Aktiviert oder deaktiviert das Plugin im Frontend.
Bestimmt wie das Plugin im Frontend dargestellt wird.
## Erweiterte Einstellungen
Zusätzliche Konfiguration.
Schaltet das erweiterte Feature ein.
# Empfänger (Empfänger-Pool)
Source: https://docs.dreizack-medien.de/DZM-Email-Plus/empfaenger
Test-Empfänger anlegen und verwalten für die E-Mail-Vorschau
Im **Empfänger-Pool** verwaltest du Test-Empfänger, die in der Vorschau als `$Kunde` verwendet werden. Lege verschiedene Varianten an (Privatperson, Firma, B2B etc.), um deine Templates für alle Fälle zu testen.
## Übersicht
Die Tabelle listet alle angelegten Test-Empfänger mit folgenden Spalten:
| Spalte | Beschreibung |
| ---------------- | ---------------------------------------------------------------- |
| **Label** | Frei wählbarer Name zur Identifikation (z. B. „Privat Kunde DE") |
| **Firma** | Firmenname des Test-Empfängers |
| **Name** | Vor- und Nachname |
| **E-Mail** | E-Mail-Adresse des Test-Empfängers |
| **Shop-Version** | JTL-Shop-Version, für die dieser Empfänger gedacht ist |
Mit dem **Stift-Symbol** bearbeitest du einen bestehenden Empfänger, mit dem **Papierkorb-Symbol** löschst du ihn. Über **+ Empfänger anlegen** erstellst du einen neuen Eintrag.
## Empfänger anlegen / bearbeiten
Beim Klick auf **+ Empfänger anlegen** oder das Stift-Symbol öffnet sich ein Formular mit allen Kontaktdaten des Test-Empfängers.
### Pflichtfelder
Bezeichnung des Empfängers – wird in der Übersicht und beim Auswählen von Fixtures angezeigt (z. B. „Privat-Kunde DE").
E-Mail-Adresse des Test-Empfängers.
### Weitere Felder
JTL-Shop-Version, für die dieser Empfänger konfiguriert ist (z. B. `5.5.3`).
ID der Kundengruppe im Shop (Standard: `1`).
Anrede des Empfängers (z. B. Herr, Frau).
Firmenname – relevant für B2B-Templates.
Vor- und Nachname des Empfängers.
Straße und Hausnummer der Rechnungsadresse.
Optionaler Adresszusatz (z. B. Etage, c/o).
Postleitzahl und Ort.
Bundesland und Land der Adresse (Standard: Deutschland).
Umsatzsteuer-ID – relevant für B2B-Mails.
Telefon- und Mobilnummer des Empfängers.
### Abweichende Lieferadresse
Aktivierst du den Schalter **Abweichende Lieferadresse**, erscheinen zusätzliche Felder für eine separate Lieferadresse. Diese stehen in den Templates als `$Lieferadresse` zur Verfügung.
Die Lieferadressfelder entsprechen den Rechnungsadressfeldern – mit dem Zusatz **(Liefer)**: Anrede, Firma, Vorname, Nachname, Straße, Hausnummer, Adresszusatz, PLZ, Ort, Bundesland, Land, E-Mail und Telefon.
# Kupon (Kupon-Pool)
Source: https://docs.dreizack-medien.de/DZM-Email-Plus/kupon
Test-Kupons anlegen und verwalten für die E-Mail-Vorschau
Im **Kupon-Pool** verwaltest du Coupon-Fixtures für das NewCoupon-Mailtemplate. Du kannst entweder einen echten Shop-Kupon per Suche referenzieren (**Live aus Shop**) oder Demo-Daten manuell pflegen (**Dummy**).
## Übersicht
Die Tabelle listet alle angelegten Test-Kupons mit folgenden Spalten:
| Spalte | Beschreibung |
| ---------------- | -------------------------------------------------------------------------- |
| **Label** | Frei wählbarer Name zur Identifikation (z. B. „5 Euro Festpreis Demo") |
| **Modus** | `Dummy` für manuell gepflegte Demo-Daten, `Live aus Shop` für echte Kupons |
| **Quelle** | Kupon-Code und Wert des referenzierten Kupons (z. B. `DEMO · 5 EUR`) |
| **Shop-Version** | JTL-Shop-Version, für die dieser Kupon gedacht ist |
Mit dem **Stift-Symbol** bearbeitest du einen bestehenden Eintrag, mit dem **Papierkorb-Symbol** löschst du ihn. Über **+ Kupon anlegen** erstellst du einen neuen Eintrag.
## Kupon anlegen / bearbeiten
Beim Klick auf **+ Kupon anlegen** oder das Stift-Symbol öffnet sich das Formular. Über den Schalter **Modus** wählst du zwischen zwei Varianten:
Im Dummy-Modus pflegst du alle Kupon-Daten manuell. Die eingetragenen Werte werden direkt in der Vorschau verwendet.
Bezeichnung des Kupons – wird in der Übersicht und beim Auswählen von Fixtures angezeigt.
JTL-Shop-Version, für die dieser Kupon konfiguriert ist (z. B. `5.5.3`).
Kupon-Code, der in der Mail angezeigt wird (z. B. `DEMO`).
Bezeichnung des Kupons (z. B. „Beispiel-Kupon").
Art des Kupons (z. B. Standard).
Bestimmt, wie der Kupon-Wert berechnet wird – z. B. `Festpreis (EUR)` oder Prozent.
Rabattwert des Kupons (z. B. `5,00`).
Mindestbestellwert, ab dem der Kupon einlösbar ist. `0,00 EUR` bedeutet kein Mindestbestellwert.
Wie oft ein einzelner Kunde den Kupon verwenden darf (z. B. `1`).
Maximale Gesamtanzahl an Einlösungen. `0` bedeutet unbegrenzt.
Kommaseparierte Liste der Länder, für die der Kupon als Versandkupon gilt (z. B. `DE`).
Im Live-Modus verlinkst du einen echten Kupon aus deinem Shop. Beim Rendern der Vorschau wird der Kupon direkt aus der Datenbank geladen – mit echten Werten, Gültigkeiten und Bedingungen.
Bezeichnung des Kupons – wird in der Übersicht und beim Auswählen von Fixtures angezeigt.
JTL-Shop-Version, für die dieser Kupon konfiguriert ist (z. B. `5.5.3`).
Suche nach Kupon-Name oder Code. Der gefundene Kupon wird beim Rendern via `new Kupon(kKupon, $db)` live aus der Datenbank geladen.
# Template (Mail-Vorlagen)
Source: https://docs.dreizack-medien.de/DZM-Email-Plus/templates
Übersicht und Verwaltung aller E-Mail-Vorlagen im Shop
In der Sektion **Mail-Vorlagen** findest du eine vollständige Liste aller E-Mail-Templates, die in deinem JTL Shop 5 aktiv sind – sowohl Core-Vorlagen des Shops als auch Vorlagen aus installierten Plugins.
## Übersicht
Die Tabelle zeigt dir auf einen Blick alle verfügbaren Vorlagen mit den folgenden Spalten:
| Spalte | Beschreibung |
| ---------- | ------------------------------------------------------------------------ |
| **Name** | Bezeichnung der Vorlage (z. B. „Accounterstellung durch Shopbetreiber") |
| **Modul** | Technische Modul-ID (z. B. `core_jtl_accounterstellung_durch_betreiber`) |
| **Status** | Zeigt an, ob die Vorlage aktiv ist |
## Filtern und Suchen
Du kannst die Vorlagen auf drei Arten eingrenzen:
* **Suchfeld** – Suche nach Name, Modul-ID oder Plugin
* **Alle** – zeigt sämtliche Vorlagen (Core + Plugins)
* **Core** – zeigt nur JTL-Kern-Vorlagen
* **Plugins** – zeigt nur Vorlagen aus installierten Plugins
## Vorlage bearbeiten
Klicke auf **Bearbeiten** neben einer Vorlage, um den Editor zu öffnen. Der Editor ist zweigeteilt: links bearbeitest du den Quellcode, rechts siehst du die Live-Vorschau.
### Editor (links)
Im linken Bereich bearbeitest du den Inhalt der Vorlage:
* **Betreff** – der E-Mail-Betreff, Smarty-Variablen sind möglich (z. B. `#artikel.name#`)
* **HTML-Inhalt** – der Haupt-Quellcode der Mail im HTML-Format
* **Plain-Text-Inhalt** – die Nur-Text-Variante für E-Mail-Clients ohne HTML-Unterstützung
* **HTML-Linter** – prüft den Code automatisch und meldet Probleme
In der oberen Leiste stehen folgende Aktionen zur Verfügung:
| Aktion | Funktion |
| ---------------- | ------------------------------------------------ |
| **GER** | Sprachauswahl – wechselt zwischen Shop-Sprachen |
| **Deaktivieren** | Deaktiviert die Vorlage |
| **Testmail** | Sendet eine Testmail an eine beliebige Adresse |
| **Auf Original** | Setzt die Vorlage auf den Ausgangszustand zurück |
| **Speichern** | Speichert alle Änderungen |
### Vorschau (rechts)
Die rechte Seite zeigt die gerenderte E-Mail in Echtzeit. Mit **Aktualisieren** kannst du die Vorschau manuell neu laden. Der Schalter **Auto-Preview** aktualisiert die Vorschau automatisch bei jeder Änderung.
Die Vorschau nutzt Demo-Daten, wenn keine Test-Daten ausgewählt sind. Über **ändern** kannst du echte Shop-Daten für die Vorschau wählen.
### Testmail senden
Über den Button **Testmail** in der oberen Leiste öffnet sich ein Dialog, mit dem du eine echte Test-E-Mail versenden kannst – auch mit ungespeicherten Änderungen.
Fülle die Felder aus und klicke auf **Testmail senden**:
* **E-Mail-Adresse** – die Empfängeradresse (Pflichtfeld)
* **Name** – optionaler Anzeigename des Empfängers
Die Mail wird mit den aktuell im Editor aktiven Fixture-Daten gerendert.
### Test-Daten für die Vorschau ändern
Über den Button **ändern** neben den Test-Daten in der Vorschau-Leiste wählst du echte Datensätze aus deinem Shop für die Vorschau aus.
Du kannst je nach Vorlage folgende Fixtures auswählen:
| Fixture | Variable | Relevant für |
| --------------- | --------------------------------------------------- | ----------------------------------------------- |
| **Empfänger** | `$Kunde`, `$oKunde`, `$data->tkunde` | Account- und Order-Mails |
| **Warenkorb** | `$Bestellung` mit Positionen, Steuern, Lieferschein | Order-Mails |
| **Zahlungsart** | `$Bestellung->Zahlungsart`, `Zahlungsinfo` | Order-Mails |
| **Artikel** | `$Artikel`, `$data->tartikel` | Verfügbarkeit, Wunschliste, Anfrage, Empfehlung |
| **Kupon** | `$Kupon`, `$data->tkupon` | Kupon-Mails (NewCoupon) |
Nicht ausgewählte Fixtures werden durch JTL-Standard-Demo-Daten ersetzt. Klicke auf **Fertig**, um die Auswahl zu übernehmen.
# Warenkörbe (Warenkorb-Pool)
Source: https://docs.dreizack-medien.de/DZM-Email-Plus/warenkorb
Test-Warenkörbe anlegen und verwalten für die E-Mail-Vorschau
Im **Warenkorb-Pool** verwaltest du Test-Bestellungen, die in der Vorschau als `$Bestellung` verwendet werden. Du kannst echte Shop-Artikel als Positionen wählen oder freie Demo-Positionen anlegen.
## Übersicht
Die Tabelle zeigt alle angelegten Test-Warenkörbe mit folgenden Spalten:
| Spalte | Beschreibung |
| ------------------ | --------------------------------------------------------------------- |
| **Label** | Frei wählbarer Name zur Identifikation (z. B. „3 Artikel + Tracking") |
| **Bestellnummer** | Demo-Bestellnummer (z. B. `DEMO-8072`) |
| **Positionen** | Anzahl der enthaltenen Artikel-Positionen |
| **Summe (Brutto)** | Gesamtbetrag der Bestellung inkl. MwSt. |
| **Shop-Version** | JTL-Shop-Version, für die dieser Warenkorb gedacht ist |
Mit dem **Stift-Symbol** bearbeitest du einen bestehenden Warenkorb, mit dem **Papierkorb-Symbol** löschst du ihn. Über **+ Warenkorb anlegen** erstellst du einen neuen Eintrag.
## Warenkorb anlegen / bearbeiten
Beim Klick auf **+ Warenkorb anlegen** oder das Stift-Symbol öffnet sich folgendes Formular:
### Allgemeine Felder
Bezeichnung des Warenkorbs – wird in der Übersicht und beim Auswählen von Fixtures angezeigt.
JTL-Shop-Version, für die dieser Warenkorb konfiguriert ist (z. B. `5.5.3`).
Demo-Bestellnummer, die in der Mail als Bestellreferenz erscheint (z. B. `DEMO-8072`).
Optionale Paketverfolgungs-URL – wird in Versandbestätigungs-Mails als Link verwendet.
Simuliert die Verwendung von Kundenguthaben in der Bestellung.
Gutschein-Betrag, der auf die Bestellsumme angerechnet wird.
### Positionen
Im Abschnitt **Positionen** bestimmst du, welche Artikel in der Test-Bestellung enthalten sind. Du hast zwei Möglichkeiten:
**Shop-Artikel suchen** – Suche nach einem echten Artikel aus deinem Shop. Die Artikeldaten (Name, Art.-Nr., Preis, MwSt.) werden automatisch befüllt.
**+ Freie Position** – Fügt eine leere Zeile hinzu, in der du Artikelname, Art.-Nr., Anzahl, Netto-Preis und MwSt.-Satz manuell einträgst. Das ist nützlich für Demo-Positionen ohne echten Shop-Artikel.
Jede Position enthält folgende Felder:
| Feld | Beschreibung |
| ---------------- | ------------------ |
| **Artikelname** | Name des Artikels |
| **Art.-Nr.** | Artikelnummer |
| **Anzahl** | Bestellmenge |
| **Netto / Stk.** | Netto-Einzelpreis |
| **MwSt %** | Mehrwertsteuersatz |
Über das **× Symbol** am Ende einer Zeile entfernst du die Position wieder.
Am Ende des Formulars wird die **MwSt.-Aufschlüsselung** und die **Gesamtsumme (Brutto)** automatisch berechnet und angezeigt.
# Zahlungsarten (Zahlungsart-Pool)
Source: https://docs.dreizack-medien.de/DZM-Email-Plus/zahlungsart
Test-Zahlungsarten anlegen und verwalten für die E-Mail-Vorschau
Im **Zahlungsart-Pool** verwaltest du Test-Zahlungsarten, die in der Vorschau als `$Bestellung->Zahlungsart` verwendet werden. Die `cModulId` entspricht den JTL-Konstanten und steuert in den Templates die zahlungsartspezifischen Blöcke – z. B. Bankdaten bei Vorkasse oder Lastschrift-Info bei Lastschrift.
## Übersicht
Die Tabelle listet alle angelegten Test-Zahlungsarten mit folgenden Spalten:
| Spalte | Beschreibung |
| ---------------- | ------------------------------------------------------------------ |
| **Label** | Frei wählbarer Name zur Identifikation (z. B. „Test Bank") |
| **Anzeige-Name** | Name der Zahlungsart, der in der Mail erscheint (z. B. „Vorkasse") |
| **Modul-ID** | JTL-Konstante der Zahlungsart (z. B. `za_ueberweisung_jtl`) |
| **Shop-Version** | JTL-Shop-Version, für die diese Zahlungsart gedacht ist |
Mit dem **Stift-Symbol** bearbeitest du einen bestehenden Eintrag, mit dem **Papierkorb-Symbol** löschst du ihn. Über **+ Zahlungsart anlegen** erstellst du einen neuen Eintrag.
## Zahlungsart anlegen / bearbeiten
Beim Klick auf **+ Zahlungsart anlegen** oder das Stift-Symbol öffnet sich folgendes Formular:
### Felder
Bezeichnung der Zahlungsart – wird in der Übersicht und beim Auswählen von Fixtures angezeigt.
JTL-Shop-Version, für die diese Zahlungsart konfiguriert ist (z. B. `5.5.3`).
JTL-Konstante der Zahlungsart. Steuert, welche zahlungsartspezifischen Template-Blöcke aktiv sind. Folgende Werte stehen zur Auswahl:
| Anzeigename | Modul-ID |
| ------------ | --------------------- |
| Vorkasse | `za_ueberweisung_jtl` |
| Lastschrift | `za_lastschrift_jtl` |
| Rechnung | `za_rechnung_jtl` |
| PayPal | `za_paypal_jtl` |
| Kreditkarte | `za_kreditkarte_jtl` |
| Nachnahme | `za_nachnahme_jtl` |
| Barzahlung | `za_barzahlung_jtl` |
| BillPay | `za_billpay_jtl` |
| Moneybookers | `za_moneybookers_jtl` |
Name der Zahlungsart, der in der gerenderten Mail angezeigt wird (z. B. „Vorkasse").
Zahlungstyp-Kennzahl – nur relevant wenn als Modul-ID `za_billpay_jtl` gewählt ist. Standard: `0`.
Freitext mit zahlungsartspezifischen Anweisungen, der in der Mail ausgegeben wird (z. B. Überweisungshinweis bei Vorkasse).
### Bankdaten (optional)
Die Bankdaten-Felder sind optional und werden typischerweise bei Vorkasse oder Lastschrift befüllt, damit die entsprechenden Kontodaten in der Mail erscheinen.
Name des Kontoinhabers.
Name der Bank (z. B. „Deutsche Bank").
IBAN des Bankkontos.
BIC/SWIFT-Code der Bank.
# Changelog
Source: https://docs.dreizack-medien.de/DZM-Monitoring/changelog
Alle Updates und Änderungen für DZM Monitoring
### Kompatibilität
* JTL-Shop 5.3.2 - 5.5.3
* Benötigt mindestens DZM Resources & Health 1.9.10
### Feature
* Recordsnippet: Binde ein Script (z.B. Posthog oder Hotjar) ein, das im Incidentfall aktiviert wird, um Screenrecords zur Fehleranalyse zu ermöglichen
### Kompatibilität
* Benötigt mindestens DZM Resources & Health 1.9.10
### Features
* Performance Metrics tracken: LCP, TTFB, DomContentLoaded, Hits pro Stunde und TotalLoadTime tagesaktuell und historisch tracken und pro Seitentyp auswerten, um kritische Ladeprobleme frühzeitig und nachhaltig zu erkennen
* Umfangreiche Grafiken, die dir visualisieren wo es Ladeverzögerungen gibt und wie sie sich entwickeln
* Beobachte wann deine Shopauslastung am stärksten ist, um Updates und Wartungsarbeiten besser einzuplanen und Zeitfenster zu nutzen, in denen du wenig Besucher hast
* Bestellabgleich Anomalie Notification: Lass dich benachrichtigen, sollten Bestellungen die älter sind als X Minuten noch nicht vom Worker abgeholt worden, um rechtzeitig auf Abgleichsfehler reagieren zu können
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.12
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.1
* Benötigt mindestens DZM Resources & Health 1.8.11
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.0
* Benötigt mindestens DZM Resources & Health 1.8.10
### Features
* Errornotification: Meldet, wenn ein Seitenaufruf auf einen 500er Fehler (weiße Seite) resultiert
* Checkoutnotification: Überwacht den Checkout und meldet Anomalien, wenn sich Warenkorbabbrecher ungewöhnlich oft häufen
* RageClick-Notification: Meldet, wenn Seitenbesucher durch mehrfaches Klicken auf die selbe Stelle auf Disfunktionalitäten deuten
* Notifications per Slack (eigene Integration vorausgesetzt, siehe Doku)
* Notifications per Mail
* Direktsupport durch DREIZACK Medien - Vertrag vorausgesetzt
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.9
# Checkoutdaten
Source: https://docs.dreizack-medien.de/DZM-Monitoring/checkoutdaten
Checkout Conversion Rate auswerten und beobachten
Der Tab **Checkoutdaten** zeigt dir eine Auswertung der Checkout Conversion Rate deines Shops. Die Daten werden gesammelt, sobald du in den [Einstellungen](/DZM-Monitoring/einstellungen) die Option **Checkoutdaten sammeln** aktiviert hast.
## Allgemein
Die Conversion Rate beschreibt das Verhältnis von Vorgang zu Abschluss. Die **globale Checkout Conversion Rate** beschreibt die Rate aller aufgezeichneter Checkout-Starter, die den Checkout auch abschließen. Die **aktuelle Checkout Conversion Rate** beschreibt die aktuelle Rate der letzten 24h.
## Checkout CR Historie
Das Diagramm zeigt dir die Entwicklung deiner Conversion Rate über die gesamte Aufzeichnungszeit.
Die einzelnen Linien und Bereiche im Diagramm haben folgende Bedeutung:
Zeigt die tägliche Checkout Conversion Rate als Verlaufskurve. Jeder Punkt entspricht der Rate eines einzelnen Tages.
Beschreibt die einzelnen Vorgänge – quasi Seitenbesucher im Verhältnis zu den Kaufabschlüssen.
Beschreibt den langfristigen Trend der Checkout Conversions über den gesamten Betrachtungszeitraum.
Die obere Kante des grünen Bereichs ist der Allzeit-Durchschnitt der Checkoutconversions im Betrachtungszeitraum.
Der rote Bereich markiert den Grenzbereich zur Warnmeldung, den du in den Settings eingestellt hast. Erreicht die tägliche Conversion Rate diesen Bereich, wird eine Meldung an uns abgesetzt.
Die rote Linie stellt die aktuelle Conversion Rate der letzten 24 Stunden dar.
Für eine aussagekräftige Auswertung werden mindestens **3 Tage** Datensammlung empfohlen, bevor du das Checkout Monitoring aktivierst.
# Einstellungen
Source: https://docs.dreizack-medien.de/DZM-Monitoring/einstellungen
Konfiguration und Einstellungen von DZM Monitoring
**ACHTUNG!** Bei aktivierter Monitoring Funktion werden wir unverzüglich bei einem Fehler im Shop benachrichtigt und handeln sofort. Jeder ausgelöste Incident wird als Notfallticket behandelt und entsprechend abgerechnet.
## Allgemein
Aktiviert das Monitoring global.
Aktiviert die Monitoring Funktion. Bei einem Fehler werden wir unverzüglich benachrichtigt und handeln sofort.
Beobachtet den Checkout und sammelt Daten über angefangene, abgebrochene und abgeschlossene Warenkörbe. Wenn du ausreichend Daten gesammelt hast, kannst du das Monitoring und damit die Notifications aktivieren. Unabhängig vom Monitoring kann dir die Sammlung der Checkoutdaten wichtige Erkenntnisse über die Conversion Rate in deinem Checkout vermitteln. Die gesammelten Daten kannst du im Tab Checkoutdaten einsehen, sobald diese vorliegen.
Aktiviert die Checkout Monitoring Funktion und beobachtet die Conversion Rate ab Checkout. Alarmiert uns bei Unterschreitung der durchschnittlichen Conversion Rate und sendet nähere Informationen.
Schickt eine Benachrichtigung, wenn Bestellungen länger als eine Zeit X in Minuten nicht vom Worker abgeholt wurden.
Aktiviert die RageClick Monitoring Funktion und beobachtet, ob User auf der Seite Rageclicks ausführen. Rageclick bedeutet, dass User innerhalb kurzer Zeit auf die gleiche Stelle klicken. In aller Regel ein Zeichen von Frust, weil eine erwartete Reaktion ausbleibt, ein Button nicht funktioniert oder eine Box sich nicht aufklappt.
Aktiviert die Datensammlung für Performancemetriken bei jedem Seitenaufruf. Gesammelt werden Metriken zu Largest Contentful Paint (LCP), Time to first byte (TTFB), DomContentLoaded Time (DCL) und TotalLoadTime. Im Tab Performance erhältst du bei ausreichenden Daten (min. 3 Tage werden für die Sammlung benötigt) eine Auswertung über die aktuellen Metriken des Tages im Verhältnis zu dem Durchschnitt der gesamten Aufzeichnungszeit.
## Recordsnippet
Du hast hier die Möglichkeit ein Script einzubinden, welches im Incidentfall aktiviert wird, um beispielsweise Posthog oder Hotjar Screenrecords zu ermöglichen.
Bitte beachte, dass es hier keine Zustimmung durch den Kunden gibt, wenn du mit deinem Script Sessions aufzeichnest. Die Benutzung soll ausschließlich der Fehleranalyse dienen und sollte das Script nach Beendigung von Formulardaten ausschließen. Deaktiviere das Script sofort nach Beendigung der Fehleranalyse. Dokumentiere den Vorfall.
Die Nutzung dieser Funktion erfolgt ausschließlich auf eigene Verantwortung und wird von uns ausdrücklich nicht empfohlen, da sie nicht zweifelsfrei der DSGVO entspricht.
Aktiviert das Recordsnippet ab dem Checkout.
Aktiviert das Recordsnippet automatisch, wenn ein Checkout Incident erkannt wird.
# Installation
Source: https://docs.dreizack-medien.de/DZM-Monitoring/installation
Schritt-für-Schritt Anleitung zur Installation von DZM Monitoring
## Installationsprozess
**⚠️ BEVOR DU BEGINNST**
Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
Diese Installationsbeschreibung richtet sich an die Installation über unseren Store. Du kannst auch die JTL Extension Store Versionen in unserem Store herunterladen und diese manuell über den Pluginmanager nach dieser Anleitung installieren. Ansonsten halte dich bitte einfach an die Installation über den Extension Store unter "Meine Käufe".
## Kurzanleitung
Resources & Health muss installiert sein
Installiere DZM Monitoring
Trag den Lizenzschlüssel in den Pluginsettings ein
***
### 1. Resources & Health
Lade unter [https://store.dreizack-medien.de/DZM-Resources-Health](https://store.dreizack-medien.de/DZM-Resources-Health) unser Plugin **Resources & Health**.
Achte auf die Wahl der passenden Version.
Lade die eben heruntergeladene Zipdatei über den Plugin Manager in deinen Store hoch.
Unter **Vorhanden** wählst du nun das hochgeladene Plugin aus, akzeptierst ggfs. die Lizenzbedingungen und klickst auf **Installieren**.
### 2. DZM Monitoring Lizenz buchen
1. Registriere dich in unserem Store.
2. Wähle auf der Produktdetailseite das passende Paket und die passende Kaufoption aus.
3. Trage deine Domain ein – ohne `https://` oder führendes `www.`
**Achtung!** Diese Auswahl ist nur möglich, wenn du bereits angemeldet bist. Eine Bestellung ohne Registrierung ist ausgeschlossen!
Wenn du bereits eine Demo- oder Entwicklerlizenz hast und angemeldet bist, kannst du alternativ zur Registrierung einer neuen Domain einfach unten im Dropdown deine bestehende Lizenz auswählen und in eine Vollversion umwandeln. Die passende Domain wird dann automatisch übernommen.
Domains einer produktiven Lizenz kannst du später in deinem Kundenkonto bearbeiten und ändern. Wenn du also auf einer Staging Domain gearbeitet hast, kannst du die Lizenz hier in eine Vollversion umwandeln und anschließend in deinem Kundenkonto auf die Live Domain umschreiben.
### 3. DZM Monitoring herunterladen und installieren
Kehre nach erfolgreicher Buchung auf die Produktseite zurück und lade hier die passende Version von DZM Monitoring herunter.
Lade anschließend die Zipdatei wie oben bei Resources & Health über den **Pluginmanager** in deinen Store hoch und installiere das Plugin.
### 4. Lizenz aktivieren
Wechsel in unserem Store in dein **Kundenkonto** unter **Meine Lizenzen** und kopiere dir den **Lizenzschlüssel** für deine Domain.
Unter Umständen kann es passieren, dass sich das Plugin so lange selbst deaktiviert, bis eine gültige Lizenz eingetragen wurde.
Aktiviere in diesem Fall das Plugin einfach wieder und wechsle **sofort** in die **Plugineinstellungen** und trage den Lizenzschlüssel ein. In wenigen Ausnahmefällen kann es sein, dass sich das Plugin noch ein mal selbst deaktiviert, nachdem du den Schlüssel eingetragen hast. Aber keine Sorge. Nach letztmaliger Aktivierung bleibt es auch aktiviert. Versprochen ;)
Trage deinen Lizenzschlüssel unter **Lizenz** ein und klick auf **Speichern**.
Das Plugin signalisiert dir, dass die Lizenz valide und aktiv ist.
***
### Wo finde ich die Installationsfiles?
Die Installer Pakete findest du jeweils am Produkt. In der Sidebar findest du alle veröffentlichten Versionen.
* **Achte auf die Info, ob das Plugin Resources & Health benötigt und in welcher Version**
* **Achte auf die kompatible Version**
* **Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast**
**Resources & Health ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop.** Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
### Wo finde ich die Lizenzschlüssel?
Deine Lizenzschlüssel findest du direkt nach der Buchung in deinem Kundenkonto unter **Meine Lizenzen**. Diesen Lizenzschlüssel trägst du im jeweiligen Plugin ein.
Einen Lizenzschlüssel findest du hier nur, wenn du das Produkt über unseren Store gebucht hast.
### Welche Lizenzen muss ich buchen?
Resources & Health benötigt keine Lizenz und kann direkt heruntergeladen und verwendet werden. Alle anderen Plugins benötigen eine Lizenz.
# Notifications
Source: https://docs.dreizack-medien.de/DZM-Monitoring/notifications
Mail- und Slack-Benachrichtigungen für DZM Monitoring konfigurieren
Hier kannst du festlegen, über welche Kanäle du bei einem Monitoring-Incident benachrichtigt werden möchtest. Aktuell stehen Mail- und Slack-Benachrichtigungen zur Verfügung.
## Mail Notifications
Aktiviert die E-Mail-Benachrichtigung bei einem Monitoring-Incident. Du erhältst eine Nachricht an die hinterlegte E-Mail-Adresse, sobald ein Fehler oder Alarm ausgelöst wird.
## Slack Notifications
Aktiviert die Slack-Benachrichtigung bei einem Monitoring-Incident. Voraussetzung ist eine konfigurierte Slack-Integration. Du erhältst eine Nachricht im gewählten Slack-Kanal, sobald ein Alarm ausgelöst wird.
# Performance
Source: https://docs.dreizack-medien.de/DZM-Monitoring/performance
Performancemetriken und Ladezeiten deines Shops auswerten
Der Tab **Performance** gibt dir eine detaillierte Übersicht über die Ladezeiten und den Traffic deines Shops. Die Daten werden gesammelt, sobald du in den [Einstellungen](/DZM-Monitoring/einstellungen) die Option **Performancedaten sammeln** aktiviert hast.
Für aussagekräftige Auswertungen werden mindestens **3 Tage** Datensammlung benötigt.
## KPIs
Die KPI-Kacheln zeigen dir auf einen Blick die wichtigsten Kennzahlen des aktuellen Tages im Vergleich zum Allzeit-Durchschnitt. Ein grüner Hintergrund signalisiert eine Verbesserung gegenüber dem Durchschnitt, ein roter Hintergrund eine Verschlechterung.
Gesamtanzahl der gemessenen Seitenaufrufe am heutigen Tag. Wird mit dem Allzeit-Durchschnitt der täglichen Hits verglichen.
Misst, wie lange es dauert, bis das größte sichtbare Element der Seite (z.B. ein Hero-Bild oder eine Überschrift) vollständig gerendert ist. Google empfiehlt einen Wert unter **2,5 Sekunden**.
Zeit zwischen dem Absenden der Browser-Anfrage und dem Empfang des ersten Bytes vom Server. Misst die Reaktionsgeschwindigkeit des Servers. Ein guter Wert liegt unter **800 ms**.
Gesamtladezeit der Seite, bis alle Ressourcen (Bilder, Skripte, Stylesheets) vollständig geladen sind.
Zeitpunkt, wann das HTML vollständig vom Browser geladen und verarbeitet wurde – ohne auf Bilder oder externe Stylesheets zu warten. Ein früher DCL-Wert bedeutet, dass die Seite schnell interaktiv wird.
## Artikeldetailseite
Zeigt dieselben vier Performancemetriken (LCP, TTFB, Total Load Time, DomContentLoaded) gefiltert auf Aufrufe von **Artikeldetailseiten**. So erkennst du, ob Produktseiten spezifische Ladezeit-Probleme haben.
## Artikelliste
Zeigt die vier Performancemetriken gefiltert auf **Artikellisten- und Kategorieseiten**. Hilfreich um zu erkennen, ob Listen mit vielen Produkten besonders langsam laden.
***
## Hits pro Stunde
Das Balkendiagramm zeigt die durchschnittliche Anzahl an Seitenaufrufen pro Stunde des Tages. So erkennst du die typischen Traffic-Spitzen und kannst den heutigen Traffic mit dem Allzeit-Durchschnitt vergleichen.
| Legende | Bedeutung |
| ------------------------- | ------------------------------------------------------------------------- |
| **avg Hits** (türkis) | Durchschnittliche Hits pro Stunde über den gesamten Aufzeichnungszeitraum |
| **current Hits** (dunkel) | Tatsächliche Hits der aktuellen Stunden des heutigen Tages |
***
## Charts pro Seitentyp
Die folgenden Balkendiagramme schlüsseln die jeweilige Metrik nach Seitentyp auf und vergleichen den heutigen Wert mit dem Allzeit-Durchschnitt. Alle Diagramme sind gleich aufgebaut.
| Legende | Bedeutung |
| ---------------------------- | ---------------------------------------------------------- |
| **avg ... alltime** (türkis) | Allzeit-Durchschnitt der Metrik für diesen Seitentyp |
| **avg ... today** (dunkel) | Heutiger Durchschnittswert der Metrik für diesen Seitentyp |
### Hits pro Seitentyp
Zeigt, wie viele Seitenaufrufe auf die einzelnen Seitentypen (Startseite, Artikelliste, Artikeldetail usw.) entfallen – heute vs. Allzeit-Durchschnitt.
### LCP pro Seitentyp
Zeigt die durchschnittliche Largest Contentful Paint-Zeit pro Seitentyp. Hilft dir, Seitentypen mit überdurchschnittlich langer Renderzeit zu identifizieren.
### TTFB pro Seitentyp
Zeigt die durchschnittliche Time to First Byte pro Seitentyp. Auffällig hohe Werte bei bestimmten Seitentypen können auf serverseiteige Probleme oder aufwändige Datenbankabfragen hinweisen.
### Total Load Time pro Seitentyp
Zeigt die Gesamtladezeit pro Seitentyp. Seitentypen mit besonders vielen Ressourcen (z.B. Kategorieseiten mit Produktbildern) haben hier naturgemäß höhere Werte.
### Dom Content Loaded pro Seitentyp
Zeigt die DCL-Zeit pro Seitentyp als Balkendiagramm. Gibt Aufschluss darüber, bei welchen Seitentypen das HTML besonders schnell oder langsam verarbeitet wird.
***
## Dom Content Loaded pro Seitentyp – Verlauf
Das Liniendiagramm zeigt die historische Entwicklung der DomContentLoaded-Zeit je Seitentyp über den gesamten Aufzeichnungszeitraum. So erkennst du langfristige Trends und ungewöhnliche Ausreißer.
| Legende | Bedeutung |
| ------------ | -------------------------------------------- |
| **Hitcount** | Anzahl der gemessenen Aufrufe pro Datenpunkt |
| **LCP** | Largest Contentful Paint im Zeitverlauf |
| **TTFB** | Time to First Byte im Zeitverlauf |
| **Load** | Total Load Time im Zeitverlauf |
| **DCL** | DomContentLoaded im Zeitverlauf |
# Abonnenten
Source: https://docs.dreizack-medien.de/DZM-PWA/abonnenten
Übersicht aller registrierten Geräte mit App-Installationsstatus und Push-Abo
Der Bereich **Abonnenten** zeigt alle Geräte, die entweder die PWA installiert haben oder ein Push-Abo abgeschlossen haben.
Oben werden drei Status-Badges angezeigt:
* **Geräte** – Gesamtzahl aller registrierten Geräte
* **installiert** – Geräte auf denen die PWA installiert ist
* **Push aktiv** – Geräte mit aktivem Push-Abo
## Registrierte Geräte
Geräte mit Push-Abo oder installierter App. Über das Suchfeld kannst du nach Kunden suchen.
| Spalte | Beschreibung |
| ------------------- | ------------------------------------------------------------------------------------------------------- |
| **Kunde** | Name und E-Mail des Kunden, oder „Gast" bei nicht eingeloggten Besuchern |
| **Plattform** | Betriebssystem des Geräts (z.B. android, ios) |
| **App** | Installationsstatus der PWA: **Installiert** (grün) oder „nicht installiert" |
| **Push** | Push-Status: **Aktiv** (grün) oder **Kein Push** – Push muss vom Nutzer aktiv im Browser erlaubt werden |
| **Zuletzt gesehen** | Datum und Uhrzeit des letzten Zugriffs |
Bei Geräten mit aktivem Push-Abo steht rechts ein **Test**-Button, über den du eine Test-Benachrichtigung direkt an dieses Gerät senden kannst.
### Testnachricht senden
Ein Klick auf **Test** öffnet einen Dialog, in dem du Titel und Text der Testnachricht eingeben kannst. Die Nachricht wird direkt an das gewählte Gerät gesendet.
Nutze den **Test**-Button, um Push-Benachrichtigungen vor dem Versand an alle Abonnenten auf einem konkreten Gerät zu prüfen.
# Changelog
Source: https://docs.dreizack-medien.de/DZM-PWA/changelog
Alle Updates und Änderungen für DZM PWA
### Features
* Marketing-Push-Nachrichten versenden und planen
* Abonnenten- und Geräteverwaltung mit Push-Status
* Testnachricht an einzelne Geräte senden
* Verlauf mit Empfangs- und Öffnungsstatistik
* Automatische Push-Benachrichtigung bei Bestellversand
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.10.7
* PHP 8.2+
# Push Notifications
Source: https://docs.dreizack-medien.de/DZM-PWA/push-notifications
Marketing-Push-Nachrichten an alle aktiven Abonnenten senden und Verlauf einsehen
Im Bereich **Push Notifications** sendest du Marketing-Nachrichten an alle aktiven Push-Abonnenten und siehst den Verlauf gesendeter Benachrichtigungen.
Oben in der Ansicht werden zwei Status-Badges angezeigt:
* **Abonnenten** – Anzahl der aktiven Push-Abonnenten
* **VAPID Key aktiv** – Zeigt an, ob der VAPID-Schlüssel korrekt konfiguriert ist (Voraussetzung für Push)
## Neue Nachricht senden
Marketing-Push an alle aktiven Abonnenten – Versand asynchron über den Cron.
Titel der Push-Benachrichtigung. Wird fett im Browser oder auf dem Sperrbildschirm angezeigt.
Inhalt der Benachrichtigung. Kurze, prägnante Nachrichten funktionieren am besten.
URL die beim Klick auf die Benachrichtigung geöffnet wird. Leer lassen = Startseite des Shops.
Zeitpunkt für den geplanten Versand. Leer lassen = beim nächsten Versandlauf sofort.
Klicke auf **An alle senden**, um die Nachricht in die Warteschlange zu stellen. Der Versand erfolgt asynchron über den Cron.
Der Versand läuft asynchron – die Nachricht erscheint nach dem nächsten Cron-Lauf im Verlauf mit dem Status **Versendet**.
## Verlauf
Gesendete und geplante Benachrichtigungen mit Statistik.
| Spalte | Beschreibung |
| ------------- | ---------------------------------------------------------- |
| **Typ** | Art der Nachricht: `marketing`, `test`, `order_shipped` |
| **Status** | Aktueller Status: **Versendet** (grün), **Geplant** (blau) |
| **Titel** | Titel der gesendeten Benachrichtigung |
| **Gesendet** | Anzahl der Versendeversuche |
| **Empfangen** | Anzahl erfolgreich zugestellter Nachrichten (mit Prozent) |
| **Geöffnet** | Anzahl der Klicks auf die Benachrichtigung (mit Prozent) |
| **Fehler** | Anzahl fehlgeschlagener Zustellungen |
| **Zeitpunkt** | Datum und Uhrzeit des Versands |
Geplante Nachrichten können über den **Storno**-Button rechts in der Zeile abgebrochen werden.
# PWA Setup
Source: https://docs.dreizack-medien.de/DZM-PWA/pwa-setup
Grundeinstellungen, App-Konfiguration, Icon, Farben und Push Notifications der DZM PWA
Im Tab **PWA Setup** konfigurierst du alle grundlegenden Einstellungen der Progressive Web App – von der App-Konfiguration über das Icon bis hin zu Push Notifications.
## Allgemein
Aktiviert die PWA-Funktionalität im Frontend. Muss aktiv sein, damit die App installiert und Push Notifications gesendet werden können.
## App-Konfiguration
Name der App auf dem Homescreen und im Manifest. Dieser Name wird dem Nutzer bei der Installation angezeigt.
URL die beim Öffnen der App geladen wird. In der Regel die Startseite deines Shops.
Wie die App nach der Installation dargestellt wird. Mögliche Werte:
* **Standalone** – Keine Browser-Leiste, vollständige App-Ansicht (empfohlen)
* **Fullscreen** – Vollbild ohne jegliche Browser-UI
* **Minimal UI** – Browser-UI wird minimiert, die App wirkt nativer
* **Browser** – Normale Browser-Ansicht
So unterscheiden sich die Anzeigemodi in der Darstellung:
So sieht der Installationsdialog für den Nutzer im Browser aus:
## App-Icon
Logo für den Homescreen und das Manifest. Das Icon sollte quadratisch und mindestens **512×512 px** groß sein.
PNG oder JPG. Das hochgeladene Bild wird automatisch in alle benötigten Größen für verschiedene Geräte generiert.
Hintergrundfarbe hinter dem Icon (für maskable Icons). Standard: `#ffffff`
Abstand zwischen Icon und Rand in Prozent (0–50). Höherer Wert = mehr Abstand.
## Farben
Farbe der Statusleiste und des Browser-UI. Wird auf Android-Geräten im Browser und bei installierter App angezeigt. Standard: `#ffffff`
Hintergrundfarbe beim Laden der App (Splash Screen). Standard: `#ffffff`
## PWA generieren
Generiert Icons, Manifest und kopiert den Service Worker ins Root-Verzeichnis des Shops.
Nach jeder Änderung am Icon oder den Farben muss **PWA generieren** erneut ausgeführt werden, damit die Änderungen aktiv werden.
## Push Notifications
Ermöglicht es Kunden, Push-Benachrichtigungen zu abonnieren.
Zeigt einen Banner im Frontend, über den Besucher Push aktivieren können. Wenn deaktiviert, wird stattdessen direkt der Browser-Dialog getriggert.
Wo der Banner im Frontend erscheint. Mögliche Werte: **Unten**, **Oben**
Hintergrundfarbe des Banners.
Textfarbe im Banner.
Nach wie vielen Tagen der Banner erneut erscheint, wenn er vom Besucher geschlossen wurde. `0` = nur für die aktuelle Session. Standard: `7`
Titel der automatischen Push-Nachricht bei Versand. Platzhalter: `{orderNo}` für die Bestellnummer. Standard: `Deine Bestellung wurde versendet!`
Text der automatischen Push-Nachricht bei Versand. Platzhalter: `{orderNo}` für die Bestellnummer. Standard: `Bestellung {orderNo} ist auf dem Weg.`
# Changelog
Source: https://docs.dreizack-medien.de/Elfsight-Plus/changelog
Alle Updates und Änderungen für Elfsight+
### Verbesserungen
* Kompatibilität mit JTL-Shop 5.8 bis 5.8.1
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.0 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Kompatibilität
* JTL-Shop 5.5.0 – 5.7.1
* Benötigt mindestens DZM Resources & Health 1.10.7
* PHP 8.2+
### Features
* Verbesserte Integration mit Consentmanager: Widgets werden ohne Seitenreload direkt geladen, sobald der Consent erteilt wird
### Kompatibilität
* JTL-Shop 5.5.0 – 5.7.1
* Benötigt mindestens DZM Resources & Health 1.10.7
* PHP 8.2+
### Kompatibilität
* JTL-Shop 5.3.1 – 5.6.1
* Benötigt mindestens DZM Resources & Health 1.9.4
* PHP 8.2+
### Features
* Die Javascript Library wird nun dynamisch eingebunden, um Probleme bei Updates der Bibliothek zu verhindern
### Bugfixes
* Einstellungen lassen sich nicht speichern, wenn kein Consent Item ausgewählt ist
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.8.17
### Kompatibilität
* JTL-Shop 5.2.0 – 5.6.1
* Benötigt mindestens DZM Resources & Health 1.8.14
* PHP 8.1+
### Features
* Update der Javascript Library
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.8.17
### Kompatibilität
* JTL-Shop 5.2.0+
* PHP 8.1+
### Features
* Verbessertes Layout im Adminpanel
* Anpassung an neue Schnittstelle
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.0
### Features
* Check, ob Object Buffer aktiv ist oder nicht
* Darstellungsoptimierung in Verbindung mit Popup Container
* Dokumentationstab in Plugineinstellungen
* Kleinere Performanceverbesserungen
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.7
### Kompatibilität
* JTL-Shop 5.2.0+
* PHP 8.1+
### Kompatibilität
* JTL-Shop 5.2.0+
* PHP 8.1+
### Features
* Zugriff auf den Elfsight Widget Katalog
* Widgets im Store platzieren: global, per Selektor oder individuell per Portlet
* An Consent Item anbinden für Datenschutzkonformität
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
# Einführung
Source: https://docs.dreizack-medien.de/Elfsight-Plus/einfuehrung
Binde Elfsight-Widgets wie Bewertungen, Social-Media-Feeds und mehr direkt in deinen JTL Shop 5 ein.
## Was ist Elfsight?
[Elfsight](https://elfsight.com/de/) ist ein externer Drittanbieter-Service mit über 97 vorgefertigten Widgets, die sich ohne Programmierkenntnisse in wenigen Minuten einbinden lassen. Die Plattform deckt alle gängigen Anwendungsfälle ab:
* **Bewertungen** – Google Reviews, Trustpilot, Tripadvisor, Amazon-Rezensionen
* **Social Media** – Instagram-, Facebook-, TikTok- und LinkedIn-Feeds
* **Chats** – WhatsApp, Facebook Messenger, Telegram, KI-Chatbots
* **E-Commerce** – Countdown-Timer, Popups, Ankündigungsleisten
* **Formulare** – Kontaktformulare, Anmeldeformulare
* **Video & Audio** – YouTube, Vimeo, Podcast-Player
* **Tools** – Google Maps, FAQ, Galerien, QR-Codes
Für die Nutzung von Elfsight+ benötigst du einen eigenen Account beim Elfsight-Service. Das Plugin stellt lediglich die technische Anbindung bereit – Inhalte und Lizenzen werden direkt über [elfsight.com](https://elfsight.com/de/) verwaltet.
**Kostenloser Plan verfügbar:** Elfsight bietet einen dauerhaft kostenlosen Plan an – ohne Kreditkarte und ohne Zeitbegrenzung. Enthalten sind **1 Widget** und **200 Views pro Monat**. Das Widget wird mit Elfsight-Branding angezeigt. Zum Testen der Plattform ist der Free Plan gut geeignet.
### Was zählt als View?
Ein View wird gezählt, sobald eine Seite mit eingebettetem Widget geladen wird – unabhängig davon, ob der Besucher das Widget tatsächlich sieht oder damit interagiert.
**Was zählt als View:**
* Jeder Seitenaufruf, bei dem das Widget eingebunden ist
**Was nicht als View zählt:**
* Klicks auf das Widget
* Ob das Widget durch Scrollen sichtbar wird
* Unique Visitors
Das monatliche View-Kontingent erneuert sich automatisch. Werden mehrere Widgets genutzt, addieren sich die Views. Wird das Limit überschritten, wird das Widget ausgeblendet, bis das Kontingent sich erneuert.
***
## Was macht das Plugin?
Das Elfsight+ Plugin bindet den Elfsight-Service direkt in dein JTL-Shop-5-Backend ein. Du kannst Widgets bequem im Plugin konfigurieren und aktivieren – ohne Smarty-Templates anfassen oder Code kopieren zu müssen.
***
## Einrichtung über das Plugin
Wenn du das Elfsight+ Plugin zum ersten Mal nutzt, kannst du dich direkt aus dem Plugin heraus registrieren oder anmelden.
Öffne das Elfsight+ Plugin im JTL-Shop-5-Backend und wechsle in den **Katalog**. Dort siehst du alle verfügbaren Widget-Typen.
Klicke bei einem Widget auf **Add**. Wenn du noch nicht angemeldet bist, öffnet sich automatisch ein Login- bzw. Registrierungsfenster mit den üblichen Optionen (z. B. Google-Account oder E-Mail).
***
## Einrichtung direkt über Elfsight
Du kannst dich auch zuerst direkt auf der Elfsight-Website registrieren und dein Widget dort einrichten.
Besuche [elfsight.com/de/](https://elfsight.com/de/) und erstelle einen kostenlosen Account.
Wähle ein Widget aus dem Katalog und richte es nach deinen Wünschen ein. Das Widget steht anschließend automatisch in deinem Elfsight+ Plugin zur Verfügung.
# Katalog und Meine Widgets
Source: https://docs.dreizack-medien.de/Elfsight-Plus/katalog
Alle verfügbaren Elfsight-Widget-Kategorien im Überblick.
Im Katalog des Elfsight+ Plugins kannst du alle verfügbaren Widget-Typen durchsuchen, auswählen und direkt konfigurieren.
Wenn du auf ein Widget klickst und zur Elfsight-Website weitergeleitet wirst, findest du dort auch **visuelle Beispiele für alle verfügbaren Widgets** – so kannst du sehen, wie sie live aussehen, bevor du dich entscheidest.
***
## Widget-Kategorien
Airbnb ReviewsAliExpress ReviewsAll-in-One ReviewsAmazon ReviewsApple App Store ReviewsBBB ReviewsBooking.com ReviewsCapterra ReviewsDealerRater ReviewseBay ReviewsEdmunds ReviewsEtsy ReviewsFacebook ReviewsG2 ReviewsGoogle Play ReviewsGoogle ReviewsHotels ReviewsHouzz ReviewsLinkedIn RecommendationsOpenTable ReviewsReviews from TripadvisorTestimonials SliderYelp Reviews
Announcement BarBannerClick to CallCountdown TimerPayPal ButtonPopupPricing TableSales NotificationSpinning Wheel
AI ChatbotAll-in-One ChatFacebook ChatInstagram ChatLine ChatTelegram ChatViber ChatWhatsApp Chat
Appointment BookingCalculatorContact FormForm BuilderPollSubscription Form
Vimeo GalleryYouTube Gallery
Audio PlayerBackground MusicPodcast PlayerRadio Player
AccessibilityAge VerificationBack to TopBefore and After SliderBusiness HoursButtonCookie ConsentEvent CalendarFacebook Share ButtonFAQGoogle MapsJob BoardLogo ShowcaseNumber CounterPhoto GalleryPortfolioQR CodeRestaurant MenuSliderStocksStore LocatorTeam ShowcaseTimelineVisitor CounterWeatherWebsite Translator
File EmbedFlipbookPDF Embed
***
## Einrichtungsbeispiel
Das folgende Beispiel zeigt den vollständigen Ablauf – vom Auswählen eines Widgets im Katalog bis zur fertigen Einbindung im Shop.
Direkt weiter zu Meine Widgets →
### Widget bei Elfsight einrichten
Klicke im Katalog bei einem Widget auf **+ Add**. Du wirst direkt zur Elfsight-Website weitergeleitet. Falls du noch nicht angemeldet bist, erscheint vorher ein Login- oder Registrierungsfenster.
Auf der Elfsight-Seite angekommen, klicke auf **+ Create Widget**.
Auf der linken Seite siehst du alle verfügbaren Vorlagen und Variationen. Klicke eine Vorlage an – in der Mitte wird dir sofort eine Live-Vorschau angezeigt. Wenn du eine passende Vorlage gefunden hast, klicke unten auf **Mit dieser Vorlage fortfahren**.
Im Tab **Inhalt** (links) befüllst du das Widget mit deinen eigenen Daten – z. B. Telefonnummer, Text oder Bilder. Über die weiteren Tabs **Position**, **Einstellungen** und **Stil** stehen dir zusätzliche Anpassungsoptionen zur Verfügung.
Wenn du mit dem Widget zufrieden bist, klicke oben rechts auf **Veröffentlichen**.
Elfsight zeigt dir nach dem Veröffentlichen einen Einbettungscode an – **diesen benötigst du nicht**. Die Einbindung erfolgt entweder direkt über das DZM Elfsight+ Plugin selbst oder – je nach gewählter Widgetposition – über den On-Page-Composer (OPC). Schließe das Fenster einfach.
### Widget installieren und im DZM Plugin konfigurieren
In der Widget-Übersicht bei Elfsight siehst du alle deine angelegten Widgets auf einen Blick:
* **1.** Oben rechts: Anzahl genutzter Widgets und verbrauchte Views im Überblick
* **2.** Links: alle deine Elfsight-Apps in der Seitenleiste
* **3.** Dreipunkt-Menü: Widget umbenennen, duplizieren oder löschen
* **4.** Direkt am Widget: **Edit** (weiterbearbeiten) oder **Install** (im DZM Plugin installieren)
Klicke auf **Install** – du wirst automatisch zurück in dein JTL-Shop-Backend zum DZM Elfsight+ Plugin weitergeleitet.
Im DZM Plugin navigiere zum Bereich **Meine Widgets**. Dort siehst du alle installierten Widgets mit ID, Name, Position und Consent-Status. Klicke auf ein Widget in der Liste, um die Konfigurationsseite zu öffnen.
Auf der Konfigurationsseite stehen dir folgende Optionen zur Verfügung:
* **Elfsight-Logo** – Öffnet die Elfsight-Übersicht des Anbieters
* **Edit** – Widget direkt bei Elfsight weiterbearbeiten
Vergib eine interne Bezeichnung für das Widget, damit du es im Backend leichter wiederfindest.
Legt fest, wo das Widget im Shop eingebunden wird:
* **Header** – Der richtige Platz für Scripte oder Styles, die möglichst früh aufgerufen werden sollen. Kein Platz für sichtbare Elemente.
* **Footer** – Der richtige Platz für die meisten Scripte, die erst am Ende der Seite geladen werden sollen, oder für schwebende Widgets, die immer in der gleichen Ecke bleiben.
* **Portlet** – Flexibles Einbinden für sichtbare Elemente. Das Widget wird als Portlet angelegt und kann anschließend im OPC Editor über das Script Portlet beliebig platziert werden.
* **Selektor** – Das Widget wird an einem bestimmten HTML-Element eingefügt. Gib eine ID (`#meine-id`) oder eine Klasse (`.meine-klasse`) an.
Wenn aktiviert, wird das Widget erst nach Zustimmung des Besuchers eingebunden.
Nur sichtbar wenn der Consent Manager aktiviert ist. Wähle ein Consent Item aus. Neue Items können in **dzm\_resources** angelegt werden.
Klicke abschließend auf **Speichern**.
### Widget im OPC einbinden
Dieser Schritt gilt nur, wenn du als Widgetposition **Portlet** gewählt hast. Bei Header, Footer oder Selektor wird das Widget automatisch ohne OPC eingebunden.
Öffne im On-Page-Composer (OPC) den gewünschten Entwurf. Suche in der Element-Leiste unter **DZM Scripts** nach dem Widget oder gib in der Suche **Elfsight Widgets** ein. Schiebe das Plugin auf die gewünschte Position auf der Seite.
Klicke auf das platzierte Element und öffne es über **Bearbeiten**. Es öffnet sich der Dialog **Elfsight Widgets bearbeiten**.
Wähle aus dem Dropdown das gewünschte Widget aus deinen installierten Elfsight-Widgets aus.
Wenn dein Widget von Cookies abhängig ist und diese deaktiviert wurden, erscheint ein Hinweis. Wähle hier den Titel für den Hinweis.
Wenn dein Widget von Cookies abhängig ist und diese deaktiviert wurden, erscheint ein Hinweis. Wähle hier eine kurze Erklärung für den Hinweis.
Wähle ein Icon, das zusammen mit dem Hinweis angezeigt wird.
Klicke auf **Speichern** um die Einstellungen zu übernehmen.
Im OPC kannst du dir das Ergebnis direkt über die **Vorschau** ansehen. Wenn alles passt, speichere den Entwurf und veröffentliche ihn, damit das Widget live auf der Website sichtbar wird.
# Installation
Source: https://docs.dreizack-medien.de/Luigis-Box/Installation
**Voraussetzungen:**
* JTL Shop 5.5.3 bis 5.8.1
* PHP 8.2 bis 8.5
* DZM Resources & Health ab 1.11.16
* Einen Luigi's Box Account
* Einen Cronjob im Shop für die laufende Produktsynchronisation
Für die aktuellen Mindestvoraussetzungen überprüfe den Changelog zu deiner heruntergeladenen Version
**Installiere immer zuerst DZM Resources & Health. Auch bei einem Update aktualisierst du zuerst DZM Resources & Health bevor du andere Plugins von uns aktualisierst.**
## Plugin Installation
* Das Plugin ist kostenfrei. Du brauchst keine Lizenz zu buchen - du benötigst aber ein aktives Luigi's Box Konto, denn die eigentliche Leistung erbringt die Luigi's Box Suite
* Lade dir das Installationspaket über den JTL Extension Store oder über unseren Store herunter
* Lade das Zip-File über den Plugin Manager in deinen Shop
* Installiere das Plugin
* Das Plugin ist nun einsatzbereit
## Feed anlegen und Luigi's Box verbinden
**Öffne die Plugin Einstellungen im Bereich "Integration"**
Für Hinweise zu Einstellungen aktiviere den Switch **Hinweise einblenden**
**Allgemeiner Hinweis zu Anbindungen:**
Eine Anbindung ist immer pro Sprache anzulegen. In Luigi's Box benötigst du pro Sprache einen eigenen "Shop", auch wenn diese unter der selben Domain laufen. Jeder Shop in Luigi's Box hat eine eigene Tracker ID. Da die KI hinter Luigi's Box ein Sprachmodell ist, ist die Sprache essentiell für die Funktionsweise.
**Eine Anbindung - Eine Sprache - Ein Shop in Luigi's Box**
**Name**: Wähle einen aussagekräftigen Namen für die neue Anbindung
**Sprache:** Wähle die Sprache, die übertragen werden soll
**Tracker ID:** Du findest deine Tracker ID in deinem Luigi's Box Account unter Einstellungen > Integration Settings. Trage die Tracker ID im Plugin ein
**ClientSecret:** Nutze den Schlüssel unter **content-api-analytics** für dein ClientSecret in den Plugin Einstellungen
**Als Standard verwenden:** Aktiviere diese Einstellung für den **ersten Feed** den du anlegst, damit dieser verwendet wird, wenn du keinen expliziten Feed für andere Sprachen verwendet hast.
**Beende das Setup indem du auf Feed hinzufügen klickst**
## Globale Einstellungen setzen
**Im Bereich der globalen Einstellungen kannst du bestimmen wie Produktdaten abgeglichen werden sollen und wie Analytics Daten erfasst werden können.**
Prüfe im ersten Schritt die Einstellungen für den Produktabgleich und fahre dann mit dem nächsten Schritt fort.
## Produktdaten synchronisieren
**Damit Produktdaten zu Luigi's Box übertragen werden, musst du die Daten synchronisieren**
Wechsel dazu in den Bereich **Produktdaten** und klicke auf **Synchronisierung starten.**
### Produktdaten laufend synchronisieren
Für die laufende Synchronisierung und Aktualisierung haben wir einen CronJob angelegt, den du im JTL Shop Admin unter den CronJobs hinzufügen kannst.
## Analytics konfigurieren
**Der Analytics Feedback-Loop ist wichtig, damit Luigi's Box versteht, wie sich deine Kunden im Shop bewegen und welche Produkte sie interessieren.**
Zur Erfassung haben wir den Luigi's Box DataCollector integriert. Dieser funktioniert mit den Standard E-Commerce Events, die auch Google Analytics 4 verwendet.
Wenn du bereits den Google Tag Manager verwendest und dort **ein sauberes Tracking nach GA4 Standard** eingerichtet ist, kannst du diese Variante verwenden und musst nichts weiter tun.
**Wenn deine Konfiguration abweicht oder du keinen Tagmanager verwendest**, dann kannst du unser LB DataLayer verwenden.
In diesem Fall musst du dich an den Support von Luigi's Box wenden und sie bitten, dass sie den DataCollector auf das DataLayer "lbDataLayer" umstellen. Der Support von Luigi's Box weiß was zu tun ist.
**Consent einholen:** Da ein User-Tracking datenschutz-rechtlich relevant ist, solltest du dir den Consent einholen, um deine User zu tracken.
# Grundkonfiguration
Damit AutoComplete und Search bei dir im Shop erscheinen, musst du in den Integration Settings in deinem Luigi's Box Account noch die Selektoren für das Such-Eingabefeld und für den Container einstellen, in dem die Suchergebnisse angezeigt werden sollen
# Erweiterte Konfiguration
Du bist soweit ready für den Einsatz von Luigi's Box. Einstellungen für Filter und Darstellung findest du in deinem Luigi's Box Account. Für mehr Unterstützung kontaktiere den Support von Luigi's Box oder buche dir eine kostenpflichtige Einrichtung bei uns.
# Recommender
Produktempfehlungen von Luigi's Box kannst du seit Version 1.0.0 direkt im Shop ausspielen - wahlweise als Luigi's Box Widget oder serverseitig als nativer Produktslider deines Templates. Platzieren kannst du sie manuell per OPC-Portlet oder automatisch je Seitentyp.
Wie du das einrichtest, steht auf einer eigenen Seite: [Empfehlungen](/Luigis-Box/empfehlungen)
# Changelog
Source: https://docs.dreizack-medien.de/Luigis-Box/changelog
Alle Updates und Änderungen für Luigis Box
### Erstveröffentlichung im JTL Extension Store
* DZM Luigi's Box ist ab sofort auch über den JTL Extension Store erhältlich
### Feature
* **Produktempfehlungen (Recommender)**: Empfehlungen von Luigi's Box direkt im Shop, in zwei Varianten. Als Luigi's Box Widget (recco.js) oder serverseitig als nativer Produktslider deines Templates, der sich optisch nicht vom Rest des Shops unterscheidet.
* Empfehlungen lassen sich manuell per OPC-Portlet platzieren oder automatisch je Seitentyp ausspielen. Auf Produktseiten und im Warenkorb wird der Artikelkontext automatisch mitgegeben.
* Neue Admin-Ansicht "Empfehlungen" für Modus, Platzierung und Anzahl der Produkte
* Diagnose über den URL-Parameter `?lbdebug=1`: schreibt die komplette Kette von der Konfiguration über den API-Aufruf bis zum fertigen Artikel ins Plugin-Log
### Verbesserung
* Backend komplett auf PrimeVue umgestellt: schnellere Oberfläche, Dark-Mode, übersichtlichere Sync-Anzeige
* Neues Abhängigkeits-Management: Fehlt DZM Resources & Health, führt dich jetzt ein Setup-Assistent durch die Installation, statt dass sich das Plugin deaktiviert
* Plugin-Name und Beschreibung im Plugin-Manager korrigiert
### Bugfix
* Zum Löschen markierte Produkte wurden weder bei Luigi's Box noch lokal entfernt und blieben dauerhaft als "zu löschen" hängen
### Kompatibilität
* JTL-Shop 5.5.3 - 5.8.1
* PHP 8.2 - 8.5
* Benötigt mindestens DZM Resources & Health 1.11.16
### Release
* Erste offizielle Version von DZM Luigis Box
### Kompatibilität
* JTL-Shop 5.3.2 - 5.6.0
* Benötigt mindestens DZM Resources & Health 1.9.10
### Feature
# Einführung
Source: https://docs.dreizack-medien.de/Luigis-Box/einfuehrung
Luigi's Box für JTL Shop 5: KI-gestützte Suche, Autocomplete und Produktempfehlungen
## Was ist DZM Luigi's Box?
DZM Luigi's Box verbindet deinen JTL Shop 5 mit [Luigi's Box](https://luigisbox.de), einer KI-gestützten Such- und Discovery-Suite. Das Plugin überträgt deine Produktdaten, bindet Autocomplete und Suche in dein Frontend ein und meldet das Kaufverhalten deiner Kunden zurück, damit die KI daraus lernt.
Das Plugin ist kostenfrei. Es ist die **Anbindung** - die eigentliche Leistung erbringt die Luigi's Box Suite, für die du ein eigenes Konto benötigst. Ein kostenloses Konto legst du unter [app.luigisbox.com](https://app.luigisbox.com/users/onboarding?language=de) an.
Pro Sprache eine eigene Anbindung mit eigener Tracker-ID. Hinter Luigi's Box steckt ein Sprachmodell - die saubere Sprachtrennung ist deshalb entscheidend für die Qualität der Ergebnisse.
Ein Cronjob hält Preise, Bestände, Kategorien, Varianten und Merkmale aktuell. Einen manuellen Voll-Sync stößt du jederzeit aus dem Backend an.
Luigi's Box blendet Vorschläge und Suchergebnisse in deiner bestehenden Suchleiste ein - mit Bild, Preis und Verfügbarkeit ab dem ersten Buchstaben.
Wahlweise als Luigi's Box Widget oder serverseitig als nativer Produktslider deines Templates. Platziert per OPC-Portlet oder automatisch je Seitentyp.
GA4-konforme E-Commerce-Events, wahlweise über deinen bestehenden Google Tag Manager oder über einen eigenen DataLayer. Consent-Anbindung inklusive.
## Voraussetzungen
| | |
| ------------------------ | --------------------------------------- |
| JTL Shop | 5.5.3 bis 5.8.1 |
| PHP | 8.2 bis 8.5 |
| DZM Resources und Health | ab 1.11.16 (kostenlos) |
| Cronjob | für die laufende Produktsynchronisation |
| Luigi's Box Konto | aktiv, mit Tracker-ID und Client-Secret |
Installiere immer **zuerst DZM Resources & Health**. Das gilt auch bei einem Update: Erst Resources & Health aktualisieren, dann alle anderen Plugins von uns.
## Bereiche im Plugin
Plugin einspielen, Anbindung anlegen, Produktdaten synchronisieren und Analytics konfigurieren
Produktempfehlungen einrichten - nativer Slider oder Widget, per Portlet oder automatisch
Alle Updates und Änderungen
## Wie die Teile zusammenspielen
Je Sprache ein eigener Feed. Initial per Voll-Sync, danach laufend über den Cronjob.
Das Plugin bindet das Luigi's Box Script in dein Template ein. Welche Elemente Luigi's Box dabei übernimmt, steuerst du über die Selektoren in deinem Luigi's Box Konto.
Das Plugin liefert GA4-konforme E-Commerce-Events. Daraus lernt die KI, welche Produkte zu welcher Suchanfrage passen.
Was geklickt und gekauft wird, steigt nach oben - ohne handgepflegte Synonymlisten und Rankings.
## Support
Fragen zu Search, Ranking, Synonymen und Auswertung beantwortet das **Luigi's Box Team** - das ist deren Oberfläche und deren Expertise.
Fehler im Plugin beheben wir über Updates. Beratung, Einrichtung und individuelle Anpassungen bieten wir als kostenpflichtige Leistung an.
# Empfehlungen
Source: https://docs.dreizack-medien.de/Luigis-Box/empfehlungen
Produktempfehlungen von Luigi's Box im Shop platzieren - nativer Slider oder Widget
## Zwei Wege zur Empfehlung
Das Plugin kann Empfehlungen von Luigi's Box auf zwei Arten ausspielen. Der Unterschied ist wichtig, weil er bestimmt, wie die Empfehlungen aussehen und wer sie trackt.
Das Plugin holt die Empfehlungen serverseitig bei Luigi's Box ab und rendert sie im **Produktslider deines Templates**. Sie sehen aus wie der Rest deines Shops, weil sie dein Template benutzen.
Luigi's Box lädt die Empfehlungen im Browser nach und rendert sie selbst. Schnell eingebunden, Optik kommt von Luigi's Box.
Im Modus **Nativer Slider** meldet das Plugin Views und Klicks der Empfehlungen aktuell noch nicht an die Luigi's Box Analytics zurück. Das recco.js Widget trackt sich selbst. Wenn dir die Auswertung der Empfehlungen wichtig ist, nimm vorerst das Widget.
## Wo die Empfehlungen erscheinen
Auch hier gibt es zwei Wege, und du kannst beide gleichzeitig nutzen.
### Per OPC-Portlet platzieren
Im OPC-Editor findest du unter der Gruppe **Luigi's Box** das Portlet **Luigi's Box Empfehlungen**. Zieh es an die Stelle, an der die Empfehlungen erscheinen sollen. Auf Produktseiten gibt das Portlet den Artikelkontext automatisch mit.
Nimm diesen Weg, wenn du die Position genau steuern willst.
### Automatisch je Seitentyp
Unter **Empfehlungen** im Plugin-Backend legst du Platzierungen an, die global greifen - ohne dass du jede Seite im OPC anfassen musst.
Nimm diesen Weg, wenn die Empfehlungen überall gleich erscheinen sollen.
## Eine Platzierung einrichten
Jede Platzierung hat die folgenden Felder:
| Feld | Bedeutung |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Aktiv** | Schaltet die Platzierung ein oder aus, ohne sie zu löschen |
| **Modus** | `Nativer Slider (Recommender-API)` oder `recco.js Widget` |
| **Seitentyp** | Produktseite, Warenkorb, Startseite oder Kategorieseite |
| **Recommender-Typ** | Das Modell bei Luigi's Box, das die Empfehlungen liefert. Freies Feld - die gängigen Modelle stehen als Vorschlag bereit |
| **Anzahl** | Wie viele Produkte angezeigt werden |
| **Titel** | Überschrift über dem Slider |
| **Selektor** | CSS-Selektor des Elements, an dem die Empfehlungen eingefügt werden |
| **Einfügemethode** | Wie relativ zum Selektor eingefügt wird: anhängen, voranstellen, davor, danach oder ersetzen |
### Gängige Recommender-Typen
| Typ | Wofür |
| -------------------------- | ------------------------------------------------------ |
| `item_detail_alternatives` | Alternativen auf der Produktdetailseite |
| `item_detail_complements` | Passendes Zubehör auf der Produktdetailseite |
| `basket` | Empfehlungen im Warenkorb |
| `basket_popup` | Empfehlungen im Warenkorb-Popup |
| `trends` | Aktuelle Trends, gut für die Startseite |
| `bestsellers` | Bestseller, gut für die Startseite und Kategorieseiten |
Welche Modelle in deinem Konto verfügbar sind, siehst du in der Luigi's Box Oberfläche. Das Feld ist bewusst frei, damit du auch neue Modelle nutzen kannst, ohne auf ein Plugin-Update zu warten.
### Artikelkontext
Auf **Produktseiten** gibt das Plugin automatisch den aktuellen Artikel als Kontext mit. Im **Warenkorb** übergibt es die enthaltenen Positionen, maximal zehn. Auf Startseite und Kategorieseite gibt es keinen Artikelkontext - nimm dort Modelle wie `trends` oder `bestsellers`, die keinen brauchen.
## Den richtigen Selektor finden
Der Selektor entscheidet, wo die Empfehlungen landen. Öffne die Seite im Browser, klick mit der rechten Maustaste auf das Element, unter oder über dem die Empfehlungen erscheinen sollen, und wähle **Untersuchen**. Nimm eine stabile Klasse oder eine ID.
Nimm keinen Selektor, der nur aus generierten Klassen besteht - die ändern sich beim nächsten Template-Update. Ein Container mit sprechendem Namen hält länger.
## Wenn nichts erscheint
Häng den Parameter `?lbdebug=1` an die URL der Seite. Das Plugin schreibt dann die komplette Kette ins Plugin-Log: welche Konfiguration gegriffen hat, welcher Feed und welche Tracker-ID benutzt wurden, was an Luigi's Box rausging, was zurückkam, wie die Treffer auf deine Artikel gemappt wurden und welche Artikel am Ende geladen werden konnten. Der Cache wird dabei übergangen.
Das Log findest du im Plugin-Backend unter **Ereignisprotokoll**, Kanal `recommender`.
Die häufigsten Ursachen:
Die Zuordnung läuft über die Artikelnummer. Prüfe, ob die Artikelnummern in Luigi's Box mit denen in deinem Shop übereinstimmen - meist fehlt ein abgeschlossener Produkt-Sync.
Entweder kennt das Modell den übergebenen Artikel noch nicht, oder der Recommender-Typ existiert in deinem Konto nicht. Beides siehst du in der Antwort im Debug-Log.
Selektor und Einfügemethode prüfen. Bei mehreren passenden Elementen greift das erste.
Die Empfehlungen werden 10 Minuten zwischengespeichert. Mit `?lbdebug=1` umgehst du den Cache.
# Ajax Suche
Source: https://docs.dreizack-medien.de/NIU-Plus/ajax-suche
Hier kannst du die Ajax Suche konfigurieren. Mit der Ajaxsuche werden passende Artikel in der Datenbank auf Basis deiner Parameter-Einstellungen ermittelt. Diese einfache Suche ist zwar nicht fehlertolerant, liefert aber schnelle Ergebnisse.
## Allgemeine Einstellungen
### Ajaxsuche aktivieren
Lege fest, ob die Ajaxsuche aktiviert und verwendet werden soll. Die Ajaxsuche triggert die Sidebar und liefert schnelle Ergebnisse ohne dass der Nutzer die aktuelle Seite verlassen muss. Wird nach Sucheingabe auf den Button "Erweiterte Suche" geklickt oder die Enter-Taste gedrückt, wird dein Kunde auf die Seite der JTL-Standardsuche weitergeleitet.
### Reaktionszeit wählen
Wähle hier eine Zeit in ms, beginnend ab der letzten Eingabe des Users, bis die Suche ausgelöst werden soll. Standardwert: 1000 (= 1 Sekunde).
### Anzahl sofort angezeigter Produkte
Wähle die maximale Anzahl an Produkten, die in der Ergebnisliste geladen werden soll. Werden mehr Artikel gefunden, kann der Kunde über einen Button weitere Suchergebnisse laden.
***
## Suchparameter
### Datenbankfelder
Gib an in welchen Datenbankfeldern die Suche ausgeführt werden soll, um Ergebnisse zu liefern. Auswahl zwischen:
* Produktname
* SKU
* GTIN
* Beschreibung
* Kurzbeschreibung
* Artikel hinterlegte Suchbegriffe
### Nur Vaterartikel ausgeben
Aktivere diese Option, damit die Suche nur Vater- und Einzelartikel ausgibt. Diese Option bietet sich besonders an, wenn deine Artikel viele verschiedene Variationen haben.
# Barrierefreiheit [BETA]
Source: https://docs.dreizack-medien.de/NIU-Plus/barrierefreiheit
Erhöhe die Zugänglichkeit deines Shops mit einem integrierten Accessibility-Widget, das Nutzern individuelle Anpassungsmöglichkeiten bietet.
Du findest hier Einstellungen für das Barrierefreiheitstool von NIU Plus. Bitte informiere dich umfassend über das Thema Barrierefreiheit, um den Anforderungen gerecht zu werden. Es kursieren viele Mythen und Irrtümer über die Barrierefreiheit. Wir wollen dich bei der Umsetzung der Barrierefreiheit unterstützen, denn wir glauben, dass von Barrierefreiheit beide Seiten profitieren können. Dennoch kann kein Standardtool die Anforderungen an die Barrierefreiheit 100% erfüllen.
**ACHTUNG! FAIR PLAY!** Die Barrierefreiheitsoptionen und Hilfestellungen sind ein kostenfreier Dienst von uns für euch als Alternative zu all den kostenpflichtigen Optionen auf dem Markt. Sie ersetzen weder eine Beratung, eine individuelle Entwicklung oder ein individuelles Audit oder sonstige professionelle Maßnahme, um den Bestimmungen des BFSG nachzukommen. Wir haben uns entschlossen diesen Dienst zu entwickeln, um euch zu helfen und unseren Beitrag zu einem barrierefreien Web zu leisten. Feedback ist erwünscht. Forderungen werden ignoriert.
## Allgemein
Hier aktivierst du das Widget grundlegend für deinen Shop.
### Barrierefreiheits Widget nutzen
Aktiviere diesen Schalter, um das Accessibility-Tool im Frontend deines Shops zu laden. Nach der Aktivierung erscheint für deine Kunden ein Button (meist am Bildschirmrand), über den sie das Menü für Lesehilfen und Darstellungsanpassungen öffnen können.
***
## Widget
In diesem Bereich konfigurierst du, welche spezifischen Hilfsmittel und Funktionen dem Kunden im Widget zur Verfügung gestellt werden sollen. Du kannst hier einzelne Features an- oder abschalten.
### Darstellung
* **Floating Button darstellen (Desktop):** Zeigt den Button zum Öffnen des Widgets dauerhaft schwebend auf dem Desktop an.
### Funktionen für den Nutzer
Hier legst du fest, welche Optionen im Widget-Menü aktivierbar sind:
* **Profile nutzen:** Erlaubt Nutzern, vordefinierte Profile (z. B. für Epilepsie oder Sehbehinderung) zu wählen.
* **Kontrast nutzen:** Ermöglicht das Anpassen der Kontraste (z. B. Dunkelmodus, Helle Farben).
* **Blaufilter nutzen:** Option zum Reduzieren von blauem Licht (augenschonend).
* **Sättigungseinstellungen nutzen:** Erlaubt die Anpassung der Farbintensität (z. B. Graustufen).
* **Zeilenabstand nutzen:** Nutzer können den Abstand zwischen Zeilen vergrößern, um die Lesbarkeit zu verbessern.
* **Zeichenabstand nutzen:** Nutzer können den Abstand zwischen Buchstaben vergrößern.
* **Textgröße nutzen:** Ermöglicht das Skalieren der Schriftgröße.
* **Hochkontrast nutzen:** Aktiviert einen Modus mit maximalem Kontrast.
* **Dyslexia Font nutzen:** Bietet eine spezielle Schriftart an, die für Menschen mit Legasthenie besser lesbar ist.
* **Cursor nutzen:** Vergrößert den Mauszeiger oder fügt eine Lesehilfslinie hinzu.
* **Lesehilfe nutzen:** Hebt den Bereich unter dem Mauszeiger hervor und dunkelt den Rest ab (Fokus-Modus).
* **Linkmarkierung nutzen:** Hebt alle klickbaren Links auf der Seite optisch stark hervor.
* **Bilder ausblenden nutzen:** Erlaubt das Ausblenden aller Bilder, um sich rein auf den Text zu konzentrieren.
# Blog
Source: https://docs.dreizack-medien.de/NIU-Plus/blog
Hier legst du fest, wie sich deine Blogbeiträge verhalten, wie sie optisch dargestellt werden und wo du wichtige SEO-Optionen findest.
## Allgemein
Hier steuerst du das grundlegende Verhalten deiner Blog-Seiten.
### Unsichtbare Blogbeiträge auf 404 weiterleiten?
Mit diesem Schalter legst du fest, ob Blogbeiträge, die auf "unsichtbar" gestellt wurden, automatisch auf eine 404-Fehlerseite weiterleiten sollen. Das ist besonders nützlich, um Besuchern und Suchmaschinen sauber mitzuteilen, dass dieser Inhalt aktuell nicht mehr verfügbar ist.
## Content
In diesem Bereich geht es um das Design und das Layout deiner Beiträge.
### Containerbreite wählen
Hier bestimmst du die maximale Breite deines Inhaltsbereiches im Browser. Über das Dropdown-Menü kannst du beispielsweise das Layout auf den "Standard Container (1250px)" festlegen.
Wenn du deine Blogbeiträge direkt mit dem OPC Editor schreibst, behältst du an dieser Stelle die volle Kontrolle über den umfassenden Contentcontainer.
### Randlosen Container verwenden
Möchtest du, dass dein Blog-Inhalt die volle verfügbare Bildschirmbreite nutzt? Dann aktiviere einfach diesen Schalter. Dies eignet sich hervorragend für moderne Layouts ohne Seitenränder.
## SEO Einstellung
Gute Inhalte wollen auch gefunden werden.
Für die Indexierungsoptionen von Newskategorien und inaktiven Blogbeiträgen beachte bitte die speziellen SEO Settings im separaten Menüabschnitt **"SEO"**. Dort kannst du im Detail steuern, was Suchmaschinen sehen dürfen.
# Changelog
Source: https://docs.dreizack-medien.de/NIU-Plus/changelog
Alle Updates und Änderungen für NIU Plus Template
### Features
* **StylesHub komplett neu gebaut: dein Shop wird jetzt im Backend eingestellt, während du ihn siehst.** Der echte Shop läuft in einem iFrame im Admin, ein Klick auf ein Element öffnet genau die Einstellung, die es färbt. Farben und Gestaltung sind sofort sichtbar, ohne Speichern und ohne SCSS-Lauf
* **Der Editor bedient das ganze Theme**, nicht nur Farben: Buttons, Rundungen, Schatten, Padding, Eingabefelder und Kartenstile. Elf Flächen plus ein Bereich „Global", jeweils in Farben, Styles und Details aufgeteilt
* **Auch die serverseitigen Bereiche sind im Editor erreichbar:** Kopfzeile, Topbar, Navigation, Footer, Sidebar, Artikelkarten, Produktseite, Warenkorb, Bestellvorgang, Slider und Suchfeld öffnen ihre gewohnte Admin-Ansicht direkt in der Editor-Spalte, die Vorschau lädt danach neu
* **Wirkungsanzeige:** Fährst du über eine Einstellung, markiert der Editor alle Stellen im Shop, an denen sie wirkt, und schreibt die Anzahl daneben. Du siehst also vorher, was eine Farbänderung sonst noch trifft
* **Hell und Dunkel im Editor gekoppelt:** Was du siehst, ist auch das, was du bearbeitest. Ein Wechsel auf Dunkel ändert nicht mehr versehentlich die hellen Werte
* **Seitenauswahl mit Bestellvorgang und freier Adresse:** Warenkorb und Bestellvorgang werden über ihre Seitenart gefunden statt über eine feste ID, dazu ein Feld für jede beliebige Shop-Adresse (Wunschliste, Blog, eine bestimmte Kategorie)
* **SpotlightBanner von Grund auf neu:** Popover, Hotspots und Sidebar-Anbindung sind neu gebaut. Die Hotspots sind jetzt auch im OPC-Editor sichtbar, der Animations-Tab ist einstellbar, und ein Titel für das Bild kommt als eigene Eigenschaft dazu. Bestehende Banner laufen ohne Migration weiter
* **Gewährleistungsseite und Gewährleistungshinweis im Bestellvorgang.** JTL-Shop 5.8 bringt den gesetzlich vorgeschriebenen Hinweis nach EU-Warenkaufrichtlinie als eigene Seite mit Hinweisbild in 23 Sprachen, dazu denselben Hinweis auf der Bestellbestätigung (nur Shop 5.8)
* **Garantie-Label** an Artikelkachel, Listenansicht, Artikelseite, Warenkorbseite, Bestellbestätigung und Schnellansicht, dazu als Filter in der Artikelübersicht (nur Shop 5.8)
* **Neuer Boxtyp „Garantie-Label"** für die Produkt-Content-Boxen: Du platzierst das Label frei auf der Artikelseite (nur Shop 5.8)
### Verbesserungen
* **Der Sofortkauf-Knopf folgt jetzt deiner Theme-Einstellung.** Er war der letzte Teil des Sofortkaufs mit fest verdrahteter Farbe und blieb dadurch im Dunkelmodus in der Hellmodus-Farbe stehen
* **Konto-Navigation mit festem Einhängepunkt für Plugins.** Zusatz-Pills von DZM-Plugins landen jetzt zuverlässig vor dem Abmeldebutton statt dahinter
* **Der Editor hat einen Ausgang.** Ein „Verlassen"-Knopf führt sauber aus dem Vollbild heraus, mit Rückfrage bei ungespeicherten Änderungen. Die Seitenwechsel im Editor verstopfen den Browser-Verlauf nicht mehr
* **Die Einstellungsebene passt sich dem Inhalt an:** schmal gedockt bei Farbzeilen, über volle Breite bei Formularen, wahlweise rechts oder unten. Breite und Höhe sind ziehbar und werden gemerkt
* **Vorschau-Größe wählbar** (50/75/100 % oder einpassen), ohne dass der Shop dabei versehentlich in seine mobilen Umbrüche kippt. Daneben steht immer, mit welcher Breite die Seite gerade rechnet
* **Der Editor sagt Bescheid, wenn der Shop weitergeleitet hat.** Wer den Bestellvorgang mit leerem Warenkorb aufruft, sieht den Warenkorb – das ist normal und steht jetzt auch dort
* **Beide Theme-Ansichten übernehmen deine vorhandenen Farben und Radien gleich.** Bisher hing der gespeicherte Stand davon ab, welche Ansicht du zuerst geöffnet hast
* **Werkzeugleiste und Spalten für kleine Bildschirme:** Symbole statt angeschnittener Wörter, beide Spalten wegklappbar, unter 1250 Pixeln klappt die linke von selbst zu
* **Der Editor reagiert deutlich schneller.** Das Überfahren einer Einstellung kostet jetzt 16 bis 26 ms statt 105 ms
* **Theme rund 165 KB kleiner:** die mitgelieferten Bibliotheken stehen auf dem Stand von NOVA 1.8.0, die ungenutzte Animationsbibliothek WOW\.js ist raus (nur Shop 5.8)
* **Barrierefreiheit:** Beschriftungen wie „Artikel-Nr.:" oder „Lieferstatus:" sind an 46 Stellen nur noch optisch fett. Screenreader betonen damit nicht mehr das Etikett statt der Information (nur Shop 5.8)
* Artikel-JavaScript auf NOVA-1.8.0-Stand, erweiterter Lieferzeit-Selektor (nur Shop 5.8)
### Bugfixes
* Kartenschatten wurden im **Produkt Slider**, im Unterkategorien-Slider und bei „Passende Artikel" an der Slider-Kante abgeschnitten
* Slider mit Karten ohne Schatten fluchteten nicht mehr mit den Überschriften darüber. Das seitliche Padding richtet sich jetzt nach dem eingestellten Kartenstil
* Beim SpotlightBanner lag der komplette Popover-Inhalt samt Produktbild und Preis offen auf dem Banner. Popover und Sofortkauf funktionierten nicht, weil das Skript an einem Syntaxfehler abbrach
* Beim SpotlightBanner erschien der Beschreibungstext doppelt, und das Popover schob sich über den Hotspot, sodass die Sidebar nicht mehr aufging
* Im Spotlight-Popover fehlte der Titel beziehungsweise der Produktname
* Ein SpotlightBanner ohne eingetragene Block-ID hatte keine ID, und ein leeres Text-Overlay lag unsichtbar über jedem Banner
* Der Farbwähler im Editor öffnete sich hinter dem Vollbild und war dadurch nicht zu sehen. Auch in den klassischen Ansichten klappten Auswahlfelder am oberen Rand nicht mehr hinter die Admin-Topbar
* „Verwerfen" im Editor nahm die Vorschau nicht zurück, und nach einem Neuladen zeigte die Auswahl auf ein Element, das es nicht mehr gab
* Der Editor blieb stumm, wenn die Vorschau nicht gelesen werden konnte, und sah dann einfach kaputt aus
* Der Editor bot „Hintergrund" doppelt an, mit zwei Reglern für denselben Wert
* Einstellungen, die nur auf dem Handy gelten, wurden im Editor auch am Desktop als zuständig gemeldet
* **Die Startseite brach unter JTL-Shop 5.8 mitten im Aufbau ab, sobald ein Slider aktiv war.** Der Hero-Slider läuft jetzt auf Splide statt Nivo, mit Bildunterschriften im Slide, Miniaturbild-Navigation und verzögert geladenen Bildern (nur Shop 5.8)
* Stand das Garantie-Label zweimal auf einer Seite, wurde der QR-Code als schwarzes Rechteck gezeichnet (nur Shop 5.8)
* Die Herstellernummer auf der Artikelseite war zwar ausgezeichnet, aber unbenannt und damit für Suchmaschinen wertlos (nur Shop 5.8)
* Der Widerrufs-Link ignorierte die Einstellung, ob der Knopf überhaupt aktiv sein soll (nur Shop 5.8)
* Die Mengenanzeige bei Konfigurationspositionen im Bestellarchiv war falsch (nur Shop 5.8)
* Banner-Bilder werden jetzt als WebP angefordert (nur Shop 5.8)
### Hinweise
* **Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren.**
* **Template und Companion gehören zusammen aktualisiert.** Der StylesHub ist vom Frontend ins Backend gezogen; wer nur eines von beiden aktualisiert, hat keinen Editor.
* **Der StylesHub liegt jetzt im Backend**, am gewohnten Menüpunkt. Der frühere Frontend-Modus samt Gastzugang entfällt, die zusätzliche Route „Theme-Editor (Beta)" ebenfalls – es gibt nur noch einen Editor.
* **7.13.0 eröffnet den ersten Kanal für JTL-Shop 5.8.** Shops auf 5.7 bleiben auf der 6.x-Linie und bekommen mit 6.13.0 denselben Funktionsstand ohne die 5.8-Anpassungen. Ein Wechsel auf 7.x ist erst beim Shop-Update auf 5.8 nötig.
* **Nach dem Update einmal im Companion kompilieren.**
### Kompatibilität
* 6.13.0: JTL-Shop 5.7.0 - 5.7.3
* 7.13.0: JTL-Shop 5.8.0
* PHP 8.2 - 8.5
* Benötigt mindestens DZM Resources & Health 1.11.17
**Bitte vor dem Update lesen – dieses Update verändert die Farbgestaltung.**
Mit 6.12.0 führt NIU Plus **Theme v2** ein, ein neues System für Farben und Gestaltung. Farben werden nicht mehr an vielen Einzelstellen gesetzt, sondern über **Flächen und Rollen** abgeleitet: Du legst fest, was eine Fläche ist (Seite, Karte, Kopfbereich, Sidebar …) und welche Rolle eine Farbe darin spielt, den Rest rechnet das Template aus. Das ist die Grundlage für den neuen Dunkelmodus und für alle einstellbaren Gestaltungsachsen.
**Was das für deinen Shop bedeutet:**
* **Leichte Abweichungen in Farben und Abständen sind nach dem Update möglich.** Plane etwas Zeit ein, um im NIU Plus Companion nachzukonfigurieren. Sieh dir den Shop nach dem Update einmal in Ruhe an.
* **Karten im Bestellvorgang** haben ohne Theme v2 keinen fest verdrahteten Rückfallwert mehr. Die Kartenstile wirken jetzt auch im bisherigen Betrieb über die Einstellungen und müssen dort konfiguriert werden.
* **Nach dem Update einmal im Companion kompilieren.** Erst danach wird die neue CSS-Auslagerung aktiv.
* **Hat dein Child einen eigenen `head.tpl`-Override, musst du ihn nachziehen.** Prüfe das aktiv: Ein alter Override greift stillschweigend weiter, die CSS-Auslagerung kommt dort nicht an, und du merkst es an nichts außer an der fehlenden Geschwindigkeit.
* **Voraussetzung:** DZM Resources und Health **1.11.16**. Diese Version sichert beim Template-Update deine eigenen SCSS-Variablen und Favicons – bitte vorher aktualisieren.
Christian nimmt ein **Video** zum neuen System auf. Video und Anleitung stehen in der Dreizack Crew: **[crew.dreizack-medien.de](https://crew.dreizack-medien.de)**. Wer sich das Nachkonfigurieren erleichtern will, schaut dort zuerst hinein.
### Features
* **Theme v2 – neues Farb- und Gestaltungssystem.** Flächen und Rollen statt Einzelfarben, mit abgeleiteten Text-, Rahmen- und Hover-Farben. Lesbarkeit wird gegen ein Kontrastverhältnis von 4,5:1 gerechnet
* **Dunkelmodus.** Umschalter im Frontend, Standardmodus einstellbar, Systemeinstellung wird erkannt
* **Einstellbare Gestaltungsachsen:** Rundungen als Familien (Karten, Bedienelemente, Bilder, Eingabefelder), Kartenstile mit globalem Standard, Schatten für Karten und Eingabefelder inklusive Form und Versatz, Polsterung von Karten und Kacheln, Rahmenführung und Rahmenbreite für Eingabefelder, Markierung der Auswahl von dezent bis Akzent
* **Komponenten-Galerie im Backend:** alle Flächen und Zustände auf einer Zeichenfläche, um Einstellungen zu prüfen ohne durch den Shop zu klicken
* **Header-Typ 4 „Kompakt":** einzeilige Navigation mit Menü-Scroller
* **Header-Typ 5 und 6 „Welten-Navigation" \[Beta]:** mehrere Sortimentswelten nebeneinander, Wechsel per Maus, Touch, Tastatur und Fokus, Kategoriezeile mit eigenem Scroller, Aktionsbereich für CTA-Button oder Bewertungswidget
* **Header-Typ 7 „Welten mit Topbar-Logo":** dreizeiliger Aufbau mit Logo in der Topbar und schmaler Mittelzeile
* **Kundengruppen-Selbstzuordnung:** Besucher können sich einer Kundengruppe zuordnen – mit Freischaltung durch dich, Nachweis-Upload, eigenen Formularfeldern je Gruppe, Benachrichtigungsmails und automatischer Aufräumaufgabe
* **Standard-Container-Breite einstellbar**, Neuinstallationen starten mit einheitlichen Breiten
* **Erweiterungspunkt in der Sidebar** für Zusatzplugins, auch beim Variationswechsel
### Verbesserungen
* **Theme v2 ist messbar schneller als das bisherige Theme.** Gemessen wurden eine kürzere Renderstrecke, ein um rund 400 ms besserer LCP beim Kaltstart und 15 KB weniger Dokumentgröße pro Seite ab dem zweiten Aufruf – bestätigt auch unter erschwerten Bedingungen mit leerem Cache und gedrosselter Verbindung
* **98 KB Inline-CSS pro Seite werden zu vier zwischenspeicherbaren Dateien.** Der Browser lädt sie einmal statt bei jedem Seitenaufruf erneut
* **Schriften entschlackt:** 236 überflüssige Dateien und 23 MB entfernt, die Schriftliste wird jetzt erzeugt und bietet nur noch Schnitte an, die es wirklich gibt
* Social-Symbole im Footer kommen als eingebettete Grafik statt aus einer eigenen Schriftdatei – eine Schriftdatei weniger im Ladepfad
* Sicherheit: Repo-Interna, Dokumentation und Quelldateien werden nicht mehr über den Webserver ausgeliefert; der Serverpfad verlässt die Kompilate nicht mehr; das Widerrufsformular ist zusätzlich gegen automatisierte Einsendungen abgesichert
* Nicht kombinierbare Varianten sagen das jetzt auch, statt „ausverkauft" zu melden
* Titel an allen Menü-Unterebenen, sowohl im Standardmenü als auch im Menu Builder
### Bugfixes
* Das Footer-Akkordeon sprang beim Klick auf den Pfeil an den Seitenanfang
* Ein Sidebar-Menü ohne gültige Verknüpfung führte zu einem Fehler statt auf das Wurzelmenü zurückzufallen
* Der Breadcrumb fehlte auf Artikelseiten
* Auswahlfelder zeigten im hellen Modus ihren Pfeil nicht
* Der Sofortkauf-Stepper erschien fälschlich bei Variationsartikeln
* „Unterkategorien anzeigen = Nein" blendete das ganze Megamenü aus
* Die Welten-Navigation ließ sich unter Smarty 5 nicht übersetzen
* Menülinks in Header-Typ 4 folgten nicht den Navigationsfarben
### Kompatibilität
* JTL-Shop 5.7.0 - 5.7.3
* PHP 8.2 - 8.5
* Benötigt mindestens DZM Resources & Health 1.11.16
### Features
* Umfassende Optimierungen an strukturierten Daten (JSON-LD) für bessere Google-Rich-Snippets: Organisation, Website, Breadcrumb und Produkt, konfigurierbar im Backend
* Streichpreise erscheinen jetzt auch in den strukturierten Daten, sodass Google den reduzierten Preis im Suchergebnis anzeigen kann
* Marke statt Hersteller in den strukturierten Daten (entspricht der Google-Präferenz), umschaltbar
* Marke wahlweise aus einem Merkmal statt aus dem Hersteller – beide werden dann getrennt ausgezeichnet, der Hersteller bleibt erhalten
* Hersteller lässt sich auf Wunsch ganz aus den strukturierten Daten herausnehmen
* Der Name von Seite, Breadcrumb und Listen kommt wahlweise aus der Seite selbst statt aus dem Meta-Titel
* Die Einlöse-Box von DZM Bonus Plus ist jetzt fest im Checkout eingebunden, im NIU-Plus-Checkout wie im Standard-Checkout
* Galerie-Videos akzeptieren jetzt vollständige YouTube- und Vimeo-URLs inklusive Vimeo-Zustimmung
### Verbesserungen
* Widerrufsformular mit Captcha abgesichert
* Titel am Logo ergänzt, UX-Verbesserung im mobilen Filter
* Einheitliche Schreibweise der Domain in den strukturierten Daten, passend zu Canonical und Breadcrumb
* Beta-Kennzeichnungen im Backend entfernt, ausgenommen der Menu Builder
### Bugfixes
* Lightbox konnte auf dem iPhone (Safari) die Seite blockieren
* Ein Anführungszeichen im Meta-Titel oder in der Meta-Beschreibung zerlegte die kompletten strukturierten Daten, außerdem landeten HTML-Entities unaufgelöst im JSON-LD
### Kompatibilität
* JTL-Shop 5.7.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.14
### Bugfixes
* Progressbar ausgebessert
* JTL Bug blockiert Unterkategorien
* Attribute für tabX sub landen in der Attributtabelle
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.8
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Features
* Neues KI Settings für bessere Sichtbarkeit
* Neues Feature: Kundengruppenvorauswahl bei Registrierung \[beta]
* Neuer Installwizard \[beta]
* Kuponfeld kann in Sidebar deaktiviert werden
* Enhanced E-Commerce Tracking zu GTM hinzugefügt \[beta]
* Option zur Deaktivierung der Such Sidebar hinzugefügt für Drittanbietersuchen
* Verbesserungen in der Scriptladefolge und Versionierung
* Kategorietext kann jetzt gesplittet werden
### Bugfixes
* Kleinere UX Fixes im Checkout
* Fehlender Footerspace, wenn keine Beschreibung vorhanden ist
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.\*
* Benötigt mindestens DZM Resources & Health 1.10.7
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.0
* Benötigt mindestens DZM Resources & Health 1.10.3
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.0
* Benötigt mindestens DZM Resources & Health 1.10.0
### Features
* Neues Admin Frontend
* Neue Funktion: CSV Importer - ermöglicht es angemeldeten Kunden über ihr Kundenkonto Produkte per CSV Import in den Einkaufswagen zu legen
* Neue Funktionen und Strukturen für eine bessere KI-Lesbarkeit
### Bugfixes
* Linkmaskierung gefixt
* Umbruch in Social Footer gefixt
* Fehlende Sprachvariablen für Kurzbeschreibung, Beschreibung und GPSR Felder
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.\*
* Benötigt mindestens DZM Resources & Health 1.9.20
### Features
* Diverse Verbesserungen im NIU Checkout
* Eigene Sprachvariable für ersten Button im Checkout eingeführt, für eindeutigere Anweisung
* Zusätzliche Option für Position der Zahlungs- und Versandicons im Checkout
* Versand- und Zahlungsicons getrennt an- und abwählbar
* Versand- und Zahlungsicons klickbar und leiten weiter zu Step 2
* Scroll-for-more-Indikator ist jetzt klickbar und deutet einen Scrollvorgang an
* Coupon-Hinweis verbessert und ausblendbar
* Coupon- und Versandposition ist jetzt immer sichtbar
* Alte X-Selling Sidebar entfernt
* Items der XSelling Sidebars gegen neue Karten getauscht
* Neue Customboxes für alle Mediendateien und Mediendateien nach Typ
### Bugfixes
* Kleinere Fixes in Itembox
* Item Slider gegen Itembox getauscht
* Bei gemischten Steuerpositionen funktioniert Sidebar nicht korrekt
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.\*
* Benötigt mindestens DZM Resources & Health 1.9.19
### Features
* Kompatibilität mit JTL Shop 5.7.0
* CLP Hinweise verbessert
* Zusatzartikel können wieder auf 0 gesetzt werden
* Aktualisiertes Iconset für Bootstrap 5 Icons
* Feature Ribbons sind jetzt offiziell raus aus der BETA
* Feature Ribbons können bei NULL Werten ausgeblendet werden
* JS verbessert
* Smarty 5 Kompatibilität
* Verbesserte strukturierte Daten durch Verknüpfung von MicroData und JSON+LD
* HTML Strukturverbesserungen für bessere Maschinenlesbarkeit
* Listenansicht verbessert
* NIU Checkout ist raus aus der BETA
* Toast und die verbesserte Warenkorbsidebar sind raus aus der BETA
* META Pixel ist raus aus der BETA
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.\*
* Benötigt mindestens DZM Resources & Health 1.9.19
### Features
* \[BETA] Meta Pixel Integration in den Entwicklereinstellungen
### Kompatibilität
* JTL-Shop 5.6.\*
* Benötigt mindestens DZM Resources & Health 1.9.18
### Features
* Verbesserte Produktauszeichnung in strukturierten Daten
### Bugfixes
* Verbesserte Struktur des neuen BETA Checkouts
* Kleinere Bugfixes in Feature Ribbons
* Sichtbarkeit der Sidebar bei verschobenem Layout
### Kompatibilität
* JTL-Shop 5.6.\*
* Benötigt mindestens DZM Resources & Health 1.9.17
### Neue Features
* Kompatibilität mit 5.6.x
* Verbesserter Installationsprozess: NIU Plus Companion App installiert alle kompatiblen Abhängigkeiten
* Neues Spotlight-Banner für NIU Plus
* Posthog Integration
* Clarity Integration
* Neue Entwicklerfunktionen
### Neue Beta Features
* Völlig überarbeiteter Checkout
* Container für Trustbadge im Checkout
* Vorschau aller Versand- und Zahlungsarten im ersten Checkout Step
* Optisch prägnante Express Checkout Box
* Instant Buy: Produkte schneller in den Warenkorb legen
* Dynamischere Warenkorb Sidebar
* Dynamische Eingabe von Kupons direkt in der Sidebar ohne Reload
* USPs in Szene setzen mit Feature Ribbons
### Bugfixes
* Strukturierte Daten ausgebessert
* Leere Produktbeschreibungs-Custom Box wird nicht mehr angezeigt
* Allgemeine Verbesserungen in der Codequalität
### Kompatibilität
* JTL-Shop 5.6.\*
* Benötigt mindestens DZM Resources & Health 1.9.16
### Neue Features
* Umbau der Artikelliste als CSS Grid
* Störer in Artikellisten
* Ausbau der graph based JSON LD
* Config Option für Anzeige der bestellten Menge
* Load More Button auf Artikellisten als Option
### Bugfixes
* JSON LD für Blog Posts gefixt
### Kompatibilität
* JTL-Shop 5.5.\*
* Benötigt mindestens DZM Resources & Health 1.9.6
### Neue Features
* Vollwertiges Graph Based JSON LD - Strukturierte Daten mit semantischer Tiefe für KI und Google Crawler
* Völlig neue Darstellungsoptionen für Unterkategorien, getrennt für Desktop und Mobil
* Border-Radius für Gallerie auf Artikeldetailseite einstellbar
* Trustbadge Container in Buybox
* USP Leiste für Buybox
* Videos lokal oder von Youtube in Bildergallerie
* Option die Form der Artikeldetailseite auf die Buybox zu reduzieren
* Zur Kasse Buttons separat stylebar
* Microdata Markup verbessert
* Neue Custom Box Kurzbeschreibung
* Zusätzliche Produkte: Bild, alternative Kurzbeschreibung und Einheit
### Bugfixes
* Doppelte H1 auf Herstellerseite gefixt
* Kleinere Stylefixes
* Image Swatch Overlay verbessert
* Bildhöhe in Produktgallerie gefixt
### Kompatibilität
* JTL-Shop 5.5.\*
* Benötigt mindestens DZM Resources & Health 1.9.5
### Neue Features
* Sidebar Kategorien kommen von links bei entsprechender Icon-Einstellung
* Zusätzliche Daten als JSON LD
* Debug Option angefangen
### Bugfixes
* Fehlende Commits aus 5.4er Version übertragen
* Herstellerinfos aus Attributen fix
* Aria Label ergänzt im Search Icon
* Quickbuy Button Style gefixt
* Kleinere Stylefixes
### Kompatibilität
* JTL-Shop 5.5.\*
* Benötigt mindestens DZM Resources & Health 1.9.3
### Neue Features - Barrierefreiheits Widget
Toolset zur Verbesserung der Barrierefreiheit:
* Kontrast, Sättigung, Blaufilter, Hochkontrastmodus
* Lesehilfe, Cursor vergrößern, Dyslexie Schriftart
* Zeichenabstand, Zeilenhöhe, Bilder ausblenden, Links markieren
* Schriftgröße anpassbar
* 3 Admintools für Überschriften, Alttags und Button Texte
* 4 vordefinierte Profile: ADHS, Sehschwäche, Epilepsie, Lernschwäche
* Einstellungen bleiben für den User gespeichert
* Neue Schriftart Dyslexic
### Kompatibilität
* JTL-Shop 5.5.\*
* Benötigt mindestens DZM Resources & Health 1.9.4
### Neue Features
* Neue Linkmaskierungs SEO Option
* Custom Menu Breadcrumb optimiert
* Neue Custom Boxes Option: Collapse
* Neue Custom Box: Kurzbeschreibung
* Freeshippingprogressbar direkt unter dem Warenkorb
* Buybox Col Optionen für Desktop
* SKU verstecken auf Artikeldetailseite
### Kompatibilität
* JTL-Shop 5.4.\*
* Benötigt mindestens DZM Resources & Health 1.9.1
### Neue Features
* Neue Pagespeedoptionen für Fonts
* Consentbanner kann optional den ganzen Bildschirm blockieren
* Blogexcerpt Template Settings für OPC Plus Portlets
### Bugfixes
* Displayfonts skalieren zu niedrig auf Mobilgeräten
### Kompatibilität
* JTL-Shop 5.4.\*
* Benötigt mindestens DZM Resources & Health 1.9.1
### Neue Features
* Lagerbestand pro Lager direkt am Verfügbarkeitsstatus
* Custom Boxes Filteroption nach Bestellbarkeit
* Easycredit & Nachnahme Payment Icons
* Consent Banner Full Mode Option
* Konfigurator Warenkorb Button direkt dargestellt
* Alpha Feature: Google Tag Manager Integration
### Kompatibilität
* JTL-Shop 5.4.\*
* Benötigt mindestens DZM Resources & Health 1.9.0
### Neue Features
* LD+JSON Markup Funktionen für Organisation, Website, Breadcrumb und Produktlisten
### Kompatibilität
* JTL-Shop 5.4.\*
* Benötigt mindestens DZM Resources & Health 1.8.17
### Neue Features
* Custom Boxes verstecken für Sidebars ohne dargestellte Custom Box
* CLP Warnhinweis Funktion via Custom Boxes
### Bugfixes
* Fehler bei Erstellung der Sicht für Kategorievererbung
* Couponfeld im Checkout war nicht disabled
### Kompatibilität
* JTL-Shop 5.4.\*
* Benötigt mindestens DZM Resources & Health 1.8.17
### Neue Features
* Kategorien zusammenfassen: Produkte aus Unterkategorien wandern automatisch in übergeordnete Kategorien
* XSellingSidebar mit eigenen Artikeln bestückbar
* XSellingSidebar Produkte shuffelbar
* SEO Settings BETA: Mehr Kontrolle über robots, canonical und hreflang
* Floating Cart Button springt am Ende der Seite nach oben
* CLP Warnhinweis Funktion vorbereitet
### Bugfixes
* Hersteller im Menü als Option implementiert
* Disabled inputs background-color fix
### Kompatibilität
* JTL-Shop 5.4.\*
* Benötigt mindestens DZM Resources & Health 1.8.17
### Neue Features
* Smarty Blöcke für individuelle Anpassungen im Kundenkonto
* Kundenreferenz im Checkout
* Zusatzprodukte direkt mitbestellen
* Alpha Feature: XSelling Produkte im Warenkorb
* Custom Menu Builder im Beta Release
* Sidebar Menu onDemand geladen
* Couponfeld direkt sichtbar
* NavIcon für NIUMenu in Navzeile
* Dispatcher verbessert
* Neue Custom Box Position unterhalb der Crossselling Slider
* Verbesserte Styles für Performance
### Bugfixes
* Gratisgeschenke werden auch angezeigt, wenn Funktion inaktiv ist
* Config Btn funktioniert nicht bei Konfigurationsartikel als Kindartikel
* Statische Texte entfernt
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.14
### Neue Features
* Loginstatus auch schon in Shop 5.3.x
* Neuer Mountpoint unter Pagenav
* Neue Option: Lagerbestand bis x anzeigen
* Custom Boxes Reihenfolge für Mobil tauschbar
* Passwort Anzeigen Option
* MenuBuilder ALPHA Version
* HTML Komprimierungsoptionen
* Herstellerangaben Custom Box für GPSR Attribute
* Scroll to top Button per Viewport steuerbar
* Verbesserte Darstellung von Mediafiles
* BrandFree Option für Footer
* Btn Style Optionen für Consent Manager
### Bugfixes
* Darstellung der Verfügbarkeit verbessert
* Javascript initialisiert nicht nach Wechsel der Variation
* Sidebar Border fix
* Ergebnistext der Ajaxsuche ausgebessert
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.8
### Neue Features
* Canonical Tag für Pagination Seiten
* 30 Tage Bestpreis Option
* Gratisgeschenke Sichtbarkeit ab Wert X
* Custom Crossselling Sidebar
* Herstellerangaben Sidebar
* Währung zur Progressbar
* Klassen für Nav Items
* Neue überarbeitete Menü Option
* NIU+ hiLite
* Display Fonts
### Bugfixes
* Preisverlauf wurde nicht dargestellt
* Kleinere Bugfixes
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.5
### Neue Features
* Top Bar auch mobil anzeigbar
* Nav Items per Attribut "css\_klasse" stylebar
* Footer Topbar komplett ausblendbar
* Verbesserte "Für dich bestellbar" Darstellung
* Linkgruppe footer-bottom-bar eingeführt
### Bugfixes
* Shipping Weight wird nicht angezeigt
* Irrelevante Optionen aus Template xml entfernt
* fa icon width auf min-width geändert
* Consent Manager Buttons auf Secondary gesetzt
* Guthabenverrechnung im Checkout nachgearbeitet
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.1
### Neue Features
* Anpassung an überarbeitetes Lizenzsystem
* Verbesserte Preisanzeige
* Verbesserter Installationsprozess
### Bugfixes
* Fehlende Warenkorbinformationen
* Kleinere Bugfixes
* Weiter Einkaufen Button nicht klickbar
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.0
### Neue Features
* Neues Zahlungsicon: American Express
* Einstellungen für Tertiärbutton und Top Footer Button
* Footer Accent Color Setting
* Neues Tool: Custom CSS Editor
* Neue Custom Box Positionen
* Neue Custom Box Styles und Kombinationen
* Völlig überarbeitetes Custom Boxes Interface
* Button Font und Uppercase Option
* Quickview Option im Konfigurator und Warenkorb
* Mediafiles und Downloadfiles in Sidebar aufgewertet
* Konfigurator in der Sidebar
* Neue Buttonstyles
* Border Radius Option für Kategoriebilder im Menü
* HTML Compression für 5.3.\*
* Bundle Hinweis in Productdetails
* Checkout Ansicht verschlankt
### Bugfixes
* Footer Color Settings gefixt
* Navitem Color Settings gefixt
* Stylefixes
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.7.2
### Neue Features
* Verbesserte Rabattdarstellung
* Floating Cart Button auf Artikeldetailseite
* B2B Switch
* Responsive Font Sizes überarbeitet
### Bugfixes
* Lightbox zeigt sich kurz
* Diverse Verbesserungen in Abständen
* Linie bei nicht vorhandenen Custom Boxes
* Konfigurator Button im Warenkorb verbessert
* Button Styles auf Kontaktform
* Sidebar von Browsern überdeckt auf Smartphones
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.7.0
Völlig überarbeitetes Javascript und neu aufbereitete Sidebar. Bei Verwendung von Childtemplates müssen diese ggfs angepasst werden.
### Neue Features
* Komplett überarbeitetes Javascript
* Komplette Überarbeitung der Sidebars
* Unabhängige Sidebars mit History
* Bundling Option für NIU Plus Javascripte
* Option für Weiterleitung nach Quickbuy-Kauf
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.7.0
### Neue Features
* Font Weight Settings
* Mehr Filter anzeigen Funktion
* Option für Anzahl der Artikel pro Viewport
### Bugfixes
* Unterkategorieslider gefixt
* Bundle Darstellung korrigiert
* Coupon Code Dropdown im Checkout gefixt
* Logoausrichtung korrigiert
* Diverse kleinere Fixes
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.6.3
Die NIU Plus Lizenz als Bundlelizenz für OPC Plugins wurde entfernt. Ab dieser Version wird zusätzlich eine OPC Suite Lizenz benötigt.
### Neue Features
* Überarbeiteter Installationsservice
* Sprachvariablen ergänzt
* Filter über Produktliste verbessert
### Bugfixes
* Fehlerhafte Konfiguration über Styleshub behoben
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.6.3
### Neue Features
* Kompatibilitätsupdate für JTL Shop ab Version 5.3.2
Ab Version 2.2.0 werden 2 parallele Versionen entwickelt: 1er Version für Shops bis 5.2.5 und 2er Version ab 5.3.2. Template, Childtemplate und NIU Plus Companion Plugin müssen immer die identische Version besitzen.
### Kompatibilität
* JTL-Shop 5.3.2 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.5.0
### Neue Features
* Komplette Überarbeitung der Companion App
* Export/Import Funktion für Einstellungen
* Setup/Update Assistent
* Style Vorlagen speichern und laden
* Custom Boxes mit Custom Templatefiles
* Neue Custom Boxes: Attributtabelle, Merkmaltabelle und Kombination
* Progressbar mit mobilen Optionen
* Custom Boxes durch Attribute steuern
* 3 Filterpositionen
* Styleshub: Styles direkt im Frontend ausprobieren
* Erscheinende Produkte laufend updaten
* Zeilenoption für Produkttitel und Beschreibung
* Responsive Fonts
* Mengenauswahl und Warenkorbbutton pro Breakpoint positionieren
* Beschreibung in Quickbuy Sidebar
* Diverse neue Sidebar Optionen
* Breadcrumbs gezielt ausblenden
* Bordercolor Option für Sidebar
* Close Button auf mobiler Sidebar
* Preload wichtiger Ressourcen
* Bessere Lazyload & Prefetch Implementierung
* HTML Komprimierung
* CSS Komprimierung und Splitting
* +50 Kundentickets geschlossen
### Kompatibilität
* JTL-Shop 5.2.4 - 5.2.5
* Benötigt mindestens DZM Resources & Health 1.5.0
### Neue Features
* "Added-to-Cart"-Nachricht als Sidebar-Event
* Navigation: Sticky & Not-Sticky Optionen
* Ajax-Suche
* Meta "theme-color" anpassbar
* Warenkorb-Summe optional ausblendbar
* Button "Zum Artikel" für QuickBuy-Sidebar
* Footer Boxen Ausrichtung
* Account-Icon für mobile Ansicht
* QuickBuy: "Nur Mobil" Option
* Alternatives Logo für Mobile
* Höhe der Navigation & des Logos einstellbar
* Artikelslider: Standard Itembox Template
* Searchicon statt Searchbar für mobile Ansicht
* Neue Icons für Wunschliste und Vergleichsliste
### Verbesserungen
* Warenkorb Detailbuttons
* Seitenleiste Boxen-Style
* Wunschzettel Ansicht
* Zahlungsanbieter Logos mobil
* Listenansicht Layout
* Sidebar "Add to cart" Layout
* Navigation Icons mobil
### Bugfixes
* Akzentfarbe auf Navigations-Links
* Secondary Outline Button hover-Farbe
* Wunschliste Button Position mobil
* Nav-Icons Verschiebung
* Warenkorb-Summe verschiebt Icon
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.15
### Features
* DAS Template für JTL Shop 5
* Best Practices aus Studien zur Conversion Optimierung
* Cleanes Design als perfekte Basis
* Intelligente Farbautomatik
* Volle Kontrolle über Farben, Fonts und Sizes
* Alles in der Sidebar
* Sprachvariablen schneller finden
* Custom Boxes für freie Artikeldetailseiten-Gestaltung
* Automatisch Childtemplate installieren
* Komplette OPC Suite inklusive
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
# Custom CSS Editor
Source: https://docs.dreizack-medien.de/NIU-Plus/custom-css
Definiere eigene CSS-Regeln und gestalte deinen Shop individuell, auch ohne tiefgehende Programmierkenntnisse.
## Deine Regeln
In diesem Reiter kannst du mithilfe eines grafischen Editors gezielt CSS-Regeln für vordefinierte Bereiche erstellen und deine gespeicherten Regeln verwalten.
**Wichtiger Hinweis:** Dieses Tool soll dir zur Unterstützung dienen, um dein NIUplus auch ohne CSS Kenntnisse zu individualisieren. Es ersetzt jedoch keine Fachkenntnisse. Du benutzt dieses Tool auf eigene Verantwortung. Der Hersteller leistet keinen kostenfreien Support für Änderungen, die mit diesem Tool erstellt wurden.
### Neue CSS Regel erstellen
Hier definierst du die Eigenschaften einer neuen Design-Anpassung.
* **Selektor wählen:** Wähle im ersten Dropdown den Bereich aus, den du bearbeiten möchtest (z. B. "Nav Topbar"). Im zweiten Dropdown kannst du einen Status wählen (z. B. "Ohne" für den Normalzustand).
* **Hintergrundfarbe:** Lege eine Hintergrundfarbe fest. Aktiviere den **Important**-Schalter, um diese Regel zu erzwingen (CSS `!important`).
* **Schriftfarbe:** Lege die Textfarbe fest. Auch hier steht dir der **Important**-Schalter zur Priorisierung zur Verfügung.
* **Schriftdicke:** Wähle die Stärke der Schriftart (Font Weight) aus dem Dropdown. Nutze **Important**, falls die Änderung sonst nicht greift.
* **Custom Rules:** In dieses Textfeld kannst du manuellen CSS-Code eingeben, um Eigenschaften zu ändern, die oben nicht als Auswahlfeld zur Verfügung stehen (z. B. `border: 1px solid #e5e5e5;`).
### Deine Regeln (Übersicht)
Unterhalb des Editors findest du eine Liste aller bereits angelegten Regeln.
* **Tabelle:** Hier siehst du eine Übersicht der Regeln, sortiert nach **Selektor** und **State**.
* Wenn keine Regeln vorhanden sind, erscheint die Meldung "Keine Datensätze gefunden".
* Du kannst die Anzahl der angezeigten Elemente pro Seite ("Items per page") steuern (z. B. `100`).
***
## Dein Stylesheet
Dieser Reiter bietet dir einen freien Code-Editor für umfangreichere oder komplett freie CSS-Anpassungen.
### Neue CSS Regel erstellen
* **Code Editor:** Trage hier deinen kompletten CSS-Code ein ("Code goes here..."). Dieser wird global in das Stylesheet des Shops geladen.
# Einführung
Source: https://docs.dreizack-medien.de/NIU-Plus/einfuehrung
Übersicht über das NIU Plus Template für JTL Shop 5
NIU Plus ist ein innovatives, conversionoptimiertes Template für JTL Shop 5, das modernes Design mit einer Vielzahl an Funktionen kombiniert, um deinen Onlineshop auf das nächste Level zu heben. Es wurde entwickelt, um ein ansprechendes und benutzerfreundliches Einkaufserlebnis zu bieten und gleichzeitig deine Verkaufszahlen zu maximieren.
## Hauptfeatures im Überblick
### Design & Anpassung
Automatische Erstellung eines perfekt abgestimmten Farbschemas basierend auf deinen Unternehmensfarben.
Über 20 beliebte Fonts lokal eingebunden plus die Möglichkeit, eigene Fonts zu nutzen.
Optimale Darstellung und Lesbarkeit auf verschiedenen Bildschirmgrößen durch responsive, intelligente Fonts.
Verschiedene Layoutoptionen für Header, Footer, Produktboxen und Slider.
### Conversion & Performance
Optimiert für mobile Endgeräte, da über 60% der Nutzer online mobil einkaufen.
Beschleunigt den Kaufprozess durch vereinfachte und schnelle Interaktion mit deinen Produkten.
Verkaufsfokussierte Produktseiten, die Ablenkungen minimieren und Zusatzinformationen in der Sidebar bieten.
Anpassbare Fortschrittsleiste, die durch Anzeige der Versandkostenfreigrenze höhere Auftragswerte anregt.
### Funktionen & Erweiterungen
Flexible Informationsdarstellung zur Unterstützung von Kaufentscheidungen ohne Überladen der Produktseite.
Fördert zusätzliche Verkäufe durch gezielte Produktvorschläge in der Sidebar.
Erweiterungsmöglichkeiten mit entwicklerfreundlichen Features.
# Entwicklereinstellungen
Source: https://docs.dreizack-medien.de/NIU-Plus/entwicklereinstellungen
Entwicklerfunktionen und erweiterte Optionen
## Entwicklerfunktionen aktivieren
1. Öffne die Companion App
2. Starte die Entwicklerkonsole deines Browsers
3. Führe die Funktione `enableDevRoutes()` aus
4. Führe einen Reload durch Die Entwicklereinstellungen sind jetzt für dich als Menüpunkt verfügbar. Die Einstellungen bleiben aktiv, auch wenn du die DevRoutes wieder deaktivierst. Wenn du mit Einstellungen nicht zufrieden bist, stelle sie wieder auf den Standard zurück.
Einstellungen aus den DevRoutes werden nach ausgiebiger Testphase direkt in die Standard Einstellungen übernommen. Du findest sie dann in den Bereichen der Templatesettings, wo sie einzuordnen sind.
Bei den Entwicklereinstellungen handelt es sich um BETA Features. Feedback ist willkommen, aber behandel sie mit Achtsamkeit
# Erste Schritte
Source: https://docs.dreizack-medien.de/NIU-Plus/erste-schritte
Quickstart Guide für NIU Plus nach der Installation
Für einen schnellen Einstieg empfehlen wir dir über den **Variablen** Bereich die Primär und Sekundär Farbe anzupassen und das Theme erneut zu kompilieren.
Im zweiten Schritt solltest du unter **Produktdetailseite** die **Custom Boxes** für deine Produkte konfigurieren, damit Inhalte wie **Beschreibungstext, Attribute, Merkmale** und sonstige Inhalte, die du sonst aus den Tabs von JTL Shop kennst dargestellt werden. Schau für nähere Details in die jeweilige Sektion der Einstellungen.
Wenn du das gemacht hast, aktiviere doch gerne unter **Styleshub** die Frontend Funktion, um die meisten Einstellungen live im Shop zu testen und deinen Store fertig zu konfigurieren.
Beschäftige dich nun mit der Gestaltung der Startseite mit **OPC Plus**, check die Optionen von **OPC Conversion Booster** und schau dir die übrigen Einstellungen genauer an.
**Viel Spaß mit NIU Plus und der OPC Suite!**
# Feature Ribbons
Source: https://docs.dreizack-medien.de/NIU-Plus/feature-ribbons
Erstelle individuelle Ribbons basierend auf Artikelattributen und steuere deren Darstellung global, in Listen und auf Detailseiten.
## Allgemeine Einstellungen
***
## Features in Kategorien
Hier konfigurierst du die Begrenzungen für die Anzeige von Ribbons in Produktlisten (Kategorieübersichten, Suchergebnisse), um das Layout übersichtlich zu halten.
### Maximale Anzahl an Ribbons auf Artikelliste
Lege fest, wie viele Ribbons maximal pro Produktkachel in der Listenansicht angezeigt werden dürfen (z. B. "4"). Überschüssige Ribbons werden ausgeblendet.
### Maximale Anzahl Ribbon Zeilen in Artikellisten
Definiere, wie viele Zeilen die Ribbons in der Listenansicht maximal einnehmen dürfen (z. B. "1"). Dies verhindert, dass Kacheln durch zu viele Ribbons unterschiedlich hoch werden.
***
## Features in Details
Hier konfigurierst du die Begrenzungen für die Anzeige von Ribbons auf der Produktdetailseite.
### Maximale Anzahl an Ribbons auf Produktdetailseite
Gib an, wie viele Ribbons maximal auf der Detailseite eines Artikels angezeigt werden sollen.
### Maximale Anzahl Ribbon Zeilen in Produktdetails
Lege fest, auf wie viele Zeilen die Ribbons auf der Detailseite begrenzt werden sollen.
***
## Ribbon anlegen
In diesem Bereich erstellst du neue Ribbons und definierst deren Quelle, Verhalten und Design.
### Merkmal oder Attribute aus Liste wählen
Wähle ein bereits im Shop bekanntes Merkmal oder Attribut direkt aus der Dropdown-Liste aus, um es als Ribbon anzulegen.
### Merkmal- oder Attributname und Quelle manuell definieren
Falls das gewünschte Attribut nicht in der Liste erscheint, kannst du es hier manuell definieren.
* **Name:** Trage den internen Namen des Merkmals oder Attributs ein.
* **Quelle:** Wähle im Dropdown daneben den Typ aus: **Attribut**, **Funktions-Attribut** oder **Merkmal**.
### Datentyp
Bestimme das Format der Daten, z. B. **Text**.
### 'Felder mit Leern und 0-Werten' nicht als Ribbon darstellen
Aktiviere diesen Schalter, damit das Ribbon automatisch ausgeblendet wird, wenn das Feld beim Artikel leer ist oder den Wert "0" enthält.
### Einheit
Gib optional eine Einheit an (z. B. "cm", "kg"), die hinter dem Wert im Ribbon angezeigt wird.
### Alternativer Eigenschaftsname
Trage hier einen alternativen Namen ein, wenn im Shop ein anderer Text stehen soll als der technische Name aus der Warenwirtschaft.
### Anzeige
Steuere die Sichtbarkeit des Ribbons getrennt für verschiedene Bereiche:
* **in Listen:** Aktivieren für Kategorie- und Übersichtsseiten.
* **in Details:** Aktivieren für die Produktdetailseite.
### Eigene Farben verwenden
Aktiviere diese Option, um die globalen Farbeinstellungen des Themes zu überschreiben und individuelle Farben für dieses spezifische Ribbon festzulegen.
### Hintergrund
Wähle die Hintergrundfarbe für das Ribbon (nur aktiv, wenn "Eigene Farben verwenden" aktiviert ist).
### Schriftfarbe
Wähle die Farbe für den Text im Ribbon (nur aktiv, wenn "Eigene Farben verwenden" aktiviert ist).
### Custom Icon Code verwenden
Aktiviere diese Option, um ein Icon mittels Code einzufügen.
### Icon
Wähle über den Icon-Picker ein Icon aus, das im Ribbon angezeigt werden soll.
### Icon anzeigen
Lege fest, ob das Icon angezeigt werden soll:
* **in Listen:** Icon in der Listenansicht anzeigen.
* **in Details:** Icon auf der Detailseite anzeigen.
### Eigenschaftsnamen anzeigen
Entscheide, ob der Name des Attributs (z. B. "Material:") angezeigt wird:
* **in Listen**
* **in Details**
### Eigenschaftswert anzeigen
Entscheide, ob der Wert des Attributs (z. B. "Holz") angezeigt wird:
* **in Listen**
* **in Details**
### Tooltip einblenden
Aktiviere diese Option, um beim Überfahren des Ribbons mit der Maus (Hover) einen Tooltip anzuzeigen.
### Eigenschaftsname im Tooltip anzeigen
Wenn aktiviert, wird auch im Tooltip der Name der Eigenschaft angezeigt.
### Custom CSS Klassen
Füge hier eigene CSS-Klassen hinzu, um das Ribbon über dein Stylesheet individuell anzusprechen.
### Entferne alle Standard Klassen des Elements
Aktiviere diese Option, um das Standard-Styling des Themes für dieses Ribbon komplett zu entfernen (Reset).
### Hinzufügen
Klicke auf diesen Button, um das konfigurierte Ribbon zu speichern und der Liste hinzuzufügen.
***
## Angelegte Feature Ribbons
Hier kannst du Einstellungen für die Darstellung der Feature-Ribbons auf der Produktdetailseite vornehmen.
### Maximale Anzahl an Ribbons auf Produktdetailseite
Gib hier einen Zahlenwert ein, um festzulegen, wie viele Ribbons maximal auf der Detailseite eines Artikels angezeigt werden dürfen.
### Maximale Anzahl Ribbon Zeilen in Produktdetails
Gib hier einen Zahlenwert ein, um zu definieren, auf wie viele Zeilen die Ribbons auf der Detailseite maximal begrenzt werden sollen.
***
## Standard Ribbons
Hier kannst du steuern, wie mit den Standard-Ribbons des Shops (z. B. "Neu", "Bestseller", "Sale") verfahren wird.
### Standardribbons mit in Liste aufnehmen
Diese Option sorgt dafür, dass die Standard-Ribbons in die Berechnung der maximalen Anzahl (siehe oben) einbezogen werden und sich in die Sortierung einreihen.
### Auf Artikellisten
Aktiviere dies, um Standard-Ribbons in den Listenansichten anzuzeigen.
### Auf Artikeldetails
Aktiviere dies, um Standard-Ribbons auf den Detailseiten anzuzeigen.
# Footer
Source: https://docs.dreizack-medien.de/NIU-Plus/footer
Hier findest du alle Einstellungen rund um den Footer von NIU Plus.
## Footer Topbar
Die Footer Topbar ist die erste Zeile des Footers und gibt dir die Möglichkeit deine Kunden noch ein letztes mal direkt anzusprechen.
### Footer Topbar Typ
Wähle hier eine von drei verschiedenen Topbars, die jeweils unterschiedliche Funktionen bieten, um den spezifischen Bedürfnissen deines Onlineshops gerecht zu werden. Die verfügbaren Optionen sind:
**Newsletter**
Ermöglicht es den Kunden, sich für den Newsletter anzumelden.
**Support**
Bietet schnellen Zugriff auf den Kundensupport.
**Suche**
Integriert eine Suchfunktion für eine einfache Navigation.
### Hintergrund Icon
Wähle hier ein passendes Hintergrundicon für die Footer Topbar.
***
## Footer Boxen
### Anordnung Footerboxen
Entscheide hier, wie die Footerboxen angeordnet sein sollen. Auswahl zwischen:
**linksbündig (start)**
### Links in Footer Bottombar anzeigen
Lege hier fest, ob Links in der Bottombar dargestellt werden sollen. Dieser Bereich gilt für alle Standardseiten bis zum Checkout mit Standard Footer. Die Links können über die Linkgruppe **Footer Bottom Bar** unter [**Eigene Seiten**](https://latest.niuplus.de/admin/links) gepflegt werden. Achte darauf, dass alle Sprachen angelegt sind.
### Links in Footer Bottombar im Checkout anzeigen
Lege hier fest, ob Links im Checkout in der Bottombar dargestellt werden sollen. Dieser Bereich gilt für alle Standardseiten bis zum Checkout mit Standard Footer. Die Links können über die Linkgruppe **Footer Bottom Bar** unter [**Eigene Seiten**](https://latest.niuplus.de/admin/links) gepflegt werden. Achte darauf, dass alle Sprachen angelegt sind.
***
## Icons
Hier kannst du entscheiden, ob die Icons für Zahlung, Versand und Social vergrößert angezeigt werden sollen.
***
## Zahlungsmethoden Icons
Wähle hier die Zahlungsmethoden aus, die du in deinem Shop anbietest. Diese werden um Footer als Icons angezeigt und optional auf den Produktdetailseiten (siehe Optionen für Produktdetails).
### Zahlungsmethoden Icons aktivieren
Um ein Icon zu aktivieren, schiebe einfach den Regler nach rechts und speichere die Einstellungen.
### Icons umranden
Entscheide, ob die Zahlungsmethoden Icons umrandet werden sollen:
**Deaktiviert**
***
## Versand Icons
Wähle hier die Versandarten aus, die du in deinem Shop anbietest. Diese werden im Footer angezeigt.
### Versand Icons aktivieren
Um ein Icon zu aktivieren, schiebe einfach den Regler nach rechts und speichere die Einstellungen.
### Icons umranden
Entscheide, ob die Versand Icons umrandet werden sollen:
**Deaktiviert**
# Globale Einstellungen
Source: https://docs.dreizack-medien.de/NIU-Plus/globale-einstellungen
Hier findest du eine Reihe von Funktionen, die sich global auf den Shop auswirken
## Allgemein
### Scroll Top Button anzeigen
Mit Aktivierung dieser Einstellung wird im rechten unterem Bildschirmeck ein Button angezeigt, mit den dein Kunde wieder zur Header-Ansicht geführt wird, wenn dieser bedrückt wird. Dabei wird die aktuell geöffnete Seite nicht verlassen.
**Mobil:**
### Scroll Top Button Sichtbarkeit
Aktiviere hier, auf welchen Endgeräten der Button ersichtlich sein soll.
***
## Lagerbestand und Lieferbarkeit
### Frühestes Lieferdatum priorisieren
Wähle diese Option, damit bei fehlendem Lagerbestand priorisiert wird nach Zulaufdatum, Lieferdatum des Lieferanten bei Lagerbestand und Lieferdatum des Lieferanten bei Verwendung des Verfügbarkeitattributs.
### Unbekanntes Lieferdatum verwenden
Aktiviere diese Option, um das konkrete Lieferdatum deiner Artikel nicht anzeigen zu lassen. Beachte dafür:
Stelle deine Lieferantenbestellungen auf den 1.1.2099. Es wird ein Hinweis ausgegeben, dass der Artikel beim Lieferanten bestellt wurde. Das konkrete Lieferdatum wird dann nicht mit angezeigt.
### Lagerbestandsampel gelb für bestellbare Artikel
Aktiviere diese Option, um den Lagerstatus 'gelb' mit einer Sprachvariable anzeigen zu lassen, dass der Artikel für dich bestellbar ist. Dies greift dann, wenn ein Artikel keinen Bestand hat und es auch sonst weder Lieferantenbestand, noch Lieferantenbestellungen oder sonstiges gibt, der Artikel aber dennoch aufgrund von Überverkäufen möglich ist zu bestellen.
Hierzu muss die JTL-Shop-Einstellung [200](https://latest.niuplus.de/admin/config?einstellungen_suchen=1\&cSuche=200) auf **"Nein"** gesetzt werden.
**Sprachvariablen:** `niu_stock_status_orderable`, `niu_stock_status_orderable_short`
### Obergrenze für Bestandsausgabe setzen
Begrenze hier die Sichtbarkeit deiner Bestände nach oben. Wenn deine Grenze bei 10 liegt, wird am Artikel angezeigt "**+10 Auf Lager**", wenn der Bestand größer 10 ist.
Hierzu muss die JTL-Shop-Einstellung [110](https://latest.niuplus.de/admin/config?einstellungen_suchen=1\&cSuche=110#artikel_lagerbestandsanzeige) auf **"Genauen Lagerbestand anzeigen"** gesetzt werden.
### Bestandsgrenze festlegen
Hier kannst du die Obergrenze für deinen anzeigbaren Bestand definieren.
### B2B Schalter verwenden
Aktiviert den B2B Umschalter für Desktop in der Topbar und Mobil im Kategoriemenü, damit Kunden zwischen Brutto/Netto Anzeige wechseln können.
***
## Produktfunktionen
### Releasedaten laufend prüfen
Diese Option dient dazu die Releasewerte laufend zu überprüfen und den Cache automatisch zu leeren, wenn es Unterschiede gibt und der Artikel verkaufbar sein sollte. Dadurch kannst du Artikel pünktlich zum Release automatisch verkaufbar machen.
Wenn du exakt zum Releasedatum Produkte verkaufbar machen möchtest, dann kann dir der Cache von JTL Shop einen Strich durch die Rechnung machen, denn die Releasedaten, und die Eigenschaft, ob ein Artikel kaufbar ist oder nicht werden vom Cache erfasst. Ist das Releasedatum erricht, kann es trotzdem sein, dass der Artikel nicht verkaufbar ist. Erst wenn das Produkt erneut abgeglichen wird oder der Produktcache anders zurückgesetzt wird, kann der Artikel gekauft werden. Diese Option löst das Problem.
Das könnte unter Umständen zu Lasten der Performance gehen. Bitte prüfe also bei eingeschalteter Funktion, ob diese sich negativ auf deinen Shop auswirkt.
***
## Trustbadge Selektor IDs
Hier kannst du Containern an 4 verschiedenen Positionen im Template eine individuelle ID zuweisen. Diese ID kannst du im Plugin Resources (Resources & Health) unter Script & Consent ein Trustbadge deiner Wahl injezieren.
In Script & Consent muss dafür in der Option "Position" die Auswahl "Selektor" genutzt werden. Über "CSS-Selektor" definierst du dann deine ID und fügst deinen bereitgestellten Trustbade-Code/Skript in das hinterlegte Feld ein. Anschließend drückst du bei "Speichern" auf den Button "Hinzufügen" um dein Skript zu hinterlegen.
### Nav Desktop
Vergebe hier eine ID für den Trustbadge Container auf dem Desktop in der Nav. Der Container befindet sich in der Navigation neben dem Suchfeld.
### Nav Mobil
Vergebe hier eine ID für den Trustbadge Container auf Mobil in der Nav. Der Container befindet sich in der mobilen Nav neben dem Suchfeld, vorausgesetzt, du hast das Suchfeld unter der Nav aktiv.
Beachte, dass du das Suchfeld mobil unter der Nav aktivieren musst, damit der Container angezeigt wird (siehe [Header-Einstellungen](/NIU-Plus/header)).
### Footer
Vergebe hier eine ID für den Trustbadge Container im Footer. Der Container befindet sich im Footer neben den Zahlungsicons.
### BuyBox
Vergebe hier eine ID für den Trustbadge Container der Buybox. Der Container befindet sich auf der Artikeldetailseite.
***
## Breadcrumbs
Wähle hier aus verschiedenen Optionen, wo die Breadcrumb ausgeblendet werden soll, damit du eigene Inhalte freier gestalten kannst. Nutze die Breadcrumb einzeln und individuell weiter über den OnPage Composer als Portlet (DZM Smarty Portlets ➝ Breadcrumbs).
Breadcrumbs sind eine sekundäre Navigationshilfe, die es Nutzern ermöglicht, ihren Standort innerhalb der Hierarchie einer Webseite zu erkennen und schnell zu höheren Ebenen zurückzukehren. Sie sind typischerweise eine horizontale Textzeile, die die Struktur der Webseite in einer hierarchischen Weise darstellt und Links zu den übergeordneten Seiten enthält.
### Auf Blogpost ausblenden
Aktiviere diese Option, um Breadcrumbs auf Blogseiten auszublenden.
### Auf Eigenen Seiten ausblenden
Aktiviere diese Option, um Breadcrumbs auf Eigenen Seiten auszublenden. Das Ausblenden von Breadcrumbs kann das Design klarer und übersichtlicher gestalten, insbesondere wenn die Seite einen spezifischen Zweck oder eine spezifische Nachricht hat.
### Auf Warenkorbseite ausblenden
Aktiviere diese Option, um Breadcrumbs auf der Warenkorbseite auszublenden. Auf Warenkorb- und Checkout-Seiten ist es entscheidend, den Benutzerfokus auf den Kaufprozess zu halten. Breadcrumbs können unnötige Ablenkungen schaffen und den Nutzer von der Kaufabschluss-Seite wegführen.
***
## Login Form
### Passwort Anzeigen Funktion verwenden
Hier kannst du aktivieren ob das angegebene Passwort, beim drücken des Buttons, sichtbar wird.
### Anzeigen Icon statt Checkbox verwenden
Lege hier fest, ob anstelle der Checkbox im Passworteingabefeld ein darunter liegender Button mit der Beschriftung "Passwort anzeigen" verwendet wird.
**Mit Button:**
### Consent Banner über den gesamten Bildschirm legen
Hier kannst du festlegen ob der Consentbanner beim Erscheinen, die aktuelle Seitenansicht unscharf ausblendet und nur der Banner visuell ersichtlich ist.
**Standard:**
### DREIZACK Branding entfernen
Die kleine Notiz in der Footer Bottom Bar fällt nicht großartig auf, unterstützt uns und unsere Partner aber enorm. Dadurch werden andere Shopbetreiber auf unser Template und die Leistung unserer Partner aufmerksam. Denn je populärer NIU Plus wird, umso schneller und besser können wir dieses Produkt weiterentwickeln, wovon Du am Ende am meisten profitierst.
In jedem Fall unterstützen wir auch unsere Partner für ihre hervorragenden Leistungen und vermitteln Kunden, die über ein Partnerprojekt auf uns aufmerksam geworden sind wieder an diese Partner weiter. Wenn du das nicht möchtest, kannst du das Branding hier deaktivieren. Trage dafür in die Textzeile ein '**Ich möchte das nicht unterstützen!**' und deaktiviere anschließend den Switch.
***
## Performance
### Seitendarstellung verzögern
**Experimentell** - Teste die Einstellung unbedingt in allen Browsern und auf mehreren Endgeräten! Diese Option ist auf eigene Verantwortung zu testen.
Aktiviere diese Funktion, um das HTML erst einzublenden, wenn das notwendige CSS geladen wird, jedoch nicht später als 1 Sekunde nach dem Ladevorgang. Dies setzt voraus, dass die Komprimierungsfunktion in den Templateeinstellungen aktiviert ist.
Layoutshifts können den Leistungsindex deiner Seite negativ beeinflussen. Oft kommt es zu Layoutshifts, weil das notwendige CSS nicht rechtzeitig geladen wurde und bereits Inhalt gerendert wird. Diese experimentelle Option verzögert die Darstellung der Seite innerhalb eines für die anderen Metriken akzeptablen Bereichs, sodass gravierende Layoutshifts vom Ladevorgang entgegengewirkt werden kann.
### NIU Javascript Bundle verwenden
Nutzt ein komprimiertes JavaScript Bundle anstelle der einzelnen Scripte. Weniger Dateien erzeugen weniger Overhead und können so schneller geladen werden.
Nutze diese Einstellung nur, wenn du weißt was du tust. Lass sie im Zweifel deaktiviert – ein Bundle ist nicht immer die bessere Alternative. Teste deinen Shop auf Funktionalität. Solltest du auf Probleme stoßen, die sich in der Console bemerkbar machen, deaktiviere diese Option wieder.
### HTML Komprimierung verwenden
Hier aktivierst du die Komprimierung des HTML-Dokument, was zu schnelleren Downloadzeiten führen kann. Lasse diese Option deaktiviert, wenn du auf etwaige Scriptfehler stößt.
Bitte prüfe nach Konfiguration dieser Einstellungen, ob der Shop in deinem Setup noch vollständig funktioniert. Teilweise kann bei Verwendung unsauberer Scripte die Komprimierung fehlschlagen und die Ausführung von Javascript blockieren.
### JavaScript Kommentare entfernen
Versucht JavaScript-Kommentare vor der Komprimierung zu entfernen. Sollten durch die Entfernung von Leerzeichen und Zeilenumbrüchen Scriptzeilen in eine Kommentarzeile rutschen und dadurch die Ausführung blockieren, kannst du hiermit vor der Komprimierung die JavaScript-Kommentare entfernen lassen.
### Leerzeichen entfernen
Entfernt doppelte Leerzeichen vor und nach HTML-Tags.
### Zeilenumbrüche reduzieren
Versucht Zeilenumbrüche zu entfernen und somit das HTML kompakter zu gestalten.
Die Entfernung von Zeilenumbrüchen kann dazu führen, dass Javascripte, deren Syntax nicht sauber abgesichert ist, nicht mehr funktionieren.
### HTML Kommentare entfernen
Entfernt HTML-Kommentare und reduziert dadurch die Größe des Dokuments.
***
## DEBUG
### Debug Mode aktivieren
Deaktiviert die HTML Komprimierung und gibt Template Hints als Kommentar aus, wenn du als Admin angemeldet bist.
### Debug Variablen im Frontend ausgeben
Gibt dir an manchen Stellen im Template Variablen aus, wenn du als Admin angemeldet bist.
# Google Tag Manager (GTM)
Source: https://docs.dreizack-medien.de/NIU-Plus/gtm
Integriere den Google Tag Manager nahtlos in deinen Shop und nutze den automatischen DataLayer für E-Commerce Tracking.
## Google Tag Manager
Mit der integrierten Google Tag Manager Lösung kannst du den Tag Manager ohne weitere Plugins einbinden und E-Commerce Daten erfassen.
Unabhängig von der Aktivierung steht dir im Template jederzeit das **DataLayer** zur Verfügung, das alle wichtigen E-Commerce Events und Daten nach dem Standard von **Google Analytics 4** enthält. So kannst du auch mit anderen Tools auf diese Daten zugreifen und sie weiterverarbeiten.
Die Daten aus dem DataLayer werden ebenfalls für die Trackingoptionen von Microsoft Clarity und PostHog verwendet.
**Datenschutzhinweis:** Der Tag Manager wird datenschutzkonform eingebunden. Bitte ergänze bei Verwendung dennoch deine Datenschutzerklärung entsprechend.
**Disclaimer:** Bitte prüfe dein Setup sorgfältig. Je nach Shop und Plugins können Anpassungen notwendig sein für ein zielgerichtetes Tracking. Passe unbedingt die Sprachvariablen für die Consent Items an. Tracke nicht ohne die Einwilligung deiner User. Ergänze deine Datenschutzerklärung entsprechend und lass diese prüfen. Lass ggfs. auch die Integration auf rechtskonforme Implementierung prüfen. Die Integration wurde nach bestem Wissen und unter den Best Practices der Google Tagmanager und Google Analytics Dokumentation entwickelt. Die Nutzung unterliegt der eigenen Verantwortung und Sorgfalt.
***
## Allgemein
Hier aktivierst du die Schnittstelle und hinterlegst deine ID.
### Google Tagmanager einbinden
Aktiviere diesen Schalter, um das Script des Google Tag Managers in den Quellcode deines Shops zu laden.
### Google Tagmanager ID
Trage hier deine Container-ID ein. Diese findest du in deinem Google Tag Manager Konto oben rechts neben dem Container-Namen. Mögliche Formate:
* `GTM-XXXXXX` – Älteres Format mit 6 alphanumerischen Zeichen (z. B. `GTM-AB12CD`)
* `GTM-XXXXXXX` – Neueres Format mit 7 alphanumerischen Zeichen (z. B. `GTM-AB12CDE`)
* `GTM-XXXXXXXX` – Erweitertes Format mit 8 Zeichen bei neueren Konten
***
## Consent
Hier steuerst du, für welche Google-Dienste explizit eine Einwilligung (Consent) eingeholt werden soll, bevor Daten fließen.
### Consent für GA4 einholen
Aktiviere diese Option, wenn die Einwilligung der Nutzer speziell für **Google Analytics 4** abgefragt werden soll.
### Consent für Google Ads einholen
Aktiviere diese Option, wenn die Einwilligung der Nutzer speziell für **Google Ads** (Werbeanzeigen/Remarketing) abgefragt werden soll.
***
## Enhanced Conversions
Übergibt SHA-256-gehashte Kundendaten als `user_data` in den DataLayer. Verbessert das Matching von Conversions in Google Ads und das User-Tracking in GA4. Wird nur ausgelöst, wenn dein Consent-Manager die Marketing-/Analytics-Cookies erlaubt.
### Enhanced Conversions aktivieren
Aktiviert die Übergabe der gehashten Kundendaten an den DataLayer.
### E-Mail übertragen
Überträgt die gehashte E-Mail-Adresse des Kunden.
### Adresse übertragen
Überträgt zusätzlich gehashte Adressdaten des Kunden.
### Auch auf allen Seiten bei eingeloggten Usern
Aktiviere diese Option, um die Daten nicht nur nach Kauf- oder Kontaktaktionen, sondern auf jeder Seite zu übergeben, sobald ein Kunde eingeloggt ist.
### Daten serverseitig SHA-256 hashen
Aktiviere diese Option, damit die Kundendaten serverseitig gehasht werden, bevor sie in den DataLayer gelangen.
# Header
Source: https://docs.dreizack-medien.de/NIU-Plus/header
Header und Navigationsleiste konfigurieren
Diese Optionen betreffen den Header und die Navigationsleiste von NIU Plus.
## Header und Navigation
### Headertyp
Hier kannst du einen der drei Headertypen wählen. Der Headertyp beeinflusst Position des Logos, der Suchleiste und der Navicons. Du hast die Auswahl zwischen:
**Typ 1 (Classic)**
### Nav Item Standardklassen überschreiben
Entfernt die Standard CSS Klasse der Nav Items, wenn über das **css\_klassen** Attribut eine eigene Klasse übergeben wurde. Je nach Art der Klasse, kann es sinnvoll sein die Standardklasse zu überschreiben, damit die Darstellung sich verbessert.
### Topbar anzeigen
Lege fest, ob die Topbar angezeigt werden soll. In der Topbar sind wichtige Elemente enthalten, wie der Sprachschalter und der Währungsschalter. Blende die Topbar nur aus, wenn du auf diese Elemente verzichten kannst und du den Platz einsparen möchtest. Denk auch daran, dass du einfach die Farbe der Topbar in den Variablen-Settings einstellen kannst.
### Topbar mobil anzeigen
Lege fest, ob die Navigationsleiste bei Mobil angezeigt werden soll. In der Topbar sind wichtige Elemente enthalten, wie der Sprachschalter und der Währungsschalter. Blende die Topbar nur aus, wenn du auf diese Elemente verzichten kannst und du den Platz einsparen möchtest. Denk auch daran, dass du einfach die Farbe der Topbar in den Variablen-Settings einstellen kannst.
### Sticky Nav Desktop
Lege fest, ob die Navigationsleiste auf dem Desktop mitscrollen und somit immer sichtbar sein soll.
### Sticky Nav Mobil
Lege fest, ob die Navigationsleiste auf Mobil mitscrollen und somit immer sichtbar sein soll.
### Suchfeld mobil unter Nav darstellen
Entscheide wie das Suchfeld mobil dargestellt werden soll. Ist diese Einstellung deaktiviert, hast du in der Navigation neben dem Burgermenü ein Suchicon. Ein Tab auf das Icon öffnet die Sidebar mit einem Suchfeld. Beachte hier auch die Einstellungen zur Ajaxsuche. Ist die Ajaxsuche aktiviert, wird in jedem Fall die Sidebar geöffnet, um deinen Besuchern schnell Artikel anzuzeigen, die auf ihre Suche passen. Vorschau:
**Deaktiviert**
**Aktiviert**
### Hersteller anzeigen
Lege fest, ob der Hersteller angezeigt werden soll.
***
## USPs
Hier kannst du USPs für deinen Shop aktivieren und in der Navigation anzeigen lassen. Header Typ 1 unterstützt die USPs 1 und 2 und stellt diese direkt in der Nav mit dar mit Icon, Text und Untertitel. Die anderen Headertypen unterstützen bis zu 4 USPs mit Icon und Text, dargestellt unter der Nav als USP Line. Die Texte pflegst du über Sprachvariablen. Aktiviere die Hinweise, um die Sprachvariablen zu sehen, die du pflegen kannst. Du kannst die Sprachvariablen über Resources & Health im Tab Plugin Variablen bequem anpassen.
**Sprachvariablen:**
| USP | Überschrift | Text |
| ----- | ----------------- | --------------- |
| USP 1 | `niu_usp1_header` | `niu_usp1_text` |
| USP 2 | `niu_usp2_header` | `niu_usp2_text` |
| USP 3 | `niu_usp3_header` | `niu_usp3_text` |
| USP 4 | `niu_usp4_header` | `niu_usp4_text` |
### Aktiv
Lege fest, ob der jeweilige USP aktiviert werden soll.
### Icon
Wähle ein passendes Icon aus dem Dropdown-Menü für den jeweiligen USP.
***
## Navicons
### Barrierefreiheit Icon anzeigen
Funktioniert nur in Kombination mit aktiven Barrierefreiheits-Einstellungen. Mobil wird der Floating Button immer verwendet. Nur auf Desktop verfügbar.
### Account Icon anzeigen
Lege fest, ob das Account-Icon angezeigt werden soll.
### Text unter Account anzeigen
Lege fest, ob der Text unter dem Account-Icon angezeigt werden soll.
### Wunschliste anzeigen
Lege fest, ob das Wunschlisten-Icon angezeigt werden soll. Damit der Wunschlisten-Icon angezeigt wird, muss die JTL-Shop-Einstellung [439](https://latest.niuplus.de/admin/config?einstellungen_suchen=1\&cSuche=439#global_wunschliste_anzeigen) aktiv sein.
### Text unter Wunschliste anzeigen
Lege fest, ob der Text unter der Wunschliste angezeigt werden soll.
### Vergleichsliste anzeigen
Lege fest, ob das Vergleichslisten-Icon angezeigt werden soll. Damit das Vergleichslisten-Icon angezeigt wird, muss die JTL-Shop-Einstellung [1780](https://latest.niuplus.de/admin/searchresults?cSuche=1780) aktiv sein.
### Text unter Vergleichsliste anzeigen
Lege fest, ob der Text unter der Vergleichsliste angezeigt werden soll.
### Text unter Warenkorb anzeigen
Lege fest, ob der Warenkorbwert unter dem Warenkorb angezeigt werden soll.
### Text unter NIU Menu Icon anzeigen
Lege fest, ob das NIU Menu Icon angezeigt werden soll. Diese Einstellung ist nur wirksam, wenn das NIU Menu aktiviert ist.
**Beispiele:**
Nur Warenkorb aktiviert:
# Installation
Source: https://docs.dreizack-medien.de/NIU-Plus/installation
Schritt-für-Schritt Anleitung zur Installation von NIUplus
## Installationsvideo
**⚠️ BEVOR DU BEGINNST**
Resources & Health muss dringend **vor** allen anderen Plugins installiert und aktualisiert werden.
## Schnellstart (tl;dr)
Das Plugin muss als Erstes installiert sein
Installiere das Companion Plugin
Trage den Lizenzschlüssel in der Companion App ein
Lade die Template Files über die Companion App
Setze die initiale Konfiguration
Wechsle in den Tab **Variablen** und kompiliere das Template
Passe die Settings nach deinen Wünschen an. Nutze unser Styleshub für die wichtigsten Einstellungen
***
## Vorbereitung
### Wo finde ich die Installationsfiles?
Die Installer Pakete findest du jeweils am Produkt.
In der Sidebar findest du alle veröffentlichten Versionen.
**Wichtige Hinweise bei der Versionswahl:**
* Achte auf die Info, ob das Plugin Resources & Health benötigt und in welcher Version
* Achte auf die kompatible Version
* Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast
**Resources & Health ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop.** Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
**Für NIU Plus gibt es aktuell 2 parallele Versionen:**
* **1.x.x** für Shop Version 5.2.4 - 5.2.6
* **2.x.x** für Shop Version 5.3.3 - 5.3.\*
Diese unterscheiden sich nicht im Funktionsumfang, nur in der Kompatibilität. Alle 1er Versionen sind kompatibel mit Shop 5.2.x, alle 2er Versionen mit 5.3.x
### Wo finde ich die Lizenzschlüssel?
Deine Lizenzschlüssel findest du direkt nach der Buchung in deinem Kundenkonto unter **Meine Lizenzen**
Diesen Lizenzschlüssel trägst du im jeweiligen Plugin ein.
Einen Lizenzschlüssel findest du hier nur, wenn du das Produkt über unseren Store gebucht hast.
### Welche Lizenzen muss ich buchen?
Resources & Health benötigt keine Lizenz und kann direkt runter geladen und verwendet werden.
Alle anderen Plugins benötigen eine Lizenz.
**Für NIU Plus Starter+, Creative+ und Business+** benötigst du einen Lizenzschlüssel.
**NIU Plus Creative+ und Business+** bieten eine Bundle Lizenz für alle weiteren Produkte der OPC Suite.
Das bedeutet, dass nur allein mit der Aktivierung einer Creative+ oder Business+ Lizenz automatisch auch die Plugins OPC Plus, OPC Conversion Booster, OPC Smarty Portlets und OPC Portlets vererben aktiviert hast.
**In diesem Fall musst du in den anderen Plugins keinen eigenen Schlüssel mehr hinterlegen.**
***
## Schritt-für-Schritt Installation
### 1. Resources & Health
Lade unter [https://store.dreizack-medien.de/DZM-Resources-Health](https://store.dreizack-medien.de/DZM-Resources-Health) unser Plugin **Resources & Health**

Unter **Vorhanden** wählst du nun das hochgeladene Plugin aus, akzeptierst ggfs die Lizenzbedingungen und klickst auf **Installieren**.
### 2. NIU Plus Lizenz buchen
Registriere dich in unserem Store
Wähle unter [https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite](https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite) das passende Paket und die passende Kaufoption aus
In diesem Beispiel ordern wir eine Lizenz für **NIU Plus Creative+** als **Vollversion** und tragen unsere Domain ein, ohne `https://` oder führendes `www.`
**Achtung!** Diese Auswahl ist nur möglich, wenn du bereits angemeldet bist. Eine Bestellung ohne Registrierung ist ausgeschlossen!
Wenn du bereits eine Demo- oder Entwicklerlizenz hast und angemeldet bist, kannst du alternativ zur Registrierung einer neuen Domain einfach unten im Dropdown deine bestehende Lizenz auswählen und in eine Vollversion umwandeln. Die passende Domain wird dann automatisch übernommen.
Domains einer produktiven Lizenz kannst du später in deinem Kundenkonto bearbeiten und ändern. Wenn du also auf einer Staging Domain gearbeitet hast, kannst du die Lizenz hier in eine Vollversion umwandeln und anschließend in deinem Kundenkonto auf die Live Domain umschreiben.
### 3. NIU Plus Companion Downloaden und installieren
Kehre nach erfolgreicher Buchung auf die Produktseite zurück und lade hier die passende Version der NIU Plus Companion App herunter: [https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite](https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite)
Lade anschließend die Zipdatei wie oben bei Resources & Health über den **Pluginmanager** in deinen Store hoch, und installiere das Plugin
### 4. Lizenz aktivieren
Wechsel in unserem Store in dein **Kundenkonto** unter **Meine Lizenzen** und kopiere dir den **Lizenzschlüssel** für deine Domain.
**Selbstdeaktivierung des Plugins**
Unter Umständen kann es passieren, dass sich das NIU Plus Companion Plugin so lange selbst deaktiviert, bis eine gültige Lizenz eingetragen wurde.
Aktiviere in diesem Fall das Plugin einfach wieder und wechsle **sofort** in die **Plugineinstellungen** und trage den Lizenzschlüssel ein. In wenigen Ausnahmefällen kann es sein, dass sich das Plugin noch ein mal selbst deaktiviert, nachdem du den Schlüssel eingetragen hast. Aber keine Sorge. Nach letztmaliger Aktivierung bleibt es auch aktiviert. Versprochen ;)
Das Plugin signalisiert dir, dass die Lizenz valide und aktiv ist.
### 5. Setup
Wechsle in den **Setup** Bereich und folge der Anleitung.
Lade zuerst die Templatefiles herunter
Du kannst in Schritt 2 die Schreibrechte prüfen. In aller Regel gibt es hier keine Probleme und dieser Schritt dient eher der Selbstkontrolle oder einem Entwickler, für den unwahrscheinlichen Fall, dass es Probleme bei der Installation geben sollte.
Klicke nun in Schritt 3 auf **Werkeinstellungen setzen**
### 6. Abschluss und weitere Schritte
**Herzlichen Glückwunsch!** Dein NIU Plus Template ist nun einsatzbereit.
Du kannst nun mit der Konfiguration fortfahren oder weitere Plugins installieren.
Wenn du **NIU Plus Creative+** oder höher erworben hast, kannst du nun einfach die Plugins der OPC Reihe installieren. Folge dazu den üblichen Schritten wie bisher:
Download des Installers von der Produktseite in der passenden Version
Hochladen über den Pluginmanager
Installation durchführen
**Für Creative+ und höher ist für Plugins der OPC Reihe keine Buchung oder Aktivierung einer Lizenz notwendig.** Die NIU Plus Creative+ Lizenz aktiviert automatisch die übrigen OPC Plugins.
***
## Kurzanleitung
Lade das Plugin DZM Resources & Health in deinen Shop hoch und installiere es
Lade das Plugin NIUplus Companion in deinen Shop hoch und installiere es
Trage deinen Lizenzschlüssel in den Plugineinstellungen ein und aktiviere deine Lizenz
Lade das Template NIUplus in deinen Template Ordner
Lade ggfs das ChildTemplate in deinen Template Ordner
Aktiviere das Template oder Childtemplate
Wechsel zum Companion, wähl den Reiter "Variablen" und klicke unten auf kompilieren
Wechsel zum Template, bearbeite es und speichere es erneut
Wechsel zum Companion
Gehe durch jeden Einstellungsreiter durch und klicke auf Speichern
Das Template sollte jetzt einsatzbereit sein. lösche ggfs den Cache
Achte darauf, dass du die richtigen Einstellungen in den Custom Boxes gesetzt hast
# Kategorieseite
Source: https://docs.dreizack-medien.de/NIU-Plus/kategorieseite
Hier findest du alle Einstellungen, welche sich global auf die Kategorieseiten auswirken.
## Darstellung Unterkategorien
### Deprecated Optionen nutzen
Lege hier fest, ob veraltete Einstellungen der Kategorieseite mit zukünftigen Versionen entfernt werden sollen.
Wenn "Deprecated Optionen nutzen" aktiviert ist, werden drei zusätzliche Einstellungen sichtbar: **Stil**, **Bildformat der Kategoriebilder** und **Bildanpassung**.
**Stil**
Entscheide hier, wie die Unterkategorien dargestellt werden sollen. Auswahl zwischen:
* **Als Grid** – Unterkategorien werden als Kachelraster mit Bild und Text nebeneinander dargestellt.
* **Als Slider** – Unterkategorien werden in einem horizontal scrollbaren Slider angezeigt.
**Bildformat der Kategoriebilder**
Lege das Seitenverhältnis der Kategoriebilder fest. Auswahl zwischen:
* **16:9** – Breitbildformat, geeignet für querformatige Motive oder Banner-ähnliche Bilder.
* **1:1** – Quadratisches Format, einheitlich und kompakt.
**Bildanpassung**
Lege fest, wie die Kategoriebilder in ihrem Container skaliert werden. Auswahl zwischen:
* **Cover (Bild füllt Container aus)** – Das Bild füllt den gesamten Container aus und wird dabei ggf. beschnitten. Geeignet für vollflächige Motive.
* **Contain (Bild passt sich an Container an)** – Das Bild wird vollständig angezeigt und an den Container angepasst, ohne beschnitten zu werden. Geeignet, wenn das Kategoriebild ein Produktbild ist, das komplett sichtbar sein soll.
Wenn "Deprecated Optionen nutzen" deaktiviert ist, stehen die aktuellen Einstellungen zur Verfügung. Die Optionen sind aufgeteilt nach **Kategorielevel 1** und **Kategorielevel über 1**, jeweils mit separaten Einstellungen für **Desktop** und **Mobil**.
**Border Radius**
Lege die Kantenabrundung der Unterkategorie-Karten fest. Trage einen CSS-Wert ein (z. B. `8px`). Der Wert `0` ergibt scharfe Ecken.
**Unterkategorie Darstellung**
Wähle, wie die Unterkategorien angezeigt werden sollen. Auswahl zwischen:
**Bilder anzeigen**
Aktiviere diesen Schalter, um Kategoriebilder in der Unterkategoriedarstellung anzuzeigen.
**Bildformat**
Lege das Seitenverhältnis der Kategoriebilder fest (z. B. `16 / 9` oder `1 / 1`).
**Object Fit**
Bestimme, wie das Bild in seinen Container eingepasst wird. Auswahl zwischen:
* **Contain (Bild passt sich an Container an)** – Das Bild wird vollständig angezeigt, ohne beschnitten zu werden.
* **Cover (Bild füllt Container aus)** – Das Bild füllt den Container vollständig aus und wird ggf. beschnitten.
**Slides per Page / Cards per row**
Lege fest, wie viele Karten pro Zeile bzw. Slides pro Seite angezeigt werden sollen. Du kannst für verschiedene Breakpoints separate Werte eintragen (von klein nach groß).
**Box Style**
Wähle den Kartenstyle für die Unterkategorie-Boxen. Auswahl zwischen:
* **Ohne Kartenstyle** – Kein Rahmen oder Hervorhebung.
* **Einfache Karte** – Dezenter Kartenstyle mit leichter Abgrenzung.
* **Schattierte Karte** – Karte mit Schattenwurf für mehr Tiefe.
* **Umrandete Karte** – Karte mit sichtbarem Rahmen.
* **Border oben/unten** – Linie nur oben und unten als Abgrenzung.
**Unter-Unterkategoriedarstellung**
Lege fest, wie Unter-Unterkategorien behandelt werden sollen. Auswahl zwischen:
* **Ausblenden** – Unter-Unterkategorien werden nicht angezeigt.
* **Anzeigen** – Unter-Unterkategorien werden sichtbar dargestellt.
**Pfeile anzeigen**
Aktiviere diesen Schalter, um Navigationspfeile im Slider anzuzeigen.
**Pagination anzeigen**
Aktiviere diesen Schalter, um Pagination-Punkte unter dem Slider anzuzeigen.
***
## Bannerdarstellung
### NIU Plus Banner Style anwenden
Hier kannst du wählen, ob der Banner im NIU-Plus-Banner-Style dargestellt werden soll. Hierzu muss im JTL-Shop die Einstellung 624 auf "Ja, mit Text und Bild" oder "Ja, als Bild" festgelegt sein.
### Bannerbild in voller Breite anzeigen
Dein Bannerbild kann mit dieser Einstellung in der kompletten Breite der Bilddatei dargestellt werden.
### Bannerbild Höhe
Wähle die Höhe des Bannerbilds über eine CSS Wert in px.
***
## Kategorietitel
Neben den hier beschriebenen Optionen kannst du den Standardtitel der Kategorie über das Attribut **niu\_alt\_cat\_title** überschreiben. Der Name bleibt dann im Menü gleich wie in der Wawi, aber der Titel auf der Kategorieseite wird durch das Attribut überschrieben
### Kategorietitel HTML Tag
Wähle aus, in welchem HTML Tag der Kategorietitel standardmäßig ausgegeben werden soll. Du kannst deine Auswahl speziell pro Kategorie über ein das Funktionsattribut **niu\_cat\_title\_tag** anpassen.
Mit dieser Einstellung kannst du die SEO Seitenstruktur verbessern. Wenn du zB in deiner Kategoriebeschreibung bereits eine H1 Überschrift verwendest und der Kategorietitel entsprechend keine H1 mehr sein soll, dann ändere hier das Tag. Über die Darstellung kannst du das Aussehen trotzdem noch steuern, ohne die SEO Struktur zu beeinflussen. Diese Option wendet sich auf alle Kategorieüberschriften an. Wenn du in einer speziellen Kategorie die Struktur ändern möchtest, überschreib die Standardeinstellung durch ein Funktionsattribut **niu\_cat\_title\_tag**. Trage in der Wawi als Wert lediglich die Bezeichnung ein. Für ein H1 Tag trage einfach **h1** ein.
### Kategorietitel Darstellung
Wähle hier aus, in welchem HTML Tag Design der Kategorietitel standardmäßig dargestellt werden soll. Dieser hat keinen Einfluss auf die SEO Struktur, nur auf die Optik, also ob der Titel aussehen soll wie beispielsweise eine H1 Überschrift. Du kannst den Wert individuell überschreiben mit einem Wawi Funktionsattribut mit dem Name **niu\_cat\_title\_class**
***
## Filterdarstellung
### Filterposition Desktop
Lege fest, wo die Filter auf dem Desktop positioniert werden sollen. Auswahl zwischen:
**Sidebar**
Auf der Kategorieseite gibt es einen "Filter-Button", der die Sidebar triggert.
**Sidepanel links**
Die Filter werden im linken Sidepanel ausgegeben.
**Über Produktübersicht**
Zusätzliche Einstellungen:
**Max. Anzahl intitial sichtbarer Filter Desktop:** Lege hier die Anzahl der Filter fest, die initial sichtbar sind. Standardwert: 8.
### Filterposition Mobil & Tablet
Lege fest, wo die Filter auf Mobil & Tablet positioniert werden sollen. Auswahl zwischen Sidebar und Über Produktübersicht.
***
## Produkte auch in Oberkategorien darstellen \[BETA]
Mit dieser Option kannst du alle Produkte, die in einer Kategorie liegen automatisch in der jeweiligen Oberkategorie anzeigen lassen. **ACHTUNG** Wenn du den Custom Menu Builder verwendest, könnte es zu verwirrenden Artikellisten führen, da sich die Zusammenfassung der Kategorien an der Standardkategorisierung der Wawi orientiert, so wie sie an den Shop übermittelt wird. **ACHTUNG! EXPERIMENTELL** - Dieses Feature ist Teil einer open public beta. Die Verwendung erfolgt auf eigene Verantwortung. Solltest du Fehler oder Probleme feststellen, kannst du uns gern kontaktieren und uns Feedback geben.
***
## Produktdarstellung
Hier findest du Einstellungen für die Details der Itembox. Diese wirkt sich auch auf Slider aus.
### Artikel pro Reihe (Gridansicht)
Lege hier fest, wie viele Produkte pro Reihe dargestellt werden sollen. Dabei kannst du für die jeweilige Kartenbreite unterschiedliche Einstellungen treffen.
### Abstand zwischen Elementen
Entscheide, wie viel Abstand zwischen den einzelnen Karten der Gridansicht vorhanden sein soll. Werte von 0-5.
### Störer
Mit Störern wird ein sich von den Produktkarten abhebendes Kartenelement eingefügt, mit dem du gezielt eine Information deiner Wahl an deinen Kunden übermitteln kannst.
Die Störer können über den OPC Editor gepflegt werden. Nutze das [Störer Container](/OPC-Plus/Stoerer-Container) Portlet, um den Störer über mehrere Spalten zu ziehen. Störer werden nur dann geladen, wenn mindestens so viele Produkte geladen werden wie du in den Positionen bestimmst. Störer werden nur dann angezeigt, wenn sie einen OPC Content gesetzt haben.
### Störer 1 Position
Hier kannst du festlegen, nach wie vielen Produkten der erste Störer erscheinen soll. Du kannst eine unterschiedliche Auswahl für die Mobile- und Desktop-Ansicht treffen.
### Störer 2 Position
Hier kannst du festlegen, nach wie vielen Produkten der zweite Störer erscheinen soll. Die Zählung für den ersten und zweiten Störer beginnt dabei beim selben Artikel; daher empfiehlt es sich, einen größeren Wert hierfür zu wählen. Du kannst eine unterschiedliche Auswahl für die Mobile- und Desktop-Ansicht treffen.
### Load More Button statt Pagination
Aktiviere diese Einstellung, damit dein Kunde sich mehr Artikel über den „Mehr Produkte laden"-Button anzeigen lassen kann, anstelle des Navigationselements der Seitennummerierung.
### Produkt Box Style
Lege hier einen Style für die Produktboxen fest. Der Style der Produktboxen hat Auswirkungen auf die Darstellung der Produkte in der Grid Ansicht, sowie in allen Slidern, die auf das Template zurückgreifen. Auswahl zwischen:
### Produkt Box als Karte darstellen
Entscheide, ob die einzelnen Produkte als Karte dargestellt werden sollen. Mit einem Kartenstyle heben sich die Produkt Boxen gut voneinander ab und Informationen wirken näher beieinander. Bitte beachte aber, dass sich der Style auf die Darstellung der Artikelbilder auswirken kann. Verwendest du keine gut freigestellten Bilder mit sauberem Hintergrund, kann der Kartenstyle eher unruhig wirken. Deaktiviere in diesem Fall den Style.
Kein Kartenstyle – die Produktboxen werden ohne Rahmung oder Hervorhebung dargestellt.
### Border Radius der Karte
Hier kannst du die Kantenabrundung der Produktkarten festlegen. Verwende eine CSS Auszeichnung, um den Border Radius festzulegen. Beispiele:
```elixir theme={null}
0 -> Keine Abrundung
5px 5px 5px 5px -> 5px an jeder Seite
5px -> 5px an jeder Seite
0 10px 5px 0 -> Oben links 0, oben rechts 10px, unten rechts 5px, unten links 0
15px 10px -> Oben links und unten rechts 15px, oben rechts und unten links 10px
```
### Produktbewertungen anzeigen
Entscheide, ob die Produktbewertungen in der Kategorieansicht bzw. in Slidern direkt am Produkt dargestellt werden sollen.
### Anzahl Produktvariationen anzeigen
Entscheide, ob die Anzahl der Produktvariationen in der Kategorieansicht bzw. in Slidern direkt am Produkt dargestellt werden sollen.
### Produktkurzbeschreibung anzeigen
Entscheide, ob eine Kurzbeschreibung deines Produkts in der Karte angezeigt werden soll.
### Preisdarstellung
Lege fest, wie die Preise deiner Produkte in der Kategorieansicht bzw. in Slidern angezeigt werden sollen. Auswahl zwischen:
### Lagerbestandsanzeige darstellen
Entscheide, ob die Lagerbestandsanzeige der einzelnen Produkte in der Kategorieansicht bzw. in Slidern dargestellt werden soll. Auswahl zwischen:
***
## Kategorietexte
Hier findest du Einstellungen für den Kategoriebeschreibungstext, den du über die Wawi gepflegt hast.
### Kategorietext Position
Lege fest, an welcher Stelle der Kategoriebeschreibungstext ausgegeben werden soll. Auswahl zwischen **Über Produktgallerie**, **Unter Produktgallerie** und **Geteilt per Trennzeichen**.
### Geteilt per Trennzeichen
Wenn du **Geteilt per Trennzeichen** als Kategorietext Position wählst, wird der Kategoriebeschreibungstext anhand eines definierten Trennzeichens in mehrere Spalten aufgeteilt. Folgende Einstellungen werden dann sichtbar:
Lege fest, in wie viele Spalten der Text aufgeteilt werden soll.
Definiere das Zeichen oder die Zeichenfolge, anhand derer der Text aufgeteilt wird. Standard: `---`
# KI & Crawler
Source: https://docs.dreizack-medien.de/NIU-Plus/ki-crawler
Optimiere deinen Shop für KI-Systeme und Suchmaschinen-Crawler durch gezielte Bot-Erkennung und schlanke Seitenausgabe.
## KI & Crawler Optimierung
Bot-irrelevante Elemente (Inline Styles, Scripts) werden für erkannte Bots nicht gerendert. Das reduziert die Seitengröße erheblich und verbessert die Lesbarkeit für KI-Systeme und Suchmaschinen-Crawler.
***
## Erkennungsmethoden
Hier legst du fest, anhand welcher Kriterien das System einen Besucher als Bot oder Crawler identifizieren soll.
### Accept Header: text/markdown
Aktiviere diese Option, um Anfragen zu erkennen, die über den HTTP-Accept-Header `text/markdown` signalisieren, dass es sich um einen KI- oder Crawler-Client handelt. Viele moderne KI-Systeme nutzen diesen Header, um Inhalte im Markdown-Format anzufragen.
### Bekannte KI-Bots
Aktiviere diese Option, um bekannte KI-Bots (z. B. GPTBot, ClaudeBot, PerplexityBot) anhand ihrer User-Agent-Zeichenkette zu erkennen und die optimierte Seitenausgabe zu aktivieren.
### Suchmaschinen-Crawler
Aktiviere diese Option, um klassische Suchmaschinen-Crawler (z. B. Googlebot, Bingbot) ebenfalls als Bots zu erkennen und für diese die bereinigte Ausgabe ohne unnötige Elemente zu liefern.
# Kundengruppen
Source: https://docs.dreizack-medien.de/NIU-Plus/kundengruppen
Konfiguriere gruppenspezifische Einstellungen für Registrierung, Checkout und Freischaltungen im NIU Plus Template.
## Kundengruppen-Selbstzuordnung
Kunden können sich bei der Registrierung oder im Checkout einer Kundengruppe zuordnen. Du konfigurierst hier, welche Gruppen verfügbar sind und wie die Aktivierung erfolgt.
Aktiviert das Kundengruppen-Dropdown im Registrierungsformular und/oder Checkout.
***
## Registrierung
Konfiguriere welche Kundengruppen im Registrierungsformular zur Auswahl stehen.
Wähle die Kundengruppen aus, die im Registrierungsformular angeboten werden sollen. Zur Auswahl stehen: **Endkunden**, **Händler**, **B2B-Prime**, **B2B-Elite**.
Diese Kundengruppe ist im Dropdown vorausgewählt. Erscheint sobald mindestens eine Kundengruppe ausgewählt wurde.
***
## Checkout-Einstellungen
Konfiguriere welche Kundengruppen im Checkout angeboten werden.
Wähle die Kundengruppen aus, die im Checkout angeboten werden sollen. Zur Auswahl stehen: **Endkunden**, **Händler**, **B2B-Prime**, **B2B-Elite**.
Wenn aktiv, können auch Gastbesteller (ohne Kundenkonto) eine Kundengruppe wählen. Andernfalls erscheint das Dropdown nur, wenn der Kunde im Checkout „Neues Kundenkonto anlegen" aktiviert.
***
## Aktivierungsmodus
Bestimme pro Kundengruppe, wann die Zuordnung aktiv wird.
Dieser Abschnitt erscheint sobald für Registrierung oder Checkout mindestens eine Kundengruppe ausgewählt wurde.
Aktivierungsmodus für Endkunden. Optionen: **Sofort**, **Nach Checkout**, **Nach Freischaltung**.
Aktivierungsmodus für Händler. Optionen: **Sofort**, **Nach Checkout**, **Nach Freischaltung**.
Aktivierungsmodus für B2B-Prime. Optionen: **Sofort**, **Nach Checkout**, **Nach Freischaltung**.
Aktivierungsmodus für B2B-Elite. Optionen: **Sofort**, **Nach Checkout**, **Nach Freischaltung**.
***
## Formularfelder (Phase 2)
Formularfeld-Konfiguration pro Kundengruppe wird in Phase 2 umgesetzt.
***
## Uploads (Phase 2)
Upload-Konfiguration pro Kundengruppe wird in Phase 2 umgesetzt.
***
## Freischaltungen (Phase 2)
Freischaltungs-View mit Pending-Einträgen wird in Phase 2 umgesetzt.
# Menü
Source: https://docs.dreizack-medien.de/NIU-Plus/menue-2
## Allgemein
Hier aktivierst du die grundlegende Funktionalität des Menüs.
### NIU Menü-Sidebar benutzen
Aktiviere diesen Schalter, um die NIU Menü-Sidebar als primäres Navigationselement zu verwenden.
***
## Details
In diesem Bereich nimmst du Feinjustierungen an der Darstellung und den Inhalten des Menüs vor.
### Icon Position Desktop
Lege fest, wo das Menü-Icon (Burger-Menü) auf Desktop-Geräten platziert werden soll (z. B. "Oben rechts bei den NavIcons").
### Untertitel anzeigen
Aktiviere diese Option, um Untertitel zu den Menüpunkten anzuzeigen, sofern diese in den Kategoriedaten gepflegt sind.
### Kategoriebilder anzeigen
Aktiviere diesen Schalter, um die Kategoriebilder innerhalb des Menüs darzustellen.
### Kategoriebilder Breite in px
Definiere die Breite der Kategoriebilder in Pixeln (z. B. `100`).
### Kategoriebilder Aspect Ratio
Gib das Seitenverhältnis der Bilder an (z. B. `16 / 9`), damit diese einheitlich und responsiv skaliert werden.
### Kategoriebilder vollständig im Container anzeigen
Aktiviere diese Option, wenn das Bild vollständig im verfügbaren Platz angezeigt werden soll (Contain-Modus), ohne beschnitten zu werden. Ist die Option deaktiviert, wird das Bild den Bereich ausfüllen (Cover-Modus).
# Menu Builder (BETA)
Source: https://docs.dreizack-medien.de/NIU-Plus/menue-builder-beta
Erstelle und verwalte individuelle Menüstrukturen völlig frei und unabhängig von der Standard-Kategoriehierarchie.
## Disclaimer ( BETA)
Der Menu-Builder ist ein mächtiges Werkzeug, das sich aktuell noch in der Entwicklungsphase befindet.
**Open BETA Status**
Dieser Menu-Builder befindet sich in der **Open BETA**. Wir laden dich herzlich dazu ein, das Feature in einer **Testumgebung** zu testen und uns Feedback zu geben.
Bitte beachte, dass wir noch keine Garantie auf vollständige Funktionsfähigkeit geben können. Die Nutzung in produktiven Systemen unterliegt der eigenen Verantwortung.
### Aktivierung
Um den Menu-Builder zu nutzen, musst du den Hinweis bestätigen und das Feature aktiv einschalten.
**Ich habe den Hinweis verstanden und aktiviere den Menubuilder auf eigene Gefahr in einer Testumgebung:** Aktiviere diesen Schalter, um die Funktionen des Builders freizuschalten.
***
## Menü Struktur
Hier kannst du deinen Navigationsbaum per Drag-and-Drop (in der Regel bei solchen Buildern üblich) und über die Aktions-Buttons zusammenstellen.
### Menüpunkte verwalten
In der Übersicht siehst du deine aktuelle Menüstruktur als Baumdiagramm. Du kannst Hierarchien bilden (Hauptpunkte und Unterpunkte).
* **Bearbeiten (Stift-Icon):** Klicke auf den Stift neben einem Eintrag, um dessen Namen, Ziel oder Eigenschaften zu ändern.
* **Ausgewählte Punkte löschen (Mülleimer):** Klicke auf den roten Button, um alle aktuell angehakten Menüpunkte unwiderruflich zu entfernen.
### Aktionen
Unterhalb der Struktur findest du die Hauptaktionen:
* **Menüpunkt hinzufügen:** Klicke auf den grünen Button, um einen neuen Menüpunkt hinzuzufügen. Es öffnet sich das Formular "Neuer Menüpunkt" mit folgenden Feldern:
**LinkTyp:** Wähle den Typ des Menüpunkts. Verfügbare Optionen: Seite, Kategorie, Link.
**Kategorie:** Wähle die Zielkategorie aus dem Dropdown (nur bei LinkTyp "Kategorie").
**Seite:** Wähle die Zielseite aus dem Dropdown (nur bei LinkTyp "Seite"). Verfügbare Seiten: Startseite, Mein Konto, Impressum, Versandinformationen, Sitemap.
**Unterseiten übernehmen?** Aktiviere diesen Schalter, um alle Unterseiten der gewählten Kategorie automatisch in das Menü zu übernehmen.
**Alternativtitel Deutsch / Englisch / Spanisch:** Trage hier einen abweichenden Anzeigetitel für den Menüpunkt in der jeweiligen Sprache ein. Bleibt das Feld leer, wird der Standardname verwendet.
**Zusätzliche CSS Klassen:** Füge dem Menüpunkt eigene CSS-Klassen hinzu (z. B. `alert alert-danger`), um ihn individuell zu stylen.
**Zusätzliches CSS:** Trage hier direktes Inline-CSS für den Menüpunkt ein (z. B. `border: 1px solid #e5e5e5;`).
**Zusätzliches HTML:** Füge eigenes HTML hinzu, das zusammen mit dem Menüpunkt gerendert wird (z. B. ein SVG-Icon ``).
* **Ausgewählte Punkte löschen (Mülleimer):** Klicke auf den roten Button, um alle aktuell angehakten Menüpunkte unwiderruflich zu entfernen.
# Checkout
Source: https://docs.dreizack-medien.de/NIU-Plus/niu-checkout
Optimiere den Bestellprozess mit dem NIU Checkout, detaillierten Artikelkarten und vertrauensbildenden Elementen.
## NIU Checkout
Hier aktivierst und konfigurierst du das optimierte Checkout-Layout des Themes.
**Achtung!** Bei Aktivierung des neuen Checkouts müssen für den Express Checkout neue CSS Query-Selektoren eingestellt werden. Die Aktivierung hat auch Auswirkungen auf den Sidebar Warenkorb und aktiviert die Toast Messages.
### NIU Checkout verwenden
Aktiviere den neuen Checkout, der sich am bewährten Shopify Checkout orientiert und schalte neue Features frei für bessere Conversions und mehr Trust.
**ACHTUNG!** Bei Aktivierung des neuen Checkouts müssen für den Express Checkout neue CSS Query-Selektoren eingestellt werden. Die Aktivierung des Checkouts hat auch Auswirkungen auf den Sidebar Warenkorb und aktiviert die Toast Messages.
### Express Checkout Container verwenden
Aktiviert eine extra Karte im Checkout für deine Express Checkout Buttons. Verwende die ID **niu-checkout-express-container** als Selektor, um die Buttons dort einzufügen.
### Versand- und Zahlungsicons anzeigen
Zeigt auf der ersten Checkout Seite eine neue Karte an, die alle deine ausgewählten Zahlungs- und Versandicons beinhaltet, um dem User eine Preview möglicher Optionen vorab anzuzeigen. Dadurch soll Vertrauen gestärkt werden, um den ersten Schritt abzuschließen. Um Verwirrungen auszuschließen, solltest du diese Option im besten Fall nur dann verwenden, wenn du gewährleisten kannst, dass deine Optionen im nächsten Schritt auch zur Verfügung stehen.
### Zahlungsicons anzeigen
Steuere spezifisch die Sichtbarkeit der Icons für Zahlungsarten.
### Versandicons anzeigen
Steuere spezifisch die Sichtbarkeit der Icons für Versandarten.
### Position der Zahlungs- und Versandicons
Lege fest, an welcher Stelle die Icons platziert werden sollen zwischen
* Unterm Button zum nächsten Schritt
* In eigener Box vor dem Button zum nächsten Schritt
***
## CSV Importer verwenden
### CSV Importer im Kundenkonto verwenden
Aktiviere diesen Schalter, um den CSV Importer im Kundenkonto zu aktivieren. Damit können Kunden Bestellungen per CSV-Datei aufgeben, anstatt Artikel einzeln in den Warenkorb zu legen.
### Erlaubte Kundengruppen
Wähle aus, für welche Kundengruppen der CSV Importer im Kundenkonto sichtbar sein soll.
***
## Artikelkarten
Diese Einstellungen beschäftigen sich mit der Darstellung der Artikel (Item Cards) im Checkout und in der Zusammenfassung.
### Verfügbarkeit und Lieferzeit anzeigen
Aktiviere diese Option, um den Lagerstatus und die Lieferzeit direkt in der Artikelkarte anzuzeigen.
### Variationsinformationen anzeigen
Entscheide, ob gewählte Variationen (z. B. "Größe: L", "Farbe: Rot") angezeigt werden sollen.
### Konfigurationsdetails anzeigen
Lege fest, ob Details aus dem Konfigurator (falls verwendet) sichtbar sein sollen.
### Produktdetails anzeigen
Steuere die Anzeige allgemeiner Produktdetails.
### SKU anzeigen
Aktiviere diese Option, um die Artikelnummer (SKU) anzuzeigen.
### GTIN anzeigen
Aktiviere diese Option, um die Global Trade Item Number (EAN/GTIN) anzuzeigen.
### Dimensionen anzeigen
Entscheide, ob Maße oder Gewichtsangaben des Artikels in der Übersicht dargestellt werden sollen.
***
## Couponhinweis
Das Theme integriert einen Hinweis auf die Coupon-Eingabe bereits in Schritt 1 und 2 des Checkouts, um Unsicherheiten bei Kunden zu vermeiden, da das technische Eingabefeld oft erst im letzten Schritt erscheint.
### Couponhinweis ausblenden, wenn kein verfügbarer Coupon vorhanden ist.
Aktiviere diese Option, wenn der Hinweistext komplett ausgeblendet werden soll, falls im Kundenkonto oder Warenkorb technisch kein Coupon zur Verfügung steht.
***
## Trust Container
Hier kannst du einen globalen Inhalt (z. B. eine USP-Bar oder Trust-Badges) definieren, der im Checkout angezeigt wird, um das Vertrauen zu erhöhen.
### Trust Container ID
Trage hier die ID des CMS-Blocks oder Portlets ein, das an dieser Stelle geladen werden soll (z. B. `trust-checkout`).
### Trust Container Style
Hier kannst du bei Bedarf spezifische CSS-Styles für den Container hinterlegen.
***
## Sonstige
Hier findest du Einstellungen zur Erfassung zusätzlicher Kundeninformationen, wie beispielsweise einer internen Referenznummer.
### Kundenreferenz Eingabe erlauben
Es wird ein Eingabefeld angezeigt, in welches der Kunde seine eigene Referenz angeben kann. Der Inhalt wird als Custom Attribute im Auftrag gespeichert und an die Wawi übergeben. Der Inhalt befindet sich dann im Auftrag unter Eigene Felder im Feld Kundenreferenz. Du kannst dieses Feld nutzen, um die Kundenreferenz auf deinen Druckvorlagen auszugeben.
### Name des Feldes wie es in der Wawi ankommen soll
Definiere hier den internen Namen des Feldes, damit die Daten korrekt an die JTL-Wawi übergeben werden (Standard: `Kundenreferenz`).
# Produktdetailseite
Source: https://docs.dreizack-medien.de/NIU-Plus/produktdetailseite
Produktdetailseiten-Einstellungen und Custom Boxes
## Allgemeine Einstellungen
### Gallerietyp
Wähle hier einen passenden Gallerietypen für die Produktbilder auf deiner Produktdetailseite. Auswahl zwischen:
**Slider**
### Border Radius
Hier kannst du die Kantenabrundung festlegen. Verwende eine CSS Auszeichnung, um den Border Radius festzulegen. Beispiele:
```elixir theme={null}
0 -> Keine Abrundung
5px 5px 5px 5px -> 5px an jeder Seite
5px -> 5px an jeder Seite
0 10px 5px 0 -> Oben links 0, oben rechts 10px, unten rechts 5px, unten links 0
15px 10px -> Oben links und unten rechts 15px, oben rechts und unten links 10px
```
### Media Videos in Gallerie darstellen
Du hast hier die Option Youtube oder lokale Videos aus den am Produkt hinterlegten Medien in der Gallerie anzeigen zu lassen. Allgemeine Anforderung: Das Video muss mit Attribut 'niu\_gallery\_video' angelegt sein und sollte mindestens einen Titel haben. Lokale Videos: Achte darauf, dass du einen Filetyp hinterlegt hast YouTube Videos: Hinterlege NUR den Videocode im Feld der URL. Blende Youtubevideos nicht zusätzlich als Custom Box ein.
### Productinfo-Nav Box Card Style
Stil der Productinfo-Nav, also der Zeile unterhalb der gesamten Productform, in die du CustomBoxes einfügen kannst (siehe unten CustomBoxes)
### Productinfo-Nav und Downloads/Medien Box Border Radius
Hier kannst du die Kantenabrundung festlegen. Verwende eine CSS Auszeichnung, um den Border Radius festzulegen. Beispiele:
```elixir theme={null}
0 -> Keine Abrundung
5px 5px 5px 5px -> 5px an jeder Seite
5px -> 5px an jeder Seite
0 10px 5px 0 -> Oben links 0, oben rechts 10px, unten rechts 5px, unten links 0
15px 10px -> Oben links und unten rechts 15px, oben rechts und unten links 10px
```
### Downloads/Medien Box Card Style
Stil der Download Elemente für Downloadpreview und Downloadmedien.
***
## BuyBox
Die Buybox ist der rechte Container der Artikeldetailseite, in dem alle kaufrelevanten Informationen enthalten sind.
### Sticky Checkout Container aktivieren
Soll die Buy Box beim scrollen im Sichtfeld des Kunden mit laufen?
Achtung! Solltest du andere Plugins verwenden, die einen Popup Button mit in diesen Bereich einfügen, kann das ungewünschte Auswirkungen auf das Popup haben, je nachdem wie die Entwickler das Popup gestaltet haben. Deaktiviere im Zweifel diese Option und wende dich an die Entwickler mit der Bitte, ihr Popup, respektive 'Modal' außerhalb des Containers einzubinden.
### Spaltenbreite Galerie zu Buybox auf Desktop
Bestimmt die Spaltenbreite der Artikelgalerie und der Buybox auf dem Desktop Die Summe muss 12 ergeben. Standard ist 7:5.
### Buy Box Card Style
Lege hier einen Style für deine Buy Box fest.
### Buy Box Border Radius
Hier kannst du die Kantenabrundung festlegen. Verwende eine CSS Auszeichnung, um den Border Radius festzulegen. Beispiele:
```elixir theme={null}
0 -> Keine Abrundung
5px 5px 5px 5px -> 5px an jeder Seite
5px -> 5px an jeder Seite
0 10px 5px 0 -> Oben links 0, oben rechts 10px, unten rechts 5px, unten links 0
15px 10px -> Oben links und unten rechts 15px, oben rechts und unten links 10px
```
### Artikelnummer ausblenden
Lege fest, ob deine Artikelnummer angezeigt werden soll.
### Bundle Hinweis Nutzen
Lege fest, ob der Hinweis auf einen Vorteilspreis beim Kauf mehrerer Artikel angezeigt werden soll.
### Variationsauswahl anzeigen
Wenn du ohnehin die Variationsauswahl in der Sidebar über die Custom Boxes aktiviert hast, kannst du hier die standardmäßige Variationsauswahl deaktivieren, um mehr Raum für wesentliche Inhalte zu schaffen. Deine Kunden können über die Variationsauswahl in der Sidebar direkt auf Kindartikel zugreifen, ohne erst die Kombination aus Variationen manuell auswählen zu müssen.
### Variationsübersicht Sidebar aktivieren
Aktiviert auf Vaterartikeln mit Klick auf 'Produktvariation wählen' die Sidebar mit allen Kindartikeln zur Direktauswahl
### Lieferzeiten mit anzeigen
Entscheide, ob die Lieferzeit des Artikels unterhalb der Bestandsanzeige auf der Produktdetailseite ausgegeben werden soll.
### Kurzübersicht einzelner Lager anzeigen
Zu diesem Zweck muss die Lageranzeige für einzelne Lager aktiviert sein:
[Zur Shopeinstellung](https://latest.niuplus.de/admin/warehouses)
### Versandkostenfrei-Progressbar anzeigen
Zeigt die Versandkostenfrei Progressbar unter dem Warenkorbbutton an, wenn diese in den Warenkorbeinstellungen aktiviert wurde und mindestens ein kostenfreier Versand zur Verfügung steht.
### Zahlungsicons mit anzeigen
Lege fest, ob die Zahlungsicons mit auf der Produktdetailseite angezeigt werden sollen. Diese kannst du in den [Footereinstellungen](https://app.clickup.com/4655718/v/dc/4e2k6-14581/4e2k6-19955?block=block-9bd7fd92-98e2-4388-bb45-0d4cabb14638) anpassen.
### Warenkorb Button ausblenden, wenn nicht verfügbar
Entscheide ob der Warenkorb Button ausgeblendet werden soll, wenn das Produkt keinen Zulauf, Lieferantenbestanden, Erscheinungsdatum oder eigenen Bestand hat. Unabhängig davon ob Überverkäufe erlaubt sind oder nicht.
Diese Option kann durch setzen des Attributs **niu\_force\_show\_checkoutbutton** beim entsprechenden Artikel in der Wawi außer Kraft gesetzt werden.
### Spaltenbreite Mengenauswahl
Gib pro Ansichtsfenster – von sehr klein (XS) bis sehr groß (XL) – an, wie breit die Mengenauswahlbox sein soll.
### Spaltenbreite Warenkorb Button
Gib pro Ansichtsfenster – von sehr klein (XS) bis sehr groß (XL) – an, wie breit der Warenkorb-Button sein soll.
### USP 1-3
Du kannst bis zu drei Alleinstellungsmerkmale (Unique Selling Points) aktivieren; zu diesen kannst du jeweils ein Icon aus der Liste auswählen.
Den Text der USPs kannst du in den Sprachvariablen über **niu\_buybox\_usp1\_text**, **niu\_buybox\_usp2\_text** und **niu\_buybox\_usp3\_text** festlegen
### Floating Cart Button verwenden
Hier kannst du einen schwebenden Warenkorbbutton einblenden, wenn der eigentliche Button nicht im Sichtfeld ist.
### BuyForm auf Buybox beschränken (Hinweis lesen)
Darüber wird die HTML Form für Kauf und andere Aktionen auf die Größe der BuyBox reduziert. Dadurch kannst du per Custom Boxes Elemente platzieren, die ebenfalls eine Form besitzen, ohne dass sich diese gegenseitig behindern. Solltest du den Konfigurator nutzen, musst du diese Funktion deaktivieren, weil der Konfigurator die BuyForm benötigt. Bei deaktivierter Option funktionieren Elemente in der Sidebar weiterhin uneingeschränkt und unabhängig. Lass diese Option im Zweifel deaktiviert und verwende die Sidebar für Form Elemente oder platziere Custom Boxes unterhalb der Artikeldetails.
***
## Zusatzprodukte anbieten
Du kannst mit 2 speziellen Crosssellinggruppen Zusatzartikel anbieten, die in der BuyBox mit gelistet werden.
### Einrichtung
Um Zusatzprodukte anzubieten benötigst du spezielle Crosssellingruppen, die du in der Wawi pflegst.
**niu\_additionals\_single#** und **niu\_additionals\_multiple#** — Du kannst mehrere solcher Crosssellinggruppen anlegen. Wichtig ist, dass der Name so lautet wie gerade beschrieben, inkl. "#". Nach dem "#" kannst du einen normalen Namen vergeben, zB. **niu\_additionals\_single#Zusatzproducte gleich mitbestellen**. Dieser Name steht als Titel über der Liste an Produkten. In **niu\_additionals\_single#** Gruppen kannst du Artikel hinzufügen, die du exakt ein mal per Checkbox aktivieren lassen möchtest. In **niu\_additionals\_multiple#** Gruppen kannst du Artikel hinzufügen, die über eine Mengenauswahl mehrfach hinzugefügt werden können. Du steuerst den Initialwert dabei über die Mindestbestellmenge und das Abnahmeintervall, wie gewohnt. Achte aber darauf, dass bei einer Mindestbestellmenge der Zusatzartikel zwingend mit in den Warenkorb gelegt wird, auch wenn der Kunde diesen wieder aus seinem Warenkorb entfernen kann.
### Kartenstil der Artikelelemente
Wähle hier zwischen verschiedenen Styles Zusatzartikelkarten.
### Bild mit anzeigen
Entscheide ob das Produktbild mit angezeigt werden soll.
### Kurzbeschreibung mit anzeigen
Aktivieren die Anzeige der Kurzbeschreibung hier.
Alternativ kannst du das spezielle Attribut **niu\_additionals\_short\_desc** für eine alternative Kurzbeschreibung innerhalb der Boxen verwenden. Wenn das Attribut gesetzt ist, wird die Beschreibung immer angezeigt. Ist es nicht gesetzt, wird die Kurzbeschreibung nur dann angezeigt, wenn die entsprechende Option aktiviert ist.
### Einheit bei Menge anzeigen
Hier kannst du die Anzeige der Mengeneinheit deiner Zusatzartikel aktivieren.
***
## NIU+ HiLite
Sag Hallo zu NIU+ HiLite - der Option, die die Farbstimmung deiner Produktfotos aufgreift und deinen Shop um eine stimmungsvolle Farbgebung bereichert.
### HiLite verwenden
Aktiviere hier diese Option.
***
## Produktempfehlungs Slider
### Kunden kauften auch Slider darstellen
Aktiviert den Slider, welcher Produkte auf Basis des Kaufverhaltens von Kunden für denselben Artikel anzeigt.
Dafür muss die JTL Shop Einstellung [87](https://latest.niuplus.de/admin/config?einstellungen_suchen=1\&cSuche=87) aktiv sein.
### Ähnliche Produkte Slider darstellen
Aktiviert den Slider, welcher gleichartige Produkte anzeigt.
Dafür muss die JTL Shop Einstellung [1123](https://latest.niuplus.de/admin/config?einstellungen_suchen=1\&cSuche=1123) mehr als 0 sein.
***
## 30 Tage Bestpreis
⚠️ **Wichtiger Hinweis:** Die Regelung der Omnibus-Richtlinie, aus der der laienhafte Begriff '30-Tage-Bestpreis' entspringt sieht nicht vor, dass eine Markierung als 30 Tage Bestpreis am Artikel geführt werden muss. Die Regel bezieht sich ausschließlich auf rabattierte Artikel. Dazu muss am Artikel 1. ein Bezugspreis stehen, also der ursprüngliche Preis und 2. muss dieser Preis dem niedrigsten Preis der letzten 30 Tage entsprechen. Das bedeutet, dass dein Standard VK in der Wawi so gepflegt sein muss, dass er nicht höher liegt als der aktuelle VK, bevor du einen Rabatt darauf anwendest. Dennoch kann eine Auszeichnung als 30 Tage Bestpreis vorteilhaft für deine Verkäufe sein und gibt dem Kunden ein gutes Gefühl. Geh sparsam damit um und pflege in erster Linie deine korrekten Preise, vermeide Ballonpreise und Fake-Rabatte.
### 30 Tage Bestpreis Badge anzeigen
Hier aktivierst du die Anzeige für ein Badge unter dem Preis mit frei wählbarem Text an, wenn der Standard VK dem niedrigsten VK des aktuellen und letzten Monats entspricht.
Den Text für den Bestpreis Badge kannst du in den Sprachvariablen über **niu\_best\_price** festlegen.
### Bestpreis statt Alter Preis
Hier ersetzt due die Anzeige '**Alter Preis**' durch ein durchgestrichenes Best Preis Badge, wenn du einen Rabatt pflegst und der sonst Standard VK dem niedrigsten VK des aktuellen und letzten Monats entspricht.
### Hinweis auf Bestpreis anzeigen
Hier aktivierst du einen abgesetzten Hinweis mit dem Wert des aktuellen Bestpreises des letzten Zeitraums, wenn der aktuelle Standard VK vor Rabatt höher liegt als der niedrigste VK des aktuellen und letzten Monats.
***
## Custom Boxes
**Allgemeines**
### Mobil Box unter Produktbild und Box unter Buybox tauschen
Standardmäßig wird mobil zuerst der Content der Boxen unter dem Produktbild und anschließend der Content der Boxen unter der Buybox ausgegeben. Mit Aktivierung der Checkbox tauschen die beiden Slots ihren Platz unter mobilen Endgeräten.
Videoeinführung in Custom Boxes
***
### Was sind Custom Boxes und worauf ist zu achten?
Custom Boxes ist unsere Antwort auf überladene Produktdetailseiten und dein Weg zu einer verkaufsoptimierten Produktpräsentation bei der Produkt und Crossselling Artikel wieder im Fokus des Users sind. Sämtliche "Tabs", die du von JTL kennst, werden bei uns über Custom Boxes abgebildet. Oben drauf haben wir noch nette Zusatzoptionen für eigene Boxen. Custom Boxes kannst du beliebig verteilen und in die dafür vorgesehenen Slots einbauen. Dabei bieten dir Custom Boxes viele Gestaltungsmöglichkeiten. Ein Grundkonzept ist die Zusammenarbeit mit der Sidebar. Standardmäßig werden alle Inhalte per Klick über Sidebar aufgerufen. Bis auf Custom Boxes vom Style "Button" hast du aber immer die Möglichkeit über eine Option den Inhalt direkt in der Box ausgeben zu lassen. So kannst du relevante Daten direkt anzeigen lassen und zusätzliche Informationen über die Sidebar zur Verfügung stellen.
**Ist das nicht schlecht fürs SEO?** Nein, ist es nicht. Fürs SEO wäre es nur schlecht, wenn du Texte komplett versteckst und damit versuchst die Suchmaschine zu täuschen. Inhalte, die bei Bedarf über Sidebars oder Akkordions bereitgestellt werden, sind SEO-technisch absolut unproblematisch.
**WICHTIG:** Damit jede Box dargestellt werden kann, muss die entsprechende Option im Shop auch aktiviert sein. zB: Wenn du die Box **Frage zum Artikel** nutzen möchtest, dann muss auch im Shop die Form **Frage zum Artikel** aktiv sein. Gleiches gilt für alle anderen Boxen wie **Bewertung** oder **Medien Tabs**
### In Kürze
Um eine Custom Box anzulegen, klickst du lediglich auf das kleine **+** auf den jeweiligen Slots und wählst den Typ der Custom Box aus. Scroll anschließend nach unten, klick auf **Hinzufügen** und abschließend im Haupteinstellungsbereich unten rechts auf **Speichern,** um die Änderung auch im Shop zu übernehmen.
### Boxen-Typen
#### Custom Template
Die Custom Box für Templateentwickler: Diese Box bietet dir die Möglichkeit ein eigenes Templatefile innerhalb deiner Box oder der Sidebar zu laden. Hinterlege dafür hier den Namen des Templatefiles und lege im Childtemplate Ordner dein File in folgendem Verzeichnis an:
```plain theme={null}
/niu-components/sidebar/mein_template_file.tpl
```
# SEO
Source: https://docs.dreizack-medien.de/NIU-Plus/seo
Konfiguriere erweiterte SEO-Einstellungen, strukturiere Daten mit LD+JSON und steuere das Crawling-Verhalten detailliert.
## Allgemein
Hier kannst du globale SEO-Funktionen und Debugging-Optionen steuern.
### Experimentelle SEO Einstellungen aktivieren
Aktiviere diesen Schalter, um Zugriff auf neue, noch in der Entwicklung befindliche SEO-Features zu erhalten (siehe Abschnitt "Experimentelle Funktionen" weiter unten).
### DEBUG MODE
Aktiviere diese Option, um Konsolenausgaben zu den SEO-Einstellungen im Browser zu erhalten. Dies ist hilfreich zur Fehleranalyse.
***
## Robots Text
Diese Optionen erscheinen nur, wenn du oben **Experimentelle SEO Einstellungen aktivieren** eingeschaltet hast. Bitte teste diese Funktionen sorgfältig, da sie tief in das Indexierungsverhalten eingreifen.
Der Robots Text weist Suchmaschinen Crawler an, dass sie eine Seite indexieren und den Links auf der Seite folgen sollen oder nicht. Es ist eine Empfehlung, kein Muss. Dennoch ist es sinnvoll manche Seitentypen durch diese Anweisungen von der Indexierung mancher Seiten auszuschließen. Einige Seiten kannst du über die Shopeinstellungen direkt ausschließen. Diese erhalten dann die Variable `\$noIndex = true`. Andere Arten wie Paginationen oder aktive Filterseiten haben diese Option nicht. Du kannst hier für alle diese Typen eigene Robots Anweisungen hinterlegen und priorisieren.
* **Robots für noindex:** Lege eine Regel für Seiten fest, die per Variable `$noIndex` ausgeschlossen wurden.
* **Robots für Folgeseiten (Pagination):** Steuere das Indexierungsverhalten auf Seite 2, 3 usw. von Artikellisten.
* **Robots für aktive Filter:** Definiere Regeln für Artikellisten, auf denen Filter aktiv sind (oft Duplicate Content).
* **Robots für Seiten mit URL Request Parameter:** Lege Regeln für URLs mit Parametern fest.
* **Robots für News Unterkategorien:** Spezielle Regeln für Blog-Kategorien.
* **Robots für unsichtbare Blogbeiträge:** Steuere die Sichtbarkeit von internen oder versteckten Beiträgen.
* **Priorisiere Custom Robots Texte über Standard noindex:** Wenn aktiviert, überschreiben deine Einstellungen hier die JTL-Standards.
***
## Canonical Tag
Das Canonical Tag zeigt Suchmaschinen an, dass es sich bei der aktuellen Seite um ein Original oder um eine Variante einer existierenden Seite handelt. Dadurch verhindert man, dass Suchmaschinen deinen Inhalt als doppelten Content werten. Die Empfehlung geht dahin, dass Seiten, die nicht indexiert werden sollen auch kein Canonical Tag benötigen. Das kannst du hier festlegen.
* **Kein Canonical Tag für noindex Seiten:** Empfohlen: **An** (da nicht indexierte Seiten kein Canonical benötigen).
* **Kein Canonical Tag für Folgeseiten (Pagination):** Empfehlung: **An**, Standard: Aus.
* **Kein Canonical Tag für aktive Filter:** Empfehlung: **An**, Standard: Aus.
* **Kein Canonical Tag für Seiten mit URL Request Parameter:** Empfehlung: **An**, Standard: Aus.
* **Kein Canonical Tag für Newsunterkategorien:** Nur sinnvoll, wenn noindex verwendet wird. Unverbindliche Empfehlung: **Aus**, Standard: Aus.
* **Kein Canonical Tag für unsichtbare Blogartikel:** Empfehlung: **An**, Standard: Aus.
* **Folgeseiten (Pagination) auf Parent referenzieren:** Setzt den Canonical Link von Seite 2, 3 etc. auf die Hauptkategorie (Seite 1). Empfehlung: **An**, Standard: Aus.
***
## Alternate Hreflang
Alternate Hreflang zeigt auf jeder Seite auf den Link der jeweiligen Sprachversion und der gesetzten Standardsprache, wenn keine passende Sprache für den Seitenbesucher zur Verfügung steht. Die Empfehlungen gehen dahin, dass Seiten, die nicht indexiert werden sollen, auch kein hreflang ausweisen sollen.
* **Kein Alternate Tag für noindex Seiten:** Empfehlung: **An**, Standard: Aus.
* **Kein Alternate Tag für Folgeseiten (Pagination):** Empfehlung: **An**, Standard: Aus.
* **Kein Alternate Tag für aktive Filter:** Empfehlung: **An**, Standard: Aus.
* **Kein Alternate Tag für Seiten mit URL Request Parameter:** Empfehlung: **An**, Standard: Aus.
* **Kein Alternate Tag für Newsunterkategorien:** Nur sinnvoll, wenn noindex verwendet wird. Unverbindliche Empfehlung: **Aus**, Standard: Aus.
* **Kein Alternate Tag für unsichtbare Blogartikel:** Empfehlung: **An**, Standard: Aus.
* **X-Default wählen:** Hier kannst du unabhängig von der Standardsprache deines Shops eine Sprache auswählen, die als X-Default verwendet wird. Browser können anhand der Sprachen für den User die passende Sprachversion anzeigen. Wenn es keine passende Sprache gibt, wird die X-Default als Standardsprache bevorzugt ausgegeben. In den meisten Fällen ist es sinnvoll die englische Version standardmäßig anzubieten. Da viele Shops aber standardmäßig auf deutsch eigestellt sind, bieten wir hier eine Möglichkeit den X-Default Wert selbst festzulegen, ohne die Standardsprache des Shops ändern zu müssen.
***
## Linkmaskierung \[BETA]
Durch die Linkmaskierung werden alle Links für Filterauswahl, Sortierung und Layout so unkenntlich gemacht, dass sie für Crawler nicht direkt als Links identifiziert werden. Dadurch kann verhindert werden, dass entsprechend parametrisierte Seiten überhaupt von Suchmaschinen indexiert werden, weil die Crawler diesen Pseudolinks gar nicht erst folgen, was sich wiederum positiv auf das Crawlingverhalten auswirken kann. Grund ist, dass manche Crawler trotz nofollow Anweisung dennoch den Links auf der Seite folgen und parametrisierte Seiten dennoch indexiert werden. Der gewünschte Vorteil wäre, dass das Crawlbudget effektiver in Hauptseiten investiert wird.
**ACHTUNG!** Diese Option ist mit Vorsicht zu genießen. Bitte überprüfe die Indexierung und Funktionstüchtigkeit deiner Seite regelmäßig.
* **Linkmaskierung aktivieren:** Schaltet die Umwandlung in Pseudolinks ein.
***
## Graph based LD+JSON für strukturierte Daten
JTL verwendet standardmäßig das inline Markup für die Auszeichnung strukturierter Daten. Diese sind zum Teil schwer wartbar, teilweise unvollständig und schlecht erweiterbar. Wir bieten dir hier die Möglichkeit die Strukturierten Daten per LD+JSON, einem JSON-ähnlichen, gut strukturierten Format zur Verfügung zu stellen. Das Format ist maschinen-freundlich für Crawler und KI. Bitte beachte, dass Suchmaschinen-Crawler erwarten, dass strukturierte Daten aus LD+JSON auch valide sind. Reichere deine Daten nicht mit widersprüchlichen Informationen an.
**Graph based LD+JSON verwenden:** Aktiviere diesen Schalter, um die strukturierten Daten im JSON-ähnlichen, gut strukturierten Format bereitzustellen.
### Strukturierte Daten (Graph) – Optionen
Dieser Abschnitt erscheint nur, wenn **Graph based LD+JSON verwenden** aktiviert ist.
Feinjustierung der Graph-Auszeichnung. Alle Optionen sind opt-in; im Standard bleibt die Ausgabe unverändert. Aktiviere sie nur, wenn deine SEO-Agentur das fordert.
* **Inline-Microdata entfernen:** Entfernt das JTL-Standard Inline-Markup, sodass nur noch die Graph-Daten per LD+JSON ausgegeben werden.
* **'brand' statt 'manufacturer':** Gibt die Marke im Feld `brand` statt `manufacturer` aus.
* **priceSpecification entfernen:** Entfernt die detaillierte `priceSpecification` aus den Produktdaten.
* **Einzelnes gtin-Feld:** Gibt die GTIN in einem einzelnen `gtin`-Feld statt in den spezifischen Feldern (`gtin8`, `gtin12`, `gtin13`, `gtin14`) aus.
* **SearchAction in Website:** Ergänzt die Website-Auszeichnung um eine `SearchAction` für die Sitelinks-Suchbox.
* **BreadcrumbList vereinfachen:** Reduziert die Breadcrumb-Auszeichnung auf die notwendigen Kernfelder.
* **businessFunction entfernen:** Entfernt das Feld `businessFunction` aus dem Angebot (Offer).
* **Produkt-Beschreibung: Quelle:** Wähle, ob als Produktbeschreibung im Graph die Kurzbeschreibung oder die Langbeschreibung verwendet wird (Standard: **Kurzbeschreibung**).
* **Produkt-Beschreibung: Fallback:** Lege eine Ersatzquelle fest, falls die gewählte Beschreibung leer ist.
* **Seitentyp ohne WebPage-Dublette:** Verhindert, dass für spezifischere Seitentypen (z. B. Produkt, Artikelliste) zusätzlich der generische Typ `WebPage` ausgegeben wird.
* **StrikethroughPrice (Streichpreis):** Lege fest, wie ein Streichpreis ausgezeichnet wird (Standard: **Aus (Legacy-Format)**).
* **Organisation-Typ:** Wähle den Schema.org-Typ für dein Unternehmen (Standard: **OnlineStore (Shop-Empfehlung)**).
* **Name von Seite, Breadcrumb und Liste:** Lege fest, welcher Wert als Name verwendet wird (Standard: **Meta-Titel**).
### Mehr Infos
**Warum Graph based?** "Graph based" bedeutet, dass Beziehungen zwischen einzelnen Elementen hergestellt werden. Crawler verstehen so die Semantik und Zusammenhänge besser, was insbesondere für KI-Anwendungen von Vorteil ist.
**Hinweis zu Testing Tools:** Es ist normal, dass Daten in Testing Tools doppelt auftauchen (einmal als JTL-Standard Microdata und einmal als LD+JSON). Das ist laut Google unbedenklich und valid.
**Achtung!** Google und andere Suchmaschinen vertrauen nicht alleine auf deine Angaben zu Produkten. Insbesondere Google hat eine eigene Datenbank zu Organisationen, Unternehmen, Marken, Produkten, etc. Damit Google deine Produkte platziert und validieren kann, solltest du deine Produkte vergleichbar und identifizierbar machen. Das bedeutet, dass du Daten zur Verfügung stellen solltest, durch die man deine Artikel auch wieder finden kann. Halte dich bei der Wahl von Artikelnummern oder der GTIN möglichst an die Originale und denk dir keine eigenen IDs aus. Missbrauche keine vordefinierten Felder, da diese sonst falsch interpretiert werden könnten. Arbeite nicht mit Fake-Preisen oder anderen irreführenden Daten
### FAQ
**Daten tauchen im Testing Tool doppelt auf - ist das schädlich?** Dass Daten nun doppelt in Testing Tools auftauchen ist normal, da wir aus Kompatibilitätsgründen das Inline-Markup per Microdata im Template gelassen haben. Das ist **unbedenklich** so lange diese keine widersprüchlichen Informationen beinhalten. Im Zweifel wird das JSON bevorzugt eingelesen. Laut Google ist es valide, dass das JSON Format die strukturierten Daten anreichert.
**Warum löscht ihr das Inline Markup nicht?** JTL hat hier und da ein paar Funktionen an das Markup geknüpft. Damit wir die Kompatibilität möglichst hoch halten können, haben wir uns entschlossen das Markup nicht zu entfernen. Darüber hinaus könnte es sein, dass sich auch Pluginanbieter an dem Markup orientieren. Auch aus diesem Grund haben wir uns gegen die Bereinigung des Markups entschieden.
**Wie kann ich den Inhalt bearbeiten?** Aktuell ist die einfachste Möglichkeit im Childtemplate die Templatefiles zu bearbeiten. Alle JSON relevanten Daten findest du in layout/components/graph\_json\_ld. Achte auf Konsistenz und überprüfe deine Daten für alle Seitentypen. Für einige Datentypen gibt es zu spezielle Anforderungen, die von Shop zu Shop unterschiedlich sein können und unterschiedlich behandelt werden müssen. Daher ist die Bearbeitung per Childtemplate die beste Variante. Die Standardversion deckt allerdings alle wichtigen Features ab.
***
## LD+JSON
JTL verwendet standardmäßig das inline Markup für die Auszeichnung strukturierter Daten. Diese sind zum Teil schwer wartbar, teilweise unvollständig und schlecht erweiterbar. Wir bieten dir hier die Möglichkeit die Strukturierten Daten per LD+JSON, einem JSON-ähnlichen, gut strukturierten Format zur Verfügung zu stellen. Bitte beachte, dass Suchmaschinen-Crawler erwarten, dass strukturierte Daten aus LD+JSON auch visuell auf der Seite repräsentiert werden. Daher tauchen im LD+JSON nur Daten auf, die auch sichtbar sind. Es ist nicht gestattet die Datensätze künstlich anzureichern und Suchmaschinen können solche Versuche hart abstrafen.
* **LD+JSON für den Typ Organisation verwenden:** Strukturierte Daten über dein Unternehmen.
* **LD+JSON für den Typ Website verwenden:** Strukturierte Daten für die Website selbst.
* **LD+JSON für den Typ Breadcrumb verwenden:** Strukturierte Daten für die Navigationsstruktur.
* **LD+JSON für Produktlisten aus Kategorie und Suchergebnissen verwenden:** Die Einstellungen hier beziehen sich auf jegliches Produktlisting, zB Kategorieseiten und auch Standardslider wie CrossSelling, Bestseller etc. Aktuell werden nur Produktlisten der Artikelkategorien und Suchergebnisse unterstützt. Die Funktion wird aber ausgeweitet. Bitte beachte, dass das inline Markup weiterhin aktiv bleibt, sodass du beim Testen neben den LD+JSON Werten auch Einträge aus dem Inline Markup sehen wirst. Das LD+JSON dient der einfacheren Indexierung und Anreicherung mit Daten.
* **LD+JSON für Produkt auf Produktdetailseite:** Strukturierte Daten für einzelne Artikel.
* **LD+JSON für News Artikel:** Strukturierte Daten für Blogbeiträge.
# Sidebar
Source: https://docs.dreizack-medien.de/NIU-Plus/sidebar
Sidebar-Einstellungen und Quickbuy
## Sidebar Darstellung
Hier kannst du einen Rahmen für die Sidebar für Desktop/mobil festlegen. So kannst du die Sidebar besser hervorheben und von dem Rest der Seite abgrenzen. Standardmäßig sind keine Rahmen (0px) definiert.
### Desktop Border Top
Vergebe hier einen Wert in Pixeln (px), um einen Rahmen an der oberen Kante der Sidebar auf dem Desktop zu erzeugen. Beispiele:
### Desktop Border Left
Vergebe hier einen Wert in Pixeln (px), um einen Rahmen an der linken Kante der Sidebar auf dem Desktop zu erzeugen. Beispiele:
***
## Mobiles Menü
Hier findest du Darstellungsoptionen für das mobile Menü (Burgermenü).
### Icons im Menüfooter
Unter den Kategoriepunkten wird eine Zeile mit Icons dargestellt. Hier findet man standardmäßig die Icons für Sprach- und Währungsschalter, wenn vorhanden. Du kannst hier zusätzlich weitere Menüicons hinzufügen. Wunsch- und Vergleichsliste werden nur dargestellt, wenn du sie hier und in den Shopeinstellungen aktiv hast.
### Account Icon darstellen
Lege fest, ob das Account Icon im Footer des mobilen Burger Menüs angezeigt werden soll.
### Such Icon darstellen
Entscheide, ob ein Such Icon im Footer des mobilen Burger Menüs erzeugt werden soll.
### Wunschliste Icon darstellen
Lege fest, ob das Wunschlisten Icon im Footer des mobilen Burger Menüs angezeigt werden soll. Dafür muss die Wunschliste in den JTL-Shopeinstellungen *(Einstellungsnummer 439)* aktiviert sein.
### Vergleichsliste Icon darstellen
Lege fest, ob das Vergleichslisten Icon im Footer des mobilen Burger Menüs angezeigt werden soll. Dafür muss die Vergleichsliste in den JTL-Shopeinstellungen *(Einstellungsnummer 1780)* aktiviert sein.
### Warenkorb Icon darstellen
Entscheide, ob im Footer des mobilen Burger Menüs ein Warenkorb Icon dargestellt werden soll.
***
## Instant Buy
Mit Instant Buy wird ein kleiner Kaufbutton auf Einzelartikeln angezeigt, der dir die Möglichkeit gibt, Einzelartikel direkt in den Warenkorb zu legen, ohne Page-Reload.
Der NIU Checkout muss dafür aktiviert sein. Du findest die Einstellung dazu in den [Checkout-Settings](/NIU-Plus/niu-checkout#niu-checkout-verwenden).
### Instant Buy bei Einzelartikeln verwenden
Aktiviere diesen Schalter, um den Instant-Buy-Button bei Einzelartikeln anzuzeigen.
***
## Quickbuy
Quickbuy ist eine innovative Funktion der Sidebar, die eine Produktvorschau bietet, sobald der Quickbuy-Button eines Artikels aus den Slidern oder der Kategorieansicht angeklickt wird. Der User kann direkt Varianten auswählen und das Produkt in den Warenkorb legen, ohne die Produktdetailseite besuchen zu müssen. Außerdem können Kunden sich so direkt einen Überblick über die verfügbaren Variationen eines Produkts verschaffen und/oder sich mit der Kurzbeschreibung des Artikels vertraut machen ohne die Produktdetailseite besuchen zu müssen. Ein Klick auf das Produkt selbst führt weiterhin zur Artikeldetailseite.
### Quickbuy global deaktivieren
Wenn diese Option aktiviert ist, wird Quickbuy auf allen Gerätetypen nicht verwendet.
### Quickbuy mobil deaktivieren
Wenn diese Option aktiviert ist, wird Quickbuy auf mobilen Endgeräten (Mobile & Tablet) nicht verwendet.
### Quickbuy für Einzelartikel deaktivieren
Wenn diese Option aktiviert ist, wird bei Einzelartikeln (= Artikel ohne Variation und Konfiguration) der Quickbuy-Button nicht angezeigt und die Funktion für diese Artikelart somit deaktiviert.
### Quickbuy für Variationsartikel deaktivieren
Wenn diese Option aktiviert ist, wird bei Variationsartikeln der Quickbuy-Button nicht angezeigt und die Funktion für diese Artikelart somit deaktiviert.
### Quickbuy für ausverkaufte Artikel deaktivieren
Wenn diese Option aktiviert ist, wird bei ausverkauften Artikeln der Quickbuy-Button nicht angezeigt und die Funktion für ausverkaufte Artikel somit deaktiviert.
### Bei Kauf über Quickbuy weiterleiten zu
Wenn deine Kunden etwas über die Quickbuy Sidebar in den Warenkorb legen, werden sie zu dem von dir gewählten Ziel weitergeleitet.
### Quickbuy Button Darstellungsoptionen Desktop
Hier kannst du aus verschiedenen Darstellungsoptionen für den Quickbuy Button auf Desktop wählen. Auswahl zwischen:
### Quickbuy Button Darstellungsoptionen mobil
Hier kannst du aus verschiedenen Darstellungsoptionen für den Quickbuy Button auf mobil wählen. Auswahl zwischen:
### Alternatives Icon für Quickbuy Button
Hier kannst du ein alternatives Icon für den Quickbuy Button wählen. Öffne einfach das Dropdown-Menü über den Pfeil und wählen ein passendes Icon aus der Bibliothek.
### Quickbuy Footer ausblenden für Vaterartikel
Wenn diese Option aktiviert ist, wird bei Vaterartikeln der Footer in der Sidebar ausgeblendet, der die Preisangabe und den Warenkorb Button enthält.
### Kurzbeschreibung bei Einzelartikeln in Quickbuy einblenden
Wenn diese Option aktiviert ist, wird bei Einzelartikeln die Kurzbeschreibung in Quickbuy eingeblendet. Das kann deinen Kunden dabei helfen, sich schnell über Artikel zu informieren ohne die aktuelle Seite zu verlassen.
### Variationsauswahl anzeigen
Wenn diese Option aktiviert ist, werden die einzelnen Auswahlelemente der Variaten (Dropdowns, Swatches etc.) in Quickbuy angezeigt. So können Kunden direkt ihre Auswahl treffen und die richtige Variante in den Warenkorb legen.
### Variationsübersicht anzeigen
Wenn diese Option aktiviert ist, wird eine Liste mit allen Variationskombinationen in Quickbuy zur Direktauswahl angezeigt.
***
## Quickview
Quickview ist die Sidebar für Artikeldetails. Quickview zeigt dir umfassende Produktinfos, ohne den Artikel direkt aufrufen zu müssen. Quickview findet Verwendung im Konfigurator und in der Warenkorbübersicht, wenn du mehr Infos zum Produkt und alle Details ansehen möchtest.
### Kurz- Langbeschreibung anzeigen
Wähle hier, welche Ansicht du für deine Artikeldetails darstellen möchtest.
***
## Warenkorb Sidebar
### Mengenregler verwenden
Aktiviere diese Option, damit deine Besucher die Menge eines Artikels direkt in der Warenkorb Sidebar editieren können, ohne die Seite zu wechseln.
### Verfügbarkeit und Lieferzeit anzeigen
Zeigt den Lagerstatus und die Lieferzeit direkt beim Artikel in der Warenkorb Sidebar an.
### Variationsinformationen anzeigen
Entscheide, ob gewählte Variationen (z. B. "Größe: L", "Farbe: Rot") beim Artikel angezeigt werden sollen.
### Konfigurationsdetails anzeigen
Lege fest, ob Details aus dem Konfigurator (falls verwendet) in der Warenkorb Sidebar sichtbar sein sollen.
### Versandfrei Progressbar verwenden
Aktiviert eine Progressbar in der Warenkorb Sidebar, die anzeigt wie viel noch zum kostenfreien Versand fehlt. Die Einstellungen aus der Warenkorbseite werden für die Darstellung übernommen.
### Couponfeld in Sidebar Warenkorb anzeigen
Zeigt ein Couponfeld in der Warenkorb Sidebar an. Nur in Verbindung mit NIU Checkout.
***
## X-Selling Sidebar
Die X-Selling Sidebar ist auf Desktop und Tablet verfügbar und zeigt neben dem Warenkorb noch eine schmale Sidebar mit Bestsellern oder passenden Produkten zum Warenkorb. Der Kunde kann Artikel bequem direkt in den Warenkorb legen.
### X-Selling Sidebar nutzen
Aktiviere diese Option, um die X-Selling Sidebar zu aktivieren.
### Spezifische Produkte in X-Selling Sidebar promoten
Hier kannst du aus all deinen Artikeln wählen, welche du hervorheben möchtest. Wenn du in die Zeile klickst, kannst du auch unter Eingabe des Produktnamens nach spezifischen Artikeln suchen.
### Promotion Artikel nur laden, wenn es keine passenden Artikel gibt
Entscheide, ob passende Artikel immer für den letzten Artikel im Warenkorb geladen werden, aber nur dann, wenn der Shop bereits CrossSellingArtikel der Gruppe 'Kunden kauften auch' generiert hat. Mit dieser Einstellung kannst du die Promotion Artikel nur dann anzeigen lassen, wenn keine anderen passenden Artikel gefunden wurden
### Passende Artikel mischen
Wenn du diese Einstellung aktivierst, wird die Liste an CrossSellingArtikeln für Promotion und passende Artikel mit jedem Aufruf neu gemischt. **Achtung:** Gilt nicht für Bestseller.
### Artikeldetails Button anzeigen, um QuickView zu öffnen
Aktiviere diese Option, um in der X-Selling Sidebar einen Button anzuzeigen, der die QuickView des jeweiligen Artikels öffnet. So können Kunden mehr Details zum Produkt einsehen, ohne die Sidebar zu verlassen.
### Verfügbarkeit und Lieferzeit anzeigen
Aktiviere diese Option, um den Lagerstatus und die Lieferzeit direkt in der X-Selling Sidebar anzuzeigen.
# Slider
Source: https://docs.dreizack-medien.de/NIU-Plus/slider
Slider-Einstellungen und -Konfiguration
Wähle deine Slidereinstellungen. Die Slidereinstellungen wirken sich auf alle Standardslider aus, die automatisch im Template ausgespielt werden, wie z.B. die Bestsellerslider.
## Konfiguration
### Slider Typ
Lege hier fest, ob die Slider sich endlos wiederholen oder mit dem letzten Element enden sollen.
Bei zu wenigen Produkten für einen endlosen Slider werden die Elemente wiederholt.
### Slider auf kleinen Displaygrößen anschneiden
Wenn aktiviert wird die erste, nicht mehr sichtbare Karte etwas angeschnitten angezeigt, damit dem User vermittelt wird, dass er weiter sliden kann, um mehr zu sehen.
### Rewind Modus
Wenn aktiviert, springen die Slider sobald sie am Ende angelangt sind wieder zurück zum Anfang.
### Slidergeschwindigkeit
Bestimme wie schnell der Slider seine Position wechseln soll. Gib dafür eine Zeit ins Millisekunden (ms) an. Der Standardwert beträgt: 400.
### Slides pro Seite
Hier kannst du flexibel einstellen, wie viele Slides je nach Bildschirmgröße angezeigt werden sollen.
**Standardwerte:**
XS = 1, SM = 2, MD = 4, LG = 5, XL = 4
**Definition der Bildschirmgrößen:**
XS = >576px, SM = ≥576px, MD = ≥768px, LG = ≥992px, XL = ≥1200px
### Seitennavigation einblenden
Aktiviere diese Option, um eine Punktnavigation unter dem Slider zu erzeugen, wenn mehr Slides vorhanden sind als auf einen Blick darstellbar. Über diese Punktnavigation kann direkt zum nächsten Satz Slides navigiert werden.
### Pfeile einblenden
Lege fest, ob links und rechts vom Slider Navigationspfeile eingeblendet werden sollen.
### Custom SVG für Pfeile
Hier kannst du einen eigenen SVG Code für die Darstellung der Pfeile hinterlegen. Lasse das Feld leer für den Standardpfeil.
### Autoplay
Entscheide, ob die Slider automatisch abspielen sollen oder nicht.
### Containerbreite
Definiere hier die globale Containerbreite für deine Slider. Du hast die Auswahl zwischen Standard Container (1250px), Container Fluid XL (1650px, je nach Setting) und Container Fluid (Bildschirmbreite).
# Styleshub
Source: https://docs.dreizack-medien.de/NIU-Plus/styleshub
Live-Konfiguration im Frontend
Aktiviere hier das Styleshub, um die meisten NIU Plus Einstellungen direkt im Frontend zu setzen. Die Änderungen im Styles Hub sind nur für dich sichtbar. So kannst du in Ruhe alles ausprobieren.
## Einstellungen
### Styleshub aktivieren
Lege fest, ob du das Styleshub aktivieren möchtest. Mit dem Styleshub hast du die Möglichkeit viele Einstellungen aus der Companion App direkt im Frontend anzupassen und unmittelbares Feedback zu deinen Änderungen zu bekommen. Du kannst das Styleshub über den Button auf der rechten Seite im Frontend deines Onlineshops aufrufen:
**Styles Hub im Frontend**
Hier findest du alle im Styleshub verfügbaren Einstellungsmöglichkeiten.
**Bei Klick auf die Website geöffnet lassen:** Aktiviere diese Option, damit du das Styleshub nicht bei jedem Klick auf die Website neu öffnen musst.
**Zurücksetzen:** Setz deine Einstellungen auf die bisher gespeicherten Einstellungen zurück.
**Preview:** Render eine Vorschau deiner getroffenen Einstellungen. Deine Einstellungen haben keine Auswirkungen auf andere Besucher und sind nur für dich sichtbar.
**Übernehmen:** Durch klick auf diesen Button übernimmst du die aktuellen Einstellungen aus dem Styleshub in die Companion App. Ab diesem Zeitpunkt sind die Änderungen für alle sichtbar.
Im produktiven Onlineshop sollte der Gast Modus immer deaktiviert sein!
### Gast Modus
Aktiviere diese Option um das Styleshub ohne Speicherfunktion auch für Gäste zu aktivieren.
# Tracking
Source: https://docs.dreizack-medien.de/NIU-Plus/tracking
Integriere Analyse-Tools und stelle Daten für erweitertes Tracking bereit.
**Disclaimer**
Bitte prüfe dein Setup sorgfältig. Je nach Shop und Plugins können Anpassungen notwendig sein für ein zielgerichtetes Tracking. Passe unbedingt die Sprachvariablen für die Consent Items an. Tracke nicht ohne die Einwilligung deiner User. Ergänze deine Datenschutzerklärung entsprechend und lass diese prüfen. Lass ggfs. auch die Integration auf rechtskonforme Implementierung prüfen. Die Integration wurde nach bestem Wissen und unter den Best Practices der Anbieter Dokumentation entwickelt. Die Nutzung unterliegt der eigenen Verantwortung und Sorgfalt.
***
## DataLayer
Hier kannst du den DataLayer konfigurieren, um strukturierte Daten für Drittanbieter-Tools bereitzustellen.
### DataLayer bereitstellen
Aktiviere diesen Schalter, um einen DataLayer im Shop-Frontend bereitzustellen. Dies ist oft die Grundlage für die Anbindung von Google Tag Manager oder anderen Analyse-Diensten, die auf strukturierte E-Commerce-Daten zugreifen müssen.
***
## Microsoft Clarity
Hier konfigurierst du die Anbindung an das Analyse-Tool Microsoft Clarity.
### Microsoft Clarity verwenden
Aktiviere diese Option, um das Tracking-Script von Microsoft Clarity in deinen Shop zu integrieren.
### Clarity Project ID
Gib hier deine eindeutige Projekt-ID ein, die du in deinem Microsoft Clarity Dashboard findest.
### Clarity nur im Checkout verwenden
Aktiviere diesen Schalter, wenn das Tracking nicht auf dem gesamten Shop, sondern ausschließlich im Bestellprozess (Checkout) aktiv sein soll.
### Clarity Dev Mode
Aktiviere den Entwicklermodus (Dev Mode) für Test- und Debugging-Zwecke.
***
## PostHog
Hier konfigurierst du die Anbindung an die Product-Analytics-Plattform PostHog.
### PostHog verwenden
Aktiviere diese Option, um die PostHog-Integration einzuschalten.
### PostHog API Key
Trage hier deinen PostHog API Key ein.
### PostHog nur im Checkout verwenden
Aktiviere diesen Schalter, um PostHog ausschließlich auf den Checkout-Seiten zu laden.
### PostHog Dev Mode
Aktiviere den Entwicklermodus für PostHog.
***
## META Pixel
Hier verwaltest du die Einstellungen für das Meta (Facebook) Pixel.
### Meta Pixel verwenden
Aktiviere diesen Schalter, um das Meta Pixel für das Tracking von Besucheraktionen und Conversions einzubinden.
### Meta Pixel ID
Gib hier deine Meta Pixel ID ein.
### Meta Pixel Dev Mode
Aktiviere den Entwicklermodus für das Meta Pixel, um die Integration zu testen.
# Update
Source: https://docs.dreizack-medien.de/NIU-Plus/update
Anleitung zum Update von NIU Plus und zugehörigen Plugins
## Resources & Health updaten
Es ist wichtig, dass du vor jedem Update unserer Produkte checkst, ob es eine neue Version von Resources & Health gibt, da die neuen Pluginversionen oftmals davon abhängen.
Lade dir das Installationspaket von Resources & Health herunter in unserem Store
Lade es über den **Pluginmanager** in deinem Store hoch und führe ein Update durch
## NIU Plus Template updaten
Lade dir dazu das Installationspaket des **NIU Plus Companion Plugins** von der Produktseite herunter, wie du es bei der Installation getan hast.
**Achte darauf, dass du über eine gültige Lizenz verfügst, da sich sonst nach einem Update das Plugin deaktivieren würde.**
Lade das Plugin über den **Pluginmanager hoch** und führe ein Update durch.
**Sicherheitshinweis:**
Auch wenn es nicht passieren sollte, dass beim Updateprozess Daten verlustig gehen, empfehlen wir allen Kunden immer vor einem Update, sowohl die Datenbank, wie auch das Childtemplate zu sichern, um einem unwahrscheinlichen Fall von Datenverlust einen Schritt voraus zu sein.
Folge nun den Schritten analog zur Installation:
Klicke unter **Setup** auf **Template Files laden**
**WICHTIG!** Klicke unter 3.1 auf **Einstellungen updaten**
Klicke anschließend unter **Variablen** auf **Theme kompilieren**
## Übrige OPC Plugins updaten
Du kannst nun auch die anderen Plugins ggfs updaten, wenn es neue Versionen gibt.
# Variablen
Source: https://docs.dreizack-medien.de/NIU-Plus/variablen
Hier findest du alle grundlegenden Farb- und Stylesettings, die sich global auf dein Template auswirken.
## Export/Import/Vorlagen
Hier kannst du deine Einstellungen exportieren und wieder importieren oder Vorlagen in der Datenbank speichern, um so schnell zwischen Styles zu wechseln.
Hier hast du die Möglichkeit die Einstellungen dieses Tabs als Vorlage in der Datenbank zu speichern, um so schnell zwischen Styles zu wechseln.
Vergebe einen aussagekräftigen Namen für deine Vorlage
Klicke auf *Vorlage speichern*
Lade eine zuvor erstellte Vorlage durch Auswählen in dem Drop-Down-Menü und anschließendem Klick auf *Vorlage laden*.
Falls du die Einstellungen nicht in deiner Datenbank speichern oder die Einstellungen auf eine andere Shopdomain übertragen willst, kannst du dir die Einstellungen ganz einfach exportieren und als Datei herunterladen.
So kannst du bspw. alle Einstellungen auf deinem Staging-Shop vorbereiten und anschließend mit wenigen Klicks auf dein Live-System übertragen.
Klicke hierfür einfach auf *Exportieren*.
Importiere einen zuvor erstellten Export der Einstellungen. Ziehe die Datei einfach in den Kasten oder drücke *Browse*, um die Datei auf deinem Gerät zu suchen.
***
## Werkseinstellungen
Hier kannst du alle Einstellungen auf den Standard wieder zurücksetzen.
**Standard wiederherstellen**
Mit Klick auf *Wiederherstellen*, werden alle Einstellungen in dem Tab "Variablen" auf den Standard zurückgesetzt.
***
## Grundfarben und Vorkonfiguration
Wähle deine Grundfarben aus. Das Template passt sich automatisch an deine Auswahl nach definierten Regeln an, die für ein ausgewogenes Ergebnis sorgen.
### Automatische Anpassung
Lasse diese Einstellung aktiviert, damit sich zusammengehörige Farben gleichmäßig und automatisch anpassen.
### Primärfarbe
Lege hier die Primärfarbe deines Shops fest. Diese beeinflusst standardmäßig unter anderem:
Farbe der Topbar, Button-Farben und Bestseller-Artikelribbon.
Außerdem wird die Farbe beim Farbgenerator berücksichtigt und wirkt sich auf die anderen automatisch gesetzten Farben aus.
### Sekundärfarbe
Lege hier die Sekundärfarbe deines Shops fest. Diese beeinflusst standardmäßig:
Sekundär-Button, Warenkorb-Button und New-Product-Ribbon für Artikel.
Diese Farbe wird ebenfalls beim Farbgenerator berücksichtigt, allerdings mit weniger Einfluss als die Primärfarbe.
### Tertiärfarbe
Lege die Tertiärfarbe deines Shops fest. Diese beeinflusst maßgeblich:
Schrift- und Hintergrundfarbe sowie Farbe des Tertiär-Buttons.
Diese Farbe wird ebenfalls beim Farbgenerator berücksichtigt und hat einen ähnlichen Einfluss wie die Primärfarbe - insbesondere auf Schrift- und Hintergrundstyles.
### Akzentfarben
* **Accent 1** – Die erste Akzentfarbe für schnellen Zugriff in der CompanionApp und im OnPage-Composer
* **Accent 2** – Die zweite Akzentfarbe für schnellen Zugriff in der CompanionApp und im OnPage-Composer
### Meta Theme Color
Lege die Meta Theme Color deines Shops fest. Diese Farbe beeinflusst das Erscheinungsbild des Browsers auf mobilen Geräten, indem sie die Farbe der Adressleiste oder der Browser-Oberfläche anpasst, wenn die Seite geöffnet ist.
Dies trägt zur einheitlichen Darstellung deiner Markenfarben über verschiedene Plattformen hinweg bei.
[Mehr Informationen bei MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta/name/theme-color)
***
## Erweiterte Einstellungen
Für die meisten Fälle genügt die Einstellung der Grundfarben. Hier kannst du alle einzelnen Styles für jedes Element individuell anpassen, ohne die Grundfarben zu beeinflussen.
### Hintergrund- und Schriftfarbe
Klicke auf den Pfeil neben der entsprechenden Farbe
Wähle deine gewünschte Farbe per Color-Picker oder trage den Hexcode ein
Drücke auf "Apply", um die Farbe anzuwenden
Vergiss nicht dein Theme zu kompilieren und die Einstellungen zu speichern
### Signalfarben
Hier kannst du die Signalfarben deines Shops anpassen. Diese werden hauptsächlich für Mitteilungen an den Nutzer verwendet.
* **Success-Farbe** – Wird angezeigt, wenn ein Artikel erfolgreich in den Warenkorb gelegt wurde
* **Info-Farbe** – Wird verwendet, wenn ein Nutzer beispielsweise sein Passwort falsch eingegeben hat
* **Warning-Farbe** – Für Warnhinweise und wichtige Mitteilungen
* **Error-Farbe** – Für Fehlermeldungen und kritische Hinweise
Du kannst per Dropdown entweder den Standard oder eine deiner hinterlegten Grundfarben wählen.
Um eine andere Farbe zu verwenden, wähle in dem Dropdown "Custom", um den Colorpicker freizuschalten. Wähle deine gewünschte Farbe per Color-Picker oder trage den Hexcode ein und drücke anschließend auf "Apply".
Vergiss nicht dein Theme zu kompilieren und die Einstellungen zu speichern!
***
## Ribbons (Artikelsticker)
### Border Radius
Hier kannst du die Kantenabrundung der Artikelribbons festlegen. Verwende eine CSS Auszeichnung, um den Border Radius festzulegen.
```css Keine Abrundung theme={null}
0
```
```css Gleichmäßig theme={null}
5px
```
```css An jeder Seite einzeln theme={null}
5px 5px 5px 5px
```
```css Individuell theme={null}
0 10px 5px 0
```
```css Diagonal theme={null}
15px 10px
```
**Beispiele:**
`0` → Keine Abrundung, `5px 5px 5px 5px` → 5px an jeder Seite, `5px` → 5px an jeder Seite, `0 10px 5px 0` → Oben links 0, oben rechts 10px, unten rechts 5px, unten links 0, `15px 10px` → Oben links und unten rechts 15px, oben rechts und unten links 10px
### Ribbon-Farben
Außerdem kannst du hier die Farbe der einzelnen Artikelribbons/Artikelsticker festlegen. Du kannst eine der vorher konfigurierten Farben aus dem Dropdown-Menü auswählen.
Um eine andere Farbe zu verwenden, wähle in dem Dropdown "Custom", um den Colorpicker freizuschalten.
Folgende Ribbons kannst du individuell einfärben:
* **Bestseller** – Standard: Primärfarbe
* **Special offer** – Standard: Dangerfarbe
* **New product** – Standard: Sekundärfarbe
* **Top offer** – Standard: Custom
* **Upcoming** – Standard: Infofarbe
* **Top reviews** – Standard: Primärhintergrund 2
* **Out of stock** – Standard: Custom
* **On stock** – Standard: Successfarbe
* **Preorder** – Standard: Warningfarbe
***
## Preis Ribbon
Wenn du in Kategorieseiteneinstellungen die Ribbondarstellung für den Preis aktiviert hast, kannst du hier die Farben und Styles wählen.
**Border Radius:** Hier kannst du die Kantenabrundung festlegen (siehe Border Radius Beispiele bei Ribbons).
**Preis Ribbon Farbe:** Wähle hier eine Farbe für das Ribbon. Du kannst eine der vorher konfigurierten Farben aus dem Dropdown-Menü auswählen oder "Custom" für den Colorpicker wählen.
***
## Lagerstatus Farben
Hier kannst du die Farben für die verschiedenen Lagerstatus definieren:
* **Sofort verfügbar** – Farbe für verfügbare Artikel (Standard: Successfarbe)
* **Für dich Bestellbar** – Farbe für begrenzt verfügbare Artikel (Standard: Warningfarbe)
* **Vergriffen** – Farbe für nicht verfügbare Artikel (Standard: Dangerfarbe)
Du kannst eine der vorher konfigurierten Farben aus dem Dropdown-Menü auswählen oder "Custom" für den Colorpicker wählen.
***
## Logo, Navigation und Footer
### Logos
Hier kannst du dein primäres Logo hochladen. Das primäre Logo ist für die Desktop Version gedacht und als Fallback für die mobilen Varianten, falls kein mobiles Logo hinterlegt wurde.
Lade hier (falls vorhanden) dein mobiles Logo hoch. Das mobile Logo bietet die Möglichkeit ein kleineres oder kompakteres Logo als Alternative anzulegen.
Gerade wenn du ein sehr breites Logo mit viel Text verwendest, eignet sich eine gekürzte Version für den mobilen Header.
### Größeneinstellungen
* **Höhe Nav Desktop** – Setze einen festen Wert für die Höhe der Nav für die Desktopansicht. Erlaubt sind CSS-Werte wie px, rem, vh oder %.
* **Höhe Nav Mobil** – Setze einen festen Wert für die Höhe der Nav für die mobile Version. Erlaubt sind CSS-Werte wie px, rem, vh oder %.
* **Höhe Logo Desktop** – Setze einen festen Wert für die Höhe des Logos für die Desktopansicht. Die maximale Höhe wird durch die Höhe der Nav gedeckelt.
* **Höhe Logo Mobile** – Setze einen festen Wert für die Höhe des Logos für die mobile Version. Die maximale Höhe wird durch die Höhe der Nav gedeckelt.
### Farbeinstellungen
Zusätzlich kannst du die Hintergrund- und Akzentfarben von Topbar, Navigation und Footer einzeln festlegen. Du kannst eine der vorher konfigurierten Farben aus dem Dropdown-Menü auswählen oder "Custom" für den Colorpicker wählen.
* **Topbar Hintergrundfarbe** – Hintergrundfarbe der obersten Leiste
* **Nav Hintergrundfarbe** – Hintergrundfarbe der Hauptnavigation
* **Nav Kategorieleiste Hintergrundfarbe** – Hintergrundfarbe der Kategorieleiste innerhalb der Navigation
* **Nav Item Akzentfarbe** – Akzentfarbe für Navigationspunkte (z.B. bei Hover/Aktiv)
* **Footer Topbar Hintergrundfarbe** – Hintergrundfarbe der obersten Footer-Leiste
* **Footer Hintergrundfarbe** – Hintergrundfarbe des Hauptfooters
* **Footer Akzentfarbe** – Akzentfarbe für Elemente im Footer
* **Footer Bottombar Hintergrundfarbe** – Hintergrundfarbe der untersten Footer-Leiste
***
## Buttons
### Border Radius
Hier kannst du die Kantenabrundung festlegen (siehe Border Radius Beispiele bei Ribbons).
### Schriftoptionen
**Headfont statt Bodyfont für Buttons verwenden:** Mit dieser Einstellung kannst du entscheiden, ob du die Schriftart für Überschriften (Headfont) anstelle der Fließtextschriftart (Bodyfont) für deine Buttons nutzen möchtest.
**Button Schrift in Caps Lock:** Bei Aktivierung dieser Einstellung wird der Buttontext ausschließlich in Großbuchstaben dargestellt.
### Button-Typen
* **Primär, Sekundär, Tertiär** – Drei separate Gestaltungsmöglichkeiten für deine Buttons, deren Aktion beim Drücken noch von dir ausgewählt werden kann
* **Warenkorb-Buttons** – Warenkorb, zur Kasse und Quickbuy Button
* **Footer Topbar Button** – Design für die Buttons in der Fußzeile bzw. Kopfzeile
* **Consent & Load more** – Buttons im Cookie-Banner und für "Mehr laden"
### Buttonfarbe
Außerdem kannst du die Farbe der verschiedenen Buttons hier anpassen. Du kannst eine der vorher konfigurierten Farben aus dem Dropdown-Menü auswählen oder "Custom" für den Colorpicker wählen.
### Buttontyp
Zusätzlich kannst du den Button-Typ der einzelnen Buttons anpassen:
* **Full** – Button ausgefüllt mit Farbe
* **Outlined** – Button umrandet mit Farbe
* **Flat** – Weder Füllung noch Umrandung, nur die Schrift ist eingefärbt
* **Link** – Button wird wie ein reiner Textlink dargestellt
***
## Eingabefelder
**Border Radius:** Hier kannst du die Kantenabrundung für Eingabefelder festlegen (siehe Border Radius Beispiele bei Ribbons).
***
## Containersettings
**Container-XL Breite:** Hier entscheidest du, wie breit die größte Containerbreite sein soll. Das begrenzt für besonders große Bildschirme die maximale Breite der Container, in denen Elemente wie die Navigation und der Footer liegen.
Der Standard liegt bei 1650px.
Um deinen Content genauso breit wie Nav und Footer zu machen, vergebe für den Container-XL und den Container-Fluid-XL die gleiche Breite.
***
## Produktboxen
Hier werden die wichtigsten Informationen zu deinem Produkt als kurze Übersicht angezeigt. Entscheide dabei, wie viele Zeilen des Produkttitels bzw. der Produktbeschreibung in deinen Produktboxen ersichtlich sind.
***
## Font Settings
Wähle hier deine Schriftarten und Styles aus. Wähle Pagespeed optimierte Optionen, wenn dir die simulierten Abstufungen der Fontweights ausreichen und du mehr Wert auf einen schlanken Ladevorgang legst.
In der Regel genügt der Browsercache, um deinen Kunden ein hervorragendes Ergebnis zu liefern auch mit mehreren Fonts. Wenn du gar keine Fonts auswählen willst, nutze die System Default Fonts, um die Standardfonts der jeweiligen User zu verwenden.
### Font Display Settings
Die Font Display Settings entscheiden darüber, wie Fonts geladen werden:
Font wechselt, sobald sie geladen wurde - kann zu Layout-Shifts führen
Gewählte Font wechselt nicht, wenn sie nicht rechtzeitig verfügbar ist - verhindert Layout-Shifts
In der Regel reicht der Browsercache, um alle Fonts rechtzeitig zur Verfügung zu stellen.
### Font Headlines
Wähle hier die Schriftart für deine Überschriften. Du kannst eine der mitgelieferten Schriftarten oder Custom wählen, um deine eigene Schriftart zu nutzen.
**Custom Headlines Font Name:** Custom Fonts musst du manuell im Stylesheet einbinden. Trage hier den exakten Namen ein, wie du die font-family bezeichnet hast.
**Headline Fontweight:** Schriftdicke der Überschriften.
### Font Bodytext
Wähle hier die Schriftart für deine Textkörper. Du kannst eine der mitgelieferten Schriftarten oder Custom wählen.
**Custom Bodytext Font Name:** Custom Fonts musst du manuell im Stylesheet einbinden. Trage hier den exakten Namen ein, wie du die font-family bezeichnet hast.
**Bodytext Fontweight:** Schriftdicke des Fließtexts.
### Display Font
Wähle hier die Schriftart für deinen Schaugrößentext.
**Display Fontweight:** Schriftdicke des Schaugrößentexts.
### Navigation
**Nav Items Level 1 Fontweight:** Schriftdicke für Hauptnavigationspunkte.
### Responsive Fontsizes
**Responsive Fontsizes nutzen:** Wenn aktiviert, passen sich die Schriftgrößen dynamisch an die Displaygröße an, wodurch eine optimale Lesbarkeit auf verschiedenen Geräten gewährleistet wird.
**Base Fontsize Skalierungsfaktor**
Bei aktivierter responsiver Schriftgröße kannst du hier einen Skalierungsfaktor wählen:
**Standardwert:** 1. **Wert \< 1** verkleinert die Schriftgröße, **Wert > 1** vergrößert die Schriftgröße.
**Base Desktop Breite**
Wähle hier die Basis-Desktopbreite in px. Von diesem Wert aus skaliert die Schriftgröße vom Maximalwert herunter bis zum empfohlenen Minimalwert.
**Skalierungsfaktor**
Hier kannst du einstellen, wie stark die einzelnen Schriftgrößen zueinander skalieren, basierend auf der Basis-Schriftgröße.
### Vorschau & Testing
**Kursiv Preview:** Aktiviere diese Einstellung, um die Schriften in der Vorschau in kursiv angezeigt zu bekommen.
Diese Einstellung hat keinen Einfluss auf das Front-End deines Shops - nur auf die Vorschau in den Einstellungen.
**Schriftdicke Preview:** Hier siehst du die Vorschau deiner gewählten Schrifteinstellungen, welche automatisch aktualisiert wird, ohne dass du auf „Speichern" oder „Theme kompilieren" drücken musst..
**Bezeichnungen in der Vorschau:**
**D1-D6:** Display-Font, **H1-H6:** Headline-Font
Die aktuelle Bildschirmbreite wird automatisch anhand deiner gewählten Browser-Fenstergröße aktualisiert.
***
## Deine Style-Vorschau
Hier siehst du eine Zusammenfassung deiner erfassten Styles auf einen Blick.
Die Vorschau fasst alle wichtigen Styles zusammen: Grundfarben (Primary, Secondary, Tertiary, Accent 1/2), Signalfarben (Info, Success, Warning, Danger), Meta Theme, Headline-Beispiele auf hellem und dunklem Hintergrund, Button-Varianten sowie Beispiele für Success-, Warning-, Info- und Error-Meldungen.
Nutze diesen Abschnitt, um schnell zu prüfen, ob deine Farbkombination stimmig wirkt, bevor du das Theme final kompilierst.
# Warenkorbseite
Source: https://docs.dreizack-medien.de/NIU-Plus/warenkorbseite
Warenkorbseiten-Einstellungen
## Allgemein
### Card Style
Entscheide hier für die **Buy-**, **Cart-** und **Gift-Box** in welchem Stil diese dargestellt werden sollen.
Vorschau Buy Box Card Style, Vorschau Cart Box Card Style und Vorschau Gift Box Card Style.
### Border Radius
Hier kannst du die Kantenabrundung für die **Buy-**, **Cart-** und **Gift-Box** festlegen. Verwende eine CSS Auszeichnung, um den Border Radius festzulegen. Beispiele:
```elixir theme={null}
0 -> Keine Abrundung
5px 5px 5px 5px -> 5px an jeder Seite
5px -> 5px an jeder Seite
0 10px 5px 0 -> Oben links 0, oben rechts 10px, unten rechts 5px, unten links 0
15px 10px -> Oben links und unten rechts 15px, oben rechts und unten links 10px
```
***
## Gratisgeschenke
### Gratisgeschenke anzeigen
Aktiviere hier eine Vorschau der Gratisgeschenke, auch bevor der Mindestbestellwert für das Geschenk erreicht ist.
### Maximal Bestellwert sichtbarer Gratisgeschenke
Lege einen Bestellwert fest, bis zu dem Gratisgeschenke angezeigt werden dürfen. Gratisgeschenke, die einen höheren Bestellwert erfordern, werden erst sichtbar, wenn dieser erreicht wurde.
***
## Versandkostenfrei Progressbar
Bitte beachte, dass die Einstellungen hier auch für die Progressbar in der Sidebar Anwendung finden.
### Progressbar aktivieren
Entscheide, ob die Progressbar für Versandkostenfreigrenze auf Warenkorbseite aktiviert werden soll oder nicht.
### Fallbackwert für Versandkostenfreigrenze
Wenn ein Kunde noch nichts im Warenkorb liegen hat, kann der Shop die Versandkostenfreigrenze nicht berechnen. Trage hier einen Fallback Wert ein, um auch bei leeren Warenkörben die Marke in der Progressbar anzuzeigen. Dieser Wert wird überschrieben, sobald ein Artikel im Warenkorb des Kunden liegt.
### Wert auf Progressbar anzeigen
Lege fest, ob der aktuelle Warenkorbwert auf der Progressbar angezeigt werden soll. Dies kannst du separat für Desktop und mobil festlegen.
### Höhe der Progressbar
Definiere hier die Höhe in Pixeln der Progressbar jeweil für Desktop und mobil. Standardwerte:
Desktop: 20px, mobil: 4px
# Angebote Countdown
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/angebote-countdown
Countdown für zeitlich begrenzte Sonderpreise aus der JTL-Wawi
## Allgemeine Beschreibung
Das **Angebote Countdown**-Widget zeigt auf der Produktdetailseite einen Countdown an, wenn ein Produkt zu einem zeitlich begrenzten Sonderpreis angeboten wird.
Dieses Widget hilft dabei, den Kunden visuell zu vermitteln, wie viel Zeit noch verbleibt, um das Angebot zu nutzen. Der Countdown erzeugt ein Gefühl der Dringlichkeit und motiviert die Kunden, schneller eine Kaufentscheidung zu treffen, um den Sonderpreis nicht zu verpassen.
Durch die Darstellung des Angebotsendes trägt das Widget dazu bei, die Konversionsrate zu erhöhen, indem es den Kunden einen klaren Anreiz bietet, unverzüglich zu handeln.
## Featureübersicht
Das Widget wird automatisch auf all Deinen Produktseiten ausgespielt.
Möchtest Du es an mehreren Stellen auf der Produktseite platzieren, kannst Du das Widget ganz einfach per OnPage-Composer an der gewünschten Stelle platzieren.
Passe den angezeigten Text ganz einfach per Sprachvariable an.
Passe das Aussehen des Widgets nach Belieben an.
Entscheide selbst per CSS-Selektor an welcher Stelle das Widget auf der Produktdetailseite ausgespielt werden soll.
## Settings
### Funktionen
Entscheide, ob das Widget aktiv und automatisch an der per CSS-Selektor gewählten Stelle platziert werden soll.
Aktiviere den Demo Modus, um das Widget zu testen. Bei jedem Produkt wird dann ein Countdown erzeugt, der anzeigt wann das fiktive Sonderangebot endet.
Diese Funktion ist nicht für den produktiven Shop geeignet.
### Sichtbarkeit
Du kannst das Widget gezielt bei Produkten ausblenden, indem du dem Artikel das Funktionsattribut `dzm_hide_special_offer_countdown` vom Typ Checkbox anhängst und die Checkbox aktivierst.
Wenn du diesen Schalter aktivierst, wird das Widget standardmäßig ausgeblendet und erscheint nur bei den Artikeln, die das entsprechende Funktionsattribut explizit zugewiesen haben.
### Vorschau
Hier siehst du dein Widget in der Vorschau.
### Styles
Wähle das angezeigte Icon für das Widget - du kannst aus einer umfangreichen Bibliothek frei wählen.
Wähle aus verschiedenen Darstellungsoptionen, wie das Widget angezeigt werden soll.
Wähle hier aus verschiedenen Darstellungsoptionen für die verbleibende Countdown-Zeit.
Wähle hier die Farbe, die für das Icon des Widgets verwendet werden soll.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Der Standard Selektor fügt das Widget über der Lagerbestandsanzeige ein. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Um zu vermeiden, dass es auf allen Produktseiten erscheint, muss der CSS-Selektor leer gelassen werden. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints auf den jeweiligen Produktseiten platzieren.
# Beobachtet gerade
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/beobachtet-gerade
Zeige wie viele Besucher das Produkt gerade ansehen
## Allgemeine Beschreibung
**Beobachtet gerade** spielt auf der Artikeldetailseite ein Widget aus, welches dem Besucher anzeigt, wie viele andere Besucher sich auch noch diese Seite gerade anschauen, um ein Gefühl von Dringlichkeit zu erzeugen.
Es ist ganz simpel, aber super effektiv: Es zeigt deinen Kunden in Echtzeit, wie viele Leute gerade dasselbe Produkt anschauen. Und das ist wie ein kleiner, virtueller Nudge, der sagt: "Hey, du bist nicht allein, das Teil ist beliebt – also schnapp zu, bevor es zu spät ist!".
Wenn in Deinem Shop mal nicht so viel los ist, hast du auch die Möglichkeit ein alternatives Widget zu nutzen, dass nur angezeigt wird, wenn ein einzelner Nutzer auf der Seite ist.
## Featureübersicht
Das Widget wird automatisch auf all Deinen Produktseiten ausgespielt.
Wenn sich gerade nur 1 Nutzer auf der Artikelseite befindet, hast du die Möglichkeit ein alternatives Widget auszuspielen.
Möchtest Du es an mehreren Stellen auf der Produktseite platzieren, kannst Du das Widget ganz einfach per OnPage-Composer an der gewünschten Stelle platzieren.
Passe den angezeigten Text ganz einfach per Sprachvariable an.
Passe das Aussehen des Widgets nach Belieben an.
Entscheide selbst per CSS-Selektor an welcher Stelle das Widget auf der Produktdetailseite ausgespielt werden soll.
## Settings
### Funktionen
Entscheide, ob das Widget aktiv und automatisch an der per CSS-Selektor gewählten Stelle platziert werden soll.
Aktiviere hier das alternative Widget, welches dann angezeigt wird, wenn der Besucher alleine auf der Artikelseite ist.
Lege hier den Grenzwert fest, welche Anzahl von Besuchern überschritten werden muss, damit das Widget angezeigt wird.
Nutzt du die Alternativansicht und es befinden sich keine Besucher auf der Seite, wird diese weiterhin ausgespielt. Wenn du das nicht möchtest und stattdessen das Produktansicht Widget ausgespielt werden soll, deaktivere das Alternative Widget.
Wenn du den Demo Modus aktivierst, werden nicht die wirklichen Besucher gezählt sondern bei jedem Aufruf der Seite eine zufällige Zahl zwischen 1 und 12 generiert.
Diese Funktion dient nur zur Veranschaulichung des Plugins und ist nicht für den produktiven Einsatz im Shop bestimmt.
### Vorschau
Hier siehst du beide Widgets in der Vorschau. Das erste zeigt die Option, wenn noch andere Besucher den gleichen Artikel betrachten. Das zweite Widget kannst du optional anzeigen lassen, wenn der Besucher alleine auf der Seite ist.
### Styles
Wähle das angezeigte Icon für das Hauptwidget - du kannst aus einer umfangreichen Bibliothek frei wählen.
Wähle das angezeigte Icon für das alternative Widget - du kannst aus einer umfangreichen Bibliothek frei wählen.
Wähle aus verschiedenen Darstellungsoptionen, wie das Hauptwidget angezeigt werden soll.
**Für Profis:** Du kannst ein eigenes Custom Template im Pluginordner anlegen und das Widget völlig frei gestalten. Erstelle dazu ein File unter:
`dzm_opc_salesbooster/Portlets/DZMObservers/DZMObservers_custom.tpl`
Wähle aus verschiedenen Darstellungsoptionen, wie das alternative Widget angezeigt werden soll.
Wähle hier die Farben, die für die Icons der entsprechenden Widgets verwendet werden soll.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Der Standard Selektor fügt das Widget über der Lagerbestandsanzeige ein. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Um zu vermeiden, dass es auf allen Produktseiten erscheint, muss der CSS-Selektor leer gelassen werden. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints auf den jeweiligen Produktseiten platzieren.
# Bestands Alarm
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/bestandtsalarm
Low Stock Alert: Warnung bei niedrigem Lagerbestand zur Steigerung der Dringlichkeit
## Allgemeine Beschreibung
Auf der Produktdetailseite sorgt das **Bestands Alarm**-Widget dafür, dass Besucher darüber informiert werden, dass nur noch eine geringe Anzahl des Produktes verfügbar ist.
Dieses clevere Tool ist darauf ausgelegt, bei Kunden ein Gefühl der Dringlichkeit zu wecken und sie zu einer schnellen Kaufentscheidung zu motivieren. Indem es in Echtzeit die knappe Verfügbarkeit des Produkts hervorhebt, spielt es effektiv auf die Furcht der Käufer an, etwas zu verpassen. So wird subtil suggeriert: „Handel jetzt, bevor es zu spät ist!".
## Featureübersicht
Das Widget wird automatisch auf all Deinen Produktseiten ausgespielt.
Entscheide selbst ab welchem Lagerbestand das Widget angezeigt werden soll.
Möchtest Du es an mehreren Stellen auf der Produktseite platzieren, kannst Du das Widget ganz einfach per OnPage-Composer an der gewünschten Stelle platzieren.
Passe den angezeigten Text ganz einfach per Sprachvariable an.
Passe das Aussehen des Widgets nach Belieben an.
Entscheide selbst per CSS-Selektor an welcher Stelle das Widget auf der Produktdetailseite ausgespielt werden soll.
## Settings
### Funktionen
Entscheide, ob das Widget aktiv und automatisch an der per CSS-Selektor gewählten Stelle platziert werden soll.
Aktiviere den Demo Modus, um das Widget zu testen. Der reale Lagerbestand wird dann ignoriert und auf der Produktdetailseite wird die definierte Lagerbestandsgrenze angezeigt.
Diese Funktion ist nicht für den produktiven Shop geeignet.
Definiere hier die untere Grenze des Lagerbestands, die definiert ab wann das Widget ausgespielt werden soll.
### Sichtbarkeit
Du kannst das Widget gezielt bei Produkten ausblenden, indem du dem Artikel das Funktionsattribut `dzm_hide_low_stock_alert` vom Typ Checkbox anhängst und die Checkbox aktivierst.
**Nur bei Attribut sichtbar schalten:** Aktiviere diese Option, damit das Widget nur dann angezeigt wird, wenn das entsprechende Attribut am Artikel gesetzt ist.
### Vorschau
Hier siehst du dein Widget in der Vorschau.
### Styles
Wähle das angezeigte Icon für das Widget - du kannst aus einer umfangreichen Bibliothek frei wählen.
Wähle aus verschiedenen Darstellungsoptionen, wie das Hauptwidget angezeigt werden soll.
Wähle hier die Farbe, die für das Icon des Widgets verwendet werden soll.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Der Standard Selektor fügt das Widget über der Lagerbestandsanzeige ein. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Um zu vermeiden, dass es auf allen Produktseiten erscheint, muss der CSS-Selektor leer gelassen werden. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints auf den jeweiligen Produktseiten platzieren.
# Changelog
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/changelog
Alle Updates und Änderungen für OPC Conversion Booster
### Features
* Die Steuerung über Funktionsattribute gilt jetzt für alle acht artikelbezogenen Widgets, neu auch für „Beobachtet gerade", „Kauften auch", das Zuletzt-angesehen-Widget und den Artikel-Coupon. Schema wie bisher: `dzm_hide_` blendet das Widget beim Artikel aus, `dzm_show_` zeigt es nur dort, sobald die Einstellung „nur bei Attribut anzeigen" aktiv ist. Das Attribut wird je Artikel gepflegt und vererbt sich nicht auf Kindartikel
### Verbesserungen
* Backend folgt dem Dark Mode, Farbfelder sind im Dark Mode lesbar
### Bugfixes
* Der Aktiv-Schalter eines Widgets hat auch von Hand im OPC platzierte Portlets stillgelegt. Nach einer Neuinstallation blieben gezogene Portlets deshalb leer, bis jemand den Schalter fand. Ein platziertes Portlet ist jetzt durch seine Platzierung aktiv, der Schalter gilt nur noch für die automatische Einblendung
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.0 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Features
* "Kauften auch"-Widget zeigt jetzt optional verkaufte Stückzahlen vs Bestellungen
### Bugfixes
* Fehlerbehebung an der Progressbar
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Features
* Kompatibilität 5.7.x
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.10.7
### Features
* Neues Admin Frontend
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.20
### Features
* Verbesserung der Codequalität
* Neuer Installservice \[BETA], checkt die installierte Resources Version und lädt die neuste kompatible Version automatisch
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.16
### Features
* Neues Widget: n mal in den letzten 24h angesehen - Zeigt an wie viele Besucher sich den Artikel innerhalb der letzten 24h angesehen haben. Zusätzlich Option zur Kombination mit dem Widget "Beobachtet gerade" als Fallback
* Neues Widget: X, Y und n Weitere haben diesen Artikel auch gekauft - Social Trust Widget
* Neues Widget: Produkt Coupon - Zeige valide Coupons direkt am Artikel an und lass deine Kunden den Code per Click kopieren
* Neue Funktion: Event Animations - Überrasche deine Kunden mit Feuerwerk und/oder Konfetti beim Bestellabschluss
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.17
### Features
* Attributgesteuertes Ein- und Ausblenden von Widgets für StockAlert und Countdowns
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.8
### Bugfix
* Wichtige Resources & Health Abhängigkeit
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.5
### Neue Features
* JTL Shop 5.4 Kompatibilität
* Sales Countdown Feature: Abgelaufene Angebote ausblenden
### Bugfixes
* Widgets laden nicht nach Javascript Injection
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.3
### Neue Features
* Verbesserte Abstände für Widgets
* Sales Countdown Feature: Abgelaufene Angebote ausblenden
### Bugfixes
* Kleinere Bugfixes
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.8.0
### Bugfixes
* Mehrere kleinere Stylefehlerbehebungen
* Falsche Einstellungsbeschriftung für Releasecountdown
* Abstände verbessert
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.7.0
Im Zuge des neuen Dispatchers in DZM Resources wurde auch in OPC Conversion Booster das Javascript neu überarbeitet.
### Features
* Überarbeitung Javascript
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.7.0
### Features
* Coupon Copy Bestätigungsfarbe kann gewählt werden
### Bugfixes
* Kleinere Fehlerbehebungen
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.6.3
### Features
* Performance Update
### Bugfixes
* Countdown Zeitzonen berücksichtigen
* Kleinere Fehlerbehebungen
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.5.0
### Bugfix
* Sonderpreiscountdown wird fehlerhaft auch ohne Enddatum ausgespielt mit NAN
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.13
### Features
* Überarbeitetes Backend
* Neues Widget: Goodie Progressbar - Stelle eine Progressbar für Gratisgeschenke, Versandkostenfreigrenze und eigene Geschenke dar
* Neues Portlet: Coupon Kalender - Bau dir zu allen vorstellbaren Anlässen einen eigenen Kalender hinter dem du Couponcodes verstecken kannst
* Überarbeitete Gruppierung und Reihenfolge
### Bugfix
* Sommerzeit wird jetzt in den Countdowns korrekt berücksichtigt
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.13
### Features
* Neues Widget: Sonderpreis Countdown - Countdown bei datum-basiertem Sonderpreis
* Neues Widget: Low Stock Alert - Informiert Kunden über niedrigen Lagerbestand
* Neues Widget: Release Countdown - Countdown bei zukünftigem Erscheinungsdatum
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.0
### Features
* Neues Widget: Shipping Countdown - Versandcountdown auf Produktseiten mit eigenem Lagerbestand
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.0
### Features
* Neues Feature: X Besucher Widget - Zeigt an wie viele Besucher sich den Artikel gerade ansehen. Global konfigurierbar oder als Portlet einsetzbar.
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.15
### Features
* Dokumentationstab in Plugineinstellungen
* Animationsklassen zu Coupon Copy hinzugefügt
* Neues Portlet: Coupon Copy - Stelle Coupons prominent dar und lass sie mit einem Klick kopieren
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.6
### Features
* CSRF Token Validierung
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Automatische Funktionsprüfung auf Kompatibilität mit DZM Resources & Health
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Verbessertes Ressourcenmanagement
* Neues Portlet: Product Showcase - Zeig deine Bestseller und besonderen Produkte von ihrer strahlendsten Seite
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Bugfix
* Fehlerbehebung bei Überprüfung des Resources Plugins
### Kompatibilität
* JTL-Shop 5.2.0 - 5.2.\*
### Features
* Warnung, wenn DZM Resources nicht installiert wurde
### Kompatibilität
* JTL-Shop 5.1.2 - 5.1.\*
### Features
* Verbesserte Usability und Styles
* Aktualisierung der Ressourcen
### Kompatibilität
* JTL-Shop 5.2.0 - 5.2.\*
### Features
* Kompatibilität mit JTL Shop 5.2.0
* Probleme mit Lizenz behoben
### Kompatibilität
* JTL-Shop 5.1.2 - 5.2.\*
### Features
* Sales Countdown Portlet: Platziere eines oder mehrere Produkte prominent mit Countdown in Szene
* Wähle ein fixes Enddatum für deinen Sale
* Nutze das ablaufende Datum deines Sonderpreises - Wenn deine Kunden durch den Slider rotieren, passt sich der Countdown automatisch an
### Kompatibilität
* JTL-Shop 5.1.2 - 5.1.\*
# Confetti
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/confetti
Begeistere deine Kunden mit Konfetti-Animationen auf ausgewählten Events
## Allgemeine Beschreibung
Wir brauchen dringend mehr Confetti im Leben – und so auch deine Kunden. Begeistere sie mit Konfetti-Animationen auf ausgewählten Events und hinterlasse einen unvergesslichen Eindruck beim Kaufabschluss.
Die confetti.js Bibliothek wiegt 130 kb. Wenn du Performanceprobleme hast, verzichte lieber auf dieses Feature.
## Settings
### Test
Über den Button **„Konfetttiiiii"** kannst du die Konfetti-Animation direkt im Backend testen, ohne den Shop aufrufen zu müssen.
### Einstellungen
Das Feature wird aktiv weiterentwickelt. Für den Start steht dir der Konfettiregen auf der Bestellabschlussseite zur Verfügung. Weitere Events und Implementierungen folgen.
Schalte die Konfetti-Animation global ein oder aus.
### Einfügeoptionen
Das Script sollte nach dem Footer platziert werden. Nutze diese Einstellung nur, wenn nötig.
Wähle aus verschiedenen Einfügemethoden, wie das Script an den CSS-Selektor eingefügt werden soll.
CSS-Selektor, nach dem das Script eingefügt wird. Der Standard-Selektor platziert das Script nach dem Footer-Element.
# Countdown Plus
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/countdown-plus
Flexibler Countdown für einmalige oder wiederkehrende Zeiträume
## Allgemeine Beschreibung
Mit dem Countdown Plus-Portlet kannst du einen Countdown an beliebiger Stelle in deinem Onlineshop platzieren. Hierbei kann entweder ein einmaliges Enddatum oder ein wiederkehrendes Enddatum/-uhrzeit gewählt werden.
Außerdem lässt sich der Text vor und hinter dem Countdown nach belieben anpassen. Zusätzlich kannst du entscheiden, was angezeigt werden soll, wenn der Timer abgelaufen ist.
## Featureübersicht
* Einmaliges oder wiederkehrendes Enddatum
* Anpassbarer Text vor und nach dem Countdown
* Verschiedene Darstellungsoptionen für abgelaufene Timer
* Umfangreiche Animationsoptionen
## Settings
### Allgemein
Wähle, ob der Timer ein einmaliges Enddatum haben soll oder regelmäßig wiederholt werden soll.
Wähle hier das fixe Enddatum für den Timer.
Trage hier den Text ein, der vor dem Countdown ausgegeben werden soll.
Trage hier den Text ein, der nach dem Countdown ausgegeben werden soll.
### Darstellung
Wähle aus verschiedenen Schreibstilen der Zeiteinheiten des Countdowns.
Entscheide, ob abgelaufene Timerbereiche ausgeblendet werden sollen.
Wähle hier die Hintergrundfarbe, die hinter dem Countdown angezeigt werden soll.
Wähle hier die Textfarbe des Countdowns.
Wähle, ob der Countdown innerhalb des Containers linksbündig oder zentriert angezeigt werden soll.
### Abgelaufener Countdown
Entscheide darüber, was angezeigt werden soll, wenn der Timer abgelaufen ist.
**Optionen:**
* Komplett ausblenden
* Timer ausblenden, Alternativtext anzeigen
* Abgelaufenen Timer darstellen mit Alternativtext
Die Alternativtexte lassen sich anpassen, wenn die entsprechende Version gewählt wurde.
### Animation
Entscheide dich für einen der vielen Animationstypen.
Lege die Dauer der Animation in Sekunden (s) fest.
Definiere die verstrichene Zeit bevor die Animation anfängt.
Lege die Anzahl der Wiederholungen fest.
# Coupon Calendar
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/coupon-calendar
Erstelle Adventskalender-Style Coupon-Aktionen für verschiedene Anlässe
## Allgemeine Beschreibung
Das "Coupon Kalender" Portlet im OPC Conversionbooster ermöglicht es dir, zu verschiedenen Anlässen eigene Kalender zu erstellen und hinter den Türchen Couponcodes zu verstecken. Diese Türchen öffnen sich nur an dem eingestellten Tag, was einen Überraschungseffekt schafft und Kunden zur wiederholten Rückkehr animiert.
Ob Weihnachtskalender, Black Friday, Ostern oder andere besondere Anlässe – mit dem Coupon Kalender Portlet bist du absolut flexibel und kannst deine Kunden mit attraktiven Angeboten begeistern.
## Einsatzmöglichkeiten
* **Saisonale Aktionen:** Nutze den Kalender, um saisonale Aktionen wie Weihnachts- oder Osterangebote hervorzuheben.
* **Sonderveranstaltungen:** Erstelle Kalender für besondere Events wie Black Friday, um die Spannung und Vorfreude zu steigern.
## Featureübersicht
Wähle den Zeitpunkt, zu dem das Türchen freigeschaltet werden soll.
Bestimme, wann das Türchen deaktiviert und nicht mehr öffnbar sein soll.
Hinterlege Bilder für die verschiedenen Zustände des Türchens.
Bestimme das Seitenverhältnis des Türchens (16:9, 4:3, 1:1 oder keins).
Verleihe dem geschlossenen Türchen eine passende Überschrift.
Trage den Inhalt ein, der beim Öffnen des Türchens angezeigt wird, wie z.B. einen Gutscheincode.
Bestimme die Schattierung des Türchens im geöffneten Zustand.
Wähle aus verschiedenen Öffnungsanimationen (aufklappen, aufdecken, hochsliden, keine).
Lege fest, wie stark die Ecken des Türchens abgerundet sind.
Wähle die Textfarbe für die Ribbons, die den Status des Türchens anzeigen ("Jetzt öffnen" oder "Ab \[Startdatum]").
Füge Einlösebedingungen oder weitere Informationen hinzu, die beim Hovern über das geöffnete Türchen angezeigt werden.
## Settings
### Allgemein
Wähle hier einen Zeitpunkt zu dem das Türchen freigeschaltet werden soll.
Wähle hier den Zeitpunkt zu dem das Türchen deaktiviert/nicht mehr öffenbar sein soll.
Hinterlege hier Bilder für jeweils das geöffnete und das geschlossene Türchen.
Entscheide hier, in welchem Seitenverhältnis das einzelne Türchen dargestellt werden soll.
**Optionen:**
* 16:9
* 4:3
* 1:1
* Keins
Vergebe hier eine passende Überschrift, die auf dem geschlossenen Türchen angezeigt werden soll.
Trage hier den Inhalt ein, der angezeigt werden soll wenn das Türchen geöffnet ist. Hier eignet sich ein Gutscheincode o.Ä.
Trage hier einen Wert zwischen 0 und 1 ein. Dieser bestimmt, wie stark die innere Schattierung des Türchens sein soll, wenn es geöffnet ist.
Entscheide hier mit welcher Animation das Türchen geöffnet werden soll.
**Optionen:**
* Türchen klappt auf
* Aufdecken
* Hochsliden
* Keine
Trage hier einen Wert in Pixeln ein. Dieser bestimmt wie sehr die Ecken des Türchens abgerundet sind.
Wähle hier die Textfarbe für das Ribbon, das in der oberen rechten Ecke des Türchens angezeigt werden soll.
Standardmäßig ist der Text:
* bei geöffnetem Türchen: "Jetzt öffnen"
* bei geschlossenem Türchen: "Ab \[Startdatum]"
Die Farbe der Ribbons orientiert sich an deinem Theme.
### Weitere Infos
Hier kannst du Text für zusätzliche Infos zum Türchen eintragen. Hierfür eignen sich bspw. Einlösebedingungen für den hinterlegten Gutschein.
Wenn hier etwas eingetragen ist, wird am unteren rechten Rand des geöffneten Türchens ein Button erzeugt, der beim Hovern die zusätzlichen Infos vollflächig im Türchen einblendet.
Wähle hier eine Farbe für die Hintergrundfarbe der zusätzlichen Info. Um eine gute Lesbarkeit zu gewähren kannst du ggbf. die Textfarbe der zusätzlichen Info über den oberen Richtext-Editor anpassen.
# Coupon Copy
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/coupon-copy
Präsentiere Gutscheincodes zum einfachen Kopieren in die Zwischenablage
## Allgemeine Beschreibung
Das "Coupon Copy" Portlet bietet eine attraktive Möglichkeit, Gutscheincodes oder Sonderangebote hervorzuheben und Kunden dazu zu bewegen, diese zu nutzen. Mit seinen vielseitigen Anpassungsmöglichkeiten kannst du sicherstellen, dass deine Angebote auffallen und die gewünschte Wirkung erzielen. Über eine kleine Schaltfläche kann sich der Nutzer den Code direkt in die Zwischenablage kopieren und anschließend im Warenkorb einsetzen.
## Einsatzmöglichkeiten
* **Exklusive Gutscheinangebote:** Biete exklusive Gutscheincodes für wiederkehrende Kunden an, um ihre Treue zu belohnen und sie zum erneuten Kauf zu motivieren.
* **Besondere Rabattaktionen:** Präsentiere temporäre Rabattaktionen oder Sonderangebote in einem auffälligen Design, um die Aufmerksamkeit der Besucher zu gewinnen.
## Featureübersicht
Gib dem Portlet eine individuelle Überschrift, um den Fokus auf das Angebot oder den Gutscheincode zu lenken.
Hinterlege einen Gutscheincode, den Kunden direkt über eine Schaltfläche kopieren können, um ihn beim Checkout einzulösen.
Passe den Text an, der nach dem Kopieren des Gutscheincodes erscheint, um den Kunden zu informieren oder zu danken.
Füge wichtige Informationen oder Bedingungen als Kleingedrucktes hinzu, damit Kunden alle relevanten Details kennen.
Lade ein eigenes Bild hoch, um das Angebot visuell ansprechend zu gestalten und die Aufmerksamkeit zu steigern.
Wähle aus verschiedenen Banderolen-Optionen wie "Sale", "Gutschein", "Coupon" oder ohne Banderole, um das Angebot visuell zu unterstreichen.
Passe die Hintergrundfarbe der Banderole an, um sie perfekt zum Gesamtdesign deiner Webseite passen zu lassen.
## Settings
### Allgemein
Hinterlege eine passende Überschrift für die Coupon-Box.
Trage hier den Gutscheincode ein.
Gebe an, welcher Text angezeigt werden soll, wenn ein Nutzer den Code kopiert hat.
Hier kannst du die Konditionen für den Gutscheincode eintragen. Diese werden in der unteren rechten Ecke angezeigt.
### Bild
Wenn Haken gesetzt, wird kein Bild verwendet.
Hier hast du die Möglichkeit ein Bild hochzuladen. Dieses wird links in der Coupon-Box angezeigt.
Achte auf ein einheitliches Seitenverhältnis (z. B. 1:1), da das Bild je nach Bildschirmgröße und Layout (kompakte Box vs. volle Breite) unterschiedlich zugeschnitten wird. Bei einem unpassenden Seitenverhältnis können wichtige Bildinhalte auf manchen Breakpoints abgeschnitten werden.
### Darstellung
Entscheide ob eine Banderole an der oberen rechten Ecke angezeigt werden soll und bestimme den Inhalt.
**Optionen:**
* Sale
* Coupon
* Gutschein
* Nicht anzeigen (deaktiviert die Banderole)
Passe die Hintergrundfarbe der Banderole an. Hinterlege entweder Farbwerte oder wähle eine Farbe mittels ColorPicker.
Wenn aktiviert, wird die Box auf die gesamte, verfügbare Breite gestreckt.
Wenn aktiviert, wird ein dezenter Schatten hinter der Coupon-Box erzeugt, um diese besser hervorzuheben.
### Animation
Entscheide dich für einen der vielen Animationstypen.
Lege die Dauer der Animation in Sekunden (s) fest.
Definiere die verstrichene Zeit bevor die Animation anfängt.
Lege die Anzahl der Wiederholungen fest.
# Einführung
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/einfuehrung
## Was ist DZM OPC Conversion Booster?
OPC Conversionbooster ist eine Sammlung conversionoptimierter Portlets für den JTL Shop 5 On, mit denen du deine Produkte richtig in Szene setzen kannst.
### Schnellanleitung
Resources & Health muss installiert sein
Installiere OPC Conversion Booster
Trag den Lizenzschlüssel in den Plugineinstellungen ein
## Allgemeine Infos - Vorbereitung
Die folgenden Anweisungen gelten für alle DZM Plugins.
### Wo finde ich die Lizenzschlüssel?
Deine Lizenzschlüssel findest du direkt nach der Buchung in deinem Kundenkonto unter **Meine Lizenzen**.
Diesen Lizenzschlüssel trägst du im jeweiligen Plugin ein.
Einen Lizenzschlüssel findest du hier nur, wenn du das Produkt über unseren Store gebucht hast.
### Welche Lizenzen muss ich buchen?
Resources & Health benötigt keine Lizenz und kann direkt runter geladen und verwendet werden. Alle anderen Plugins benötigen eine Lizenz.
Für **OPC Suite** benötigst du einen Lizenzschlüssel.
**OPC Suite** bietet eine Bundle Lizenz für alle weiteren Produkte:
* OPC Plus
* OPC Conversion Booster
* OPC Smarty Portlets
* OPC Portlets vererben
Das bedeutet, dass nur allein mit der Aktivierung einer OPC Suite Lizenz automatisch auch die Plugins OPC Plus, OPC Conversion Booster, OPC Smarty Portlets und OPC Portlets vererben aktiviert hast. **In diesem Fall musst du in den anderen Plugins keinen eigenen Schlüssel mehr hinterlegen.**
## Inhaltsübersicht
Präsentiere ausgewählte Produkte in einem attraktiven Tab-basierten Showcase
Erzeuge Dringlichkeit durch Countdown-Angebote
Erstelle Adventskalender-Style Coupon-Aktionen
Präsentiere Gutscheincodes zum einfachen Kopieren
Flexibler Countdown für verschiedene Anlässe
Zeige wie viele Besucher das Produkt gerade ansehen
Informiere über den nächsten Versandzeitpunkt
Warnung bei niedrigem Lagerbestand
Countdown für zeitlich begrenzte Sonderpreise
Countdown für kommende Produktveröffentlichungen
Motiviere zu höheren Warenkorbwerten
# Feuerwerk
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/feuerwerk
Belohne deine Kunden mit einer Feuerwerkanimation
## Allgemeine Beschreibung
Belohne deine Kunden mit einer Feuerwerkanimation und hinterlasse einen unvergesslichen Eindruck beim Kaufabschluss.
## Settings
### Test
Über den Button **„Feuer!!!"** kannst du die Feuerwerk-Animation direkt im Backend testen, ohne den Shop aufrufen zu müssen.
### Einstellungen
Das Feature wird aktiv weiterentwickelt. Für den Start steht dir Feuerwerk auf der Bestellabschlussseite zur Verfügung. Weitere Events und Implementierungen folgen.
Schalte die Feuerwerk-Animation global ein oder aus.
### Einfügeoptionen
Das Script sollte nach dem Footer platziert werden. Nutze diese Einstellung nur, wenn nötig.
Wähle aus verschiedenen Einfügemethoden, wie das Script an den CSS-Selektor eingefügt werden soll.
CSS-Selektor, nach dem das Script eingefügt wird. Der Standard-Selektor platziert das Script nach dem Footer-Element.
# Free Gifts Progressbar
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/goodie-progressbar
Motiviere Kunden zu höheren Warenkorbwerten mit einer Fortschrittsleiste
## Allgemeine Beschreibung
Die Goodie-Progressbar wird standardmäßig auf der Warenkorbseite eingesetzt und zeigt eine Fortschrittsleiste an, die deinen Kunden anzeigt, wie viel sie noch einkaufen müssen, um das nächste Gratisgeschenk oder die versandkostenfreie Lieferung zu erhalten.
Diese Funktion motiviert Kunden, ihren Einkauf fortzusetzen, um von zusätzlichen Belohnungen zu profitieren. Durch klare visuelle Marker und anpassbare Texte können Kunden ihre Fortschritte leicht verfolgen und werden ermutigt, mehr zu kaufen.
## Featureübersicht
Die Goodie-Progressbar wird standardmäßig auf der Warenkorbseite angezeigt.
Möchtest du die Goodie-Progressbar an mehreren Stellen auf der Produktseite oder anderen Seiten platzieren, kannst du sie ganz einfach per OnPage-Composer an der gewünschten Stelle einfügen.
Passe den angezeigten Text ganz einfach per Sprachvariable an, um die Kunden optimal zu informieren.
Gestalte das Aussehen der Progressbar nach Belieben und passe Farben, Icons und Layouts an dein Shop-Design an.
Entscheide selbst per CSS-Selektor, an welcher Stelle die Progressbar angezeigt werden soll.
## Settings
### Funktionen
Entscheide, ob das Widget aktiv und automatisch an der per CSS-Selektor gewählten Stelle platziert werden soll.
Entscheide, ob Gratisgeschenke als Marker auf der Progressbar angezeigt werden sollen.
Entscheide, ob du die Versandkostenfreigrenze als Marker auf der Progressbar angezeigt werden soll.
Wenn du etwas anderes als "Alle Ziele anzeigen" im Anzeigenmodus auswählst, kannst du hier festlegen ob die Versandkostenfreigrenze trotzdem immer angezeigt werden soll. Auch wenn diese bereits erreicht ist und/oder es andere Ziele gibt, die niedriger liegen.
Wenn ein Kunde noch nichts im Warenkorb liegen hat, kann der Shop die Versandkostenfreigrenze nicht berechnen. Trage hier einen Fallback Wert ein, um auch bei leeren Warenkörben die Marke in der Progressbar anzuzeigen. Dieser Wert wird überschrieben, sobald ein Artikel im Warenkorb des Kunden liegt.
### Beschriftung
Entscheide, ob der aktuelle Warenkorbwert bzw. der Wert des nächsten Markers auf der Progressbar angezeigt werden soll.
Lege fest, ob der Info-Text unter der Progressbar angezeigt werden soll. Diesen kannst du für jeden Marker einzeln unter dem Menüpunkt "Custom Gifts" über Sprachvariablen definieren.
Entscheide, ob die Icons (definierbar unter Styles) auf der Progressbar angezeigt werden sollen.
### Darstellungsmodus
Wenn aktiv, werden im kompakten Darstellungsmodus die Icons immer ausgeblendet. Der Text auf der Progressbar wird nicht angezeigt, und die Progressbar schrumpft auf eine geringere Höhe. Dadurch bleibt mehr Platz für Inhalt.
Wenn aktiv, werden im kompakten Darstellungsmodus die Icons immer ausgeblendet. Der Text auf der Progressbar wird nicht angezeigt, und die Progressbar schrumpft auf eine geringere Höhe. Dadurch bleibt mehr Platz für Inhalt.
Wenn aktiv, werden im kompakten Darstellungsmodus die Icons immer ausgeblendet. Der Text auf der Progressbar wird nicht angezeigt, und die Progressbar schrumpft auf eine geringere Höhe. Dadurch bleibt mehr Platz für Inhalt.
Definiere hier die Höhe der Progressbar in Pixeln, wenn der Kompaktmodus aktiviert ist.
Lege hier fest, welche Ziele auf der Progressbar dargestellt werden sollen.
**Optionen:**
* Alle Ziele
* Alle erreichten und das nächste Ziel
* Das letzte und das nächste Ziel
Lege hier fest, welche Ziele auf der Progressbar dargestellt werden sollen.
**Optionen:**
* Alle Ziele
* Alle erreichten und das nächste Ziel
* Das letzte und das nächste Ziel
Lege hier fest, welche Ziele auf der Progressbar dargestellt werden sollen.
**Optionen:**
* Alle Ziele
* Alle erreichten und das nächste Ziel
* Das letzte und das nächste Ziel
### Vorschau
Hier siehst du eine Vorschau der Progressbar mit deinen aktuellen Einstellungen.
### Custom Gifts
Hier kannst du unabhängig von Gratisgeschenken oder Versandkostenfreigrenzen eigene Marker setzen, um deine Kunden immateriell zu belohnen. Beispiel: Baum pflanzen oder Spende an gemeinnützige Organisation.
Vergebe einen internen Namen für das Custom Gift. Dieser wird nicht im Shop ausgespielt und dient lediglich der Verwaltung von den Custom Gifts.
Um Sprachvariablen zu verwenden, musst du diese zunächst über das Resources & Health-Dashboard in der Region "Custom" anlegen. Lege eine Sprachvariable für den Titel des CustomGifts an, der auf der Progressbar angezeigt wird, und eine Sprachvariable für den Infotext, der unterhalb der Progressbar angezeigt wird.
Trage hier den Warenkorbwert ein, der benötigt wird um das Custom Gift zu erreichen.
Durch Klick auf diesen Button speicherst du das Custom Gift und fügst es deiner Progressbar hinzu.
Zeigt eine Übersicht aller gespeicherten Custom Gifts mit Name, Wert, Titel Variable und Info Variable. Hier kannst du eingetragene Gifts einsehen und verwalten.
### Styles
Wähle hier das Icon, das für den Gratisgeschenk-Marker verwendet werden soll.
Wähle hier das Icon, das für den Versandkostenfrei-Marker verwendet werden soll.
Wähle hier das Icon, das für den Custom Geschenk-Marker verwendet werden soll.
Wähle eine Farbe für die Progressbar.
Wähle eine Hintergrundfarbe für die Progressbar.
Wähle eine Farbe für die Icons und Schrift auf der Progressbar.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Wenn du den CSS-Selektor leer lässt, wird das Widget nur im Warenkorb ausgespielt.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints an beliebigen Stellen in deinem Shop platzieren.
# Installation
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/installation
## Installationsprozess
**BEVOR DU BEGINNST**
Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
### 1. Resources & Health
Lade unter [https://dreizack-medien.de/DZM-Resources-Health](https://dreizack-medien.de/DZM-Resources-Health) unser Plugin **Resources & Health**.
Achte auf die Wahl der passenden Version.
Lade die eben herunter geladene Zipdatei über den Plugin Manager in deinen Store hoch.
Unter **Vorhanden** wählst du nun das hochgeladene Plugin aus, akzeptierst ggfs die Lizenzbedingungen und klickst auf **Installieren**.
### 2. OPC Conversion Booster Lizenz buchen
1. Registriere dich in unserem Store.
2. Wähle unter [https://dreizack-medien.de/DZM-OPC-Conversionbooster](https://dreizack-medien.de/DZM-OPC-Conversionbooster) die passende Kaufoption aus.
3. In diesem Beispiel ordern wir eine Lizenz für **OPC Conversion Booster** als **Vollversion** und tragen unsere Domain ein, ohne `https://` oder führendes `www.`
**Achtung!** Diese Auswahl ist nur möglich, wenn du bereits angemeldet bist. Eine Bestellung ohne Registrierung ist ausgeschlossen!
Wenn du bereits eine Demo- oder Entwicklerlizenz hast und angemeldet bist, kannst du alternativ zur Registrierung einer neuen Domain einfach unten im Dropdown deine bestehende Lizenz auswählen und in eine Vollversion umwandeln. Die passende Domain wird dann automatisch übernommen.
Domains einer produktiven Lizenz kannst du später in deinem Kundenkonto bearbeiten und ändern. Wenn du also auf einer Staging Domain gearbeitet hast, kannst du die Lizenz hier in eine Vollversion umwandeln und anschließend in deinem Kundenkonto auf die Live Domain umschreiben.
### 3. OPC Conversion Booster Downloaden und installieren
Kehre nach erfolgreicher Buchung auf die Produktseite zurück und lade hier die passende Version von OPC Conversion Booster herunter: [https://dreizack-medien.de/DZM-OPC-Conversionbooster](https://dreizack-medien.de/DZM-OPC-Conversionbooster)
Lade anschließend die Zipdatei wie oben bei Resources & Health über den **Pluginmanager** in deinen Store hoch, und installiere das Plugin.
### 4. Lizenz aktivieren
Wechsel in unserem Store in dein **Kundenkonto** unter **Meine Lizenzen** und kopiere dir den **Lizenzschlüssel** für deine Domain.
Unter Umständen kann es passieren, dass sich das OPC Conversion Booster Plugin so lange selbst deaktiviert, bis eine gültige Lizenz eingetragen wurde.
Aktiviere in diesem Fall das Plugin einfach wieder und wechsle **sofort** in die **Plugineinstellungen** und trage den Lizenzschlüssel ein. In wenigen Ausnahmefällen kann es sein, dass sich das Plugin noch ein mal selbst deaktiviert, nachdem du den Schlüssel eingetragen hast. Aber keine Sorge. Nach letztmaliger Aktivierung bleibt es auch aktiviert. Versprochen ;)
Trage deinen Lizenzschlüssel unter **Lizenz** ein und klick auf **Speichern**.
Das Plugin signalisiert dir, dass die Lizenz valide und aktiv ist.
### Wo finde ich die Installationsfiles?
Die Installer Pakete findest du jeweils am Produkt.
In der Sidebar findest du alle veröffentlichten Versionen.
* **Achte auf die Info, ob das Plugin Resources & Health benötigt und in welcher Version.**
* **Achte auf die kompatible Version**
* **Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast**
**Resources & Health ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop.** Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
# Kauften auch
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/kauften-auch
Steigere deinen Umsatz durch automatische Cross-Selling-Empfehlungen
## Allgemeine Beschreibung
Das **Kauften auch**-Widget zeigt Besuchern auf der Produktdetailseite oder im Warenkorb automatisch Produkte an, die andere Kunden häufig gemeinsam mit dem aktuell betrachteten Artikel gekauft haben. Es nutzt das Kaufverhalten deiner Kunden, um relevante Produktempfehlungen auszuspielen und so Cross-Selling-Potenziale zu aktivieren.
Durch die gezielte Anzeige passender Ergänzungsprodukte erhöhst du den durchschnittlichen Warenkorbwert und bietest deinen Kunden gleichzeitig einen echten Mehrwert – ohne dass sie aktiv danach suchen müssen.
## Featureübersicht
Das Widget analysiert das Kaufverhalten deiner Kunden und spielt automatisch passende Produkte aus, die häufig zusammen gekauft wurden.
Möchtest du das Widget an mehreren Stellen im Shop platzieren, kannst du es ganz einfach per OnPage-Composer an der gewünschten Stelle einfügen.
Passe den angezeigten Text ganz einfach per Sprachvariable an, um die Kunden optimal anzusprechen.
Gestalte das Aussehen des Widgets nach Belieben und passe es an dein Shop-Design an.
Entscheide selbst per CSS-Selektor, an welcher Stelle das Widget angezeigt werden soll.
## Settings
### Funktionen
Entscheide, ob das Widget aktiv und automatisch an der per CSS-Selektor gewählten Stelle platziert werden soll.
Aktiviere den Demo Modus, um das Widget zu testen.
Diese Funktion ist nicht für den produktiven Shop geeignet.
Lege hier den Mindestwert an gemeinsamen Käufen fest, ab dem ein Produkt als Empfehlung angezeigt wird.
Wenn aktiv, werden immer die gesamten Verkaufszahlen angezeigt, auch wenn der Grenzwert nicht erreicht wurde.
### Vorschau
Hier siehst du eine Vorschau des Widgets mit deinen aktuellen Einstellungen.
Vorschau des angezeigten Textes im Widget. Den Text kannst du über Sprachvariablen anpassen.
### Styles
Wähle das angezeigte Icon für das Widget – du kannst aus einer umfangreichen Bibliothek frei wählen.
Bestimme hier den visuellen Rahmen deines Widgets. Wähle aus verschiedenen Darstellungsoptionen, wie das Widget angezeigt werden soll.
**Optionen:**
* **Clean:** Aufgeräumte, minimalistische Darstellung ohne Rahmen
* **Card:** Widget wird als Karte mit Hintergrund dargestellt
* **Bordered:** Widget mit sichtbarem Rahmen
* **Full:** Widget erstreckt sich über die volle Breite
* **Alert Info:** Darstellung als informativer Hinweis
* **Alert Warning:** Darstellung als Warnhinweis
* **Alert Danger:** Darstellung als Gefahrenhinweis
* **Alert Success:** Darstellung als Erfolgshinweis
Wähle hier die Farbe, die für das Icon des Widgets verwendet werden soll.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints an beliebigen Stellen in deinem Shop platzieren.
# Portlet vs. Widget
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/portlet-vs-widget
Unterschied zwischen Portlets und Widgets im OPC Conversion Booster
## Portlets vs. Widgets
Dieses Plugin enthält sowohl Portlets als auch Widgets. Beide dienen dazu, Inhalte in deinem Shop auszuspielen – unterscheiden sich aber in der Art, wie sie eingesetzt werden.
### Portlets
**Portlets** sind kleine Bausteine, die man über den OnPage-Composer (OPC) an der gewünschten Stelle platzieren kann. Je nach Portlet gibt es dann noch verschiedene Einstellungen.
* Platzierung per Drag & Drop im OPC
* Volle Kontrolle über Position und Seite
* Einstellungen direkt am Portlet im OPC
### Widgets
**Widgets** hingegen können über das Plugin-Backend konfiguriert und automatisch auf alle entsprechenden Seiten per CSS-Selektor übertragen werden. Zusätzlich sind alle Widgets auch als Portlet verfügbar und können nach Belieben platziert werden.
* Konfiguration im Plugin-Backend
* Automatische Platzierung auf allen entsprechenden Seiten per CSS-Selektor
* Auch als Portlet im OPC verwendbar
### Widget als Portlet nutzen
Um ein Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Um zu vermeiden, dass es automatisch auf allen Seiten erscheint, muss der CSS-Selektor im Backend leer gelassen werden. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints platzieren.
Widgets können nur als Portlet verwendet werden, wenn das Widget im Backend aktiviert ist. Damit es nicht automatisch auf allen Artikeldetailseiten platziert wird, entferne einfach den entsprechenden CSS-Selektor im Backend und platziere das Portlet an der gewünschten Stelle mit dem OnPage-Composer.
# Product Showcase
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/product-showcase
Präsentiere ausgewählte Produkte oder Produktkategorien in einem attraktiven Tab-basierten Showcase
## Allgemeine Beschreibung
Das "Product Showcase" Portlet im OPC Conversion Booster bietet eine effektive Möglichkeit, ausgewählte Produkte oder Produktkategorien gezielt zu präsentieren. Mit seiner tab-basierten Struktur, den anpassbaren Erscheinungsbildern und den speziellen Effekten kannst du sicherstellen, dass deine Produkte in einem attraktiven und interaktiven Showcase hervorgehoben werden.
## Einsatzmöglichkeiten
* **Produktempfehlungen:** Zeige Empfehlungen für bestimmte Produkte in verschiedenen Kategorien an, um Kunden zu inspirieren.
* **Feature-Highlights:** Präsentiere herausragende Funktionen oder Vorteile deiner Produkte durch individuell gestaltete Tabs.
* **Saisonale Angebote:** Stelle spezielle Angebote oder Kollektionen in einem ansprechenden Showcase während saisonaler Ereignisse oder Feiertage vor.
## Featureübersicht
Lege verschiedene Tabs im Showcase an, um Produkte oder Produktkategorien gezielt zu präsentieren.
Fülle jeden Tab mit verschiedenen Inhalten, wie Artikelslidern, um eine breite Produktpalette auf ansprechende Weise zu zeigen.
Definiere eine Überschrift für das Showcase, um den Fokus auf bestimmte Produkte oder Themenbereiche zu lenken.
Wähle aus verschiedenen Hintergrundverläufen (Gold, Bronze, Grau oder Transparent), um das visuelle Erscheinungsbild des Showcases zu gestalten.
Schalte einen Effekt ein, der Sterne anzeigen kann, um besondere Produkte oder Empfehlungen hervorzuheben.
Das Product Showcase passt sich verschiedenen Bildschirmgrößen und Geräten an, um eine optimale Darstellung sicherzustellen.
Konfiguriere das Showcase mühelos und intuitiv, um eine gezielte Präsentation deiner Produkte zu ermöglichen, ohne komplexe Einstellungen vornehmen zu müssen.
## Settings
### Allgemein
Wähle hier, wie die Überschrift und Tabs horizontal ausgerichtet werden sollen.
**Optionen:**
* links
* zentriert
* rechts
### Überschrift
Vergebe hier eine Überschrift, die oberhalb der Tabs angezeigt wird.
Bestimmt welchen HTML-Tag die Überschrift bekommen soll. Hilfreich für SEO-freundliche Textstrukturen.
Bestimmt, wie groß der Text angezeigt werden soll und orientiert sich an den Vorgaben des aktuellen Themes.
Bestimmt die Farbe der Überschrift.
Bestimmt die font-weight (CSS) der Überschrift. Je höher die font-weight, desto dicker die Schrift.
### Tabs
| Aktion | Beschreibung |
| ----------------------- | ----------------------------------------------------------- |
| **Entfernen von Tabs** | Durch Klicken auf das 'x' löschst du den entsprechenden Tab |
| **Hinzufügen von Tabs** | Durch Klicken auf das '+' fügst du neue Tabs hinzu |
| **Benennen von Tabs** | Hier kannst du den einzelnen Tabs Namen/Überschriften geben |
### Darstellung
Bestimmt wie breit der Container in den einzelnen Tabs sein soll.
**Optionen:**
* Fluid (minimaler Abstand)
* Boxed (regulärer Abstand)
* Kein Container (ohne Abstand)
Die Abstände orientieren sich an den gesetzten Werten in deinem Theme.
Wähle hier einen Hintergrundverlauf für das Productshowcase aus.
**Optionen:**
* Gold
* Bronze
* Grau
* Transparent
Wenn aktiviert, wird das Showcase mit einem Sternregen-Effekt bestückt.
# Produkt Coupon
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/produkt-coupon
Präsentiere Besuchern direkt am Produkt einen Couponcode und nutze psychologische Kaufanreize
## Allgemeine Beschreibung
Das **Produkt Coupon**-Widget spielt auf der Artikeldetailseite ein Widget aus, welches dem Besucher direkt einen verfügbaren Couponcode präsentiert. Das Widget nutzt dabei geschickt psychologische Trigger wie Micro-Achievement und Gamification: Der Kunde bekommt sofort das positive Gefühl, etwas gewonnen oder einen exklusiven Vorteil für seinen Einkauf erhalten zu haben.
**Wichtiger Konfigurationshinweis:** Um festzulegen, dass ein bestimmter Coupon im Widget angeboten wird, musst du an den Namen dieses Coupons das Suffix `__show__` anhängen.
Da immer nur *ein* Coupon gleichzeitig angezeigt werden kann und das System alphabetisch sortiert, kannst du deine Coupons durch eine Nummerierung im Namen priorisieren.
**Beispiel:** Nenne deinen wichtigsten Gutschein `001 Mein Gutschein__show__`. Das System prüft die alphabetische Reihenfolge und gibt den ersten Coupon aus, der für das aktuelle Produkt gültig ist.
## Einsatzmöglichkeiten
* **Conversion-Rate steigern:** Gib zögerlichen Kunden den letzten Anstoß zum Kauf, indem du ihnen direkt am Produkt einen kleinen Rabattcode (z.B. für kostenlosen Versand oder 5% Rabatt) anbietest.
* **Lagerüberhänge abverkaufen:** Biete auf bestimmten, schwer verkäuflichen Artikeldetailseiten gezielt hohe Gutscheine an, um den Abverkauf zu pushen, ohne den Streichpreis des Artikels dauerhaft ändern zu müssen.
## Featureübersicht
Erzeugt durch direkte Coupon-Vergabe ein Belohnungsgefühl (Gamification) beim Kunden.
Steuere über eine einfache Nummerierung im Coupon-Namen genau, welcher Gutscheincode bei mehreren aktiven Aktionen Vorrang hat.
Passe das Icon, die Icon-Farbe und den grundlegenden Widget-Stil perfekt an dein Shop-Design an.
Füge das Widget über CSS-Selektoren punktgenau dort auf der Artikeldetailseite ein, wo es am besten konvertiert.
## Settings
### Funktionen
Mit diesem Schalter kannst du das Produkt Coupon Widget global in deinem Shop ein- oder ausschalten.
### Vorschau
Hier siehst du das Widget in der Live-Vorschau. Es zeigt dir an, wie der Text in Kombination mit deinem ausgewählten Icon auf der Seite wirken wird.
Vorschau des angezeigten Textes im Widget (z.B. „Sichere dir heute 10% Rabatt mit TEST10"). Den Text kannst du über Sprachvariablen anpassen.
### Styles
Wähle ein passendes Symbol aus, das neben dem Coupontext stehen soll.
Bestimme hier den visuellen Rahmen deines Widgets. Wähle aus verschiedenen Darstellungsoptionen, wie das Widget angezeigt werden soll.
**Optionen:**
* **Clean:** Aufgeräumte, minimalistische Darstellung ohne Rahmen
* **Card:** Widget wird als Karte mit Hintergrund dargestellt
* **Bordered:** Widget mit sichtbarem Rahmen
* **Full:** Widget erstreckt sich über die volle Breite
* **Alert Info:** Darstellung als informativer Hinweis
* **Alert Warning:** Darstellung als Warnhinweis
* **Alert Danger:** Darstellung als Gefahrenhinweis
* **Alert Success:** Darstellung als Erfolgshinweis
Wähle hier die Farbe, die für das Icon des Widgets verwendet werden soll.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints an beliebigen Stellen in deinem Shop platzieren.
# Produktansichten
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/produktansichten
Zeigt Besuchern wie viele andere Besucher sich das Produkt in den letzten 24h angesehen haben
## Allgemeine Beschreibung
Das **Produktansichten**-Widget spielt auf der Artikeldetailseite ein Widget aus, welches dem Besucher anzeigt, wie viele andere Besucher sich das Produkt innerhalb der letzten 24 Stunden angesehen haben. Das Konzept dahinter ist eine Mischung aus Dringlichkeit und Social Trust.
## Einsatzmöglichkeiten
* **Kaufanreiz schaffen:** Nutze das Widget, um durch Social Proof (soziales Vertrauen) die Kaufentscheidung unentschlossener Kunden zu beschleunigen. Wenn andere Kunden sich den Artikel ansehen, wirkt er begehrter.
* **Verknappung suggerieren:** Besonders bei Artikeln mit geringem Bestand erzeugt die Anzeige hoher Besucherzahlen ein Gefühl der Dringlichkeit (FOMO – Fear of Missing Out), was die Conversion Rate steigern kann.
## Featureübersicht
Zeigt automatisch die Seitenaufrufe der letzten 24 Stunden direkt am Artikel an.
Du kannst gezielt einstellen, ob Mehrfachaufrufe desselben Nutzers ignoriert werden sollen, um realistische Zahlen zu gewährleisten.
Die Aufrufe von Haupt- und Kindartikeln (Variationen) lassen sich bequem zusammenrechnen.
Flexibel wählbare Icons und verschiedene Widget-Stile zur nahtlosen Integration in dein Shop-Design.
Einfache Positionierung im Shop über CSS-Selektoren und verschiedene Einfügemethoden.
## Settings
### Funktionen
Mit diesem Schalter kannst du das Widget global ein- oder ausschalten.
Aktiviere diesen Schalter, wenn du die Anzeige der "letzten 24h" als Ersatz für eine Live-Beobachter-Funktion nutzen möchtest.
Wenn aktiv, werden die Seitenaufrufe eines Hauptartikels (Parent) und all seiner zugehörigen Varianten (Child) addiert und als Gesamtwert angezeigt.
Wenn aktiviert, wird verhindert, dass ein einzelner Besucher, der die Seite mehrmals neu lädt, die Zählung künstlich in die Höhe treibt.
Schalte diesen Modus ein, um die Anzeige des Widgets erst einmal sicher im Hintergrund testen zu können.
Diese Funktion ist nicht für den produktiven Shop geeignet.
### Vorschau
Hier siehst du das Widget in der Vorschau. Dir wird direkt angezeigt, wie das Icon und der Text auf der Seite zusammenwirken.
### Styles
Wähle das angezeigte Icon für das Widget – du kannst aus einer umfangreichen Bibliothek frei wählen.
Bestimme hier den visuellen Rahmen deines Widgets. Wähle aus verschiedenen Darstellungsoptionen, wie das Widget angezeigt werden soll.
**Optionen:**
* **Clean:** Aufgeräumte, minimalistische Darstellung ohne Rahmen
* **Card:** Widget wird als Karte mit Hintergrund dargestellt
* **Bordered:** Widget mit sichtbarem Rahmen
* **Full:** Widget erstreckt sich über die volle Breite
* **Alert Info:** Darstellung als informativer Hinweis
* **Alert Warning:** Darstellung als Warnhinweis
* **Alert Danger:** Darstellung als Gefahrenhinweis
* **Alert Success:** Darstellung als Erfolgshinweis
Wähle hier die Farbe, die für das Icon des Widgets verwendet werden soll.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Der Standard Selektor fügt das Widget über der Lagerbestandsanzeige ein. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Um zu vermeiden, dass es auf allen Produktseiten erscheint, muss der CSS-Selektor leer gelassen werden. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints auf den jeweiligen Produktseiten platzieren.
# Release Countdown
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/release-countdown
Countdown für kommende Produktveröffentlichungen
## Allgemeine Beschreibung
Das Release-Countdown Widget wird auf der Produktdetailseite eingesetzt, wenn ein Artikel ein zukünftiges Erscheinungsdatum hat. Es zeigt einen Countdown, der die verbleibende Zeit bis zum Release des Artikels anzeigt, zusammen mit einem über Sprachvariablen anpassbaren Text.
Dieses Widget macht es einfach, die Aufmerksamkeit der Kunden auf bevorstehende Produkte zu lenken und die Vorfreude darauf zu steigern. Durch den Countdown und die klare Aufforderung zur Vorbestellung werden Kunden motiviert, ihre Kaufentscheidung nicht aufzuschieben.
## Featureübersicht
Das Widget wird automatisch auf all Deinen Produktseiten ausgespielt.
Möchtest Du es an mehreren Stellen auf der Produktseite platzieren, kannst Du das Widget ganz einfach per OnPage-Composer an der gewünschten Stelle platzieren.
Passe den angezeigten Text ganz einfach per Sprachvariable an.
Passe das Aussehen des Widgets nach Belieben an.
Entscheide selbst per CSS-Selektor an welcher Stelle das Widget auf der Produktdetailseite ausgespielt werden soll.
## Settings
### Funktionen
Entscheide, ob das Widget aktiv und automatisch an der per CSS-Selektor gewählten Stelle platziert werden soll.
Aktiviere den Demo Modus, um das Widget zu testen.
Diese Funktion ist nicht für den produktiven Shop geeignet.
### Sichtbarkeit
In diesem Bereich kannst du steuern, unter welchen Bedingungen das Widget im Onlineshop für deine Kunden sichtbar sein soll. Du kannst das Widget gezielt bei Produkten ausblenden, indem du dem Artikel das Funktionsattribut `dzm_hide_release_countdown` vom Typ Checkbox anhängst und die Checkbox aktivierst.
Wenn du diesen Schalter aktivierst, wird das Widget standardmäßig ausgeblendet und erscheint nur bei den Artikeln, die das entsprechende Funktionsattribut explizit zugewiesen haben.
### Vorschau
Hier siehst du eine Vorschau des Widgets.
### Styles
Wähle das angezeigte Icon für das Widget - du kannst aus einer umfangreichen Bibliothek frei wählen.
Wähle aus verschiedenen Darstellungsoptionen, wie das Widget angezeigt werden soll.
Wähle hier aus verschiedenen Darstellungsoptionen für die verbleibende Countdown-Zeit.
Wähle hier die Farbe, die für das Icon des Widgets verwendet werden soll.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Der Standard Selektor fügt das Widget über der Lagerbestandsanzeige ein. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Um zu vermeiden, dass es auf allen Produktseiten erscheint, muss der CSS-Selektor leer gelassen werden. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints auf den jeweiligen Produktseiten platzieren.
# Sales Countdown
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/sales-countdown
Erzeuge Dringlichkeit durch Countdown-Angebote für begrenzte Zeit
## Allgemeine Beschreibung
Das "Sales Countdown" Portlet im OPC Conversion Booster bietet eine effektive Möglichkeit, zeitlich begrenzte Angebote hervorzuheben und Kunden zu schnellen Käufen zu motivieren. Mit seinen flexiblen Produktfiltern und anpassbaren Countdown-Optionen kannst du sicherstellen, dass deine Angebote optimal präsentiert werden.
## Einsatzmöglichkeiten
* **Flash Sales:** Erzeuge Aufregung und Dringlichkeit durch Countdown-Angebote für begrenzte Zeit, um Kunden zu schnellen Käufen zu motivieren.
* **Saisonale Aktionen:** Nutze den Countdown, um saisonale Verkaufsaktionen wie Sommer- oder Weihnachtsangebote hervorzuheben und zu bewerben.
## Featureübersicht
Gib der Countdown-Box einen individuellen Titel, um den Fokus auf das Angebot oder die Aktion zu lenken.
Zeige eine Banderole ("Sale" oder "%") an, um das Angebot visuell hervorzuheben und den Kunden auf den Rabatt hinzuweisen.
Filtere Produkte genau nach Kategorie, Hersteller, Artikelbesonderheiten und Preisspanne, um maßgeschneiderte Angebote zu präsentieren.
Definiere den Countdown entweder durch ein festes Enddatum oder das Enddatum des Sonderpreises des Artikels, das sich an JTL-Wawi orientiert.
Passe die Textfarbe des Countdowns an und hebe den Sales Countdown durch Schatten hervor, um ihn ins Auge fallen zu lassen.
Stelle ein, ob der Slider automatisch abgespielt werden soll, definiere die Abspielgeschwindigkeit, aktiviere das Pausieren bei Hover und wähle, ob Pfeile für die Navigation angezeigt werden sollen.
## Settings
### Allgemein
Vergebe einen Titel für den Sales-Countdown, der oberhalb angezeigt wird.
Wähle eine Banderole die oben links im Sale-Countdown angezeigt werden soll.
**Optionen:**
* Sale
* %
* Nicht anzeigen
### Produktauswahl
Lege hier die Anzahl der Produkte fest, die im Sale Countdown nacheinander angezeigt werden. Bei einem Produkt wird kein Slider erzeugt und es wird nur das eine Produkt permanent angezeigt.
Wähle hier aus, wie du deine Produkte hinzufügen möchtest.
**Optionen:**
* **Produkt(e) filtern:** Nutze die Filter, um passende Produkte zu finden
* **Nach Artikelnummer oder -name:** Suche explizit nach bestimmten Artikeln
### Zeitraum
Wähle mit dem Kalender das entsprechende Enddatum und -uhrzeit aus.
Diese Einstellung greift nur, wenn **Fixes Enddatum** ausgewählt wurde bzw. kein Ende des Sonderpreises in der Wawi hinterlegt wurde.
Definiere hier woran sich das Enddatum der Aktion orientieren soll.
**Optionen:**
* **Fixes Enddatum:** Die Einstellung von "Aktionsende" bestimmt das Enddatum
* **Enddatum des Sonderpreises:** Der Countdown orientiert sich an den Sonderpreisen, die für die entsprechenden Artikel in der Wawi hinterlegt sind
### Darstellung
Definiere hier die Textfarbe des Countdowns. Entweder durch Hinterlegen von Farbwerten oder mithilfe des ColorPickers.
Wenn aktiviert, wird ein dezenter Schatten hinter der Box platziert, um diese besser hervorzuheben.
Wenn aktiviert, wird der Slider automatisch abgespielt.
Greift natürlich nur, wenn mehr als 1 Artikel in der Produktauswahl hinterlegt wurde.
Wenn aktiviert, wird der Slider pausiert wenn sich eine Maus auf ihm befindet.
Lege fest, wie schnell das nächste Produkt angezeigt werden soll (in ms).
Wenn aktiviert, werden links und rechts kleine Pfeile eingeblendet, um die Navigation durch den Slider zu vereinfachen.
# Versand Countdown
Source: https://docs.dreizack-medien.de/OPC-Conversion-Booster/versand-countdown
Informiere Besucher über den nächsten Versandzeitpunkt
## Allgemeine Beschreibung
Das Versand-Countdown Widget erscheint auf der Produktdetailseite und informiert den Besucher über den Zeitpunkt des nächsten Versands. Es zeigt einen Countdown, der angibt, wie viel Zeit noch verbleibt, bis der nächste Versandprozess für das Produkt beginnt.
Dieses direkte Informationsangebot motiviert Kunden, ihre Kaufentscheidung zu beschleunigen, um die Sendung zum nächstmöglichen Zeitpunkt zu erhalten. Indem es die Frist für den bevorstehenden Versand klar kommuniziert, hilft das Widget, die Kundenerwartungen hinsichtlich der Lieferzeit zu managen und fördert schnelle Kaufabschlüsse.
## Featureübersicht
Das Widget wird automatisch auf all Deinen Produktseiten ausgespielt.
Möchtest Du es an mehreren Stellen auf der Produktseite platzieren, kannst Du das Widget ganz einfach per OnPage-Composer an der gewünschten Stelle platzieren.
Definiere selbst an welchen Tagen und bis zu welcher Uhrzeit Bestellungen versendet werden. Auch Feiertage und andere versandfreie Tage lassen sich problemlos hinterlegen.
Passe den angezeigten Text ganz einfach per Sprachvariable an.
Passe das Aussehen des Widgets nach Belieben an.
Entscheide selbst per CSS-Selektor an welcher Stelle das Widget auf der Produktdetailseite ausgespielt werden soll.
## Settings
### Funktionen
Entscheide, ob das Widget aktiv und automatisch an der per CSS-Selektor gewählten Stelle platziert werden soll.
Hier kannst du den DEBUG Modus aktivieren.
Deaktiviere diesen sobald dein Shop produktiv agiert.
Wähle hier was dargestellt werden soll, wenn der Countdown für den heutigen Tag abgelaufen ist.
**Optionen:**
* **Widget ausblenden:** Widget wird ausgeblendet und erst am nächsten Versandtag wieder eingeblendet
* **Alternativtext zeigen:** Zeigt anstelle des Countdowns einen Alternativtext, der sich per JTL-Sprachvariable `shipping_countdown_alt_text` anpassen lässt
* **Nächstes Versanddatum ausgeben:** Gibt anstelle des Countdowns das nächste Versanddatum aus
* **Countdown bis zum nächsten Versand:** Widget zeigt einen Countdown bis zum nächsten Versandtag an
### Sichtbarkeit
In diesem Bereich kannst du steuern, unter welchen Bedingungen das Widget im Onlineshop für deine Kunden sichtbar sein soll. Du kannst das Widget gezielt bei Produkten ausblenden, indem du dem Artikel das Funktionsattribut `dzm_hide_shipping_countdown` vom Typ Checkbox anhängst und die Checkbox aktivierst.
Wenn du diesen Schalter aktivierst, wird das Widget standardmäßig ausgeblendet und erscheint nur bei den Artikeln, die das entsprechende Funktionsattribut explizit zugewiesen haben.
### Vorschau
Hier siehst du beide Widgets in der Vorschau.
Stelle hier ein Demo Datum ein, um zu testen wie das Widget für deine Besucher zur angegebenen Zeit ausgespielt wird.
Zeigt eine Live-Vorschau des Versand-Countdown-Widgets mit deinen aktuellen Einstellungen.
### Wir versenden... außer an folgenden Tagen
Aktiviere die Tage, an denen du versendest, und lege jeweils die späteste Uhrzeit fest, bis zu der Bestellungen noch am selben Tag versendet werden.
Wähle eine passende Feiertags-Region für deinen Versand. Klicke anschließend auf "Feiertage aktualisieren", um die Feiertagsliste zu befüllen.
Wähle einen Feiertag aus der Liste und klicke auf "Hinzufuegen", um ihn als versandfreien Tag einzutragen. Über "Alle hinzufuegen" kannst du alle Feiertage der gewählten Region auf einmal hinzufügen.
Trage hier einen eigenen versandfreien Tag ein. Vergib einen Namen (nur intern sichtbar), wähle das Datum und klicke auf "Hinzufuegen".
### Styles
Wähle hier ein passendes Icon für das Widget oder entferne es, wenn du kein Icon haben möchtest.
Wähle die Farbe des Icons bei laufendem Countdown. Wenn du die Standardfarbe wählen willst, entferne die Farbe aus dem ColorPicker.
Wähle hier ein passendes Icon für das Widget bei abgelaufenem Countdown, wenn du kein Icon haben möchtest, entferne es einfach.
Wähle hier die Farbe, die für das Icon beim abgelaufenen Countdown angezeigt werden soll.
Wähle hier ein passendes Icon für das Widget, wenn ein Alternativtext angezeigt wird.
Wähle hier die Farbe, die für das Icon beim Alternativtext angezeigt werden soll.
Wähle hier aus verschiedenen Schreibstilen für den Countdown. Die Vorschau zeigt die Änderungen sofort an, nachdem du unten rechts auf speichern gedrückt hast.
**Optionen:**
* **Volltext:** Zeigt den Countdown als vollständigen Text an
* **Kurz:** Kompakte Darstellung des Countdowns
* **Digital:** Digitale Uhranzeige
* **Digital mit Tagen:** Digitale Uhranzeige mit zusätzlicher Tagesangabe
* **nur Enddatum anzeigen:** Zeigt ausschließlich das Enddatum an
* **Unformatiert (für eigenes CSS):** Ausgabe ohne Formatierung für individuelle CSS-Gestaltung
* **Unformatiert mit Tagen (für eigenes CSS):** Ausgabe mit Tagen, ohne Formatierung für individuelle CSS-Gestaltung
Wähle einen Style für das Hauptwidget aus.
**Optionen:**
* **Clean:** Aufgeräumte, minimalistische Darstellung ohne Rahmen
* **Card:** Widget wird als Karte mit Hintergrund dargestellt
* **Bordered:** Widget mit sichtbarem Rahmen
* **Full:** Widget erstreckt sich über die volle Breite
* **Alert Info:** Darstellung als informativer Hinweis
* **Alert Warning:** Darstellung als Warnhinweis
* **Alert Danger:** Darstellung als Gefahrenhinweis
* **Alert Success:** Darstellung als Erfolgshinweis
**Für Profis:** Du kannst ein eigenes Custom Template im Pluginordner anlegen und das Widget völlig frei gestalten. Erstelle dazu ein File unter:
`dzm_opc_salesbooster/Portlets/DZMObservers/DZMObservers_custom.tpl`
Wähle einen Style für das Widget, wenn der Timer abgelaufen ist.
**Optionen:**
* **Clean:** Aufgeräumte, minimalistische Darstellung ohne Rahmen
* **Card:** Widget wird als Karte mit Hintergrund dargestellt
* **Bordered:** Widget mit sichtbarem Rahmen
* **Full:** Widget erstreckt sich über die volle Breite
* **Alert Info:** Darstellung als informativer Hinweis
* **Alert Warning:** Darstellung als Warnhinweis
* **Alert Danger:** Darstellung als Gefahrenhinweis
* **Alert Success:** Darstellung als Erfolgshinweis
Wähle einen Style für das Widget, wenn unter *Funktionen > abgelaufener Countdown > Alternativtext anzeigen* gewählt wurde.
**Optionen:**
* **Clean:** Aufgeräumte, minimalistische Darstellung ohne Rahmen
* **Card:** Widget wird als Karte mit Hintergrund dargestellt
* **Bordered:** Widget mit sichtbarem Rahmen
* **Full:** Widget erstreckt sich über die volle Breite
* **Alert Info:** Darstellung als informativer Hinweis
* **Alert Warning:** Darstellung als Warnhinweis
* **Alert Danger:** Darstellung als Gefahrenhinweis
* **Alert Success:** Darstellung als Erfolgshinweis
Färbt den Countdown. Wenn du die Standardfarbe wählen willst, entferne die Farbe aus dem ColorPicker.
Färbt den Text vor und hinter dem Countdown, wenn der Countdown abgelaufen ist. Wenn du die Standardfarbe wählen willst, entferne die Farbe aus dem ColorPicker.
Färbt den Text vor und nach dem Countdown. Wenn du die Standardfarbe wählen willst, entferne die Farbe aus dem ColorPicker.
Nur notwendig wenn bei "Abgelaufener Countdown: Nächstes Versanddatum ausgeben" oder "Countdown bis zum nächsten Versand starten" ausgewählt ist. Wenn du die Standardfarbe wählen willst, entferne die Farbe aus dem ColorPicker.
Nur notwendig wenn bei "Abgelaufener Countdown: Alternativtext anzeigen" ausgewählt ist. Wenn du die Standardfarbe wählen willst, entferne die Farbe aus dem ColorPicker.
### Einfügeoptionen
Wähle aus verschiedenen Einfügemethoden, wie das Widget an den CSS-Selektor eingefügt werden soll.
**Optionen:**
* **Anhängen:** Hängt das Widget an den restlichen Inhalt an
* **Voranstellen:** Stellt das Widget dem restlichen Inhalt voran
* **Vor dem Container:** Fügt das Widget vor dem Container ein
* **Nach dem Container:** Hängt das Widget an den Container an
* **Ersetzen:** Ersetzt den restlichen Inhalt des Containers mit dem Widget
Wähle hier einen oder mehrere CSS Selektoren in die das Widget geladen wird. Du kannst mehrere Selektoren mit Komma (,) trennen. Der Standard Selektor fügt das Widget über der Lagerbestandsanzeige ein. Wenn du das Feld komplett leer lässt, wird das Widget nicht injiziert und du kannst es per Portlet einbinden wo du möchtest.
### Textinhalt
Alle Textinhalte des Countdowns können über JTL-Sprachvariablen eingestellt werden.
Folgende Sprachvariablen stehen zur Verfügung:
| Sprachvariable | Beschreibung |
| ---------------------------------------- | ------------------------------------ |
| `shipping_countdown_text_before` | Text vor dem Countdown |
| `shipping_countdown_text_after` | Text nach dem Countdown |
| `shipping_countdown_expired_text_before` | Text vor dem abgelaufenen Countdown |
| `shipping_countdown_expired_text_after` | Text nach dem abgelaufenen Countdown |
| `shipping_countdown_alt_text` | Alternativtext |
| `shipping_countdown_string_day` | "Tag" (Singular) |
| `shipping_countdown_string_days` | "Tage" (Plural) |
| `shipping_countdown_string_hour` | "Stunde" (Singular) |
| `shipping_countdown_string_hours` | "Stunden" (Plural) |
| `shipping_countdown_string_minute` | "Minute" (Singular) |
| `shipping_countdown_string_minutes` | "Minuten" (Plural) |
| `shipping_countdown_string_second` | "Sekunde" (Singular) |
| `shipping_countdown_string_seconds` | "Sekunden" (Plural) |
| `shipping_countdown_string_today` | "heute" |
| `shipping_countdown_string_tomorrow` | "morgen" |
| `shipping_countdown_string_until` | "bis" |
| `shipping_countdown_string_clock` | "Uhr" |
| `shipping_countdown_string_and` | "und" |
## Widget als Portlet nutzen
Um das Widget als Portlet zu nutzen, muss das Widget in den Einstellungen aktiviert sein. Um zu vermeiden, dass es auf allen Produktseiten erscheint, muss der CSS-Selektor leer gelassen werden. Dadurch kann das Widget flexibel im OnPage-Composer (OPC) verwendet werden. Du kannst es per Drag & Drop an den gewünschten Mountpoints auf den jeweiligen Produktseiten platzieren.
# Angebot Countdown
Source: https://docs.dreizack-medien.de/OPC-Plus/Angebot-Countdown
# Allgemeine Beschreibung
Der "Angebot Countdown" ist ein starkes verkaufsförderndes Element, das direkt am Artikel platziert wird. Er visualisiert die verbleibende Zeit eines zeitlich begrenzten Angebots (z. B. JTL Sonderpreise). Durch das Ablaufen der Uhr wird psychologischer Druck (Urgency / FOMO) aufgebaut, der den Kunden motiviert, den Kauf sofort abzuschließen, um den Rabatt nicht zu verpassen.
**Hinweis:** Die Einstellungen für dieses Portlet werden im Backend vorgenommen.
# Einsatzmöglichkeiten (Inspiration)
* **Tages-Deals (Live Shopping):** "Dieser Deal gilt nur noch 4 Stunden!" – Perfekt für täglich wechselnde Angebote auf der Startseite.
* **Wochenend-Aktionen:** Schalte Freitag bis Sonntag Sonderpreise frei und lasse den Countdown herunterzählen.
* **Einführungspreise:** Biete neue Artikel für kurze Zeit günstiger an und zeige das Ende der Intro-Phase an.
* **Adventskalender:** Limitiere Angebote exakt auf 24 Stunden.
# Featureübersicht:
* **Automatische Steuerung:** Greift oft direkt auf die in der JTL-Wawi hinterlegten Enddaten für Sonderpreise zu.
* **Verkaufspsychologie:** Visualisiert Verknappung effektiv durch laufende Sekunden.
* **Flexible Platzierung:** Kann meist direkt beim Preis, über dem Warenkorb-Button oder auf dem Artikelbild angezeigt werden.
* **Design-Anpassung:** Farben und Texte lassen sich an das Corporate Design anpassen.
***
***
# Artikel-Variablen
Source: https://docs.dreizack-medien.de/OPC-Plus/Artikel-Variablen
# Allgemeine Beschreibung
Das "Artikel-Variablen" Portlet ist ein dynamisches Werkzeug für den Onpage Composer, mit dem du spezifische Produktdaten automatisch an beliebiger Stelle anzeigen lassen kannst.
Anstatt statischen Text zu schreiben (wie z.B. einen Produktnamen), platzierst du dieses Portlet. Es zieht sich dann automatisch die entsprechende Information aus dem Artikel, auf dem der Kunde sich gerade befindet. Dies ist unverzichtbar für die Gestaltung von individuellen Produktdetailseiten-Layouts.
# Einsatzmöglichkeiten (Inspiration)
* **Individuelle Header:** Baue dir eigene Überschriften-Strukturen, indem du den Produktnamen als H1 oder H2 an einer ganz neuen Stelle platzierst.
* **Technische Daten hervorheben:** Zeige wichtige Kennzahlen wie EAN, SKU oder Hersteller-Infos prominent in einer Sidebar oder einem Info-Kasten an.
* **SEO-Optimierung:** Nutze Artikeldaten innerhalb von Textblöcken, um den Content relevanter zu gestalten, ohne jeden Artikel einzeln bearbeiten zu müssen.
* **Logistik-Infos:** Zeige Zoll-Informationen (Taric) oder Gefahrgutnummern direkt dort an, wo sie für den Kunden relevant sind.
***
# Featureübersicht:
* **Dynamischer Datenabruf:** Greift direkt auf die Datenbank des JTL-Shops zu und zeigt immer die aktuellen Werte des jeweiligen Artikels an.
* **Umfangreiche Datenauswahl:** Zugriff auf Stammdaten wie EAN, ISBN, Hersteller, Warengruppe und Beschreibungen.
* **Flexible HTML-Struktur:** Du kannst bestimmen, ob die Variable als fließender Text, eigenständiger Block oder semantische Überschrift (H1-H6) ausgegeben wird.
***
# Settings:
## Allgemein
***
Wähle hier eine Variable, die ausgegeben werden soll.
Bitte beachte, dass die Variablen nur auf Produktseiten ausgegeben werden können.
**Variable wählen:** Hier bestimmst du, welche Information aus dem Artikelstamm angezeigt werden soll. Das Portlet ersetzt sich selbst im Frontend durch den Wert dieses Feldes. Auswahl zwischen:
* **Name:** Der Artikelname
* **Kurzbezeichnung**
* **Beschreibungstext:** Die komplette Produktbeschreibung
* **Kurzbeschreibung**
* **Hersteller**
* **Warengruppe**
* **SKU:** Die Artikelnummer
* **EAN:** Die europäische Artikelnummer (Barcode)
* **UPC**
* **ISBN:** Buchnummer
* **Gefahrnr.:** Gefahrgutnummer
* **Taric:** Zolltarifnummer
**Block Style:** Hier legst du fest, wie sich das Element verhält (Layout) und welches HTML-Tag verwendet wird (Formatierung/SEO). Auswahl zwischen:
*Layout-Verhalten:*
* **Inline (Element reiht sich mit anderen Elementen ein):** Das Element verhält sich wie ein Wort im Satz. Es erzeugt keinen Zeilenumbruch. Perfekt, um z.B. eine EAN mitten in einem Fließtext anzuzeigen.
* **Container (Element nimmt eine Zeile in Anspruch):** Das Element verhält sich wie ein Block (div). Es steht in einer eigenen Zeile und drückt nachfolgende Elemente nach unten.
*Formatierung & HTML-Tags:*
* **kleiner Text:** Ausgabe als `small` Tag.
* **Fetter Text:** Ausgabe als `strong` oder `b` Tag.
* **Normaler Text:** Standard Textausgabe (`span` oder `p`).
* **Überschrift 1 bis 6:** Ausgabe als `h1` bis `h6`. Wichtig für die SEO-Struktur, wenn du beispielsweise den Artikelnamen als Hauptüberschrift an einer anderen Stelle nutzen möchtest.
# Beobachtet gerade
Source: https://docs.dreizack-medien.de/OPC-Plus/Beobachtet-gerade
# Allgemeine Beschreibung
Das "Beobachtet gerade" Portlet (oft auch Live-View-Counter genannt) ist ein effektives Instrument für Social Proof. Es zeigt dem Kunden auf der Produktdetailseite an, wie viele andere Besucher sich diesen Artikel im Moment ebenfalls ansehen. Dies erzeugt ein Gefühl von Beliebtheit und kann durch das Prinzip der Verknappung (FOMO - Fear Of Missing Out) die Kaufentscheidung beschleunigen.
**Hinweis:** Die Einstellungen für dieses Portlet werden im Backend vorgenommen. Das "Beobachtet gerade" Widget wird standardmäßig unter der Produktbeschreibung in der Artikeldetailseite angezeigt. Hiermit kannst du einen alternativen Platz für das Portlet wählen.
# Einsatzmöglichkeiten (Inspiration)
* **Bestseller:** Zeige bei beliebten Artikeln hohe Besucherzahlen, um den Trend-Status zu unterstreichen ("Das wollen gerade alle haben").
* **Geringer Lagerbestand:** In Kombination mit einer knappen Lageranzeige erhöht dies den Druck, den Kauf jetzt abzuschließen ("30 Leute schauen zu, aber nur noch 2 da").
* **Aktionsartikel:** Nutze das Portlet bei Flash-Sales oder zeitbegrenzten Angeboten, um die Dringlichkeit visuell zu verstärken.
***
# Featureübersicht:
* **Social Proof:** Baut Vertrauen auf, indem es zeigt, dass der Shop aktiv besucht wird.
* **Kaufbeschleuniger:** Erzeugt subtilen psychologischen Druck durch Wettbewerb um das Produkt.
* **Anpassbare Texte:** Volle Kontrolle über die Formulierung vor und nach der Zahl.
* **Intelligente Steuerung:** Lege Schwellenwerte fest, damit die Anzeige nur erscheint, wenn auch wirklich genug Traffic auf dem Artikel ist.
***
# Bestands Alarm
Source: https://docs.dreizack-medien.de/OPC-Plus/Bestands-Alarm
# Allgemeine Beschreibung
Der **Bestands Alarm** informiert Besucher auf der Produktdetailseite darüber, dass nur noch eine geringe Anzahl eines Produktes verfügbar ist. Durch das Aufzeigen der knappen Verfügbarkeit wird ein Gefühl der Dringlichkeit erzeugt, das Kunden zu einer schnelleren Kaufentscheidung motiviert (Scarcity-Effekt).
**Hinweis:** Die Einstellungen für dieses Portlet werden im Backend unter **OPC Conversion Booster** vorgenommen.
# Einsatzmöglichkeiten (Inspiration)
* **Restposten/Auslaufartikel:** Signalisiere niedrigen Lagerbestand, um den Abverkauf zu beschleunigen.
* **Saisonartikel:** Erzeuge zusätzlichen Kaufanreiz bei zeitlich begrenzt verfügbaren Produkten.
* **Bestseller:** Zeige bei stark nachgefragten Artikeln, dass der Vorrat begrenzt ist.
# Featureübersicht
* **Definierbare Lagerbestandsgrenze:** Lege selbst fest, ab welchem Lagerbestand das Widget angezeigt wird.
* **Flexible Platzierung:** Automatisch per CSS-Selektor oder frei per OnPage-Composer als Portlet.
* **Anpassbare Styles:** Icon, Darstellung und Farbe lassen sich an das Corporate Design anpassen.
Die vollständige Beschreibung aller Einstellungen findest du in der Dokumentation zum [OPC Conversion Booster – Bestands Alarm](/OPC-Conversion-Booster/bestandtsalarm).
***
# Bestes Angebot
Source: https://docs.dreizack-medien.de/OPC-Plus/Bestes-Angebot
# 
## Allgemeine Beschreibung
Unser Portlet "Bestes Angebot" gibt dir die Möglichkeit ein Produkt oder eine Dienstleistung besonders in Szene zu setzen. Das Portlet ist voll ausdesigned, lässt dir aber noch ausreichend Spielraum für individuelle Anpassungen.
## Einsatzmöglichkeiten (Inspiration)
* 3 Besondere Produkte
* Bestseller Präsentation
* Konkurrenzangebote hinter eigenem Angebot
* 3 gestaffelte Dienstleistungen mit bester Preis/Leistung
* Top Neuheiten
* Must Haves
* Top Zubehör
* Bundles
***
## Featureübersicht:
* 3 Angebote im Vergleich
* Featureliste pro Angebot
* Banderole "Beste Wahl" mit freiem Text und Farbe
* Link zu jedem Angebot
* Angebotsbutton hervorheben
* Preisfeld frei anpassbar
* Auswahl von Icons und Farbe
***
***
# Settings:
## Allgemein
***
**Icon für Liste:** Wähle hier ein Icon für die USP Listen aus. Die USP Listen werden in den Angeboten gepflegt und sollen dem Besucher vermitteln welche Features das Produkt oder Angebot hat
**Farbe des Icons:** Legt die Farbe des Icons fest
**Label für mittleres Angebot (B):** Definiert den Text auf der Banderole, um das Angebot in der Mitte besonders hervorzuheben.
**Label Farbe:** Definiert die Farbe für die Banderole und die Umrandung der mittleren Angebots, um dieses besonders hervorzuheben.
***
### Angebot A | Angebot B | Angebot C
***
**Angebot:** Text der über der Überschrift steht
**Überschrift:** Überschrift des Angebots, zB Artikelname
**Bild:** Bild für das Angebot, Artikelbild oder ähnliches - muss angegeben werden
**USP:** Liste der Features oder Merkmale, die das Angebot hat und/oder von anderen Abgrenzt
**Preis:** Textfeld, welches über dem Button auftaucht. Kann für den Preis oder einen anderen Text verwendet werden, zB "Angebot auf Anfrage" zB. für eine Enterprise Dienstleistung oder ein B2B Produkt
**Button verwenden**: Auswahl, ob ein Button dargestellt werden soll oder nicht
**Buttonlink:** URL auf die der Button bei Klick leiten soll. Die Seite wird in einem neuen Tab geöffnet. Für Verlinkung auf andere Seiten muss die vollständige URL angelegt werden. Für Verlinkungen auf der eigenen Domain reicht der relative Pfad. Damit der Link innerhalb der aktuellen Seite zu einem Bereich scrollt, muss der Bereich eine ID haben, dann kannst du mit #mein-id automatisch dort hin scrollen lassen per Klick. Siehe Allgemeine Dokumentation für das Anlegen von IDs in OPC Portlets
```plain theme={null}
Verlinkung auf Drittseite:
https://dreizack-medien.de/meine-kategorie/mein-produkt
Verlinkung innerhalb der eigenen Domain:
/meine-kategorie/mein-produkt
Verlinkung zu Container:
#meine-id
/meine-kategorie/mein-produkt#meine-id
```
***
**Button Text:** Text, der auf dem Button steht
**Button Type:** Wie soll der Button dargestellt werden
* Full: vollflächig mit Farbe
* Outlined: weiß mit farbigem Rand
* Plain Text: nur Text wird farbig angezeigt, ähnlich wie ein Link
***
**Button Farbe:** Farbe des Buttons. Je nach Type färbt sich die Fläche (Full), der Rahmen (Outlined) oder die Schriftfarbe (Plain Text). Die Farbauswahl richtet sich nach Templateeinstellung und passt sich so nahtlos deinem Design an.
**Button Breite:** Auswahl wie der Button in der Breite dargestellt wird:
* Content Width: So breit wie der Text darin
* Full Width: Über die gesamte Breite des Containers
***
***
# Bewertungsslider
Source: https://docs.dreizack-medien.de/OPC-Plus/Bewertungsslider
# Allgemeine Beschreibung
Das "Bewertungs-Slider" Portlet bietet eine effektive Möglichkeit, Kundenbewertungen und Feedback auf deiner Webseite ansprechend zu präsentieren. Mit den zahlreichen Anpassungsoptionen kannst du den Slider so gestalten, dass er perfekt zu deinem Inhalt und Design passt.
# Einsatzmöglichkeiten (Inspiration)
* **Kundenbewertungen:** Zeige Kundenbewertungen auf deiner Webseite an, um das Vertrauen potenzieller Kunden zu gewinnen
* **Produktbewertungen:** Präsentiere Bewertungen und Feedback zu deinen Produkten oder Dienstleistungen in einem ansprechenden Slider
* **Testimonials:** Nutze das Portlet, um positive Rückmeldungen von Kunden oder Geschäftspartnern zu teilen
* **Referenzprojekte:** Zeige Bewertungen und Erfahrungen von Kunden in Bezug auf abgeschlossene Projekte oder Dienstleistungen
***
# Featureübersicht:
* **Mehrere Bewertungen:** Du kannst mehrere Bewertungen erstellen und die Anzahl der vergebenen Punkte für jede Bewertung festlegen
* **Anpassbare Icons:** Wähle Icons für die Punkte frei aus und passe ihre Farben an, um sie an das Design deiner Webseite anzupassen
* **Bild pro Bewertung:** Hinterlege für jede Bewertung ein Bild, um sie visuell ansprechend zu gestalten
* **Slider-Anpassungen:** Du hast die Möglichkeit, den Slider gemäß deinen Anforderungen anzupassen:
* **Anzahl der angezeigten Bewertungen:** Definiere, wie viele Bewertungen je nach Displaygröße angezeigt werden sollen
* **Abstände zwischen den Slides:** Lege den Abstand zwischen den Bewertungen fest, um das Erscheinungsbild des Sliders zu gestalten
* **Automatisches Scrollen:** Entscheide, ob der Slider automatisch und in welchem Intervall gescrollt werden soll
***
***
# Settings:
## Allgemein
***
**Icon für Bewerungspunkte:** Wähle hier ein Icon für die vergebenen Punkte
**Farbe des Icons:** Lege die Farbe der Bewertungspunkte fest. Entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
***
## Bewertungen
***
**1.** Lade hier ein Bild für die Bewertung hoch
Es muss ein Bild für jede Bewerung hochgeladen werden, da die Slides ohne Bild sonst nicht angezeigt werden können
**2.** Gib den Titel für die Bewertung an. Hierfür eignet sich besonders ein Name oder Verfasser
**3.** Trage hier den Bewertungstext ein. Je nach Präferenz kannst du 1. und 2. auch tauschen, um ein individuellen Look zu erzeugen
**4.** Gib hier die Anzahl der vergebenen Punkte an. In der Regel zwischen 1 und 5
**5.** Hier hast du die Möglichkeit die Bewertung zu verlinken. Beispiel: Auf die Originalbewertung auf einer externen Bewertungsplattform
**6.** Durch Klick auf diese Schaltfläche kannst du weitere Bewertungen hinzufügen
**7.** Drag & Drop: Verändere die Reihenfolge der Bewertungen
**8.** Dupliziere die Bewertungen
**9.** Lösche die Bewertung
***
## Darstellung
***
**Vor- und Zurückbutton anzeigen?:** Lege fest ob Indikatoren für das Scrollen durch den Slider angezeigt werden sollen
**Vor- und Zurückbutton Typ:** Ändere hier die Darstellung der Indikatoren für die Vor- und Zurückbuttons
**Seitenindexierung anzeigen?:** Lege fest, ob im unteren Bereich des Sliders angezeigt werden soll auf welcher Seite des Sliders man sich befindet
***
## Größe und Abstände
***
**Anzahl der sichtbaren Produkt je Displaygröße:** Definiere hier, wieviele Bewertungen gleichzeitig je nach Displaygröße angezeigt werden sollen (XS kleinste; XL größte)
**Anzahl der Slides um die verschoben wird:** Lege fest um wieviele Slides je nach Displaygröße verschoben werden soll (XS kleinste; XL größte)
**Lücke zwischen des Slides:** Definiere wieviel Abstand zwischen den einzelnen Slides sein soll (Standard: 1rem)
**Höhe Slider:** Hier kannst du dem Slider eine feste Höhe zuweisen, damit alle Inhalte immer gut sichtbar sind
***
## Bewegung
***
**Ausrichtung Slider:** Lege fest, ob der Slider von links nach rechts oder von rechts nach links scrollen soll
**Übergangsgeschwindigkeit in ms:** Definiere, wie viel Zeit zwischen dem Wechsel der Slides vergehen soll
**Ziehen per Maus:** Entscheide, ob man die Slides durch Ziehen mit der Maus verschieben kann
**Automatisch abspielen aktivieren:** Lege fest, ob die Slides automatisch durchscrollen sollen
**Abspielinternvall in ms:** Bestimme das Zeitintervall in dem der Slider automatisch verschoben werden soll
Hat nur eine Funktion, wenn automatisches abspielen aktiviert ist!
**Pausieren bei Hover?:** Lege fest, ob das automatisch Scrollen pausiert werden soll, wenn jemand mit der Maus auf dem Slider ist
***
# Bild Content Box
Source: https://docs.dreizack-medien.de/OPC-Plus/Bild-Content-Box
# Allgemeine Beschreibung
Bild Content Box ist ein sehr flexibles Portlet. Damit kannst du ansprechende Produkt- oder Informationskarten erstellen mit einem Bild und Text, wahlweise auf dem Bild oder unter dem Bild, wahlweise mit oder ohne Button.
# Einsatzmöglichkeiten (Inspiration)
* **Produktkarten:** Stelle einzelne Produkte mit Bild, Text und Button vor.
* **Kategoriedarstellung:** Präsentiere Kategorien deines Shops visuell ansprechend.
* **Verlinkung zu Angebot:** Verlinke gezielt zu Aktionen oder Sonderangeboten.
* **Blogbeitrag verlinken:** Teaser für Blogartikel oder redaktionelle Inhalte.
* **Auf Informationen hinweisen:** Hebe wichtige Informationen visuell hervor.
* **Themenboxen:** Kombiniere Bild und Text, um Themenwelten, Kategorien oder Aktionen vorzustellen.
* **Call-to-Action-Karten:** Nutze die Box inklusive Button, um Besucher gezielt weiterzuleiten.
# Featureübersicht
* **2 Designs:** Bild im Hintergrund oder Text unter Bild.
* **Verlinkung durch Button:** Optionaler Button oder Verlinkung der gesamten Karte.
* **Zoom beim Hovern:** Leichter Zoomeffekt beim Überfahren mit der Maus.
* **Inhalt beim Hovern ausblenden:** Blendet Text und Button aus, damit nur das Bild zu sehen ist.
* **Flexibles Bild-Text-Verhältnis:** Wähle je nach Design, ob Text neben, unter oder über dem Bild angezeigt wird.
***
# Tutorial
***
# Settings:
## Settings
**Design:** Wähle das grundlegende Layout der Box, Auswahl zwischen Bild im Hintergrund und Text unter Bild.
**Schatten verwenden:** Gibt dem Container einen dezenten Schatten, sorgt so für mehr Plastizität und räumliche Tiefe.
***
## Box
**Größe der Box festlegen nach...:** Lege fest, wie die Höhe der Box bestimmt wird:
* Automatisch nach Content = Die Größe der Box passt sich ganz flexibel an den tatsächlich eingefügten Inhalt an.
* Contenthöhe erzwingen = Die Box richtet sich strikt nach der Höhe des Contents und gibt diese als Maß vor.
* Fixe Höhe = Du legst eine feste, unveränderliche Höhe für deine Box fest, unabhängig vom Inhalt.
* Dynamisch = Die Höhe der Box verhält sich dynamisch und passt sich an.
* Verhältnis = Die Größe der Box wird anhand eines bestimmten Seitenverhältnisses berechnet.
***
## Bild
**Bild deaktivieren:** Deaktiviert die Darstellung eines Bildes und ermöglicht so die Nutzung der Features von Bild Content Box auch ohne Bild. Das eignet sich hervorragend für eine einfache Textdarstellung, für eine saubere Darstellung in einer Masonry Gallery oder um in Kombination mit einem Bild den Text daneben darstellen zu lassen:
**Bild:** Klicke auf diesen Bereich, um das gewünschte Bild für deine Box aus der Mediathek auszuwählen oder ein neues hochzuladen.
**Alternativ Text:** Hier kannst du eine kurze Bildbeschreibung hinterlegen. Dieser Text wird angezeigt, falls das Bild bei einem Besucher aus technischen Gründen nicht geladen werden kann. Zudem ist er wichtig für die Barrierefreiheit und Suchmaschinen (SEO).
**Title Tag:** Gib hier einen Titel für dein Bild ein. Dieser Text erscheint in der Regel als kleiner Hinweis (Tooltip), wenn ein Nutzer mit der Maus über das Bild fährt.
**Bild verzögert laden?:** Wenn du diese Option aktivierst, wird das Bild erst dann geladen, wenn der Besucher auf der Seite zu diesem Bild scrollt (Lazy Loading). Das hilft dabei, die anfängliche Ladezeit deiner Webseite zu verbessern. Deaktiviere die Option, wenn das Bild initial above-the-fold angezeigt wird. Ist sie aktiv, wird ein Flag für lazyLoad gesetzt; die Funktion ist abhängig von Browser und Template.
**Bild bevorzugt laden:** Setze hier ein Häkchen, wenn es sich um ein besonders wichtiges Bild handelt (z. B. direkt oben auf der Startseite im sichtbaren Bereich). Es wird dann versucht, die Ladepriorität dieses Bildes zu erhöhen. Die Funktion ist abhängig von Browser und Template.
**Bildtyp:** Lege fest, wie das Bild im Container dargestellt wird:
* Bild ist Hintergrundbild (füllt den Container komplett aus) = Das Bild wird als Hintergrund gesetzt und füllt die gesamte Box aus. Je nach Format können dabei Teile des Bildes abgeschnitten werden.
* Bild ist Produktbild (ist komplett im Container sichtbar) = Das Bild wird so eingepasst, dass es immer vollständig und ohne Beschnitt in der Box zu sehen ist.
**Größe des Bildes festlegen nach...:** Lege fest, wie die Größe des Bildes bestimmt wird:
* Automatisch nach Content = Die Bildgröße passt sich automatisch an den restlichen Inhalt der Box an.
* Dynamisch = Die Bildgröße verhält sich dynamisch und passt sich an die jeweiligen Gegebenheiten (wie Displaygröße) an.
* Fixe Höhe = Du gibst eine feste, unveränderliche Höhe für das Bild vor.
* Verhältnis = Die Größe des Bildes wird anhand eines vorgegebenen Seitenverhältnisses (z. B. 16:9 oder 4:3) berechnet.
***
## Content
**Überschrift:** Hier kannst du eine aussagekräftige Überschrift für deine Bild Content Box eintragen, die über dem Text angezeigt wird.
**Text:** Über den integrierten Texteditor kannst du den Hauptinhalt deiner Box frei formulieren und formatieren. Dir stehen dabei gängige Textwerkzeuge (wie fett, kursiv, Listen oder Textausrichtung) zur Verfügung.
### Button Eigenschaften und Styles
**Link:** URL auf die der Button bei Klick leiten soll. Für Verlinkung auf andere Seiten muss die vollständige URL angelegt werden. Für Verlinkungen auf der eigenen Domain reicht der relative Pfad. Damit der Link innerhalb der aktuellen Seite zu einem Bereich scrollt, muss der Bereich eine ID haben, dann kannst du mit #mein-id automatisch dort hin scrollen lassen per Klick. Siehe Allgemeine Dokumentation für das Anlegen von IDs in OPC Portlets.
```plain theme={null}
Verlinkung auf Drittseite:
https://dreizack-medien.de/meine-kategorie/mein-produkt
Verlinkung innerhalb der eigenen Domain:
/meine-kategorie/mein-produkt
Verlinkung zu Container:
#meine-id
/meine-kategorie/mein-produkt#meine-id
```
**Link in neuen Tab öffnen?:** Setze hier ein Häkchen, wenn sich die verlinkte Seite in einem neuen Browser-Fenster (Tab) öffnen soll. Das ist besonders bei externen Links empfehlenswert, damit der Kunde deinen Shop nicht verlässt.
**Karte verlinken?:** Wenn du diese Option aktivierst, wird nicht nur ein möglicher Button oder Link-Text klickbar, sondern die komplette "Karte" (also die gesamte Bild Content Box). Ein Klick irgendwo in die Box leitet den Kunden dann auf die hinterlegte URL weiter. Du benötigst so keinen Button, kannst ihn aber zur Aufmerksamkeit mit einfügen.
**Button verwenden?:** Lege hier über das Dropdown-Menü fest, ob zusätzlich ein sichtbarer Button in deiner Box angezeigt werden soll (z. B. Auswahl zwischen "Nein" und "Ja"). Wenn du dich für einen Button entscheidest, öffnen sich in der Regel weitere Einstellungsmöglichkeiten für dessen Design.
Wenn aktiviert ("Ja"), erscheinen folgende zusätzliche Einstellungen:
**Button als Link oder Funktionsbutton verwenden?:**
* Linkbutton
* Funktionsbutton
* Data-Attribute
**Button Text:** Text, der auf dem Button angezeigt wird (z. B. "Mehr erfahren").
**Button Typ:** Darstellung des Buttons:
* Full = vollflächig
* Outlined = farblich umrandet
* Plain Text = nur Schrift
**Button Farbe:** Wähle die Farbe des Buttons:
* Primary
* Secondary
* Warning
* Danger
* Info
* Success
* Dark
* Light
**Button Breite:** Lege die Breite des Buttons fest (z. B. Content Width).
### Button Ausrichtung nach Breakpoints
Lege für die Breakpoints XS, SM, MD, LG und XL die Ausrichtung des Buttons fest (z. B. zentriert).
**Icon vor oder nach dem Text:** Lege fest, ob ein Icon vor oder nach dem Button-Text angezeigt wird.
**Icon verwenden?:** Aktiviert die Anzeige eines Icons auf dem Button.
**Wähle ein Icon:** Icon-Picker zur Auswahl des gewünschten Icons.
***
## Darstellung
### Ausrichtung und Positionierung
**Textcontent gruppieren:** Dadurch werden Überschrift und Textblock als ein Block zusammengefasst, was die Ausrichtung relativ zueinander und zum Button beeinflusst.
**Contentabstand zur Box:** Bestimme den inneren Abstand (Padding) zwischen dem Rand deiner Box und dem darin liegenden Inhalt. Du kannst hier aus verschiedenen Größen (wie S, M, L) wählen. Je größer die Zahl, desto größer der Abstand.
**Abstand zw. Content Elementen (Text, Button):** Lege fest, wie viel Platz zwischen den einzelnen Elementen innerhalb der Box (also zwischen Überschrift, Text und dem Button) gelassen werden soll. Je größer die Zahl, desto größer der Abstand.
**Horizontale Textausrichtung:** Hier bestimmst du die waagerechte Ausrichtung deines Inhalts. Wähle zwischen linksbündig, zentriert oder rechtsbündig.
**Vertikale Contentausrichtung:** Bestimmt, wie sich Überschrift, Text und Button zueinander vertikal ausrichten, wenn mehr Platz vorhanden ist, als die Elemente für ihren Inhalt benötigen:
* **zentriert:** Text und Button sind direkt beieinander und in der Mitte des Containers
* **oben:** Text und Button sind direkt beieinander und am oberen Rand des Containers
* **unten:** Text und Button sind direkt beieinander und am unteren Rand des Containers
* **Gesamten Platz einnehmen:** Überschrift, Text und Button nehmen die gesamte Höhe des Containers ein. Der Abstand zwischen Überschrift und Text und Text und Button ist gleich
* **Gleichmäßig verteilen:** Überschrift, Text und Button nehmen die gesamte Höhe des Containers ein. Der Abstand zwischen Containerrand, Überschrift, Text und Button ist gleich
### Überschrift - Styles
**Überschrift anzeigen:** Wähle per Dropdown, ob die Überschrift in der Box sichtbar sein soll ("Ja") oder nicht ("Nein").
**Überschrift Element:** Bestimme das HTML-Tag (z. B. H1, H2, H3) für deine Überschrift. Das ist besonders wichtig für die Strukturierung deiner Seite und für Suchmaschinen (SEO).
**Überschrift Size:** Unabhängig von dem oben gewählten HTML-Tag kannst du hier die rein optische Größe der Überschrift festlegen (z. B. eine H2-Überschrift, die aber optisch wie eine kleinere H4 dargestellt wird).
**Custom Color:** Weiche von der Standardfarbe deines Templates ab und wähle über den Color-Picker eine ganz individuelle Farbe für deine Überschrift.
**Schrift-Dicke:** Bestimme, wie kräftig die Überschrift dargestellt werden soll (z. B. normal, fett oder vom Theme "vererbt").
**Additional Classes:** Dieses Feld ist für fortgeschrittene Nutzer. Hier können eigene CSS-Klassen eingetragen werden, um die Überschrift über das CSS des Child-Templates weiter zu individualisieren.
### Optionen für Textcontent
**Farbe des Texts:** Wähle hier eine individuelle Schriftfarbe für den normalen Fließtext (unterhalb der Überschrift) aus, oder belasse die Standardfarbe.
### Optionen für das Overlay
**Farbüberlagerung:** Um sicherzustellen, dass dein Text auf unruhigen oder hellen Hintergrundbildern gut lesbar bleibt, kannst du hier einen Farbfilter (Overlay) über das Bild legen. Oft wird hierfür eine halbtransparente, dunkle Farbe genutzt.
### Zusatzoptionen für Modus "Bild im Hintergrund"
*Diese Optionen greifen primär, wenn du im Reiter "Bild" die Einstellung "Bild ist Hintergrundbild" gewählt hast.*
**Inhalt bei Maus-Hover ausblenden:** Wenn aktiviert, verschwinden Text und Button, sobald der Besucher mit der Maus über die Box fährt. So wird der Blick komplett auf das Bild freigegeben.
**Zoomeffekt bei Maus-Hover:** Aktivierst du diese Option, wird das Bild leicht vergrößert (herangezoomt), wenn der Nutzer mit dem Mauszeiger darüber fährt. Das sorgt für eine schöne, interaktive Dynamik.
**Farbüberlagerung bei Maus-Hover ausblenden:** Setzt du hier ein Häkchen, verschwindet das eingestellte Farb-Overlay, sobald man mit der Maus über die Box fährt. Das Bild leuchtet dann in seinen Originalfarben auf.
Für weitere Einstellungen zum Layout, siehe den Tab **Layout** im Portlet selbst.
***
# Beispiel
So erscheint die Bild Content Box im Frontend:
# Bild und Button
Source: https://docs.dreizack-medien.de/OPC-Plus/Bild-und-Button
## 
# Allgemeine Beschreibung
Das "Bild und Button" Portlet bietet eine flexible Möglichkeit, Bilder und Schaltflächen auf deiner Webseite zu platzieren und sie nach deinen gestalterischen Vorlieben anzupassen. Mit den verschiedenen Verlinkungsoptionen und Anpassungsmöglichkeiten kannst du gezielte Aktionen fördern und die Benutzerinteraktion auf deiner Webseite steigern.
# Einsatzmöglichkeiten (Inspiration)
* **Produktdarstellung:** Nutze das "Bild und Button" Portlet, um Produkte oder Dienstleistungen mit ansprechenden Bildern und Handlungsaufforderungen zu präsentieren
* **Angebote:** Platziere ansprechende Angebote oder Rabatte auf deiner Webseite und verknüpfe sie mit einem Button zur Weiterleitung zur Angebotsseite
* **Newsletter-Abonnement:** Ermutige Besucher dazu, sich für deinen Newsletter anzumelden, indem du ein Bild und einen gut sichtbaren Abonnieren-Button verwendest
* **Call-to-Action:** Verwende das Portlet, um wichtige Handlungsaufrufe hervorzuheben, z. B. die Kontaktaufnahme, das Anfordern von Informationen oder das Durchführen einer Bestellung
***
# Featureübersicht:
* **Anpassbares Bild:** Du kannst ein eigenes Bild hochladen
* **Mindesthöhe:** Lege eine Mindesthöhe für das Portlet fest, um sicherzustellen, dass das Bild immer gut sichtbar ist.
* **Button-Funktionen:**
* **Anpassbare Gestaltung:** Du kannst die Schaltfläche in Bezug auf Farbe, Stil und Größe anpassen, um sie perfekt in das Design deiner Webseite zu integrieren.
* **Verlinkungsoptionen:** Verknüpfe die Schaltfläche einfach mit externen URLs oder internen Seiten deiner Webseite, um die Navigation für deine Besucher zu erleichtern. Der Button kann auch verschiedene Events auslösen.
* **Responsives Design:** Die Buttons passen sich automatisch verschiedenen Bildschirmgrößen und Gerätetypen an, um eine konsistente Darstellung sicherzustellen.
* **Hervorhebungsfunktion:** Du kannst die Schaltfläche so gestalten, dass sie hervorsticht und die Aufmerksamkeit der Besucher auf sich zieht, insbesondere für wichtige Handlungsaufrufe oder Angebote.
***
***
# Settings:
## Allgemein
***
**Bild:** Lade hier dein eigenes Bild hoch
**Mindesthöhe:** Lege die Mindesthöhe für das Portlet, unabhängig vom gewählten Bild, fest
***
## Button
***
**Button als Link oder Funktionsbutton verwenden:** Auswahl zwischen:
* Linkbutton = Wird verwendet, um auf eine in- bzw. externe URL zu verweisen. Durch Angabe einer #-ElementID kann auch auf ein bestimmtes Element innerhalb der Seite verwiesen werden ➝ Buttonlink = Legt die Zielseite/ das Zielelement des Buttons fest
* Funktionsbutton = Wird verwendet um bestimmte Events auszulösen. So kann beispielsweise unser PopUp-Container getriggert werden. ➝ EventID = Hier kann eine eindeutige EventID vergeben werden, die an anderen Stellen als Auslöser definiert werden kann
***
## **Buttontext:** Definiert den Textinhalt, der auf dem Button steht
**Buttontyp**: Auswahl zwischen:
* Full = Vollständig gefüllter Button
* Outlined = Umrandeter Button ohne Füllung
* Plain Text = Button ohne Umrandung und Füllung
* Link = Lässt den Button wie einen Link aussehen
**Buttonfarbe:** Auswahl zwischen:
* Primary
* Secondary
* Warning
* Danger
* Info
* Sucess
* Dark
* Light **Diese Farben orientieren sich an deinem Template und können nur dort geändert werden**
**Buttonbreite:** Auswahl zwischen:
* Content Width = Die Breite orientiert sich an dem Inhalt des Buttons
* Full Width = Der Button verwendet immer die maximal mögliche Breite
**Buttonausrichtung:** Auswahl zwischen:
* links, zentriert und rechts **Außerdem lässt sich die Ausrichtung je nach Displaygröße steuern (XS als kleinste Displaygröße; XL als größte Displaygröße)**
**Icon verwenden:** Auswahl zwischen:
* Nein = Es wird kein Icon verwendet
* Ja = Es öffnet sich eine Vielzahl an Icons zur Auswahl und ein Icon wird auf dem Button angezeigt
**Icon vor oder nach dem Text:** Auswahl zwischen:
* Vor dem Text = Icon wird vor dem Text angezeigt
* Nach dem Text = Icon wird nach dem Text angezeigt
***
***
# Bild und Text - Wide
Source: https://docs.dreizack-medien.de/OPC-Plus/Bild-und-Text-Wide
## Allgemeine Beschreibung
Dieses Portlet ermöglicht es, Texte (Überschrift und Textinhalt) und Bilder nebeneinander zu platzieren. Es bietet eine flexible Möglichkeit, Inhalte ansprechend und strukturiert darzustellen. Ob für Produktbeschreibungen, Blogartikel oder Marketingkampagnen – mit "Bild und Text Wide" kannst du visuell ansprechende und informative Layouts erstellen.
## Einsatzmöglichkeiten (Inspiration)
**Visuelle Präsentation:** Stelle deine Produkte mit einer Kombination aus Text und Bild vor. Zeige detaillierte Beschreibungen neben hochwertigen Bildern, um die wichtigsten Merkmale hervorzuheben.
## Featureübersicht
* **Flexibles Layout:** Platziere Bilder und Texte nebeneinander für eine klare und ansprechende Darstellung.
* **Überschriften und Textinhalte:** Füge sowohl Überschriften als auch detaillierte Textinhalte ein, um deine Botschaft klar zu kommunizieren.
* **Bilder:** Integriere hochauflösende Bilder, die neben dem Text erscheinen und das Layout aufwerten.
* **Responsive Design:** Das Layout passt sich automatisch an verschiedene Bildschirmgrößen an, um eine optimale Darstellung auf allen Geräten zu gewährleisten.
***
## Settings
### Textinhalt
***
**Überschrift Inhalt:** Gebe hier den Inhalt der Überschrift ein.
**Tipp: Es können HTML-Tags verwendet werden.**
**HTML-Tag der Überschrift:** Bestimmt, welchen HTML-Tag die Überschrift nutzt. Nützlich für SEO-freundliche Strukturen.
**Größe der Überschrift:** Bestimmt, wie groß die Überschrift dargestellt wird. Orientiert sich an den Vorgaben (h1-h6 und p) des aktuellen Themes.
**Schrift-Dicke:** Bestimmt die font-weight (CSS) der Überschrift.
**Position:** Bestimmt an welcher Position die Überschrift ausgegeben wird. Auswahl zwischen:
* links
* zentriert
* rechts
**Textfarbe der Überschrift:** Wähle hier die Textfarbe der Überschrift mittels ColorPicker aus.
**Hintergrundfarbe:** Hier kannst du eine passende Hintergrundfarbe für den Textinhalt mittels ColorPicker auswählen.
**Textinhalt:** Gebe hier zusätzlichen Textinhalt ein. Dieser wird unterhalb der Überschrift dargestellt.
***
### Bild
***
**Bild:** Füge hier ein passendes Bild hinzu. Achte auf einen transparenten Hintergrund bzw. ein freigestelltes Bild, damit das Portlet seine volle Wirkung entfalten kann.
***
### Button Settings
***
**Button als Link oder Funktionsbutton verwenden:** Auswahl zwischen:
* Linkbutton = Wird verwendet, um auf eine in- bzw. externe URL zu verweisen. Durch Angabe einer #-ElementID kann auch auf ein bestimmtes Element innerhalb der Seite verwiesen werden ➝ Buttonlink = Legt die Zielseite/ das Zielelement des Buttons fest
* Funktionsbutton = Wird verwendet um bestimmte Events auszulösen. So kann beispielsweise unser PopUp-Container getriggert werden. ➝ EventID = Hier kann eine eindeutige EventID vergeben werden, die an anderen Stellen als Auslöser definiert werden kann
**Buttontext:** Definiert den Textinhalt, der auf dem Button steht
**Buttontyp**: Auswahl zwischen:
* Full = Vollständig gefüllter Button
* Outlined = Umrandeter Button ohne Füllung
* Plain Text = Button ohne Umrandung und Füllung
* Link = Lässt den Button wie einen Link aussehen
**Buttonfarbe:** Auswahl zwischen:
* Primary
* Secondary
* Warning
* Danger
* Info
* Sucess
* Dark
* Light **Diese Farben orientieren sich an deinem Template und können nur dort geändert werden**
**Buttonbreite:** Auswahl zwischen:
* Content Width = Die Breite orientiert sich an dem Inhalt des Buttons
* Full Width = Der Button verwendet immer die maximal mögliche Breite
**Buttonausrichtung:** Auswahl zwischen:
* links, zentriert und rechts **Außerdem lässt sich die Ausrichtung je nach Displaygröße steuern (XS als kleinste Displaygröße; XL als größte Displaygröße)**
**Icon verwenden:** Auswahl zwischen:
* Nein = Es wird kein Icon verwendet
* Ja = Es öffnet sich eine Vielzahl an Icons zur Auswahl und ein Icon wird auf dem Button angezeigt
**Icon vor oder nach dem Text:** Auswahl zwischen:
* Vor dem Text = Icon wird vor dem Text angezeigt
* Nach dem Text = Icon wird nach dem Text angezeigt
***
***
# Breadcrumb
Source: https://docs.dreizack-medien.de/OPC-Plus/Breadcrumb
# Allgemeine Beschreibung
Das "Breadcrumb" Portlet (auch Brotkrümelnavigation genannt) fügt eine sekundäre Navigationsleiste ein, die deinen Besuchern den Pfad zur aktuellen Seite anzeigt (z.B. Startseite > Kategorie > Produkt).
Dies ist ein essentielles Element für die Benutzerfreundlichkeit (Usability) und hilft auch Suchmaschinen, die Struktur deines Shops besser zu verstehen.
# Einsatzmöglichkeiten (Inspiration)
* **Orientierung:** Hilf deinen Kunden, sich in tiefen Kategoriestrukturen zurechtzufinden und immer zu wissen, wo sie sich gerade befinden.
* **SEO-Boost:** Suchmaschinen wie Google nutzen Breadcrumbs, um die Hierarchie deiner Webseite zu verstehen und diese oft auch direkt in den Suchergebnissen anzuzeigen.
* **Schnellzugriff:** Ermögliche Kunden, mit nur einem Klick zur übergeordneten Kategorie zurückzuspringen, ohne den "Zurück"-Button des Browsers nutzen zu müssen.
***
# Featureübersicht:
* **Automatische Struktur:** Der Pfad wird vollautomatisch und dynamisch basierend auf der aktuellen Position des Kunden im Shop generiert.
* **SEO-Optimiert:** Das Markup ist technisch so gestaltet, dass es von Suchmaschinen optimal ausgelesen werden kann (Schema.org).
* **Responsive:** Passt sich der Bildschirmgröße an oder wird auf mobilen Geräten oft vereinfacht dargestellt.
***
# Button Plus
Source: https://docs.dreizack-medien.de/OPC-Plus/Button-Plus
# Allgemeine Beschreibung
Das "Button Plus" Portlet ermöglicht die einfache Integration von Schaltflächen (Buttons) in deinen Onlineshop. Diese Buttons können für verschiedene Aktionen oder Verlinkungen genutzt werden.
# Einsatzmöglichkeiten (Inspiration)
* **Handlungsaufruf:** Nutzen Sie Buttons, um Besucher Ihrer Webseite dazu aufzufordern, bestimmte Aktionen durchzuführen, wie das Absenden eines Formulars, das Herunterladen von Dateien oder das Teilen von Inhalten in sozialen Medien.
* **Navigation:** Verwenden Sie Buttons zur Navigation, um Besucher zu wichtigen Seiten Ihrer Webseite zu leiten, wie beispielsweise zur Startseite, zu Produktseiten oder Kontaktinformationen.
* **Hervorhebung von Call-to-Action (CTA):** Buttons können als effektive Call-to-Action-Elemente verwendet werden, um die Aufmerksamkeit auf spezielle Angebote, Rabatte oder Newsletter-Abonnements zu lenken.
***
# Featureübersicht:
* **Anpassbare Gestaltung:** Das "Button" Portlet bietet vielfältige Optionen zur Anpassung der Schaltfläche, einschließlich Farbauswahl, Buttonstil und Größe.
* **Verlinkungsoptionen:** Sie können die Schaltfläche einfach mit externen URLs oder internen Seiten Ihrer Webseite verlinken, um die Navigation für Ihre Besucher zu erleichtern. Außerdem kann der Button verschiedene Events auslösen
* **Responsives Design:** Die Buttons können an verschiedene Bildschirmgrößen und Gerätetypen angepasst werden, um eine konsistente Darstellung auf allen Plattformen zu gewährleisten.
* **Hervorhebungsfunktion:** Die Schaltflächen können so gestaltet werden, dass sie hervorstechen und die Aufmerksamkeit der Besucher auf sich ziehen, insbesondere für wichtige Handlungsaufrufe oder Angebote.
***
# Tutorial
***
# Settings:
## Elements
***
**Button als Link oder Funktionsbutton verwenden:** Auswahl zwischen:
* Linkbutton = Wird verwendet, um auf eine in- bzw. externe URL zu verweisen. Durch Angabe einer #-ElementID kann auch auf ein bestimmtes Element innerhalb der Seite verwiesen werden ➝ Buttonlink = Legt die Zielseite/ das Zielelement des Buttons fest
* Funktionsbutton = Wird verwendet um bestimmte Events auszulösen. So kann beispielsweise unser PopUp-Container getriggert werden. ➝ EventID = Hier kann eine eindeutige EventID vergeben werden, die an anderen Stellen als Auslöser definiert werden kann
**Buttontyp**: Auswahl zwischen:
* Full = Vollständig gefüllter Button
* Outlined = Umrandeter Button ohne Füllung
* Plain Text = Button ohne Umrandung und Füllung
* Link = Lässt den Button wie einen Link aussehen
**Buttonfarbe:** Auswahl zwischen:
* Primary
* Secondary
* Warning
* Danger
* Info
* Sucess
* Dark
* Light **Diese Farben orientieren sich an deinem Template und können nur dort geändert werden**
**Buttonbreite:** Auswahl zwischen:
* Content Width = Die Breite orientiert sich an dem Inhalt des Buttons
* Full Width = Der Button verwendet immer die maximal mögliche Breite
**Buttonausrichtung:** Auswahl zwischen:
* links, zentriert und rechts **Außerdem lässt sich die Ausrichtung je nach Displaygröße steuern (XS als kleinste Displaygröße; XL als größte Displaygröße)**
**Icon verwenden:** Auswahl zwischen:
* Nein = Es wird kein Icon verwendet
* Ja = Es öffnet sich eine Vielzahl an Icons zur Auswahl und ein Icon wird auf dem Button angezeigt
**Icon vor oder nach dem Text:** Auswahl zwischen:
* Vor dem Text = Icon wird vor dem Text angezeigt
* Nach dem Text = Icon wird nach dem Text angezeigt
***
# CSS Grid Container BETA
Source: https://docs.dreizack-medien.de/OPC-Plus/CSS-Grid-Container-BETA
# Allgemeine Beschreibung
Der "CSS Grid Container BETA" ist ein mächtiges Werkzeug für fortgeschrittene Nutzer, um hochgradig individuelle Layouts in deinem Onlineshop zu erstellen. Mit diesem Portlet kannst du die Struktur deines Rasters (Grids) auf Basis von echtem CSS-Grid exakt definieren und so auch komplexe Anordnungen realisieren, die über herkömmliche Zeilen- und Spalten-Container hinausgehen.
# Einsatzmöglichkeiten (Inspiration)
* **Komplexe Magazin-Layouts:** Erstelle asymmetrische oder verschachtelte Raster-Designs für Startseiten, Landingpages oder Themenwelten.
* **Maßgeschneiderte Galerien:** Baue einzigartige Bild- und Text-Kombinationen auf, in denen bestimmte Elemente z.B. über mehrere Spalten oder Zeilen gezogen werden können.
* **Maximale Flexibilität:** Steuere die exakten Abmessungen und das Verhalten deines Layouts punktgenau nach deinen eigenen Vorstellungen.
# Featureübersicht:
* **Volle CSS-Grid Kontrolle:** Definiere die Spalten und Zeilen mit gängigen CSS-Einheiten wie `fr` (Fraction/Bruchteil), `px` (Pixel), `%` (Prozent) oder `auto`.
* **Flexibles Management:** Füge beliebig viele Spalten und Zeilen hinzu, lösche sie wieder oder ändere ihre Reihenfolge ganz bequem per Drag-and-Drop.
* **Exakte Platzaufteilung:** Gib den Rahmen vor, an dem sich die in diesem Container platzierten Elemente (wie Bilder oder Texte) exakt orientieren.
***
# Settings:
## Allgemein
In diesem Reiter baust du das grundlegende Raster (das sogenannte Grid-Template) für deinen Container auf.
***
**Spalten:** Hier legst du die vertikalen Spalten (Columns) deines Rasters fest.
* Klicke auf das blaue **"+" Symbol**, um eine neue Spalte hinzuzufügen.
* Trage in das Textfeld den gewünschten CSS-Wert ein (z. B. `1fr` für einen gleichmäßigen anteiligen Platz, `200px` für eine feste Breite oder `auto` für eine automatische Anpassung).
* Über das **"x" Symbol** auf der linken Seite kannst du eine Spalte löschen.
* Mit dem **Verschieben-Symbol** (Pfeilkreuz) auf der rechten Seite kannst du die Reihenfolge der Spalten festhalten und per Drag-and-Drop verschieben.
**Zeilen:** Hier definierst du die horizontalen Zeilen (Rows) deines Rasters.
* Klicke auf das blaue **"+" Symbol**, um eine neue Zeile hinzuzufügen.
* Trage den entsprechenden Wert in das Feld ein (oft wird hier `auto` genutzt, damit sich die Zeilenhöhe flexibel an den Inhalt anpasst, den du später einfügst).
* Über das **"x" Symbol** links kannst du eine nicht mehr benötigte Zeile entfernen.
* Über das **Verschieben-Symbol** rechts lässt sich die Position der Zeile im Grid verändern.
***
***
# CSS Grid Element BETA
Source: https://docs.dreizack-medien.de/OPC-Plus/CSS-Grid-Element-BETA
# Allgemeine Beschreibung
Das "CSS Grid Element BETA" ist der eigentliche Inhaltsbaustein, den du in deinen zuvor erstellten "CSS Grid Container BETA" einfügst. Mit diesem Portlet legst du für jedes einzelne Element (wie z. B. ein Bild, einen Text oder einen Banner) ganz individuell fest, wie viel Platz es innerhalb deines Rasters (Grids) beanspruchen soll.
# Einsatzmöglichkeiten (Inspiration)
* **Fokus-Elemente schaffen:** Lasse ein wichtiges Hauptbild über zwei Spalten und zwei Zeilen gehen, während sich kleinere Nebenbilder brav in jeweils nur einer Spalte darum herum anordnen.
* **Asymmetrische Layouts:** Durchbrich langweilige Kachel-Muster, indem du Elemente unterschiedlich weit aufziehst – perfekt für moderne Magazin- oder Portfolio-Designs.
* **Baukasten-System:** Nutze das Element als "Hülle" und ziehe anschließend beliebige andere OPC-Portlets (wie Textblöcke oder Buttons) direkt hinein.
# Featureübersicht:
* **Einfache Platzaufteilung:** Bestimme ganz ohne CSS-Code nur durch die Eingabe von Zahlen, wie weit sich das Element ausdehnen soll.
* **Horizontale und vertikale Ausdehnung:** Steuere unabhängig voneinander, über wie viele Spalten (Breite) und Zeilen (Höhe) sich der Inhalt erstreckt.
***
# Settings:
## Allgemein
In diesem Reiter steuerst du das Verhalten deines Elements innerhalb des übergreifenden CSS Grids.
***
**Wie viele Spalten nimmt das Element ein?:** Trage hier als Zahl ein, über wie viele der vertikalen Raster-Spalten sich dieses Element strecken soll.
* Ein Wert von `1` bedeutet, das Element füllt genau eine Spalte aus (Standard).
* Ein Wert von `2` (oder mehr) zieht das Element entsprechend in die Breite, sodass es mehrere Spalten überdeckt.
**Wie viele Zeilen nimmt das Element ein?:** Trage hier als Zahl ein, über wie viele der horizontalen Raster-Zeilen sich dieses Element nach unten hin ausdehnen soll.
* Ein Wert von `1` belässt das Element in einer einzigen Zeile.
* Ein Wert von `2` (oder mehr) zieht das Element vertikal in die Länge, sodass es über mehrere Zeilen verläuft.
***
***
# Call to Action PWA
Source: https://docs.dreizack-medien.de/OPC-Plus/Call-to-Action-PWA
# Allgemeine Beschreibung
Der **Call to Action PWA**-Portlet zeigt einen Installations-Button, mit dem Besucher deine Progressive Web App (PWA) direkt auf ihrem Endgerät installieren können. Du kannst frei entscheiden, wie und wo der Button dargestellt wird, um die Installationsrate zu steigern.
**Hinweis:** Die eigentlichen Einstellungen für die Progressive Web App selbst (Icon, App-Konfiguration, Push Notifications etc.) findest du im Plugin [DZM PWA](/DZM-PWA/pwa-setup). Dieses Portlet dient lediglich der Darstellung des Installations-Buttons im OnPage-Composer.
# Featureübersicht
Wähle zwischen einem einfachen Button, einer Topbar oder einer Image Box als Installations-Button Typ.
Passe Text, Typ, Farbe und Breite des Buttons individuell an dein Design an.
Lege die Ausrichtung des Buttons für jeden Breakpoint (XS bis XL) separat fest.
Ergänze den Button optional um ein Icon, das vor oder nach dem Text angezeigt wird.
# Settings
## Darstellung
Wähle die Darstellungsform des Installations-Buttons.
**Optionen:**
* **Einfacher Button:** Klassischer Call-to-Action-Button
* **Topbar:** Installationshinweis als Leiste am oberen Seitenrand
* **Image Box:** Installationshinweis als Box mit Bild
Für den einfachen Button gibt es keine weiteren Einstellungen auf dieser Ansicht – Text, Farbe und Breite legst du unter [Button Einstellungen](#button-einstellungen) fest.
Merkt sich per Cookie, dass ein Besucher die Topbar bereits geschlossen hat, damit sie ihm nicht erneut angezeigt wird.
Legt fest, wie viele Tage das "Geschlossen"-Cookie gültig bleibt. Bei `0` gilt es nur für die Dauer der Session.
Der Text, der in der Topbar angezeigt wird.
Farbe des Topbar-Textes.
Schriftgröße des Topbar-Textes, wählbar über die Überschriften-Stile (z. B. h1).
Ausrichtung des Textes innerhalb der Topbar.
Aktiviert die Möglichkeit, zusätzlich zum Text ein Bild in der Topbar anzuzeigen.
Das Bild, das in der Topbar angezeigt wird, wenn "Topbar Bild nutzen?" aktiviert ist.
Legt die Höhe des Topbar-Bildes fest. Die Einheit (px, rem oder %) wird direkt mit angegeben.
Legt fest, wie sich das Bild an die verfügbare Fläche anpasst (z. B. `cover`).
Die Überschrift, die in der Image Box angezeigt wird.
Farbe der Überschrift.
Schriftgröße der Überschrift, wählbar über die Überschriften-Stile (z. B. h1).
Ausrichtung der Überschrift innerhalb der Image Box.
Formatierbarer Text-Editor für einen zusätzlichen Beschreibungstext unterhalb der Überschrift, inklusive Textformatierung, Listen und Links.
Das Bild, das in der Image Box angezeigt wird.
Legt die Höhe des Image-Box-Bildes fest. Die Einheit (px, rem oder %) wird direkt mit angegeben.
Legt fest, wie sich das Bild an die verfügbare Fläche anpasst (z. B. `cover`).
### Beispiele im Frontend
## Button Einstellungen
Der Text, der auf dem Button angezeigt wird.
Legt die Darstellung des Buttons fest.
**Optionen:**
* **Full:** Vollflächig
* **Outlined:** Farblich umrandet
* **Plain Text:** Nur Schrift
Legt fest, welchem Farbschema der Button folgen soll. Die Farbe richtet sich nach den eingestellten Farben des Templates.
Legt fest, wie breit der Button sein soll.
**Optionen:**
* **Content Width:** So breit wie der Text
* **Full Width:** So breit wie der umliegende Container
Lege die Ausrichtung des Buttons für jeden Breakpoint (XS, SM, MD, LG, XL) separat fest.
Legt fest, an welcher Position das Icon relativ zum Button-Text angezeigt wird.
Entscheide, ob ein Icon zusätzlich zum Button-Text angezeigt werden soll.
***
# Code Block
Source: https://docs.dreizack-medien.de/OPC-Plus/Code-Block
# Allgemeine Beschreibung
Das "Code Block" Portlet stellt einen formatierten Code-Ausschnitt mit Syntax-Highlighting dar, inklusive Kopieren-Button und optionaler Zeilennummerierung.
# Einsatzmöglichkeiten (Inspiration)
* **Technische Anleitungen:** Zeige HTML-, CSS- oder JavaScript-Snippets in Blogbeiträgen oder Anleitungen ansprechend formatiert an.
* **Entwicklerdokumentation:** Stelle Beispielcode für Integrationen oder Anpassungen bereit.
***
# Settings:
## Allgemein
**Editor:** Trage hier deinen Code ein. Besucher können den Code über den **Copy**-Button mit einem Klick kopieren.
**Sprache:** Wähle die Sprache für die Syntax-Hervorhebung:
* HTML
* CSS
* batch
* JavaScript
**Zeilennummern verwenden:** Aktiviere diese Option, um Zeilennummern neben dem Code anzuzeigen.
***
# Container Plus
Source: https://docs.dreizack-medien.de/OPC-Plus/Container-Plus
# Allgemeine Beschreibung
Der "Container Plus" ist ein vielseitiges Werkzeug zur Gestaltung von Webseitenabschnitten. Es ermöglicht die Erstellung von Containern mit anpassbarem Hintergrund, sei es ein statisches Bild oder ein Hintergrund-Video. Innerhalb dieser Container können zusätzliche Inhalte platziert und die Darstellung je nach Bedarf angepasst werden.
# Einsatzmöglichkeiten (Inspiration)
* **Hero-Sektionen:** Verwende das "Container Plus" Portlet, um eindrucksvolle Hero-Sektionen mit großen Bildern oder Videos und auffälligen Botschaften zu erstellen
* **Abschnittsübergänge:** Nutze es, um Abschnittsübergänge auf deiner Webseite zu gestalten, die visuell ansprechend und informativ sind
* **Produktpräsentation:** Präsentiere Produkte oder Dienstleistungen in einem auffälligen Container mit Hintergrundvideo und beschreibendem Text
*
***
# Featureübersicht:
* **Anpassbare Hintergründe:** Du kannst statische Bilder oder Hintergrundvideos verwenden, um den Container zu gestalten und für visuellen Wow-Effekt zu sorgen.
* **Flexibles Layout:** Wähle aus, ob du die gesamte Breite der Seite nutzen möchtest oder ob du den Container auf einen bestimmten Bereich begrenzen willst.
* **Inhaltsplatzierung:** Platziere jegliche Inhalte in den Container, sei es Text, Bilder, Schaltflächen und vieles mehr.
* **Responsives Design:** Der Container und seine Inhalte passen sich automatisch verschiedenen Bildschirmgrößen und Gerätetypen an, um immer gut auszusehen.
* **Kreative Freiheit:** Mit dem "Container Plus" Portlet kannst du coole Webseiteabschnitte gestalten, um die Aufmerksamkeit deiner Besucher zu gewinnen und deine Botschaft effektiv zu übermitteln
***
# Tutorial
***
# Settings:
## Allgemein
## 
***
**boxedContainer:** Lege fest, ob der Container sich über die gesamte Breite der Seite erstrecken oder mittig eingerückt werden soll. Wenn du es deaktivierst, erstreckt sich der Container über die gesamte Breite mit dem Standard-Abstand nach links und rechts.
**Abstandloser Container:** Wenn aktiviert, dann wird der standardmäßige Abstand des Containers deaktiviert und vollflächiger Inhalt ermöglicht. Diese Option eignet sich besonders für Contentbreaker bzw. vollflächige Inhalte.
**Standard-Container verwenden:** Wenn aktiv, wird die kleinste Containerbreite verwendet.
**Hintergrund:** Lege fest, ob der Container einen Hintergrund haben soll oder nicht. Auswahl zwischen
* **Image:** Wähle ein Bild, dass den Hintergrund des Containers füllen soll.
* **ImageParallax:** Wähle ein Bild, dass den Hintergrund des Containers füllen soll und sich beim scrollen leicht mitbewegt.
* **backgroundVideo:** Wähle ein Video, dass den Hintergrund des Containers füllen soll.
* **noBackground:** Der Container wird ohne Hintergrund ausgespielt.
***
# Content Slider
Source: https://docs.dreizack-medien.de/OPC-Plus/Content-Slider
# Allgemeine Beschreibung
Das "Content Slider" Portlet zeigt frei konfigurierbare Inhalte als Slider an, inklusive individuell einstellbarer Darstellung, Größe, Abstände und Bewegung.
# Einsatzmöglichkeiten (Inspiration)
* **Inhalte hervorheben:** Präsentiere mehrere Inhalte platzsparend nebeneinander in einem Slider.
* **Individuelle Bewegung:** Passe Laufrichtung und Bedienung des Sliders an dein Design an.
***
# Settings:
## Slides
**Anzahl von Slides:** Lege fest, wie viele Slides der Slider enthalten soll.
***
## Darstellung
**Slider Typ:** Sollen sich die Slides endlos wiederholen oder der Slider von Anfang bis Ende der Slides durchlaufen?
**Slider Focus zentrieren?:** Setzt den Focus auf die Mitte des Sliders, sodass ein Element mittig erscheint. Bei deaktivierter Option ist der Focus auf der linken Seite.
**Farbüberlagerung:** Farblicher Hintergrund, der über dem Bild und unter dem Text liegt. Kann zur besseren Lesbarkeit des Textes dienen, wenn keine Hintergrundfarbe für die Textbox gewählt wurde.
**Vor- und Zurückbutton anzeigen?:** Aktiviere die Navigationsbuttons des Sliders.
**Seitenindexierung anzeigen?:** Aktiviere die Punktnavigation unter dem Slider.
**Vor- und Zurückbutton Typ:** Wähle die Darstellung der Navigationsbuttons:
* Chevron (>)
* Doppel Chevron (>>)
* Standard Pfeil (->)
***
## Größe und Abstände
**Anzahl der sichtbaren Slides je Displaygröße:** Lege für die folgenden Breakpoints fest, wie viele Slides gleichzeitig sichtbar sein sollen:
* **XS:** \<576px
* **S:** ≥576px
* **M:** ≥768px
* **L:** ≥992px
* **XL:** ≥1200px
**Anzahl der Slides, um die verschoben wird:** Lege für dieselben Breakpoints fest, um wie viele Slides pro Klick oder Wisch weitergeschaltet wird.
**Lücke zwischen Slides (in px, rem, em):** Lege den Abstand zwischen den einzelnen Slides fest.
**Höhe Slider:** Lege die Höhe des Sliders fest.
**Slides rechts und links anschneiden (bis > 991px):** Schneidet Slides rechts und links an, um zu zeigen, dass es noch mehr gibt.
***
## Bewegung
**Ausrichtung Slider:** Bestimmt die Laufrichtung des Sliders:
* links nach rechts
* rechts nach links
* oben nach unten
**Übergangsgeschwindigkeit in Millisekunden:** Geschwindigkeit des Übergangs zwischen den Slides.
**Ziehen per Maus:** Lege fest, ob und wie der Slider per Maus gezogen werden kann:
* erlauben mit Einrastpunkten
* erlauben ohne Einrastpunkte
* verbieten
### Optionen für Automatisches abspielen
**Automatisch abspielen aktivieren?:** Aktiviert das automatische Weiterschalten des Sliders.
**Abspielintervall in Millisekunden:** Zeitabstand zwischen den automatischen Übergängen.
**Pausieren bei Hover?:** Pausiert das automatische Abspielen, sobald der Nutzer mit der Maus über den Slider fährt.
***
# Beispiel
So erscheint der Content Slider im Frontend:
***
# Cookie Wrapper
Source: https://docs.dreizack-medien.de/OPC-Plus/Cookie-Wrapper
# Allgemeine Beschreibung
Der "Cookie Wrapper" ist ein Portlet, das dir die Möglichkeit gibt, Bereiche auf deiner Webseite zu erstellen, die sich nach gespeicherten Cookies orientieren. Dies ermöglicht dir, zu steuern, wie oft bestimmte Elemente einem Benutzer angezeigt werden sollen. Durch die Steuerung der Anzeigefrequenz und die Möglichkeit, Bereiche schließbar zu machen, kannst du sicherstellen, dass die Interaktion mit wiederholten Besuchern auf deiner Webseite angenehm und effizient ist.
# Einsatzmöglichkeiten (Inspiration)
* **Werbemitteilungen:** Beschränke die Häufigkeit von Werbebotschaften für wiederkehrende Besucher, um ein angenehmes Surferlebnis zu gewährleisten.
* **Angebote und Rabatte:** Begrenze die Häufigkeit, mit der spezielle Angebote oder Rabatte angezeigt werden, um eine übermäßige Werbung zu vermeiden.
***
# Featureübersicht:
* **Cookie-Steuerung:** Orientiert sich an gespeicherten Cookies, um zu entscheiden, wie oft ein bestimmter Bereich einem Benutzer angezeigt wird.
* **Schließbarkeitsoption:** Entscheide, ob der Bereich schließbar sein soll oder nicht. Ein schließbarer Bereich ermöglicht es dem Benutzer, den Bereich zu schließen, wenn er ihn nicht sehen möchte.
* **Optimierte Benutzererfahrung:** Verbessere die Benutzerfreundlichkeit, indem du sicherstellst, dass wiederholte Besucher nicht von denselben Botschaften oder Aufforderungen überwältigt werden.
***
# Settings:
## Allgemein
***
**UID:** Diese UID wird automatisch generiert. In der Regel muss hier nicht verändert werden.
Achtung! Wenn du den Block kopiert hast, achte darauf, dass pro Seite jeder Block eine unterschiedliche UID hat
**Erlaube den Container zu schließen:** Entscheide, ob der Container schließbar ist oder nicht
**Container erst nach X Sekunden einblenden:** Lege die verstrichene Zeit fest, nach welcher der Container erst eingeblendet werden soll
**Container beim Verlassen der Seite einblenden:** Einstellung, ob der Container erst eingeblendet werden soll, wenn sich der Mauszeiger Richtung "Verlassen" bewegt. Sogenanntes Exit-Intent.
**boxedContainer:** Wenn deaktiviert, dann erstreckt sich der Container über die ganze Seite
**Hintergrund:** Lege einen Hintergrund für den Container fest Auswahl zwischen:
* image = Lade ein Hintergrundbild hoch
* backgroundVideo = hinterlege ein Video, was im Hintergrund abgespielt werden soll
* noBackground = kein Hintergrund
***
## Animation
***
**Animationstyp:** Entscheide dich für einen der vielen Animationstypen
**Dauer:** Lege die Dauer der Animation in Sekunden (s) fest.
**Verzögerung:** Definiere die verstriche Zeit bevor die Animation anfängt
**Wiederholung:** Lege die Anzahl der Wiederholungen fest
***
***
# Countdown Plus
Source: https://docs.dreizack-medien.de/OPC-Plus/Countdown-Plus
# Allgemeine Beschreibung
Das "Countdown Plus" Portlet ist ein leistungsstarkes Tool, um Dringlichkeit zu erzeugen oder auf zeitkritische Ereignisse hinzuweisen. Egal ob für limitierte Verkaufsaktionen, Produktlaunches oder den Versand-Cutoff – ein visuell ansprechender Timer motiviert Kunden zur schnelleren Interaktion (FOMO-Effekt). Du hast dabei volle Kontrolle über das Design, das Verhalten nach Ablauf der Zeit und wiederkehrende Intervalle.
# Einsatzmöglichkeiten (Inspiration)
* **Flash Sales & Aktionen:** "Nur noch 2 Stunden: 20% Rabatt auf alles!" – Erzeuge Kaufdruck durch klare Fristen.
* **Product Launches:** "Die neue Kollektion ist online in..." – Baue Spannung für neue Artikel auf.
* **Versand-Countdown:** "Bestelle innerhalb von 30 Min für Versand heute." – Erhöhe die Conversion-Rate kurz vor Annahmeschluss.
* **Wiederkehrende Events:** Nutze den Timer für wöchentliche Aktionen wie "Happy Hour jeden Sonntag".
***
# Featureübersicht:
* **Flexible Timer-Typen:** Wähle zwischen einem festen Enddatum oder wiederkehrenden Intervallen.
* **Design-Vielfalt:** Verschiedene Stile (z. B. Cards, Alerts, Clean) und Zeitanzeigen (Digitaluhr vs. Text).
* **Intelligente Ablauf-Logik:** Bestimme genau, was passiert, wenn die Zeit abgelaufen ist (Ausblenden, Text ändern, Neustart).
* **Text-Integration:** Füge nahtlos Texte vor und nach dem Timer ein, um den Kontext zu erklären.
***
# Beispiel im Frontend
***
# Settings:
## Allgemein
***
**Timer Typ:** Hier legst du die grundlegende Funktionsweise fest.
* *Einmaliges Ende:* Der Countdown läuft auf ein festes Datum/Uhrzeit zu.
* *Wiederholend:* Der Countdown startet nach Ablauf neu (z. B. täglich oder wöchentlich).
**fixes Enddatum:** Wähle das genaue Datum und die Uhrzeit, wann der Countdown enden soll (nur bei "Einmaliges Ende").
**Text vor dem Countdown:** Ein optionaler Text, der direkt links oder über dem Timer steht (z. B. "Angebot endet in:").
**Text nach dem Countdown:** Ein optionaler Text, der direkt rechts oder unter dem Timer steht.
***
## Darstellung
Hier definierst du das optische Erscheinungsbild des Timers.
***
**Schreibstil der Zeiteinheiten:** Bestimme, wie die Zeit dargestellt wird.
* *Ausgeschrieben:* Tage, Stunden, Minuten (lang).
* *Abgekürzt:* T, Std, Min.
* *Digitaluhr:* Klassische Doppelpunkt-Trennung (00:00:00).
* *Nur das Enddatum anzeigen:* Zeigt statt des Countdowns das Zieldatum.
**Abgelaufene Timerbereiche ausblenden:** Wenn aktiviert, werden Zeiteinheiten, die auf "0" stehen, ausgeblendet (z. B. werden "Tage" nicht mehr angezeigt, wenn es nur noch wenige Stunden sind).
**Textfarbe des Countdowns:** Passe die Farbe der Ziffern und Texte an dein Design an.
**Ausrichtung des Inhalts:** Lege fest, ob der Timer linksbündig, zentriert oder rechtsbündig im Container stehen soll.
**Stil des Widgets:** Wähle aus vorgefertigten Design-Templates.
* *Auswahlmöglichkeiten:* Clean, Card, Bordered, Full, Alert Info, Alert Warning, Alert Danger, Alert Success.
**Stil des Widgets, wenn abgelaufen:** Definiere ein abweichendes Design, sobald der Timer 0 erreicht hat.
* *Auswahlmöglichkeiten:* Clean, Card, Bordered, Full, Alert Info, Alert Warning, Alert Danger, Alert Success.
***
## Abgelaufener Countdown
Hier steuerst du das Verhalten, nachdem der Countdown 0 erreicht hat.
***
**Was wird dargestellt, wenn der Timer abgelaufen ist:**
* *Komplett ausblenden:* Das gesamte Portlet verschwindet.
* *Timer ausblenden, Alternativtext anzeigen:* Der Countdown verschwindet, stattdessen erscheint eine definierte Nachricht (z. B. "Aktion beendet").
* *Nächstes Datum anzeigen:* Zeigt den Zeitpunkt des nächsten Intervalls an.
* *Countdown zum nächsten Enddatum starten:* Der Timer beginnt sofort wieder für das nächste Intervall zu laufen.
# Coupon Copy
Source: https://docs.dreizack-medien.de/OPC-Plus/Coupon
# Allgemeine Beschreibung
Das "Coupon Copy" Portlet ist ein praktisches Tool, um Gutscheincodes optisch ansprechend im Shop zu präsentieren. Der Clou dabei: Kunden müssen den Code nicht abtippen oder manuell markieren. Ein Klick auf das Element genügt, und der Code wird automatisch in die Zwischenablage kopiert. Eine visuelle Bestätigung signalisiert dem Nutzer den Erfolg. Dies reduziert Hürden im Checkout-Prozess und erhöht die Einlösequote von Aktionen.
# Einsatzmöglichkeiten (Inspiration)
* **Influencer Kampagnen:** Erstelle eine Landingpage für eine Kooperation und stelle den Rabattcode des Influencers prominent dar.
* **Newsletter-Anmeldung:** Zeige auf der "Danke"-Seite nach der Anmeldung direkt den versprochenen Willkommens-Gutschein an.
* **Saisonale Sales:** Nutze das Portlet in Einkaufswelten für Black Friday oder Schlussverkäufe, um Codes wie "SALE20" schnell verfügbar zu machen.
* **Paketbeilagen:** Wenn du physische Flyer mit Codes versendest, biete auf der Ziel-URL dieses Portlet an, um den Medienbruch für den Kunden zu erleichtern.
***
# Featureübersicht:
* **One-Click-Copy:** Kopiert den Code sofort bei Klick/Tap in die Zwischenablage.
* **Visuelles Feedback:** Zeigt eine anpassbare Bestätigungsnachricht (z. B. "Code kopiert") an.
* **Banderolen-System:** Nutze Labels wie "Sale" oder "Neu", um Aufmerksamkeit zu erregen.
* **Flexible Darstellung:** Wahlweise mit oder ohne Bild, als kompakte Box oder über die volle Breite.
***
# Settings:
## Allgemein
Hier definierst du die Inhalte und Texte des Coupons.
***
**Überschrift:** Der Titel der Box, der den Kunden zum Handeln auffordert (z. B. "Dein 10% Willkommens-Code").
**Gutscheincode:** Trage hier den eigentlichen Code ein, der kopiert werden soll (z. B. `WELCOME10`).
**Bestätigungstext nach dem Kopieren des Codes:** Dieser Text erscheint kurzzeitig, nachdem der Kunde geklickt hat, um den Erfolg zu bestätigen (z. B. "Code kopiert").
**Bestätigungstext Hintergrundfarbe:** Lege die Farbe des Bestätigungs-Hinweises fest (z. B. Grün für Erfolg).
**Kleingedrucktes:** Ein Rich-Text-Editor für rechtliche Hinweise, Gültigkeitsdauer oder Mindestbestellwerte.
***
## Bild
In diesem Reiter kannst du das visuelle Erscheinungsbild erweitern.
***
**Bild deaktivieren:** Aktiviere diese Checkbox, wenn du einen rein textbasierten Coupon ohne Grafik darstellen möchtest.
**Bild:** Hier kannst du ein passendes Bild hochladen oder auswählen (z. B. ein Produktbild, ein Geschenk-Icon oder ein Kampagnen-Visual).
***
## Darstellung
Hier nimmst du Feinjustierungen am Design und Layout vor.
***
**Inhalt der Banderole:** Wähle aus vordefinierten Labels für das Eck-Bändchen (z. B. "Sale").
**Hintergrundfarbe der Banderole:** Bestimme die Farbe des Bändchens, um es z. B. als "Rot" für Sale zu kennzeichnen.
**Coupon-Box auf die gesamte Breite strecken:** Wenn aktiviert, nimmt die Box den gesamten verfügbaren Platz des Containers ein. Andernfalls bleibt sie kompakter.
**Boxschatten aktivieren:** Fügt der Coupon-Box einen Schatten hinzu, um sie optisch vom Hintergrund abzuheben.
***
***
# Coupon Calendar
Source: https://docs.dreizack-medien.de/OPC-Plus/Coupon-Kalender
# Allgemeine Beschreibung
Der "Coupon Calendar" ist ein interaktives Portlet, mit dem du digitale Adventskalender oder zeitgesteuerte Aktions-Kalender erstellen kannst. Du kannst für bestimmte Zeiträume "Türchen" definieren, die sich erst ab einem festgelegten Startdatum öffnen lassen. Dahinter kannst du Bilder, Texte, Gutscheincodes oder Videos verstecken. Es ist das perfekte Tool für saisonale Kampagnen (wie Weihnachten) oder Jubiläums-Aktionen.
# Einsatzmöglichkeiten (Inspiration)
* **Klassischer Adventskalender:** Erstelle 24 Türchen für den Dezember, hinter denen sich jeden Tag ein neues Angebot oder ein kleiner Gewinn verbirgt.
* **Jubiläums-Woche:** Feiere deinen Firmengeburtstag mit einer Woche voller täglicher Überraschungen.
* **Produkt-Launch Countdown:** Enthülle jeden Tag ein neues Detail oder Feature eines kommenden Produktes, um Spannung aufzubauen.
* **Black Week:** Biete jeden Tag während der Black Week einen anderen Deal an.
***
# Featureübersicht:
* **Zeitsteuerung:** Lege exakt fest, von wann bis wann ein Türchen geöffnet werden kann.
* **Visuelle Anpassung:** Lade eigene Bilder für den geschlossenen und den geöffneten Zustand hoch.
* **Interaktive Animationen:** Wähle aus verschiedenen Effekten, wie sich das Türchen öffnen soll (z. B. Aufklappen oder Hochschieben).
* **Flexible Inhalte:** Nutze den Editor, um Texte, Links und Formatierungen frei zu gestalten.
***
# Settings:
## Allgemein
Hier konfigurierst du das Verhalten und das Aussehen des einzelnen Türchens.
***
**Öffnungsdatum und -zeit:** Lege fest, ab wann dieses Türchen vom Kunden angeklickt und geöffnet werden darf.
**Schliessdatum und -zeit:** Bestimme, bis wann der Inhalt sichtbar bleibt (optional).
**Bild für geschlossenes Türchen:** Das Cover-Bild, das der Kunde sieht, bevor er das Türchen öffnet (z. B. eine Zahl oder ein Geschenk-Icon).
**Bild für geöffnetes Türchen:** Das Bild, das im Hintergrund erscheint, sobald das Türchen offen ist.
**Seitenverhältnis:** Bestimme das Format des Türchens (z. B. `1:1` für quadratisch), damit alle Türchen im Grid gleichmäßig aussehen.
**Überschrift des geschlossenen Türchens:** Ein kurzer Text, der auf dem geschlossenen Zustand steht (z. B. "Tag 1" oder "15.12.").
**Inhalt des Türchens:** Hier kannst du den eigentlichen Inhalt gestalten, der enthüllt wird (Gutscheincode, Glückwünsche, Beschreibungstext).
**Stärke des Schattens der offenen Tür (0 - 1):** Regelt die Intensität des Schattens, um räumliche Tiefe zu erzeugen.
**Animationsstil:** Wähle den Effekt, mit dem sich das Türchen öffnet:
* *Türchen klappt auf:* Klassischer 3D-Effekt wie bei einem Pappkalender.
* *Aufdecken:* Das Cover verschwindet einfach.
* *Hochsliden:* Das Cover schiebt sich nach oben weg.
* *Keine:* Der Inhalt erscheint sofort ohne Animation.
**Rundung der Ecken (in px):** Mach die Ecken der Türchen eckig (0) oder abgerundet (z. B. 10).
**Textfarbe des Ribbons:** Definiere die Farben für Beschriftungen im geschlossenen und geöffneten Zustand.
***
## Weitere Infos
Hier kannst du zusätzliche Informationen hinterlegen, die oft für rechtliche Hinweise oder Detailbedingungen genutzt werden.
***
**Zusätzliche Info zum Türchen:** Ein weiteres Textfeld für ergänzende Inhalte (z. B. "Nur solange der Vorrat reicht" oder Einlösebedingungen).
**Hintergrundfarbe der zusätzlichen Info:** Lege eine separate Hintergrundfarbe für diesen Infobereich fest.
***
***
# Custom Smarty
Source: https://docs.dreizack-medien.de/OPC-Plus/Custom-Smarty
# Allgemeine Beschreibung
Das "Custom Smarty" Portlet ist ein mächtiges Werkzeug für Fortgeschrittene und Entwickler, die ihren Onlineshop um individuelle Logik oder spezifische HTML-Strukturen erweitern möchten. Es ermöglicht dir, eigenen Code direkt in deine Seite zu integrieren.
# Einsatzmöglichkeiten (Inspiration)
* **Individuelle Logik:** Nutze Smarty-Tags, um dynamische Inhalte basierend auf Shop-Variablen oder Abfragen anzuzeigen.
* **Eigener HTML-Code:** Integriere spezielle HTML-Strukturen, die über die Standard-Portlets nicht abgebildet werden können.
* **Drittanbieter-Skripte:** Binde gezielt Skripte oder Widgets von externen Diensten an einer exakten Position in deinem Layout ein.
***
# Featureübersicht:
* **Integrierter Code-Editor:** Ein spezialisierter Editor mit Syntax-Hervorhebung hilft dir dabei, deinen Code übersichtlich zu schreiben und Fehler schneller zu finden.
* **Smarty-Unterstützung:** Du kannst die volle Power der Smarty-Engine von JTL-Shop nutzen, um auf Shop-Daten zuzugreifen.
* **Flexibles Layout:** Wie alle Plus-Portlets lässt sich auch das Custom Smarty Element nahtlos in deine bestehenden Grid-Strukturen einfügen.
***
# Settings:
## Allgemein
***
**Editor**: In diesem Bereich verfasst du deinen individuellen Code.
* **html / code goes here...**: Hier gibst du deinen HTML- oder Smarty-Code ein.
* **Copy-Funktion**: Über die Schaltfläche "copy" oben rechts im Editor-Fenster kannst du den gesamten Inhalt des Editors schnell in deine Zwischenablage kopieren.
***
***
# Custom Template
Source: https://docs.dreizack-medien.de/OPC-Plus/Custom-Template
# Allgemeine Beschreibung
Das "Custom Template" Portlet bietet dir eine effiziente Möglichkeit, vorgefertigte Template-Dateien (.tpl) direkt in deinem Onlineshop über den OPC zu platzieren. Dies ist besonders nützlich, um wiederkehrende Designelemente oder komplexe Smarty-Strukturen zentral zu verwalten und einfach einzubinden.
# Einsatzmöglichkeiten (Inspiration)
* **Zentrale Designelemente:** Nutze das Portlet, um speziell entwickelte Templates für Teaser, Banner oder spezielle Sektionen an verschiedenen Stellen deiner Seite konsistent anzuzeigen.
* **Komplexe Datenanzeigen:** Binde Templates ein, die komplexe Smarty-Logiken oder Datenbankabfragen enthalten, ohne den Code jedes Mal neu schreiben zu müssen.
* **Modularer Aufbau:** Erstelle eine Bibliothek an Custom-Templates, die du flexibel in dein Layout integrieren kannst, um die Wartbarkeit deines Shops zu erhöhen.
***
# Featureübersicht:
* **Template-Auswahl:** Du kannst bequem aus einer Liste deiner im Dateisystem hinterlegten Template-Dateien wählen.
* **Einfache Einbindung:** Statt Code manuell zu kopieren, wählst du einfach die gewünschte Datei aus, was Fehlerquellen minimiert.
* **Flexibles Layout & Animation:** Wie bei allen Plus-Portlets kannst du auch für das Custom Template individuelle Layout-Einstellungen und Animationen definieren.
***
# Settings:
## Allgemein
***
**Wähle dein Template:** Auswahl zwischen:
* In diesem Dropdown-Menü werden dir alle verfügbaren `.tpl` Dateien angezeigt, die im entsprechenden Verzeichnis deines Shops liegen. Wähle einfach die gewünschte Datei aus, die an dieser Stelle ausgegeben werden soll.
Lege deine Custom Templates in Plugin-Verzeichnis *frontend/custom* ab.
***
***
# Customer Service
Source: https://docs.dreizack-medien.de/OPC-Plus/Customer-Service
# Allgemeine Beschreibung
Das "Customer Service" Portlet zeigt deinen Besuchern ein Kontakt-Widget, über das sie deine Support-Kanäle (E-Mail, Telefon, WhatsApp) erreichen, deine Supportzeiten einsehen und zusätzliche Hinweise in aufklappbaren Accordions lesen können.
# Einsatzmöglichkeiten (Inspiration)
* **Kontaktbündelung:** Zeige alle deine Support-Kanäle gebündelt an einer Stelle, z. B. auf der Produktdetailseite.
* **Transparenz zu Erreichbarkeit:** Informiere deine Kunden direkt über deine Supportzeiten inklusive Online-Status.
* **Zusätzliche Hinweise:** Nutze die frei befüllbaren Accordions für FAQ, Rückgabehinweise oder andere ergänzende Informationen.
# Featureübersicht:
* **Mehrere Support-Kanäle:** E-Mail, Telefon und WhatsApp (inkl. vorgefertigtem Chat-Text) sowie optionaler SmartSupp Chat-Trigger.
* **Supportzeiten je Wochentag:** Hinterlege für jeden Wochentag individuelle Zeiten inklusive eines Hinweistextes.
* **Frei gestaltbare Darstellung:** Icon oder Bild, Icongröße, Eckenradius, Schatten und Ausrichtung des Widgets.
* **Erweiterbare Inhalte:** Bis zu zwei zusätzliche Accordions mit eigenem Titel und Richtext-Inhalt.
***
# Settings:
## Allgemein
**Titel des Widgets:** Titel, der für den Support angezeigt wird (z. B. "Kundenservice").
**Online-Status:** Lege fest, ob und wo während der Support-Zeiten ein Online-Icon angezeigt werden soll:
* Ja, oben rechts am Widget
* Ja, am Widget-Titel
* Ja, am Avatar
* Nein
**SmartSupp Chat – Widget-Trigger aktivieren:** Wenn du das Chat-Widget von SmartSupp verwendest, kannst du hier den Trigger dafür aktivieren.
***
## Support-Kanäle
**E-Mail:** E-Mail-Adresse für den Support.
**Telefon:** Telefonnummer für den Support (Format-Beispiel: `+4916012312312`).
**WhatsApp:** Whatsappnummer für den Support – lass bei der Nummer Nullen, Klammern, Leerzeichen und Bindestriche aus. Zusätzlich kannst du einen vorgefertigten Text für den Whatsapp-Chat hinterlegen.
***
## Support-Zeiten
Lege für jeden Wochentag (Montag bis Sonntag) individuell fest, ob und zu welchen Zeiten Support verfügbar ist.
**Support-Zeiten Hinweis:** Freier Richtext-Hinweis, der oberhalb der Support-Zeiten angezeigt wird.
***
## Darstellung
**Bilder oder Icon:** Lade ein Bild hoch oder wähle ein Icon für die Darstellung.
**Icon für Support:** Wähle über den Icon-Picker ein passendes Icon aus (nur bei Auswahl von "Icon" relevant).
**Icongröße für Support in px:** Größe des Icons in Pixel.
**Border Radius des Widgets:** Radius der Ecken in Pixel für das Widget und Bild.
**Schatten:** Soll das Widget einen Schatten haben?
**Horizontale Ausrichtung:** Links, mittig oder rechts ausrichten.
**Volle Breite:** Soll das Widget die volle Breite seines Containers einnehmen?
***
## Freier Inhalt 1 & Freier Inhalt 2
Über diese beiden Tabs kannst du bis zu zwei zusätzliche, frei befüllbare Accordions zum Widget hinzufügen (baugleich, jeweils für ein weiteres Accordion):
* **Support-Accordion aktivieren?:** Schaltet das jeweilige zusätzliche Accordion an oder aus.
* **Titel für das Support-Accordion:** Überschrift des Accordions (z. B. "Hier gibts mehr").
* **Inhalt für das Support-Accordion:** Freier Richtext-Inhalt innerhalb des Accordions.
***
# Beispiel
So erscheint das Widget im Frontend als Button auf der Produktdetailseite:
Nach einem Klick öffnet sich das Widget mit Kontaktmöglichkeiten, Supportzeiten und den zusätzlichen Accordions:
***
# DZM Qualitylist Box
Source: https://docs.dreizack-medien.de/OPC-Plus/DZM-Qualitylist-Box
# 
***
# Allgemeine Beschreibung
Mit der Qualitylist Box kannst du deine besten Merkmale als Liste ausgeben lassen, mit Icon. In Verbindung mit der Titel Box wird aus einer Liste ein Qualitätsversprechen
# Einsatzmöglichkeiten (Inspiration)
* USP deines Shops auflisten
* Deine Qualitätsversprechen
* Checklist anlegen
* Features eines Produkts prominent platzieren
* Vorteile auflisten
***
# Featureübersicht:
* Icon Auswahl
* Freie Liste
***
# Settings:
## Allgemein
In diesem Reiter verwaltest du die Inhalte und das Design der Liste.
***
* **Liste:** Hier siehst du alle angelegten Listenpunkte (z. B. "Super Produkt", "Schnelle Lieferung").
* **Hinzufügen (+):** Klicke auf den blauen Plus-Button, um einen neuen Eintrag zu erstellen.
* **Löschen (x):** Entferne einen Eintrag über das "x"-Symbol.
* **Verschieben:** Nutze das Pfeil-Symbol rechts, um die Reihenfolge der Einträge per Drag-and-Drop zu ändern.
* **Anordnung der Listenelemente:** Bestimme, wie die Einträge innerhalb der Box ausgerichtet werden (z. B. **zentriert**), um sie harmonisch in das Layout einzufügen.
* **Darstellungsform:** Lege fest, wie die Listenelemente visuell aufbereitet werden. Im Screenshot ist **Icon** ausgewählt, was die Darstellung mit den unten gewählten Symbolen aktiviert.
* **Icon für Liste:** Wähle hier das passende Icon für deine Vorteile aus. Du kannst die Bibliothek durchsuchen ("Type to filter") oder durch die Übersicht scrollen.
* **Farbe des Icons:** Definiere die Farbe der Icons.
* **Standardfarbe:** Nutzt die globale Shop-Farbe.
* **Farbauswahl:** Klicke auf den Kreis, um eine individuelle Farbe festzulegen.
***
***
# FAQ
Source: https://docs.dreizack-medien.de/OPC-Plus/FAQ
## 
# Allgemeine Beschreibung
Mit dem FAQ Portlet kannst du Häufig gestellte Fragen als praktisches Accordion anlegen und auf Inhalte verlinken.
Damit Google die hinterlegten Fragen auch als solche auslesen bzw. indexieren kann, musst du die FAQ-Portlets in unserem "[Strukturierte Daten-Container](https://app.clickup.com/4655718/v/dc/4e2k6-13450/4e2k6-18895)" platzieren. Du kannst mehrere FAQ-Portlets in einem Container platzieren. Achte jedoch darauf, dass pro Seite nur ein "Strukturierte Daten-Container" verwendet wird
***
# Einsatzmöglichkeiten (Inspiration)
* Häufig gestellte Fragen
* Zusatzinformationen
* Weiterführende Inhalte
***
# Featureübersicht:
* Accordion mit kleinen Designoptionen
* Antwort im Accordion Body
* Optional mit Button
***
# Settings:
## Allgemein
In diesem Reiter pflegst du den eigentlichen Inhalt der Frage und Antwort ein.
***
* **Name der FAQ Page (Wichtig für ein sauberes Markup):** Gib hier einen übergeordneten Namen für die FAQ-Sektion ein. Dies wird für das schema.org Markup verwendet, um Suchmaschinen den Inhalt besser verständlich zu machen.
* **ID der FAQ Page (Wichtig für die korrekte Zuordnung):** Definiere eine eindeutige ID. Wenn du mehrere FAQ-Elemente auf einer Seite hast, die zusammengehören (z. B. für das Markup), sollten sie dieselbe ID nutzen.
* **Frage:** Trage hier die Frage ein, die im zugeklappten Zustand sichtbar ist (die Überschrift des Elements).
* **Antwort:** Nutze den Editor, um die Antwort zu verfassen. Du kannst hier Texte formatieren, Listen erstellen oder Bilder einfügen.
***
## Darstellung
Hier definierst du das visuelle Erscheinungsbild der Frage und des Containers.
***
* **Überschrift Element:** Wähle den semantischen HTML-Tag für die Frage (wichtig für SEO). Die Optionen sind:
* ****H1 bisH6****
* **Standard Text**
* **Überschrift Size:** Bestimme die optische Größe der Frage unabhängig vom HTML-Tag. Die Optionen sind:
* **Element Standard**
* **H1** bis **H6**
* **Standard Text**
* **Display 1 (nur NIU Plus)** bis **Display 6 (nur NIU Plus)**
* **Schrift-Dicke:** Lege die Strichstärke der Schrift fest (z. B. **800** für fett).
* **Additional Classes:** Hier kannst du eigene CSS-Klassen für spezielles Styling hinzufügen (z. B. `m-0`).
* **Hintergrundfarbe Frage:** Wähle eine Farbe für den Balken, in dem die Frage steht.
* **Custom Color:** Definiere eine individuelle Farbe, falls die Standardfarben nicht passen.
* **Icon Style:** Wähle das Symbol, das anzeigt, ob die Frage auf- oder zugeklappt ist (z. B. `+`).
* **Box mit Schatten unterlegen:** Aktiviere diese Checkbox, um dem FAQ-Element einen Schatten zu geben (Card-Look).
* **Initial ausgeklappt:** Aktiviere diese Option, wenn diese Frage beim Laden der Seite bereits geöffnet sein soll.
***
## Button
In diesem Reiter kannst du einen Button konfigurieren, der unterhalb der Antwort angezeigt wird.
***
* **Button verwenden?:** Wähle "Ja", um die Button-Einstellungen einzublenden.
* **Button als Link oder Funktionsbutton verwenden?:** Bestimme die Art des Buttons. Die Optionen sind:
* **Linkbutton**
* **Funktionsbutton**
* **Data-Attribute**
* **Buttonlink:** URL auf die der Button bei Klick leiten soll. Für Verlinkung auf andere Seiten muss die vollständige URL angelegt werden. Für Verlinkungen auf der eigenen Domain reicht der relative Pfad. Damit der Link innerhalb der aktuellen Seite zu einem Bereich scrollt, muss der Bereich eine ID haben, dann kannst du mit #mein-id automatisch dort hin scrollen lassen per Klick. Siehe Allgemeine Dokumentation für das Anlegen von IDs in OPC Portlets
```plain theme={null}
Verlinkung auf Drittseite:
https://dreizack-medien.de/meine-kategorie/mein-produkt
Verlinkung innerhalb der eigenen Domain:
/meine-kategorie/mein-produkt
Verlinkung zu Container:
#meine-id
/meine-kategorie/mein-produkt#meine-id
```
* **Button Text:** Gib die Beschriftung des Buttons ein (z. B. "Mehr erfahren").
* **Full**
* **Outlined**
* **Plain Text**
* **Link**
* **Button Farbe:** Wähle eine Theme-Farbe (z. B. **Primary**).
* **Button Breite:** Wähle zwischen **Content Width** (Textlänge) oder **Full Width** (Volle Breite).
* **Button Ausrichtung nach Breakpoints (XS bis XL):** Bestimme für jede Displaygröße, wo der Button stehen soll (z. B. **zentriert**).
* **Link in neuen Tab öffnen?:** Setze den Haken, wenn der Link in einem neuen Fenster geöffnet werden soll.
* **Icon vor oder nach dem Text:** Platziere ein Icon relativ zum Button-Text (z. B. "Nach dem Text").
* **Icon verwenden?:** Entscheide mit "Ja" oder "Nein", ob ein Icon angezeigt wird.
***
***
# Fülltext
Source: https://docs.dreizack-medien.de/OPC-Plus/Fuelltext
# Allgemeine Beschreibung
Das "Fülltext" Portlet ist das Standard-Werkzeug für die Textgestaltung in deinem Onlineshop. Es bietet dir einen klassischen WYSIWYG-Editor (What You See Is What You Get), mit dem du Texte ohne Programmierkenntnisse formatieren und mit Medien anreichern kannst.
# Einsatzmöglichkeiten (Inspiration)
* **Storytelling & Markenbotschaft:** Nutze den Editor, um deine Markengeschichte mit emotionalen Texten und passenden Bildern zum Leben zu erwecken und so eine Bindung zu deinen Kunden aufzubauen.
* **Visuelle Ratgeber:** Kombiniere detaillierte Anleitungen mit Icons und formatierten Listen, um deinen Besuchern einen echten Mehrwert zu bieten und komplexe Themen einfach zu erklären.
* **Interaktive Content-Bereiche:** Gestalte spannende Blog-Beiträge oder News-Sektionen, indem du Zitate hervorhebst und wichtige Call-to-Actions direkt in den Fließtext integrierst.
***
# Featureübersicht:
* **Umfangreiche Textformatierung:** Dir stehen alle gängigen Optionen wie Schriftart, Größe, Farben und Ausrichtungen zur Verfügung.
* **Medienintegration:** Integriere einfach Bilder, Emojis oder Links direkt in deinen Textfluss.
* **Tabellen & Listen:** Erstelle strukturierte Daten mithilfe von Tabellen-Tools sowie ungeordneten und geordneten Listen.
* **Quellcode-Ansicht:** Für fortgeschrittene Nutzer gibt es die Möglichkeit, direkt in den HTML-Code zu wechseln.
***
# Settings:
## Allgemein
***
**Text**: Hier befindet sich das Hauptfenster für deine inhaltliche Gestaltung.
Dieser Baustein dient als Fülltext. Kombiniere diesen Block in einem Textwrapper zusammen mit Smarty Variablen Portlets wie Produktvariablen und bau dir so einen dynamischen Text, ohne Smarty Code programmieren zu müssen.
* **Formatierungsleiste**: Am oberen Rand findest du Werkzeuge für:
* **Schriftstil**: Fett, Kursiv, Unterstrichen, Durchgestrichen sowie Tief- und Hochstellen.
* **Listen**: Erstellung von Aufzählungszeichen oder nummerierten Listen.
* **Zitate & Ausrichtung**: Einrücken von Texten sowie linksbündige, zentrierte, rechtsbündige Ausrichtung oder Blocksatz.
* **Einfügen-Optionen**: Schaltflächen für Links, Bilder, Emojis, Tabellen und horizontale Linien.
* **Stile**: Auswahl von Absatzformaten (z. B. Überschriften), Schriftarten und Schriftgrößen.
* **Farben**: Anpassung der Textfarbe und der Hintergrundfarbe (Markierung).
* **Editor-Bereich**: In das große Textfeld kannst du deinen Text direkt eingeben oder hineinkopieren.
* **`Quellcode (<>)`**: Durch Klick auf dieses Symbol kannst du zwischen der visuellen Ansicht und dem HTML-Quellcode umschalten.
***
***
# Goodie Progress Bar
Source: https://docs.dreizack-medien.de/OPC-Plus/Goodi-Progress-Bar
# Allgemeine Beschreibung
Der "Goodie Progress Bar" ist ein Gamification-Element, das den aktuellen Warenkorbwert des Kunden visualisiert und anzeigt, wie viel noch fehlt, um bestimmte Ziele zu erreichen. Solche Ziele können der kostenlose Versand, ein Gratisartikel oder ein Rabatt sein. Durch die visuelle Darstellung des Fortschritts werden Kunden motiviert, weitere Artikel in den Warenkorb zu legen, um die Belohnung freizuschalten ("Nur noch 5€ bis zum Gratis-Versand").
**Hinweis:** Dieses Portlet dient primär der *Darstellung* an einer beliebigen Stelle im Shop (z. B. im Header oder auf einer Landingpage). Die eigentlichen Schwellenwerte und Belohnungen (die "Haupteinstellungen") werden zentral in den Plugin-Einstellungen definiert.
# Einsatzmöglichkeiten (Inspiration)
* **Versandkostenfrei-Grenze:** Platziere die Leiste prominent im Header oder Warenkorb, um den Weg zum kostenlosen Versand zu zeigen.
* **Gratis-Beigaben:** "Kaufe für 100€ ein und erhalte eine Tasche gratis" – visualisiere diesen Meilenstein.
* **Mini-Warenkorb (Sidebar):** Nutze die kompakte Darstellung im Offcanvas-Warenkorb, um platzsparend Upselling zu betreiben.
* **Checkout:** Erinnere Kunden im letzten Schritt daran, dass nur noch ein kleiner Betrag fehlt, um einen Vorteil zu sichern.
***
# Featureübersicht:
* **Visuelle Motivation:** Fortschrittsbalken sind intuitiv und regen den Spieltrieb an.
* **Flexible Detailtiefe:** Entscheide selbst, ob Texte, Icons oder nur der nackte Balken angezeigt werden sollen.
* **Responsive Kontrolle:** Steuere detailliert, auf welchen Geräten (Desktop, Tablet, Mobil) eine kompakte Version angezeigt wird, um Platz zu sparen.
* **Meilenstein-Management:** Konfiguriere, welche Zwischenziele (Marken) auf der Leiste sichtbar sein sollen.
***
# Settings:
## Allgemein
Hier passt du die individuelle Darstellung dieser spezifischen Portlet-Instanz an.
***
**Icons anzeigen:** Aktiviere diese Option, um Symbole (z. B. ein Paket-Icon für Versand oder ein Geschenk-Icon) auf der Leiste oder bei den Meilensteinen anzuzeigen.
**Infotext unter Progressbar anzeigen:** Blendet erklärende Texte unterhalb des Balkens ein (z. B. "Noch 10,00 € bis Versandkostenfrei").
**Progresswert auf Progressbar anzeigen:** Zeigt den aktuellen Wert oder Prozentsatz direkt auf dem Balken an.
***
## Kompaktmodus (Responsive)
Der Kompaktmodus reduziert die Progress Bar meist auf eine schmale Linie ohne viel drumherum, ideal für Bereiche mit wenig Platz (wie Header oder Mobile).
**Auf Desktop kompakt darstellen:** Schaltet den Kompaktmodus für große Bildschirme ein.
**Auf Tablet kompakt darstellen:** Schaltet den Kompaktmodus für Tablets ein.
**Auf Mobil kompakt darstellen:** Schaltet den Kompaktmodus für Smartphones ein.
**Höhe der Progressbar im Kompaktmodus in px:** Definiere hier, wie dünn oder dick der Balken im Kompaktmodus sein soll (z. B. `4` Pixel).
***
## Marken (Meilensteine)
Hier steuerst du, welche Ziel-Markierungen auf der Leiste visualisiert werden.
**Anzeigemodus der Marken Desktop:** Wähle, welche Ziele auf Desktop-Geräten markiert werden sollen.
* **Alle Ziele:** Zeigt sämtliche definierten Belohnungsstufen auf der gesamten Leiste an.
* **Alle erreichten und das nächste Ziel:** Zeigt die Historie des Erfolgs und motiviert mit dem direkten nächsten Schritt.
* **Das letzte und nächste Ziel:** Eine sehr reduzierte Ansicht, die den Fokus nur auf den aktuellen Status und das kommende Ziel legt.
**Anzeigemodus der Marken Tablet:** Wähle die Darstellung der Marken für Tablets.
* **Alle Ziele:** Zeigt sämtliche definierten Belohnungsstufen auf der gesamten Leiste an.
* **Alle erreichten und das nächste Ziel:** Zeigt die Historie des Erfolgs und motiviert mit dem direkten nächsten Schritt.
* **Das letzte und nächste Ziel:** Eine sehr reduzierte Ansicht, die den Fokus nur auf den aktuellen Status und das kommende Ziel legt.
**Anzeigemodus der Marken Mobil:** Wähle die Darstellung der Marken für mobile Geräte.
* **Alle Ziele:** Zeigt sämtliche definierten Belohnungsstufen auf der gesamten Leiste an.
* **Alle erreichten und das nächste Ziel:** Zeigt die Historie des Erfolgs und motiviert mit dem direkten nächsten Schritt.
* **Das letzte und nächste Ziel:** Eine sehr reduzierte Ansicht, die den Fokus nur auf den aktuellen Status und das kommende Ziel legt.
***
***
# Google Maps
Source: https://docs.dreizack-medien.de/OPC-Plus/Google-Maps
# 
## Allgemeine Beschreibung
Unser Portlet "Google Maps" gibt dir die Möglichkeit eine Google Maps auf deiner Seite zu platzieren. Du kannst deine Adresse angeben und die Karte wird mit deinem Punkt zentriert platziert. Wenn du einen größeren Ausschnitt wählst und dein Unternehmen in die Suche einträgst, können auch Informationen wie Rezensionen und Google Bewertung mit ausgegeben werden.
## Einsatzmöglichkeiten (Inspiration)
* Karte im Impressum
* Karte auf voller Breite im Footer
* Ladenlokal direkt bewerben
* Mehrere Standorte auflisten
## Featureübersicht:
* Adresssuche
* Anzeigen von Unternehmensinformationen und Bewertungen
* Direkter Link zu deiner Unternehmensadresse
***
# Settings:
## Allgemein
***
**Adresse:** Gib hier deine genaue Adresse an. Google Maps sucht diese Adresse und stellt diese dann zentriert in der Karte dar.
**Beachte den Hinweis mit der Containerhöhe. Ab einer ausreichenden Höhe werden Unternehmensinformationen mit eingeblendet und man kann die Karte verschieben.**
***
***
# Grid Plus
Source: https://docs.dreizack-medien.de/OPC-Plus/Grid-Plus
# Allgemeine Beschreibung
Mit dem "Grid Plus" Portlet kannst du kinderleicht Rasterlayouts erstellen. Du hast die Kontrolle über die Anzahl der Spalten (2, 3, 4 oder 6) und die vertikale Ausrichtung deiner Inhalte. Dieses Portlet ermöglicht dir, deinen Inhalt übersichtlich und ansprechend darzustellen
# Einsatzmöglichkeiten (Inspiration)
* **Produktlisten:** Nutze das "Grid Plus", um Produkte oder Dienstleistungen in einem ordentlichen Raster anzuzeigen, egal ob du 2 oder 6 Spalten benötigst.
* **Teammitglieder:** Präsentiere dein Team in einem ansprechenden Rasterlayout
* **Portfolio:** Zeige deine kreativen Werke oder Projekte in einem flexiblen Raster
* **Referenzen:** Erstelle Referenzseiten mit Kundenbewertungen oder Projektbeispielen, die einfach zu überblicken sind
***
# Featureübersicht:
* **Anzahl der Spalten:** Du kannst zwischen 2, 3, 4 oder 6 Spalten wählen, um sicherzustellen, dass dein Rasterlayout perfekt zu deinen Inhalten passt
* **Vertikale Ausrichtung:** Du hast die Wahl zwischen verschiedenen vertikalen Ausrichtungsoptionen, wie oben, unten, gestreckt oder zentriert, um den Look deiner Webseite anzupassen
* **Flexibles Layout:** Das "Grid Plus" Portlet passt sich automatisch verschiedenen Bildschirmgrößen und Gerätetypen an, um eine optimale Darstellung zu gewährleisten
* **Inhaltliche Freiheit:** Du kannst beliebige Inhalte in die Rasterzellen einfügen, sei es Text, Bilder, Schaltflächen oder andere Elemente
* **Kreative Gestaltung:** Nutze das Portlet, um kreative Layouts zu erstellen und deine Inhalte auf eine Weise zu präsentieren, die deine Webseite herausstechen lässt
***
# Settings:
## Allgemein
***
**Layout:** Auswahl zwischen:
* 2 / 4 / 6 Columns = Lege die Anzahl der Spalten auf 2, 4 oder 6 Spalten fest
* 2 Columns (2:1) = 2 Spalten, wobei die linke Spalte zwei Drittel einnimmt
* 2 Columns (1:2) = 2 Spalten, wobei die rechte Spalte zwei Drittel einnimmt
* Benutzerdefiniert = Lege die Anzahl der Spalten je nach Displaygröße vollkommen individuell fest
**Abstand zwischen Elementen deaktivieren:** Wenn Haken gesetzt ist, sind keine Lücken zwischen den Spalten
**Vertikale Ausrichtung der Inhalte:** Je Displaygröße Auswahl zwischen:
* oben = alle Inhalte werden an der oberen Kante platziert
* zentriert = alle Inhalte werden mittig platziert
* unten = alle Inhalte werden unten platziert
* gestreckt = alle Inhalte werden auf die gleiche Höhe gestreckt
***
***
# Hero Slider
Source: https://docs.dreizack-medien.de/OPC-Plus/Hero-Slider
# 
***
# Allgemeine Beschreibung
Der "Hero-Slider" ist ein vielseitiges Portlet, das es dir ermöglicht, beeindruckende Hero-Banner in Deinem Webshop zu erstellen. Du kannst mehrere Bilder oder Banner hinterlegen, die automatisch durchsliden oder erst nach Klicken durch den Besucher wechseln. Der Hero-Slider bietet eine Vielzahl von Anpassungsmöglichkeiten, darunter die Hinzufügung von Buttons, das Anpassen von Texten, Verlinkungen und Farbüberlagerungen auf den Slides . Darüber hinaus kannst du die Bewegungen der einzelnen Slides nach deinen Wünschen anpassen.
# Einsatzmöglichkeiten (Inspiration)
* **Produktdarstellung:** Präsentiere deine Produkte oder Dienstleistungen mit hochwertigen Bildern und überzeugenden Handlungsaufforderungen.
* **Aktuelle Angebote:** Zeige Sonderangebote, Rabatte oder Aktionen auf auffälligen Slides, um die Aufmerksamkeit der Besucher zu gewinnen.
* **Veranstaltungen:** Bewerbe bevorstehende Veranstaltungen oder Events mit ansprechenden Bildern und den entsprechenden Details.
* **Markenbotschaft:** Kommuniziere die Kernbotschaft und Werte deiner Marke durch visuell ansprechende Slides und aussagekräftige Texte.
***
# Featureübersicht:
* **Mehrere Bilder/Banner:** Du kannst mehrere Bilder oder Banner hochladen, die im Slider angezeigt werden sollen.
* **Automatisches oder manuelles Sliden:** Wähle zwischen automatischem Durchsliden der Bilder oder einem Wechsel erst nach Klicken durch den Besucher.
* **Anpassbare Texte:** Passe die Texte auf den Slides individuell an, einschließlich Schriftart, Farbe, Größe und Ausrichtung.
* **Button-Funktionen:** Füge Buttons hinzu, die die Besucher zu spezifischen Seiten oder Aktionen führen können. Passe die Button-Texte und -Stile nach Bedarf an.
* **Verlinkungsoptionen:** Verlinke die Slides mit internen oder externen Seiten, um die Navigation zu erleichtern oder wichtige Informationen bereitzustellen.
* **Farbüberlagerung:** Füge Farbüberlagerungen auf den Slides hinzu, um die Bildästhetik zu betonen oder den Text besser lesbar zu machen.
* **Individuelle Bewegungseffekte:** Passe die Bewegungen der Slides an, wie z. B. Fade-In oder Slide-In-Effekte, um eine dynamische Präsentation zu schaffen.
* **Responsives Design:** Der Hero-Slider passt sich verschiedenen Bildschirmgrößen und Geräten an, um eine optimale Darstellung sicherzustellen.
***
# Settings:
## Slides
***
**1.** Lade hier ein Bild für den Hero-Slider hoch
**2.** Gib den Titel für den Banner an. Dieser Textinhalt stellt den größten auf dem Banner dar
**3.** Gebe hier eine passende Beschreibung an.
**4.** Hier kannst du einen Alternativtext hinterlegen, falls das Bannerbild nicht korrekt angezeigt werden kann.
**5.** Hier hast du die Möglichkeit die Slides zu verlinken. Beispiel: Auf eine Angebotsseite in Deinem Shop
**6.** Durch Klick auf diese Schaltfläche kannst du weitere Slides hinzufügen
**7.** Drag & Drop: Verändere die Reihenfolge der Slides
**8.** Dupliziere die Slides
**9.** Lösche den Slide
***
## Verlinkungen
***
**Button anzeigen, wenn Slide verlinkt wurde:** Auswahl zwischen:
* Ja = Ein Button wird auf dem Banner erzeugt, anstatt den ganzen Slide zu verlinken
* Nein = Wenn ein Slide verlinkt wurde, dann reicht ein Klick auf irgendeine Fläche im Banner, um weitergeleitet zu werden
**Button als Link oder Funktionsbutton verwenden:** Auswahl zwischen:
* Linkbutton = Wird verwendet, um auf eine in- bzw. externe URL zu verweisen. Durch Angabe einer #-ElementID kann auch auf ein bestimmtes Element innerhalb der Seite verwiesen werden ➝ Buttonlink = Legt die Zielseite/ das Zielelement des Buttons fest
* Funktionsbutton = Wird verwendet um bestimmte Events auszulösen. So kann beispielsweise unser PopUp-Container getriggert werden. ➝ EventID = Hier kann eine eindeutige EventID vergeben werden, die an anderen Stellen als Auslöser definiert werden kann
**Buttontext:** Definiert den Textinhalt, der auf dem Button steht
**Buttontyp**: Auswahl zwischen:
* Full = Vollständig gefüllter Button
* Outlined = Umrandeter Button ohne Füllung
* Plain Text = Button ohne Umrandung und Füllung
* Link = Lässt den Button wie einen Link aussehen
**Buttonfarbe:** Auswahl zwischen:
* Primary
* Secondary
* Warning
* Danger
* Info
* Sucess
* Dark
* Light **Diese Farben orientieren sich an deinem Template und können nur dort geändert werden**
**Buttonbreite:** Auswahl zwischen:
* Content Width = Die Breite orientiert sich an dem Inhalt des Buttons
* Full Width = Der Button verwendet immer die maximal mögliche Breite
**Buttonausrichtung:** Auswahl zwischen:
* links, zentriert und rechts **Außerdem lässt sich die Ausrichtung je nach Displaygröße steuern (XS als kleinste Displaygröße; XL als größte Displaygröße)**
**Icon verwenden:** Auswahl zwischen:
* Nein = Es wird kein Icon verwendet
* Ja = Es öffnet sich eine Vielzahl an Icons zur Auswahl und ein Icon wird auf dem Button angezeigt
**Icon vor oder nach dem Text:** Auswahl zwischen:
* Vor dem Text = Icon wird vor dem Text angezeigt
* Nach dem Text = Icon wird nach dem Text angezeigt
***
## Darstellung
***
#### Slide Darstellungsoptionen
**Bilder ausgrauen und bei Hover hervorheben:** Bilder werden in Graustufen dargestellt. Wenn man mit der Maus über den Inhalt fährt, werden sie farbig dargestellt.
**Bild soll Hintergrundbild sein:** Konvertiert das Bild zu einem Hintergrundbild (CSS)
**Position des Hintergrundbilds:** Ausrichtung des Bildes. Legt fest an welcher Kante sich das Bild innerhalb des Containers orientieren soll, wenn es größer als der Container ist.
**Farbüberlagerung:** Farblicher Hintergrund, der über dem Bild und unter dem Text liegt. Kann zur besseren Lesbarkeit des Textes beitragen, wenn keine Hintergrundfarbe für die Textbox gewählt wurde.
Beim Erstellen für das Oberlay den Deckraftregler/Alphakana beachten und auf einen geringen Wert stellen!
#### Indikatoren
**Vor- und Zurückbutton anzeigen:** Zeige Indikatoren zur Steuerung der Slides an
**Seitenindexierung anzeigen:** Zeige Indikatoren an, auf welchem Slide man sich befindet
**Vor- und Zurückbutton Typ:** Auswahl zwischen:
* Chevron (>)
* Doppeltes Chevron (>>)
* Einfacher Pfeil (➝)
#### Textoptionen
**Textposition Vertikal:** Lege die vertikale Ausrichtung des Textinhalts fest Auswahl zwischen:
* oben
* zentriert
* unten
**Textposition Horizontal:** Lege die horizontale Ausrichtung des Textinhalts fest Auswahl zwischen:
* links
* zentriert
* rechts
**Hintergrundfarbe Textbox:** Lege eine Hintergrundfarbe für den Textinhalt fest; dies kann zur besseren Lesbarkeit beitragen
**Innenabstand Textbox:** Abstand der Box bis zum Text Auswahl zwischen:
* kein Abstand
* p-1 bis p-7
* maximaler Abstand
**Außenabstand Textbox:** Abstand der Box zum Rand des Containers Auswahl zwischen:
* kein Abstand
* m-1 bis m-7
* maximaler Abstand
**Rahmenabrundung:** Lege hier einen Wert in Pixeln fest. Bestimmt, wie viel die Ecken der Textbox abgerundet werden ➝ kein Wert = keine Abrundung
**Schrift-Dicke Überschrift:** Lege hier die Schriftdicke fest. Je größer die Zahl, desto dicker die Schrift.
**Schrift-Dicke Untertitel:** Lege hier die Schriftdicke fest. Je größer die Zahl, desto dicker die Schrift.
***
## Größe und Abstände
***
**Anzahl der sichtbaren Produkt je Displaygröße:** Definiere hier, wieviele Slides gleichzeitig je nach Displaygröße angezeigt werden sollen (XS kleinste; XL größte)
**Bildbreite verwenden:** Durch eine feste Bildbreite richtet sich die Anzahl der sichtbaren Slides nach der Bildbreite und ist unabhängig von der oberen Einstellung.
**Anzahl der Slides um die verschoben wird:** Lege fest um wieviele Slides je nach Displaygröße verschoben werden soll (XS kleinste; XL größte)
**Lücke zwischen des Slides:** Definiere wieviel Abstand zwischen den einzelnen Slides sein soll (Standard: 1rem)
**Höhe Slider:** Hier kannst du dem Slider eine feste Höhe zuweisen, damit alle Inhalte immer gut sichtbar sind
***
## Bewegung
***
**Ausrichtung Slider:** Lege fest, ob der Slider von links nach rechts oder von rechts nach links scrollen soll
**Übergangsgeschwindigkeit in ms:** Definiere, wie viel Zeit zwischen dem Wechsel der Slides vergehen soll
**Ziehen per Maus:** Entscheide, ob man die Slides durch Ziehen mit der Maus verschieben kann
**Automatisch abspielen aktivieren:** Lege fest, ob die Slides automatisch durchscrollen sollen
**Abspielinternvall in ms:** Bestimme das Zeitintervall in dem der Slider automatisch verschoben werden soll
Hat nur eine Funktion, wenn automatisches abspielen aktiviert ist!
**Pausieren bei Hover?:** Lege fest, ob das automatisch Scrollen pausiert werden soll, wenn jemand mit der Maus auf dem Slider ist
***
***
# Hersteller Link
Source: https://docs.dreizack-medien.de/OPC-Plus/Hersteller-Link
# Allgemeine Beschreibung
Das "Hersteller Link" Portlet zeigt auf der Produktdetailseite einen Link zum Hersteller des Artikels an, über den Kunden weitere Produkte dieser Marke entdecken können.
# Einsatzmöglichkeiten (Inspiration)
* **Cross-Selling über Marken:** Biete Kunden einen schnellen Zugang zu weiteren Produkten desselben Herstellers.
* **Markenwahrnehmung stärken:** Hebe die Marke des Artikels gezielt hervor.
***
# Tutorial
***
# Settings:
## Allgemein
**Hersteller automatisch beziehen?:** Wenn aktiviert, kannst du einen eigenen Hersteller angeben. Wenn nicht, wird der Hersteller des Artikels automatisch verwendet.
* Ja, Hersteller automatisch beziehen
* Nein, eigenen Hersteller angeben
Wenn auf "Ja" gesetzt, aber kein Hersteller in der Wawi hinterlegt oder das Portlet nicht auf einer Artikelseite platziert wurde, wird es automatisch ausgeblendet.
**Textblock vor Herstellername:** Text, der vor dem Herstellernamen angezeigt wird (z. B. "Mehr von").
**Textblock nach Herstellername:** Text, der nach dem Herstellernamen angezeigt wird.
***
## Darstellung
**Wie soll der Hersteller angezeigt werden?:** Wähle, ob der Hersteller als Bild und Text, nur als Bild oder nur als Text dargestellt wird.
**Ausrichtung:** Lege die Ausrichtung des Inhalts fest:
* Gestreckt
* Zentriert
* Links
* Rechts
**Textfarbe des Herstellernamens:** Wähle eine eigene Farbe für den Herstellernamen oder belasse die Standardfarbe.
**Bildgröße des Herstellers, wenn aktiv:** Lege die Größe des Herstellerbildes fest (z. B. Klein).
**Herstellbild: Weißen Hintergrund entfernen:** Aktiviere diese Option, um den weißen Hintergrund des Herstellerbildes zu entfernen.
**Pfeil anzeigen:** Aktiviere diese Option, um einen Pfeil nach rechts anzuzeigen.
**Innenabstand aktivieren:** Aktiviere diese Option, um einen Innenabstand zu aktivieren.
Für weitere Darstellungs-Optionen, klicke auf den Tab **Layout**.
***
# Beispiel
So erscheint der Hersteller-Link auf der Produktdetailseite, verlinkt zu allen Produkten der Marke:
***
# Icon
Source: https://docs.dreizack-medien.de/OPC-Plus/Icon
# Allgemeine Beschreibung
Das "Icon" Portlet ermöglicht es dir, skalierbare Vektorgrafiken aus der beliebten Font Awesome Bibliothek direkt in deinem Layout zu platzieren. Da es sich um Vektoren handelt, bleiben die Icons auf jeder Bildschirmgröße gestochen scharf. Dieses Portlet ist ideal, um textlastige Bereiche aufzulockern, Funktionen zu visualisieren oder Vertrauenselemente (Trust Elements) darzustellen.
# Einsatzmöglichkeiten (Inspiration)
* **USP-Leiste:** Nutze Icons wie einen LKW, ein Paket oder einen Hörer, um Versandvorteile oder Support-Optionen im Header oder Footer zu visualisieren.
* **Feature-Listen:** Verwende Häkchen oder spezifische Symbole anstelle von normalen Aufzählungspunkten, um Produktvorteile hervorzuheben.
* **Social Media:** Platziere die Logos von Instagram, Facebook & Co. an prominenter Stelle.
* **Navigationshilfen:** Nutze Pfeile oder Wegweiser, um den Blick des Nutzers auf Call-to-Action Buttons zu lenken.
# Featureübersicht:
* **Riesige Bibliothek:** Zugriff auf die umfangreiche Sammlung von Font Awesome Icons.
* **Individuelle Größe:** Pixelgenaue Einstellung der Icon-Größe.
* **Freie Farbwahl:** Passe die Farbe des Icons passend zu deinem Corporate Design an.
* **Ausrichtung:** Flexible Positionierung (horizontal und vertikal) innerhalb des Containers.
***
# Settings:
## Allgemein
***
**Icon (Font Awesome):** Nutze das Suchfeld ("Type to filter"), um das gewünschte Icon zu finden (z. B. "check", "user", "cart"). Wähle das Icon anschließend durch Anklicken aus der Liste aus.
**Farbe des Icons:** Bestimme die Farbe des Icons. Du kannst hier oft zwischen Standardfarben des Themes wählen oder eine eigene Farbe definieren.
**Größe des Icons in px:** Gib die gewünschte Höhe und Breite des Icons in Pixeln an (z. B. 16 für kleine Icons oder 64 für große Teaser-Icons).
**Horizontale Position des Icons:** Lege die Ausrichtung auf der horizontalen Achse fest (z. B. Zentriert, Links, Rechts).
**Vertikale Position des Icons:** Lege die Ausrichtung auf der vertikalen Achse fest. Dies ist besonders relevant, wenn das Icon in einem Container steht, der höher ist als das Icon selbst.
***
***
# Icon Line
Source: https://docs.dreizack-medien.de/OPC-Plus/Icon-Line

***
# Allgemeine Beschreibung
Die Icon Line ermöglicht die optische Trennung von Inhalten, durch eine Linie mit Icons. Mit einer breiten Auswahl an Icons zur Auswahl oder der Möglichkeit, eigenes Bildmaterial hochzuladen, bietet dieses Portlet eine flexible Lösung zur visuellen Präsentation von Inhalten.
# Einsatzmöglichkeiten (Inspiration)
* Weise auf besondere Versandinformationen hin
* Hebe die wichtigsten Produktmerkmale hervor
* Zeige deine Unternehmensverifizierungen, Brachenauszeichnungen oder Qualifikationen
* Füge das Portlet deinem Kontaktbereich hinzu, um Telefonnummern, E-Mail-Adressen und Standortinformationen visuell ansprechend darzustellen
* Nutze das Portlet, um auf deine Social-Media-Kanäle aufmerksam zu machen
# Featureübersicht:
* Wahl aus vielen Icons oder die Option eigenes Bildmaterial hochzuladen
* Anzahl der Icons flexibel nach Displaygröße steuern
* Farbe der Icons und der Trennlinie anpassen
***
# Settings:
## Allgemein
***
**Anzahl der Icons je Displaygröße:** Steuert flexibel wie viele Icons auf den verschiedenen Displaygrößen angezeigt werden sollen
**Größe Icon/Bild in px:** Legt die Größe des Icons bzw. deines hinterlegten Bildes in Pixeln fest
**Darstellungsform:** Auswahl zwischen:
* Icon: Wähle aus hinterlegten Icons und passe rechts daneben die Farbe des Icons an
* Bild: Lade dein eigenes Bild/Icon hoch
**Abstand zwischen Icon und Linie:** Legt den Abstand zwischen dem Icon und der Trennlinie fest
* mx-0 = kein Abstand
* mx-6 = maximaler Abstand
**Dicke Linie in Pixel:** Legt die Dicke der Linie in Pixeln fest
**Style der Linie:** Auswahl zwischen:
* dotted: gepunktete Linie
* dashed: gestrichelte Linie
* solid: durchgezogene Linie
* double: doppelte Linie mit kleinem Abstand zwischen den Linien
**Farbe der Linie:** Wähle die Farbe der Linie entweder über den Colorpicker (Klick auf die Farbe) oder trage die RGB-Werte selbst ein
***
***
# Icon Textbox
Source: https://docs.dreizack-medien.de/OPC-Plus/Icon-Textbox
# Allgemeine Beschreibung
Die Icon Textbox ist ein einfaches Designelement mit einem prominenten Icon, Text und optionaler Verlinkung. Mit der Icon Textbox kannst du auf Inhalt aufmerksam machen, Schritt für Schritt Anleitungen schreiben, oder auch Angebote platzieren
# Einsatzmöglichkeiten (Inspiration)
* Zeig wie einfach dein Produkt ist mit Schrittanleitungen
* Stelle Angebote prominent dar
* Warnmeldungen
* Infoboxen
# Featureübersicht:
* Wahl zwischen Buchstabe/Zahl oder Icon
* Optionale Verlinkung
***
# Tutorial
***
# Settings:
## Textinhalt
***
**Überschrift:** Legt die Überschrift fest
**Inhalt:** Legt den Textinhalt fest
***
## Icon
***
**Darstellungsform:** Wähle zwischen
* Icon: stellt ein Icon im Kreis über dem Text dar
* Zahl/Buchstabe: Stellt eine ausgewählte Zahl oder einen Buchstaben dar
***
## Darstellung
***
**Icon Farbe:** Legt die Farbe des Icons fest
**Boxschatten verwenden:** Verleiht der Box einen dezenten Schatten, der dem Element mehr räumliche Tiefe verleiht.
***
## Button
***
**Button verwenden**: Auswahl, ob ein Button dargestellt werden soll oder nicht
**Buttonlink:** URL auf die der Button bei Klick leiten soll. Für Verlinkung auf andere Seiten muss die vollständige URL angelegt werden. Für Verlinkungen auf der eigenen Domain reicht der relative Pfad. Damit der Link innerhalb der aktuellen Seite zu einem Bereich scrollt, muss der Bereich eine ID haben, dann kannst du mit #mein-id automatisch dort hin scrollen lassen per Klick. Siehe Allgemeine Dokumentation für das Anlegen von IDs in OPC Portlets
```plain theme={null}
Verlinkung auf Drittseite:
https://dreizack-medien.de/meine-kategorie/mein-produkt
Verlinkung innerhalb der eigenen Domain:
/meine-kategorie/mein-produkt
Verlinkung zu Container:
#meine-id
/meine-kategorie/mein-produkt#meine-id
```
**Button Text:** Text, der auf dem Button steht
**Button Type:** Wie soll der Button dargestellt werden
* Full: vollflächig mit Farbe
* Outlined: weiß mit farbigem Rand
* Plain Text: nur Text wird farbig angezeigt, ähnlich wie ein Link
**Button Farbe:** Farbe des Buttons. Je nach Type färbt sich die Fläche (Full), der Rahmen (Outlined) oder die Schriftfarbe (Plain Text). Die Farbauswahl richtet sich nach Templateeinstellung und passt sich so nahtlos deinem Design an.
**Button Breite:** Auswahl wie der Button in der Breite dargestellt wird:
* Content Width: So breit wie der Text darin
* Full Width: Über die gesamte Breite des Containers
**Button Ausrichtungen:** Hier kannst du für jede Bildschirmgröße auswählen wie sich der Button verhalten soll, ob er links-, rechtsbündig oder zentriert dargestellt werden soll. Das ist sinnvoll zu durchdenken, denn auf mobilen Ansichten, insbesondere wenn dein Gridlayout umbricht, kann die Buttonposition im Verhältnis darunter leiden.
**Link in neuen Tab öffnen:** Bei Klick auf den Link wird ein neuer Tab geöffnet.
**Icon vor oder nach dem Text:** Hat hier aktuell leider keine Funktion und wird in einer der kommenden Versionen entfernt
***
# Kategorie Grid
Source: https://docs.dreizack-medien.de/OPC-Plus/Kategorie-Grid
## Besondere Konfigurationen
### Alternativer Kategorietitel
Um den Karten einen abweichenden Namen zu vergeben, kannst du das folgende Attribut verwenden:
```plain theme={null}
dzm_opc_cg_alt_name
```
Lege das Attribut in der Wawi für Kategorien an und aktiviere es für deinen Shop.
Achte darauf, dass du den Attributnamen `dzm_opc_cg_alt_name` für alle Sprachen übernimmst.
Füge das Attribut der Kategorie hinzu und hinterlege für deinen Shop einen alternativen Namen, pro Sprache.
Der Name in der Karte wird mit dem Wert des Attributs ersetzt.
# Kategorie Slider
Source: https://docs.dreizack-medien.de/OPC-Plus/Kategorie-Slider
# Allgemeine Beschreibung
Das "Kategorie Slider" Portlet zeigt eine frei wählbare Auswahl an Kategorien als Slider an, inklusive Bild, Titel und individuell konfigurierbarer Darstellung.
# Einsatzmöglichkeiten (Inspiration)
* **Kategorien bewerben:** Hebe ausgewählte Kategorien (z. B. Aktionen oder Saisonthemen) prominent auf der Startseite oder Landingpages hervor.
* **Navigation erleichtern:** Biete Besuchern einen schnellen visuellen Einstieg in dein Sortiment.
***
# Tutorial
***
# Settings:
## Kategorieauswahl
**Kategorien Auswählen:** Suche über das Textfeld nach Kategorien und wähle per Klick aus den gefundenen Einträgen die Kategorien aus, die im Slider angezeigt werden sollen. Über **Alle auswählen** bzw. **Alle abwählen** kannst du die gesamte Trefferliste auf einmal (ab)wählen.
Angeklickte, also ausgewählte Kategorien werden blau hinterlegt dargestellt.
***
## Darstellung
### Slider-Darstellung
**Slider Typ:** Wähle, ob die Slides als Bild & Text oder in einer anderen Variante dargestellt werden.
**Bildtyp:** Lege fest, ob das Bild als Hintergrundbild oder als Produktbild dargestellt wird.
* Bild ist Hintergrundbild
* Bild ist Produktbild
**Bildgröße:** Wähle die Bildgröße für die Darstellung (Standard: `default`).
**Fallback image:** Wird angezeigt, wenn für eine Kategorie kein Bild hinterlegt ist.
**Farbüberlagerung:** Legt eine Farbe zwischen Bild und Inhalt, um die Lesbarkeit zu verbessern. Verwende den Transparenz-Slider, um das Bild durchscheinen zu lassen.
**Seitenverhältnis des Bildes:** Lege das Seitenverhältnis fest:
* 1 / 1
* 16 / 9
* 3 / 2
* custom
**Kategorie-Slider Kartentyp:** Wähle, wo der Text der Karte angezeigt wird:
* Text in der Karte
* Text unter der Karte
### Slider-Item-Darstellung
**Textposition horizontal / vertikal:** Positioniere den Text innerhalb der Karte (z. B. Links / Oben).
**Innenabstand:** Lege den Innenabstand der Karte fest (z. B. `p-0`).
**HTML-Tag der Überschrift:** Wähle das HTML-Tag für die Überschrift (h1-h6 oder Standard Text).
**Größe der Überschrift:** Bestimmt, wie groß der Text dargestellt wird und orientiert sich an den Vorgaben (h1-h6 & p) des aktuellen Themes.
**Textfarbe der Überschrift:** Wähle eine eigene Farbe für die Überschrift oder belasse die Standardfarbe.
**Schrift-Dicke:** Bestimmt die font-weight (CSS) der Überschrift (z. B. `800`).
### Slider-Controls-Darstellung
**Vor- und Zurückbutton anzeigen?:** Aktiviere die Navigationsbuttons des Sliders.
**Seitenindexierung anzeigen?:** Aktiviere die Punktnavigation unter dem Slider.
**Vor- und Zurückbutton Typ:** Wähle die Darstellung der Navigationsbuttons:
* Chevron (>)
* Doppel Chevron (>>)
* Standard Pfeil (->)
***
## Größe und Abstände
### Slides - Darstellung
**Anzahl der sichtbaren Slides je Displaygröße:** Lege für die folgenden Breakpoints fest, wie viele Slides gleichzeitig sichtbar sein sollen:
* **XS:** \<576px
* **S:** ≥576px
* **M:** ≥768px
* **L:** ≥992px
* **XL:** ≥1200px
**Anzahl der Slides, um die verschoben wird:** Lege für dieselben Breakpoints fest, um wie viele Slides pro Klick oder Wisch weitergeschaltet wird.
### Slides - Größe und Abstände
**Lücke zwischen Slides:** Wähle den Abstand zwischen den einzelnen Slides:
* Kein Abstand
* XS (0.25rem)
* M (1rem)
* XL (2rem)
**Produkte rechts anschneiden:** Schneidet Produkte rechts ab, um zu zeigen, dass es noch mehr gibt.
***
## Bewegung
**Ausrichtung Slider:** Bestimmt die Laufrichtung des Sliders (z. B. links nach rechts).
**Übergangsgeschwindigkeit in Millisekunden:** Geschwindigkeit des Übergangs zwischen den Slides.
**Ziehen per Maus:** Lege fest, ob und wie der Slider per Maus gezogen werden kann (z. B. "erlauben mit Einrastpunkten").
### Optionen für Automatisches abspielen
**Automatisch abspielen aktivieren?:** Aktiviert das automatische Weiterschalten des Sliders.
**Abspielintervall in Millisekunden:** Zeitabstand zwischen den automatischen Übergängen.
**Pausieren bei Hover?:** Pausiert das automatische Abspielen, sobald der Nutzer mit der Maus über den Slider fährt.
***
Für weitere Einstellungen zum Layout, siehe den Tab **Layout** im Portlet selbst.
***
# Beispiel
So erscheint der Kategorie Slider im Frontend:
# Kategorie-Variablen
Source: https://docs.dreizack-medien.de/OPC-Plus/Kategorie-Variablen
# Allgemeine Beschreibung
Das "Kategorie-Variablen" Portlet ermöglicht es dir, dynamische Informationen der aktuell aufgerufenen Kategorie direkt in dein Layout einzubinden. So kannst du automatisierte Inhalte erstellen, die sich je nach besuchter Kategorie im Shop aktualisieren.
# Einsatzmöglichkeiten (Inspiration)
* **Dynamische SEO-Texte:** Nutze die Kategoriebeschreibung, um auf jeder Kategorieseite individuellen Content anzuzeigen, ohne für jede Seite ein eigenes Portlet pflegen zu müssen.
* **Automatisierte Überschriften:** Verwende den Kategorienamen als zentrale Überschrift in deinem Banner oder Hero-Bereich.
* **Individuelle Kategorieseiten:** Baue dir ein Master-Layout für deine Kategorien, das die spezifischen Daten der jeweiligen Kategorie automatisch an der richtigen Stelle ausgibt.
# Featureübersicht:
* **Echtzeit-Daten:** Greift direkt auf die Datenbankinformationen der jeweiligen Kategorie zu.
* **Flexible Formatierung:** Durch verschiedene Block-Styles passt sich die Variable nahtlos in dein bestehendes Design ein.
* **Layout-Integration:** Wie alle Portlets lässt sich auch dieses Element in Grids oder Containern platzieren und über den Layout-Reiter feinjustieren.
***
# Settings:
## Allgemein
***
**Variable wählen:** Hier entscheidest du, welche Information der Kategorie angezeigt werden soll. Zur Auswahl stehen:
Wähle hier eine Variable, die ausgegeben werden soll. Bitte beachte, dass die Variablen nur auf Kategorieseiten ausgegeben werden können.
* **Name**: Gibt den offiziellen Namen der Kategorie aus.
* **Beschreibung**: Zeigt den im Backend hinterlegten Beschreibungstext der Kategorie an.
**Block Style:** Hier legst du fest, wie die Variable technisch und optisch in die Seite eingebunden wird:
* **Inline (Element reiht sich mit anderen Elementen ein)**: Das Element verhält sich wie Text im Fluss und nimmt nur so viel Platz wie nötig ein.
* **Container (Element nimmt eine Zeile in Anspruch)**: Erzeugt einen Block, der die volle verfügbare Breite nutzt.
* **kleiner Text**: Formatiert die Ausgabe in einer dezenten, kleineren Schriftgröße.
* **Fetter Text**: Hebt die Variable durch eine fette Schriftart hervor.
* **Normaler Text**: Standard-Textformatierung ohne zusätzliche Hervorhebung.
* **Überschrift 1 bis 6**: Formatiert die Variable als HTML-Überschrift ($H1$ bis $H6$), was besonders wichtig für deine SEO-Struktur ist.
***
***
# Kunden-Variablen
Source: https://docs.dreizack-medien.de/OPC-Plus/Kunden-Variablen
# Allgemeine Beschreibung
Mit dem "Kunden-Variablen" Portlet kannst du dynamische Kundendaten flexibel in deinem Onlineshop anzeigen lassen. So kannst du angemeldete Kunden beispielsweise persönlich ansprechen oder spezifische Konto-Informationen (wie die Kundennummer oder das aktuelle Guthaben) an passender Stelle ausgeben.
# Einsatzmöglichkeiten (Inspiration)
* **Persönliche Begrüßung:** Nutze Variablen wie Vor- und Nachname, um deine Kunden auf bestimmten Seiten direkt und persönlich willkommen zu heißen.
* **Profil-Informationen:** Zeige dem Kunden schnell und unkompliziert seine hinterlegten Kontaktdaten (wie Adresse, E-Mail oder Telefonnummer) oder sein aktuelles Guthaben an.
* **Individuelle Ansprache:** Steigere die Kundenbindung durch maßgeschneiderte Textelemente, die sich dynamisch an den jeweils eingeloggten Nutzer anpassen.
# Featureübersicht:
* **Umfangreiche Datenauswahl:** Dir stehen zahlreiche Variablen von den grundlegenden Adressdaten bis hin zum Kundenguthaben zur Verfügung.
* **Flexible Formatierung:** Passe die Textdarstellung direkt über vordefinierte Block-Stile (wie verschiedene Überschriften oder fetten Text) an das Design deines Shops an.
* **Nahtlose Integration:** Die Variablen lassen sich nahtlos als Inline-Elemente im Fließtext platzieren oder als eigenständige Blöcke (Container) integrieren.
***
# Settings:
## Allgemein
***
**Variable wählen:** Wähle hier die Kundeneigenschaft aus, die an der gewünschten Stelle ausgegeben werden soll.
Bitte beachte, dass bestimmte Variablen unter Umständen nur auf Kategorieseiten ausgegeben werden können und voraussetzen, dass der Kunde im Shop angemeldet ist.
Du hast die Auswahl zwischen folgenden Datenfeldern:
* Vorname
* Nachname
* Anrede
* Title
* Firma
* Straße
* Hausnummer
* Adresszusatz
* PLZ
* Ort
* Bundesland
* Land
* Mail
* Telefon
* Mobil
* Fax
* Geburtstag
* Kundennummer
* Guthaben
**Block Style:** Hier legst du fest, wie das ausgewählte Element strukturiert und formatiert werden soll. Auswahl zwischen:
* Inline (Element reiht sich mit anderen Elementen ein)
* Container (Element nimmt eine Zeile in Anspruch)
* kleiner Text
* Fetter Text
* Normaler Text
* Überschrift 1 bis 6
***
***
# Kunden kauften auch
Source: https://docs.dreizack-medien.de/OPC-Plus/Kunden-kauften-auch
# Allgemeine Beschreibung
Das "Kunden kauften auch" Portlet ist eines der effektivsten Cross-Selling-Tools im E-Commerce. Es nutzt die Transaktionsdaten deines Shops, um automatisch Produkte anzuzeigen, die häufig zusammen mit dem aktuell betrachteten Artikel gekauft wurden. Diese datengestützte Empfehlung ("Andere Kunden haben sich so entschieden") wirkt als starker Social Proof und hilft dabei, den durchschnittlichen Warenkorbwert zu erhöhen, indem passende Ergänzungsartikel vorgeschlagen werden.
**Hinweis:** Die Einstellungen für dieses Portlet werden im Backend vorgenommen. Das "Kunden kauften auch" Widget wird standardmäßig unter dem Produkt in der Artikeldetailseite angezeigt. Hiermit kannst du einen alternativen Platz für das Portlet wählen.
# Einsatzmöglichkeiten (Inspiration)
* **Produktdetailseite:** Der Klassiker – platziere den Slider unterhalb der Produktbeschreibung, um Zubehör oder Sets vorzuschlagen.
* **Warenkorb:** Zeige im Warenkorb, was andere Käufer noch dazu gepackt haben (z. B. Batterien zum Spielzeug).
* **Checkout-Success:** Inspiriere Kunden auf der Bestellbestätigungsseite für ihren nächsten Einkauf.
* **Warenkorb-Layer:** Biete beim Hinzufügen eines Artikels direkt passende Ergänzungen im Popup/Layer an.
# Featureübersicht:
* **Vollautomatisch:** Keine manuelle Pflege nötig – die Logik basiert auf echten Kaufdaten aus der JTL-Datenbank.
* **Lernfähig:** Je mehr Verkäufe stattfinden, desto präziser werden die Vorschläge.
* **Slider-Layout:** Platzsparende Darstellung vieler Artikel durch horizontale Navigation.
* **Responsive:** Passt sich perfekt an Mobile, Tablet und Desktop an.
***
# Kundenbewertung
Source: https://docs.dreizack-medien.de/OPC-Plus/Kundenbewertung
## 
# Allgemeine Beschreibung
Mit dem Portlet Kundenbewertung kannst du Kundenstimmen nachbilden und beliebig platzieren. Es greift zwar keine Bewertungen aus Bewertungsportalen ab, gibt dir dafür aber die volle Freiheit deine Kundenmeinungen gezielt zu platzieren. Du kannst die Kundenbewertung auch mit dem Link zur Originalbewertung verlinken.
# Einsatzmöglichkeiten (Inspiration)
* Kundenmeinungen
# Featureübersicht:
* Diverse Anordnungsmöglichkeiten der Sterne und Texte
* Iconwahl
* ...
***
# Settings:
## Allgemein
***
**Bewertungstext 1:** Kann für die Überschrift oder den Inhalt genutzt werden.
**Bewertungstext 2:** Kann für den Inhalt oder den Namen des Verfassers genutzt werden
**Bewertungsscore:** Legt die Anzahl der vergebenen Sterne fest
**Position der Bewertungspunkte:** Auswahl zwischen:
* Über Text1: Die Bewertungspunkte werden ganz oben angezeigt
* Zwischen Text1 und 2: Die Bewertungspunkte werden zwischen den Inhalten angezeigt
* Unter Text2: Die Bewertungspunkte werden ganz unten angezeigt
**Icon für Bewertungspunkte:** Legt das Icon für die Bewertungspunkte fest
**Farbe des Icons:** Setzt die Farbe des Icons. Entweder per Colorpicker oder durch Eingabe der RGB-Werte
***
***
# Line
Source: https://docs.dreizack-medien.de/OPC-Plus/Line
# Allgemeine Beschreibung
Dieses Portlet dient zur visuellen Trennung oder Strukturierung von Inhalten auf der Webseite. Es ermöglicht eine klare Abgrenzung zwischen verschiedenen Abschnitten oder Elementen.
# Einsatzmöglichkeiten (Inspiration)
* **Inhaltsabgrenzung:** Das "Trennlinien" Portlet kann verwendet werden, um Inhalte klar voneinander abzugrenzen, was die Übersichtlichkeit auf Ihrer Webseite verbessert.
* **Designelement:** Es kann als Designelement eingesetzt werden, um visuelles Interesse zu wecken oder bestimmte Abschnitte hervorzuheben.
* **Strukturierung von Text:** Bei längeren Texten kann die Trennlinie verwendet werden, um Absätze oder Abschnitte optisch zu gliedern.
# Featureübersicht:
* Vielfältige Gestaltungsmöglicheiten: Lege Dicke, Farbe und Position flexibel fest
* Trenne Inhalte visuell voneinander ab und steigere die Benutzerfreundlichkeit
***
# Settings:
## Allgemein
***
**Line Position:** Auswahl zwischen:
* Left = linksbündig
* Center = zentriert
* Right = rechtsbündig
* FullWidth = volle Breite
**Linie Farbe:** Legt die Farbe der Linie fest. Entweder per Colorpicker oder per Eingage des RGB-Farbwerts
**Linie Dicke:** Legt die Dicke der Linie in Pixeln fest; 0 deaktivert die Linie
**Linie Breite:** Setzt die Breite der Linie in % fest. 100% entspricht der maximalen Breite
***
***
# Logo Slider
Source: https://docs.dreizack-medien.de/OPC-Plus/Logo-Slider
## 
# Allgemeine Beschreibung
Der "Logo-Slider" ist ein effektives Portlet, mit dem du verschiedene Logos, beispielsweise von Herstellern oder Partnern, auf deiner Webseite präsentieren kannst. Diese Logos können verlinkt werden, um Besucher zu spezifischen Seiten oder Partnern zu führen. Zusätzlich bietet das Portlet die Möglichkeit, die Logos auszugrauen und sie nur beim Überfahren mit der Maus farbig anzuzeigen. Du kannst auch die Darstellung und Bewegung der Logos nach deinen Wünschen anpassen.
# Einsatzmöglichkeiten (Inspiration)
* **Hersteller-Logos:** Zeige die Logos der Hersteller, deren Produkte oder Dienstleistungen du anbietest, um Vertrauen zu schaffen.
* **Partner-Logos:** Präsentiere die Logos von Geschäftspartnern oder Kooperationspartnern, um Zusammenarbeit und Verlässlichkeit zu verdeutlichen.
* **Zertifizierungen:** Zeige Zertifikatslogos oder Auszeichnungen, um die Qualität deiner Produkte oder Dienstleistungen zu unterstreichen.
* **Referenzen:** Verwende Logos von Kunden oder Unternehmen, mit denen du zusammengearbeitet hast, um Vertrauen bei neuen Besuchern zu schaffen.
# Featureübersicht:
* **Verschiedene Logos hochladen:** Du kannst verschiedene Logos hochladen und sie im Slider anzeigen lassen.
* **Verlinkung der Logos:** Jedes Logo kann mit einer spezifischen Seite oder URL verlinkt werden, um Besucher zu weiteren Informationen zu führen.
* **Hover-Effekte:** Du kannst einstellen, dass die Logos beim Überfahren mit der Maus farbig werden, um besondere Aufmerksamkeit zu erregen.
* **Anpassbare Darstellung:** Passe die Abstände und Anzahl der angezeigten Logos an, um sie optimal auf deiner Webseite zu platzieren.
* **Individuelle Bewegungseffekte:** Definiere Bewegungseffekte wie Slide-In oder Fade-In, um die Art und Weise zu steuern, wie die Logos angezeigt werden.
* **Responsives Design:** Der Logo-Slider passt sich verschiedenen Bildschirmgrößen und Geräten an, um eine optimale Darstellung sicherzustellen.
***
# Tutorial
***
# Settings:
## Slides
***
**Logos ausgrauen und bei Hover hervorheben:** Logos werden in Graustufen dargestellt. Wenn man mit der Maus darüber fährt, werden sie farbig dargestellt.
**1.** Lade hier ein Logo für den Slider hoch
**2.** In diesen Portlet keine Funktion
**3.** In diesen Portlet keine Funktion
**4.** Hier kannst du einen Alternativtext hinterlegen, falls das Logo nicht korrekt angezeigt werden kann.
**5.** Hier hast du die Möglichkeit die Logos zu verlinken.
**6.** Durch Klick auf diese Schaltfläche kannst du weitere Slides hinzufügen
**7.** Drag & Drop: Verändere die Reihenfolge der Slides
**8.** Dupliziere den Slide
**9.** Lösche den Slide
***
## Darstellung
***
#### Indikatoren
**Vor- und Zurückbutton anzeigen:** Zeige Indikatoren zur Steuerung der Slides an
**Seitenindexierung anzeigen:** Zeige Indikatoren an, auf welchem Slide man sich befindet
**Vor- und Zurückbutton Typ:** Auswahl zwischen:
* Chevron (>)
* Doppeltes Chevron (>>)
* Einfacher Pfeil (➝)
***
## Größe und Abstände
***
**Anzahl der sichtbaren Produkt je Displaygröße:** Definiere hier, wieviele Slides gleichzeitig je nach Displaygröße angezeigt werden sollen (XS kleinste; XL größte)
**Anzahl der Slides um die verschoben wird:** Lege fest um wieviele Slides je nach Displaygröße verschoben werden soll (XS kleinste; XL größte)
**Lücke zwischen des Slides:** Definiere wieviel Abstand zwischen den einzelnen Slides sein soll (Standard: 1rem)
**Höhe Slider:** Hier kannst du dem Slider eine feste Höhe zuweisen, damit alle Inhalte immer gut sichtbar sind
***
## Bewegung
***
**Ausrichtung Slider:** Lege fest, ob der Slider von links nach rechts oder von rechts nach links scrollen soll
**Übergangsgeschwindigkeit in ms:** Definiere, wie viel Zeit zwischen dem Wechsel der Slides vergehen soll
**Ziehen per Maus:** Entscheide, ob man die Slides durch Ziehen mit der Maus verschieben kann
**Automatisch abspielen aktivieren:** Lege fest, ob die Slides automatisch durchscrollen sollen
**Abspielinternvall in ms:** Bestimme das Zeitintervall in dem der Slider automatisch verschoben werden soll
Hat nur eine Funktion, wenn automatisches abspielen aktiviert ist!
**Pausieren bei Hover?:** Lege fest, ob das automatisch Scrollen pausiert werden soll, wenn jemand mit der Maus auf dem Slider ist
***
# Marquee
Source: https://docs.dreizack-medien.de/OPC-Plus/Marquee
# Allgemeine Beschreibung
Das "Marquee" Portlet zeigt einen fortlaufend durchlaufenden Textstreifen (Laufband) an.
# Einsatzmöglichkeiten (Inspiration)
* **Ankündigungen:** Hebe Aktionen, News oder wichtige Hinweise durch ein auffälliges Laufband hervor.
* **Aufmerksamkeit erzeugen:** Nutze die Bewegung, um Besucher gezielt auf einen Inhalt hinzuweisen.
***
# Tutorial
***
# Settings:
## Allgemein
Wenn du den Block kopiert hast, achte bitte darauf, dass pro Seite jeder Block eine unterschiedliche UID hat. Ändere bitte die ID, wenn du diesen Block kopiert hast.
**UID:** Diese UID wird automatisch generiert. In der Regel muss hier nichts verändert werden.
**Speichern, ob Container geschlossen wurde:** Merkt sich per Cookie, ob der Besucher den Marquee-Container bereits geschlossen hat, damit er nicht erneut angezeigt wird.
**Wie viele Tage soll der Cookie gespeichert bleiben (0 für die Dauer der Session):** Zeitraum, bis der Container das nächste Mal angezeigt wird.
***
## Darstellung
**Textinhalt:** Trage die Texte ein, die im Laufband nacheinander angezeigt werden sollen. Über das **"+"** Symbol fügst du weitere Texteinträge hinzu, über das **"x"** Symbol entfernst du einen Eintrag. Über das Verschieben-Symbol (rechts) änderst du per Drag-and-Drop die Reihenfolge.
**Trennzeichen:** Zeichen, das zwischen den einzelnen Texteinträgen im Laufband angezeigt wird (z. B. `-`).
**Geschwindigkeit:** Geschwindigkeit, mit der das Laufband durchläuft (z. B. `250`).
***
# Beispiel
So erscheint der Marquee im Frontend:
***
# NIU OPC Sidebar
Source: https://docs.dreizack-medien.de/OPC-Plus/NIU-OPC-Sidebar
# Allgemeine Beschreibung
Mit dem "NIU OPC Sidebar" Portlet kannst du eine interaktive, ausklappbare Seitenleiste (Off-Canvas-Menü) in deinen Onlineshop integrieren. Diese Sidebar legt sich elegant über den eigentlichen Seiteninhalt und bietet dir extrem viel Flexibilität, um zusätzliche Informationen, Menüs oder Widgets platzsparend und nutzerfreundlich unterzubringen.
# Einsatzmöglichkeiten (Inspiration)
* **Erweiterte Navigation:** Nutze die Sidebar, um komplexe Kategoriemenüs oder Filteroptionen übersichtlich auf mobilen Endgeräten oder als verstecktes Desktop-Menü (Hamburger-Menü) darzustellen.
* **Warenkorb-Vorschau (Mini-Cart):** Biete deinen Kunden einen schnellen Blick in ihren Warenkorb, ohne dass sie die aktuelle Shopping-Seite verlassen müssen.
* **Promotions & Kontakt:** Platziere Newsletter-Formulare, Kontaktinformationen oder aktuelle Rabattaktionen in der Sidebar, damit sie jederzeit mit einem Klick erreichbar sind.
# Featureübersicht:
* **Individuelle Titel:** Verleihe deiner Sidebar eine klare Struktur durch anpassbare Haupt- und Untertitel.
* **Flexible Container-Struktur:** Aktiviere je nach Bedarf bis zu vier verschiedene, unabhängige Inhaltsbereiche (Container), in die du später per Drag-and-Drop beliebige andere OPC-Elemente ziehen kannst.
* **Statische und Action-Bereiche:** Unterteile deine Sidebar in scrollbare Inhaltsbereiche und fixierte Footer- oder Action-Container für wichtige Buttons, die immer sichtbar bleiben sollen.
***
# Settings:
## Allgemein
In diesem Reiter nimmst du die grundlegenden Einstellungen für den Aufbau und die Beschriftung deiner Sidebar vor.
***
**Sidebar Title:** Trage hier die Hauptüberschrift ein, die ganz oben in deiner Seitenleiste angezeigt werden soll (z. B. "Warenkorb", "Menü" oder "Filter").
**Sidebar Untertitle:** Hier kannst du eine ergänzende Unterüberschrift oder einen kurzen Hinweistext eingeben, der direkt unter dem Haupttitel erscheint.
**Ersten Statischen Container nutzen:** Setze hier ein Häkchen, um den ersten Inhaltsbereich innerhalb der Sidebar zu aktivieren. In diesen Container kannst du später im Editor deine gewünschten Elemente (wie Texte, Bilder oder Menüs) einfügen.
**Zweiten Statischen Container nutzen:** Aktivierst du diese Option, wird ein weiterer, separater Inhaltsbereich freigeschaltet. Das ist besonders praktisch, um verschiedene Themenblöcke in der Sidebar optisch und strukturell voneinander zu trennen.
**Statischen Container im Footer nutzen:** Wenn du hier ein Häkchen setzt, wird am unteren Rand der Sidebar ein spezieller Footer-Bereich aktiviert. Dieser eignet sich ideal für Elemente, die am Ende der Sidebar stehen sollen, wie z. B. Links zum Impressum, Social-Media-Icons oder Zahlungsanbieter-Logos.
**Action Container im nutzen:** *(Hinweis: Bezieht sich auf den "Action Container")* Aktiviere diese Checkbox, um einen speziellen Aktionsbereich freizuschalten. Dieser Bereich wird oft genutzt, um wichtige Handlungsaufrufe (Call-to-Action) wie "Zur Kasse" oder "Jetzt abonnieren" prominent und oft auch fixiert im Sichtbereich der Sidebar zu platzieren.
***
***
# NIU Sidebar Container
Source: https://docs.dreizack-medien.de/OPC-Plus/NIU-Sidebar-Container
# Allgemeine Beschreibung
Das "NIU Sidebar Container" Portlet ist das übergeordnete Verwaltungs-Element für deine Sidebars (ausklappbare Seitenleisten). Es dient als Rahmen (Container), in dem du eine oder gleich mehrere Sidebars für deinen Onlineshop anlegen und zentral organisieren kannst, bevor du sie mit Inhalten füllst.
# Einsatzmöglichkeiten (Inspiration)
* **Multi-Sidebar Layouts:** Richte unterschiedliche Sidebars für verschiedene Zwecke auf derselben Seite ein (erstelle beispielsweise eine linke Sidebar für das Hauptmenü und eine rechte Sidebar für den Mini-Warenkorb).
* **Zentrale Verwaltung:** Behalte den Überblick über alle deine Flyout-Menüs und Off-Canvas-Elemente an einem einzigen Ort.
# Featureübersicht:
* **Einfache Strukturierung:** Füge beliebig viele Sidebars per Klick hinzu oder lösche sie wieder aus deinem Container.
* **Flexible Reihenfolge:** Ändere die Anordnung und Hierarchie deiner Sidebars ganz intuitiv per Drag-and-Drop.
***
# Settings:
## Allgemein
In diesem Reiter verwaltest du die grundsätzliche Struktur und Anzahl deiner Sidebars innerhalb dieses Containers.
***
**Sidebars:** Hier siehst du eine Auflistung aller aktuell im Container angelegten Sidebars. Du hast folgende Steuerungsmöglichkeiten:
* **"+" Symbol (Blauer Button):** Klicke auf das Plus-Icon, um eine neue Sidebar zu deinem Container hinzuzufügen. In das leere Textfeld daneben kannst du in der Regel einen internen Namen eintragen, um die Sidebars im Editor besser voneinander unterscheiden zu können.
* **"x" Symbol:** Klicke auf dieses Kreuz links neben einem Eintrag, um die entsprechende Sidebar wieder komplett aus dem Container zu löschen.
* **Verschieben-Symbol (Pfeilkreuz rechts):** Halte dieses Symbol mit der Maus gedrückt, um die jeweilige Sidebar per Drag-and-Drop an eine andere Position zu ziehen und so die Reihenfolge anzupassen.
***
***
# NIU Sidebar Trigger Container
Source: https://docs.dreizack-medien.de/OPC-Plus/NIU-Sidebar-Trigger-Container
# Allgemeine Beschreibung
Das "NIU Sidebar Trigger Container" Portlet fungiert als interaktiver Schalter (Auslöser) für deine angelegten Sidebars. Du platzierst diesen Container einfach an der gewünschten Stelle in deinem Shop und legst dort beispielsweise einen Button, ein Icon oder einen Text hinein. Sobald ein Kunde auf dieses Element klickt, öffnet sich automatisch die von dir verknüpfte Sidebar.
# Einsatzmöglichkeiten (Inspiration)
* **Individuelle Menü-Buttons:** Baue dir einen eigenen "Hamburger"-Button oder nutze einen Textlink, der per Klick dein verstecktes Navigationsmenü (Off-Canvas) ausfährt.
* **Warenkorb-Aufruf:** Lege ein Warenkorb-Icon in diesen Container, um beim Klick darauf die Mini-Cart Sidebar an der Bildschirmseite hereinrutschen zu lassen.
* **Info-Trigger:** Nutze kleine Info-Icons oder "Mehr erfahren"-Texte, um Kunden detaillierte Erklärungen, Größentabellen oder Filter-Optionen in einer Seitenleiste anzuzeigen, ohne dass sie die aktuelle Seite verlassen müssen.
# Featureübersicht:
* **Nahtlose Verknüpfung:** Verbinde den Auslöser ganz einfach über ein Dropdown-Menü mit der passenden Sidebar.
* **Flexibles Layouting:** Steuere das CSS-Verhalten (die Anzeigeart) deines Trigger-Containers, damit er sich perfekt in den umgebenden Inhalt einfügt (z. B. als Inline-Element im Fließtext oder als eigenständiger Block).
* **Gezielte Content-Auswahl:** Nutze CSS-Selektoren, um bei Bedarf nur ganz bestimmte Inhalte in der Sidebar anzusprechen.
***
# Settings:
## Allgemein
In diesem Reiter legst du fest, welche Sidebar geöffnet werden soll und wie sich der Container auf deiner Seite verhält.
***
**Sidebar Selector:** Wähle hier über das Dropdown-Menü aus, welche deiner angelegten Sidebars durch den Klick auf diesen Container ausgelöst (geöffnet) werden soll. Zur Auswahl stehen in der Regel:
* NIU OPC Sidebar
* NIU OPC Sidebar Modal
**Sidebar Content Selektor:** Hier kannst du bei Bedarf einen spezifischen CSS-Selektor eintragen. Das ist besonders für fortgeschrittene Anwendungsfälle nützlich, wenn du innerhalb der Ziel-Sidebar noch einmal gezielt bestimmte Inhaltsbereiche ansprechen oder steuern möchtest.
Trage die ID deiner angelegten Sidebar ein, die getriggert werden soll
**Block Typ:** Bestimme hier die grundlegende CSS-Display-Eigenschaft deines Trigger-Containers, damit er das Layout deiner Seite nicht ungewollt verschiebt. Du hast die Auswahl zwischen:
* **Block** = Das Element verhält sich wie ein klassischer Block und nimmt (wenn nicht anders definiert) die volle verfügbare Breite ein; es erzeugt in der Regel einen Zeilenumbruch.
* **Inline Block** = Das Element reiht sich neben anderen Elementen ein (wie Inline), du kannst ihm aber dennoch eine feste Breite und Höhe zuweisen.
* **Inline** = Das Element fließt ganz natürlich mit dem restlichen Text oder Inhalt mit, ohne Zeilenumbrüche zu erzeugen.
* **Flex** = Das Element nutzt das moderne CSS Flexbox-Layout, ideal um darin liegende Elemente (wie ein Icon und Text) flexibel aneinander auszurichten.
***
***
# Newsletter Form
Source: https://docs.dreizack-medien.de/OPC-Plus/Newsletter-Form
# Allgemeine Beschreibung
Das "Newsletter Form" Portlet ermöglicht es dir, ein unkompliziertes Anmeldeformular für deinen Newsletter direkt auf den Seiten deines Onlineshops zu integrieren. So machst du es deinen Kunden besonders einfach, sich für Neuigkeiten und Angebote einzutragen, und kannst aktiv neue Abonnenten gewinnen.
# Einsatzmöglichkeiten (Inspiration)
* **Kundenbindung stärken:** Biete Besuchern die Möglichkeit, sich unkompliziert für exklusive Rabatte, Updates oder deinen Blog-Newsletter anzumelden.
* **Lead-Generierung:** Platziere das Formular prominent auf deiner Startseite, in Themenwelten oder im Footer-Bereich, um effektiv deine E-Mail-Kontaktliste aufzubauen.
* **Rechtssichere Anmeldung:** Integriere notwendige Datenschutzinformationen direkt am Formular, um transparente Bedingungen für deine Abonnenten zu schaffen.
# Featureübersicht:
* **Eigene Fehlermeldungen:** Definiere einen individuellen Text, der angezeigt wird, falls bei der Anmeldung ein technisches Problem auftritt.
* **Flexible Datenschutzhinweise:** Du hast die volle Kontrolle darüber, ob und in welcher Form ein Hinweis auf deine Datenschutzerklärung am Formular platziert wird.
***
# Settings:
## Allgemein
***
**Text bei Fehlermeldung:** Trage hier den Text ein, der deinen Kunden angezeigt werden soll, falls bei der Übermittlung der Newsletter-Anmeldung ein Fehler auftritt (z. B. "Ups... da ist etwas schief gelaufen."). Das hilft, Frust beim Kunden zu vermeiden und informiert ihn freundlich über das Problem.
**Hinweis zum Datenschutz anzeigen:** Wähle hier über das Dropdown-Menü aus, ob und wie ein Text zum Thema Datenschutz an deinem Formular eingebunden werden soll. Du hast die Auswahl zwischen:
* **Keinen Hinweis anzeigen** = Es wird kein zusätzlicher Text zum Datenschutz am Formular eingeblendet.
* **Standardhinweis anzeigen** = Es wird ein vorgefertigter Standardtext aus deinem Shop-System verwendet.
* **Eigenen Hinweis anzeigen** = Wenn du diese Option wählst, kannst du einen komplett eigenen Text formulieren, der auf deine Datenschutzerklärung verweist.
***
***
# Popup Container
Source: https://docs.dreizack-medien.de/OPC-Plus/Popup-Container
# Allgemeine Beschreibung
Der "Popup-Container" ist ein leistungsstarkes Tool, um gezielte Informationen oder Angebote auf deiner Webseite hervorzuheben und die Interaktion mit den Besuchern zu steigern. Mit seinen vielseitigen Auslösern und der Möglichkeit, individuelle Popups zu erstellen, kannst du sicherstellen, dass die Nachrichten zur richtigen Zeit an die richtigen Besucher gesendet werden.
# Einsatzmöglichkeiten (Inspiration)
* **Angebote und Rabatte:** Präsentiere zeitlich begrenzte Angebote oder spezielle Rabatte, um die Aufmerksamkeit der Besucher zu gewinnen.
* **Newsletter-Anmeldung:** Nutze das Popup, um Besucher zur Anmeldung für deinen Newsletter zu ermutigen und ihnen einen Anreiz zu bieten.
* **Wichtige Mitteilungen:** Zeige wichtige Mitteilungen, wie z.B. Betriebsunterbrechungen oder besondere Ereignisse, um sicherzustellen, dass die Besucher gut informiert sind.
* **Produktneuheiten:** Stelle neue Produkte oder Dienstleistungen in einem Popup vor, um das Interesse der Besucher zu wecken.
# Featureübersicht:
* **Individuelle Popup-Erstellung:** Erstelle ein maßgeschneidertes Popup mit spezifischen Inhalten und einem ansprechenden Design.
* **OPC-Portlet-Befüllung:** Fülle das Popup mit OPC-Portlets, um relevante Informationen oder Angebote anzuzeigen.
* **Verschiedene Auslöser:** Verwende vordefinierte Auslöser wie Verzögerung, Scrollen oder Verlassen der Seite, um das Popup anzuzeigen.
* **Benutzerdefinierte Auslöser:** Ergänze die vordefinierten Auslöser durch die Möglichkeit, das Popup durch einen Button an beliebiger Stelle auf der Webseite manuell auszulösen.
***
# Tutorial
***
# Settings:
## Allgemein
***
**UID:** Diese UID wird automatisch generiert. In der Regel muss hier nicht verändert werden.
Achtung! Wenn du den Block kopiert hast, achte darauf, dass pro Seite jeder Block eine unterschiedliche UID hat
**Auslöser:** Definiere hier den Auslöser für das Popup Auswahl zwischen:
* **Ohne Auslöser - kann durch andere Funktionsbutton geöffnet werden:**
Trage hierfür einfach die UID in den Funktionsbutton ein.
* **Spezieller Button nur für dieses Popup:**
Es wird ein Button an der Stelle des Popups erzeugt, der nur dieses PopUp öffnet und keine andere Funktion annehmen kann
* **ExitIntent - Beim Verlassen des Browserfensters:**
Das Popup löst aus, sobald sich der Mauszeiger Richtung "Verlassen" bewegt
* **Beim Scrollen der Seite zu x%:**
Das Popup öffnet sich sobald zu einer bestimmten Prozentanzahl der Seite gescrollt wurde
* **Nach x Sekunden:**
Das Popup öffnet sich nach einer bestimmten Anzahl von Sekunden auf der jeweiligen Seite
* **Beim Scrollen zu einem bestimmten Element (benötigt ID)**
Das Popup öffnet sich sobald ein bestimmtes anderes Element auf der Seite erreicht ist. Trage dazu einfach die ID des Elements in den Popup-Container ein.
**Speichern, ob Container geschlossen wurde:** Lege fest, ob in den Cookies gespeichert werden soll, ob der Container geschlossen wurde. Wenn aktiviert: Das Popup wird dem Nutzer für die Cookiedauer nicht mehr angezeigt
**Wie viele Tage soll der Cookie gespeichert bleiben:** Lege hier die Dauer fest, wie lange der Cookie für das Popup-Schließen gespeichert werden soll.
Setze die Dauer auf 0, damit der Cookie nur für diese Session gespeichert wird
**Boxschatten aktivieren:** Platziert einen dezenten Schatten hinter dem Popup, damit es besser wahrgenommen wird
***
## Animation
***
**Animationstyp:** Entscheide dich für einen der vielen Animationstypen
**Dauer:** Lege die Dauer der Animation in Sekunden (s) fest.
**Verzögerung:** Definiere die verstriche Zeit bevor die Animation anfängt
**Wiederholung:** Lege die Anzahl der Wiederholungen fest
***
# Product Item Box
Source: https://docs.dreizack-medien.de/OPC-Plus/Product-Item-Box
# Allgemeine Beschreibung
Das "Product Item Box" Portlet zeigt einen oder mehrere frei ausgewählte Artikel in der bekannten Produktkachel-Darstellung an, z. B. um bestimmte Produkte gezielt hervorzuheben.
# Einsatzmöglichkeiten (Inspiration)
* **Einzelne Produkte hervorheben:** Platziere gezielt einzelne Artikel außerhalb von Kategorie- oder Suchergebnislisten, z. B. in Content-Seiten oder Landingpages.
* **Konsistente Darstellung:** Nutze dieselbe Produktkachel-Optik wie in deinen Artikellisten, auch außerhalb dieser Listen.
***
# Settings:
## Produktauswahl
**Suche nach Artikelnamen oder -nummern:** Suche über das Textfeld nach Artikeln und wähle per Klick aus den gefundenen Einträgen die Artikel aus, die angezeigt werden sollen. Über **Alle auswählen** bzw. **Alle abwählen** kannst du die gesamte Trefferliste auf einmal (ab)wählen.
***
## Darstellung
**Design:** Wähle das Design der Produktkachel:
* Clean
* Cards
***
## Strukturierte Daten
**Strukturierte Daten verwenden?** (nur relevant für NIU Plus und Slider mit Item Box Templates): Entfernt bei Bedarf das Microdata Markup, z. B. wenn die Item Box auf Produktseiten platziert werden soll.
Für weitere Einstellungen zum Layout, siehe den Tab **Layout** im Portlet selbst.
***
# Beispiel
So erscheinen die Product Item Boxes im Frontend:
***
# Product Showcase
Source: https://docs.dreizack-medien.de/OPC-Plus/Produkt-Showcase
# Allgemeine Beschreibung
Der "Product Showcase" ist ein elegantes Portlet, um Produktgruppen in einem tab-basierten Layout zu präsentieren. Anstatt mehrere Slider untereinander zu stapeln, können Kunden hier bequem zwischen verschiedenen Kategorien oder Themen (Tabs) umschalten, ohne die Seite scrollen zu müssen. Dies spart Platz und sorgt für eine strukturierte, übersichtliche Darstellung deiner Highlights.
# Einsatzmöglichkeiten (Inspiration)
* **Neuheiten vs. Sale:** Erstelle Tabs für "Neue Kollektion" und "Reduziert", damit Kunden sofort die für sie interessanten Angebote finden.
* **Kategorien-Mix:** Zeige Tabs wie "Wohnzimmer", "Schlafzimmer", "Küche" an, um Bestseller aus verschiedenen Bereichen kompakt zu teasern.
* **Zielgruppen:** Nutze Tabs für "Damen", "Herren", "Kinder".
* **Themenwelten:** "Geschenkideen", "Outdoor", "Home Office" – gruppiere Produkte nach Anlass.
# Featureübersicht:
* **Tab-Navigation:** Intuitive Umschaltung zwischen verschiedenen Produktlisten.
* **Vollständige Design-Kontrolle:** Passe Überschriften, HTML-Tags und Größen individuell an (SEO-freundlich).
* **Flexible Layouts:** Wähle zwischen Boxed- oder Fluid-Containern und verschiedenen Hintergrundstilen.
* **Bewertungen:** Integrierte Option, um Bewertungssterne direkt im Showcase anzuzeigen.
***
# Tutorial
***
# Settings:
## Allgemein
***
**Position der Überschrift und Tabs:** Lege fest, wie die Navigation und der Titel ausgerichtet sein sollen (z. B. "Zentriert").
***
## Überschrift
Hier definierst du den Titel des gesamten Blocks.
**Überschrift des Showcases:** Der Text, der über den Tabs steht (z. B. "Unsere Highlights").
**HTML-Tag der Überschrift:** Wähle aus semantischen Gründen das passende Tag (h1-h6 oder Standard Text/Div). Dies ist wichtig für die SEO-Struktur deiner Seite.
**Größe der Überschrift:** Steuere die optische Größe unabhängig vom HTML-Tag (z. B. "wie ein h1-tag" für große Darstellung, auch wenn es technisch eine h2 ist).
**Textfarbe der Überschrift:** Passe die Farbe an dein Design an.
**Schrift-Dicke:** Wähle den Schriftschnitt (z. B. 800 für Fett/Bold).
***
## Tabs
In diesem Bereich verwaltest du die einzelnen Reiter.
***
**Tabs verwalten:**
* **Hinzufügen (+):** Erstelle einen neuen Tab.
* **Verschieben:** Nutze das Icon rechts, um die Reihenfolge der Tabs per Drag & Drop zu ändern.
* **Löschen (x):** Entferne nicht mehr benötigte Tabs.
* **Benennen:** Gib jedem Tab einen eindeutigen Namen (z. B. "Tab-1", "Tab-2"), der dem Kunden als Klickfläche dient. *Hinweis: Die Produkte für die Tabs werden vermutlich in den Einstellungen des jeweiligen Tabs zugewiesen.*
***
## Darstellung
Hier passt du das Layout und den Hintergrund des Inhaltsbereichs an.
***
**Containergröße in den Tabs:** Bestimme die Breite des Inhalts innerhalb der Tabs.
* *Fluid:* Der Inhalt nutzt die volle Bildschirmbreite.
* *Boxed:* Der Inhalt wird auf eine maximale Breite begrenzt (zentriert).
* *Kein Container:* Der Inhalt hat keine Begrenzung.
**Hintergrundverlauf:** Wähle einen stilvollen Hintergrundeffekt für den aktiven Tab-Bereich.
* *Auswahlmöglichkeiten:* Gold, Bronze, Grau, Transparent.
**Sterne anzeigen:** Aktiviere diese Checkbox, um die Bewertungssterne der Produkte (JTL Bewertungen) direkt in der Vorschau anzuzeigen.
***
# Produkt Slider
Source: https://docs.dreizack-medien.de/OPC-Plus/Produkt-Slider
## 
# Allgemeine Beschreibung
Der "Produkt Slider" ist ein äußerst vielseitiges Portlet, das den Standard-Slider von JTL nahezu überflüssig macht. Mit diesem Slider kannst du die anzuzeigenden Produkte feingranular filtern, basierend auf Kategorien, Herstellern, Artikelbesonderheiten und Preisspannen. Der Slider bietet verschiedene Darstellungsmöglichkeiten sowohl für die einzelnen Kacheln als auch für die Produkte selbst. Zusätzlich kannst du Bewegung und Layout nach deinen Wünschen anpassen.
# Einsatzmöglichkeiten (Inspiration)
* **Produkt-Highlights:** Zeige ausgewählte Produkte aus verschiedenen Kategorien als Highlights, um Kunden auf besondere Angebote aufmerksam zu machen.
* **Saisonale Angebote:** Präsentiere saisonale Produkte oder Sondereditionen in einem auffälligen Slider, um die Aufmerksamkeit der Besucher zu gewinnen.
* **Hersteller-Specials:** Zeige Produkte eines bestimmten Herstellers oder einer Marke in einem Slider, um die Markenpräsenz zu stärken und Kundenloyalität aufzubauen.
# Featureübersicht:
* **Feingranulare Filterung:** Filtere Produkte nach Kategorie, Hersteller, Artikelbesonderheiten und Preisspanne, um genau die Produkte anzuzeigen, die du präsentieren möchtest.
* **Anpassbares Card-Design:** Gestalte das Aussehen der Produktkarten im Slider nach deinen Vorstellungen und passe Farben, Schriftarten und Hintergründe an.
* **Flexible Inhaltsausgabe:** Entscheide, ob die Slides nur mit Bild, Bild und Namen, Bild, Kurzbeschreibung und Preis angezeigt werden sollen
* **Responsives Design:** Der Produkt Slider passt sich verschiedenen Bildschirmgrößen und Geräten an, um eine optimale Darstellung sicherzustellen.
***
# Settings:
## Produktauswahl
***
**Anzahl der Produkte:** Definiere hier die Gesamtanzahl der Produkte im Slider
**Produktreihenfolge beim neu laden mischen:** Wenn aktiviert: Reihenfolge der Produkte wird bei erneutem Laden neu gemischt
**Suche:** Suche explizit nach Artikeln, die in dem Slider angezeigt werden sollen
**Kategorien:** Markiere hier Kategorien, die Artikel enthalten, die im Slider angezeigt werden sollen
**Hersteller:** Markiere hier Hersteller, die im Artikel hinterlegt sind und dessen Produkte angezeigt werden sollen
**Besondere Artikel:** Markiere hier die Artikelbesonderheiten der Artikel, die im Slider angezeigt werden sollen
**Preisspanne:** Definiere hier die Preisspanne in der sich die Artikel bewegen, die angezeigt werden solllen
***
## Darstellung
***
**Design:** Lege hier das Design des Sliders fest Auswahl zwischen:
* Clean
* Bordered
* Cards
**Darstellung:** Lege hier die Darstellung der Produkte fest Auswahl zwischen:
* Einfacher Slider mit Bildern
* Slider mit Namen und Preisen
* Slider mit Namen, Kurzbeschreibung und Preisen
**Vor- und Zurückbutton anzeigen?:** Lege fest ob Indikatoren für das Scrollen durch den Slider angezeigt werden sollen
**Vor- und Zurückbutton Typ:** Ändere hier die Darstellung der Indikatoren für die Vor- und Zurückbuttons
**Seitenindexierung anzeigen?:** Lege fest, ob im unteren Bereich des Sliders angezeigt werden soll auf welcher Seite des Sliders man sich befindet
***
## Größe und Abstände
***
**Anzahl der sichtbaren Produkt je Displaygröße:** Definiere hier, wieviele Bewertungen gleichzeitig je nach Displaygröße angezeigt werden sollen (XS kleinste; XL größte)
**Anzahl der Slides um die verschoben wird:** Lege fest um wieviele Slides je nach Displaygröße verschoben werden soll (XS kleinste; XL größte)
**Lücke zwischen des Slides:** Definiere wieviel Abstand zwischen den einzelnen Slides sein soll (Standard: 1rem)
**Höhe Slider:** Hier kannst du dem Slider eine feste Höhe zuweisen, damit alle Inhalte immer gut sichtbar sind
***
## Bewegung
***
**Ausrichtung Slider:** Lege fest, ob der Slider von links nach rechts oder von rechts nach links scrollen soll
**Übergangsgeschwindigkeit in ms:** Definiere, wie viel Zeit zwischen dem Wechsel der Slides vergehen soll
**Ziehen per Maus:** Entscheide, ob man die Slides durch Ziehen mit der Maus verschieben kann
**Automatisch abspielen aktivieren:** Lege fest, ob die Slides automatisch durchscrollen sollen
**Abspielinternvall in ms:** Bestimme das Zeitintervall in dem der Slider automatisch verschoben werden soll
Hat nur eine Funktion, wenn automatisches abspielen aktiviert ist!
**Pausieren bei Hover?:** Lege fest, ob das automatisch Scrollen pausiert werden soll, wenn jemand mit der Maus auf dem Slider ist
***
***
# Release Countdown
Source: https://docs.dreizack-medien.de/OPC-Plus/Release-Countdown
# Allgemeine Beschreibung
Der "Release Countdown" ist das ideale Werkzeug für Produkt-Launches (sogenannte "Drops") und Ankündigungen. Er zählt die Zeit herunter, bis ein Artikel offiziell zum Kauf verfügbar ist. Dies baut Spannung und Vorfreude bei den Kunden auf ("Hype") und sorgt dafür, dass alle Kunden zum gleichen Zeitpunkt die Chance haben, limitierte Ware zu ergattern.
**Hinweis:** Die Einstellungen für dieses Portlet werden im Backend vorgenommen.
# Einsatzmöglichkeiten (Inspiration)
* **Produkt-Drops (Sneaker/Mode):** "Verkaufsstart am Samstag um 09:00 Uhr" – Inszeniere limitierte Artikel.
* **Black Friday Start:** Zähle die Zeit bis zum Beginn der großen Rabattschlacht herunter, bevor der Shop für alle geöffnet wird.
* **Pre-Order Phasen:** Kündige an, ab wann Vorbestellungen für neue Technik-Gadgets oder Games möglich sind.
* **Event-Starts:** Nutze den Countdown für den Beginn eines Live-Shopping-Streams.
# Featureübersicht:
* **Warenkorb-Steuerung:** Kann (je nach Einstellung) den "In den Warenkorb"-Button bis zum Ablauf des Timers blockieren oder ausblenden.
* **Automatische Synchronisation:** Greift oft auf das in der JTL-Wawi hinterlegte "Erscheinungsdatum" zu.
* **Echtzeit-Freigabe:** Sobald der Timer 0 erreicht, wird die Kauf-Funktion oft automatisch freigeschaltet (ggf. per Page-Reload).
* **Benachrichtigungs-Option:** Lässt sich oft mit einem "Erinner mich"-Button kombinieren.
***
***
# Request Container
Source: https://docs.dreizack-medien.de/OPC-Plus/Request-Container
# Allgemeine Beschreibung
Der "Request Container" ist ein mächtiges Werkzeug, um Inhalte in deinem Onlineshop dynamisch basierend auf der URL (Internetadresse) zu steuern. Er ermöglicht es dir, bestimmte Bereiche nur dann anzuzeigen (oder auszublenden), wenn ein spezifischer Parameter in der Adresszeile des Browsers vorhanden ist.
Besonders wichtig: Wenn der Container ausgeblendet wird, wird er technisch gar nicht erst geladen ("gerendert"). Das bedeutet, der Inhalt ist im Quellcode nicht sichtbar, was für Performance und Sicherheit sorgt.
# Einsatzmöglichkeiten (Inspiration)
* **Marketing-Kampagnen (UTM):** Zeige Besuchern, die über einen Newsletter-Link oder eine Facebook-Werbung kommen (z.B. `?utm_source=newsletter`), einen speziellen Willkommens-Banner oder Gutscheincode an.
* **A/B Tests:** Teste verschiedene Inhalte, indem du unterschiedliche Links verteilst und so steuerst, welche Kundengruppe welchen Content sieht.
* **Versteckte Inhalte ("Easter Eggs"):** Sende Kunden einen speziellen Link, der eine Überraschung oder ein exklusives Angebot freischaltet, das für normale Shop-Besucher unsichtbar ist.
* **JTL Filter-Reaktionen:** Reagiere auf typische JTL-Filterparameter in der URL, um passenden Content zu spezifischen Filtern anzuzeigen.
# Featureübersicht:
* **URL-Steuerung:** Inhalte reagieren auf Parameter in der Browser-Adresszeile.
* **Performance-Optimierung:** Ausgeblendete Inhalte werden vom Server nicht geladen, was die Ladezeit nicht belastet und den Inhalt vor unbefugtem Auslesen schützt.
* **Flexible Logik:** Du kannst entscheiden, ob Inhalte bei einem Treffer *gezeigt* oder *versteckt* werden sollen.
* **Optionale Werte:** Die Prüfung funktioniert entweder nur auf das Vorhandensein eines Parameters oder auf einen exakten Wert.
***
# Settings:
## Allgemein
***
**Bei Eintreffen der Bedingung ...**: Lege fest, was passieren soll, wenn der Parameter in der URL gefunden wird. Auswahl zwischen:
* ... Container einblenden = Der Inhalt ist standardmäßig unsichtbar und erscheint nur, wenn der Parameter vorhanden ist.
* ... Container ausblenden = Der Inhalt ist standardmäßig sichtbar und verschwindet, wenn der Parameter vorhanden ist.
**Parameter-Name**: Hier trägst du den Namen des Parameters ein, auf den der Shop achten soll. *`Beispiel: In der URL deinshop.de?aktion=sommer ist "aktion" der Parameter-Name.`*
**Parameter-Wert (optional)**:
* **Leer lassen:** Der Container reagiert, sobald der Parameter-Name in der URL steht – egal was dahinter steht.
* **Wert eintragen:** Der Container reagiert nur, wenn Name UND Wert exakt stimmen. *`Beispiel: Trägst du hier "sommer" ein, reagiert der Container nur bei ?aktion=sommer, aber nicht bei ?aktion=winter.`*
***
***
# RichText-Variables
Source: https://docs.dreizack-medien.de/OPC-Plus/RichText-Variables
# Allgemeine Beschreibung
Mit dem "RichText-Variables" Portlet kannst du formatierte Texteingaben (Rich Text) mit dynamischen Inhalten kombinieren. Dir steht ein vollwertiger Texteditor zur Verfügung, in dem du nicht nur klassischen Text verfassen und formatieren, sondern auch Smarty-Variablen (wie z. B. den Kundennamen) und einfache Logiken (wie If-Else-Bedingungen) nutzen kannst.
# Einsatzmöglichkeiten (Inspiration)
* **Persönliche Ansprache:** Begrüße eingeloggte Kunden direkt mit ihrem Vornamen (z. B. "Hallo Max! Schön, dass du da bist!") und zeige Gästen stattdessen einen allgemeinen Text ("Hi! Bitte melde dich an.").
* **Dynamische Hinweise:** Blende spezifische Informationen, Rabattcodes oder Hinweise ein, die sich dynamisch an den jeweiligen Nutzer oder die Session anpassen.
* **SEO-Texte platzsparend einbinden:** Nutze die Ausklapp-Funktion ("Mehr lesen"), um lange Info- oder SEO-Texte in deinem Shop unterzubringen, ohne dass diese das Seitenlayout überladen oder den Kunden beim Scrollen stören.
# Featureübersicht:
* **Integrierter Texteditor:** Formatiere deinen Text ganz einfach über die Werkzeugleiste (fett, kursiv, Listen, etc.), ohne HTML-Kenntnisse zu benötigen.
* **Smarty-Unterstützung:** Binde Shop-Variablen ein und nutze Programmierlogiken direkt im Textfeld, um personalisierte Inhalte auszuspielen.
* **Text einklappen (Read-More):** Kürze sehr lange Textblöcke automatisch auf eine definierte Höhe und lasse deine Kunden den restlichen Text bei Bedarf über einen Button aufklappen.
***
# Settings:
## Allgemein
***
**Text:** Hier findest du den Texteditor, um deine Inhalte zu erstellen und zu formatieren. Neben normalem Text kannst du hier auch dynamischen Code einfügen. *Tipp aus dem Beispielbild:* Du kannst eine Abfrage einbauen, die prüft, ob ein Kunde angemeldet ist. Ist dies der Fall, wird er persönlich mit Vornamen angesprochen. Ist er nicht angemeldet, sieht er einen alternativen Text.
***
## Options
***
**Langen Text kürzen und ausklappbar machen?:** Setze hier ein Häkchen, um sehr lange Texte platzsparend darzustellen. Dein Textblock wird dann auf eine bestimmte Höhe reduziert und der zu lange Text wird vorerst ausgeblendet. Zusätzlich wird (je nach Einstellung) ein Button angezeigt, mit dem der Kunde den kompletten Text aufklappen und lesen kann.
**Maximale Höhe des Textausschnittes:** Falls du die Kürzungsfunktion aktiviert hast, wählst du hier aus dem Dropdown-Menü, wie viel von dem Text anfangs sichtbar sein soll (z. B. "M (10vh)" für einen mittleren Ausschnitt, der sich dynamisch an die Displayhöhe anpasst).
### Button Eigenschaften und Styles
**Button verwenden?:** Lege hier über das Dropdown-Menü fest, ob für die Ausklapp-Funktion ein eigener Button angezeigt werden soll ("Ja" oder "Nein"). Wählst du "Ja", öffnen sich in der Regel weitere Optionen, um den Button-Text (wie z. B. "Weiterlesen") und sein Design an deinen Shop anzupassen.
***
***
# Richtext Plus
Source: https://docs.dreizack-medien.de/OPC-Plus/Richtext-Plus
# Allgemeine Beschreibung
Das "Richtext Plus" Portlet stellt einen umfangreichen RichText-Editor zur Verfügung, der es ermöglicht, Texte und Inhalte flexibel zu gestalten und zu formatieren. Dieses Portlet bietet vielfältige Möglichkeiten zur Erstellung ansprechender Texte und kann für verschiedene Zwecke verwendet werden.
# Einsatzmöglichkeiten (Inspiration)
* **Inhaltserstellung:** Mit dem RichText-Editor können Sie Inhalte wie Artikel, Blog-Beiträge, Produktbeschreibungen oder allgemeine Informationen erstellen und formatieren
* **Textgestaltung:** Nutzen Sie verschiedene Formatierungsoptionen wie Schriftarten, Schriftgrößen, Farben, Listen und Aufzählungen, um Texte ansprechend zu gestalten
# Featureübersicht:
* **Voll ausgestatteter RichText-Editor:** Das Portlet bietet einen umfangreichen RichText-Editor, der Formatierungsoptionen wie Fett, Kursiv, Unterstreichung, Aufzählungen, Nummerierungen und vieles mehr unterstützt
* **Link-Einbettung:** Füge Hyperlinks zu internen oder externen Seiten hinzu, um die Navigation für Besucher zu erleichtern
* **Quellcode:** Neben dem einfachen Text-Editor kann der RichText Plus auch verwendet werden, um beispielsweise HTML-Code zu hinterlegen und Inhalte noch ansprechender darzustellen
***
# Settings:
## Allgemein
***
**Text:** Alle Standardfunktionen eines RichText-Editors; durch wechseln auf Quellcode bekommt man den entsprechenden HTML-Code angezeigt und kann diesen anpassen
***
## Options
***
**Längeren Text kürzen und ausklappbar machen:** Auwahl zwischen:
* nein = der Inhalt wird in voller Länge dargestellt
* ja = der Inhalt wird gekürzt ➝ die Länge kann über das untere Auswahlfeld definiert werden
* S(5vh) = 5% der Bildschirmhöhe
* M(10vh) = 10% der Bildschirmhöhe
* L(20vh) = 20% der Bildschirmhöhe
**Button verwenden:** Auswahl zwischen:
* nein
* ja ➝ \[siehe Button Plus Dokumentation]
***
***
# Sales Countdown
Source: https://docs.dreizack-medien.de/OPC-Plus/Sales-Countdown
# Allgemeine Beschreibung
Das "Sales Countdown" Portlet ermöglicht es dir, zeitlich begrenzte Angebote in deinem Onlineshop mit einem dynamischen Countdown hervorzuheben. Mit diesem Tool kannst du die Dringlichkeit deiner Aktionen steigern und Kunden gezielt auf Sonderangebote aufmerksam machen.
# Einsatzmöglichkeiten (Inspiration)
* **Flash Sales:** Erzeuge Aufmerksamkeit für kurzzeitige Rabattaktionen, die nur für wenige Stunden oder Tage gültig sind.
* **Saisonale Angebote:** Nutze den Countdown für saisonale Abverkäufe wie Black Friday, Winterschlussverkauf oder Jubiläumsaktionen.
* **Lagerabverkauf:** Markiere Restposten als zeitlich begrenztes Sonderangebot, um den Abverkauf zu beschleunigen.
* **Produkt-Launches:** Begleite die Einführung neuer Produkte mit einem zeitlich begrenzten Einführungspreis.
# Featureübersicht:
* **Flexible Produktauswahl:** Wähle Produkte manuell aus oder nutze umfangreiche Filteroptionen wie Kategorien, Hersteller oder Merkmale.
* **Automatisierte Zeitsteuerung:** Steuere den Zeitraum deiner Aktion entweder über ein fix hinterlegtes Enddatum oder direkt über die Sonderpreis-Funktion deiner JTL-Wawi.
* **Visuelle Highlights:** Nutze konfigurierbare Sale-Banderolen (z.B. "Sale" oder "%"), um die Angebote optisch abzuheben.
* **Responsive Darstellung:** Der Countdown und die Produktdarstellung passen sich automatisch an verschiedene Bildschirmgrößen an.
***
# Settings:
## Allgemein
***
**Titel:** Hier legst du den Titel fest, der im Frontend deines Shops über dem Portlet angezeigt wird (z.B. "Sonderangebot").
**Inhalt der Banderole:** Auswahl zwischen:
* Sale
* %
* Nicht anzeigen
***
## Produktauswahl
***
**Anzahl der Produkte:** Bestimme hier über eine Zahleneingabe, wie viele Produkte nacheinander (als Slider) angezeigt werden sollen.
**Quelle des Produkts:** Auswahl zwischen:
* Produkt(e) filtern = Ermöglicht die Einschränkung der angezeigten Artikel nach Kategorien, Herstellern, Merkmalen, Preisspannen oder Bewertungen.
* Nach Artikelnummer(n) oder Name = Erlaubt die gezielte Suche und Auswahl bestimmter Produkte.
**Filteroptionen (bei "Produkt(e) filtern"):**
* **Alle Kategorien:** Filterung nach Shop-Kategorien.
* **Alle Hersteller:** Filterung nach bestimmten Marken.
* **Merkmale:** Filtere nach Artikelzuständen oder speziellen Preistypen (z.B. Staffelpreis, UVP).
* **Besondere Artikel:** Auswahl von Top-Artikeln oder Neuheiten.
* **Preisspanne:** Einschränkung auf ein bestimmtes Budget.
* **Bewertungen:** Anzeige von Produkten ab einer bestimmten Sternebewertung.
* **Verfügbarkeit:** Filterung nach sofort verfügbaren Artikeln.
***
## Zeitraum
***
**Aktionsende:** Hier kannst du ein fixes Enddatum und die Uhrzeit eintragen, an dem die Aktion endet (relevant bei Auswahl "Fixes Enddatum").
**Ausblenden falls Enddatum abgelaufen ist:** Wenn diese Checkbox aktiviert ist, verschwindet das Portlet automatisch aus dem Shop, sobald die Zeit abgelaufen ist.
**Enddatum der Aktion:** Auswahl zwischen:
* Fixes Enddatum = Nutzt das manuell im Portlet eingetragene Datum.
* Enddatum des Sonderpreises = Nutzt automatisch das in der JTL-Wawi hinterlegte Enddatum des Sonderpreises für den jeweiligen Artikel.
***
***
# Script einbinden
Source: https://docs.dreizack-medien.de/OPC-Plus/Script-einbinden
# Allgemeine Beschreibung
Das "Script einbinden" Portlet ermöglicht es dir, vordefinierte Skripte oder Stylesheets (CSS) an gewünschter Stelle in deinem Onlineshop zu platzieren.
Ein besonderes Feature dieses Portlets ist die integrierte Behandlung von Consent-Manager-Einstellungen (Cookie-Hinweise). Du kannst definieren, was dem Kunden angezeigt wird, falls er dem Laden des Skripts (z.B. aus Datenschutzgründen) nicht zugestimmt hat. Anstatt einer leeren Fläche sieht der Kunde dann einen informativen Platzhalter.
# Einsatzmöglichkeiten (Inspiration)
* **Design-Anpassungen (Custom CSS):** Lade spezielle Stylesheets nur auf bestimmten Landingpages, um das Design dort individuell anzupassen, ohne den globalen Shop-Code zu verändern.
* **Externe Widgets:** Binde externe Inhalte ein und stelle sicher, dass diese DSGVO-konform erst nach Zustimmung geladen werden.
* **Hinweis-Management:** Informiere Kunden transparent darüber, warum ein bestimmter Inhalt gerade nicht sichtbar ist (z.B. "Cookies deaktiviert").
# Featureübersicht:
* **Skript-Auswahl:** Einfache Auswahl der gewünschten Ressource aus einer Liste (z.B. Custom Stylesheets).
* **Individualisierbarer Platzhalter:** Volle Kontrolle über Titel, Text und Icon, die angezeigt werden, wenn das Skript blockiert wird.
* **Visuelle Gestaltung:** Wähle passenden Icons aus einer großen Bibliothek, um den Hinweis optisch ansprechend zu gestalten.
* **Styling-Kontrolle:** Option, die Standard-Formatierungen des Portlets zu entfernen, um eigene CSS-Regeln anzuwenden.
***
# Settings:
## Allgemein
***
**Script auswählen:** Hier wählst du aus einer Liste das Skript oder Stylesheet aus, das geladen werden soll.
Wähle hier ein Script aus, welches eingebunden werden soll. Wenn du noch kein Script erstellt hast, kannst du das im Resources Widget auf der JTL Shop Admin Startseite machen.
**Hinweis Titel:** Lege die Überschrift für den Platzhalter-Text fest, der erscheint, wenn das Skript (z.B. aufgrund fehlender Cookie-Zustimmung) nicht geladen werden darf. *Standardwert:* "Cookies deaktiviert:"
Wenn dein Script von Cookies abhängig ist und diese deaktiviert wurden, erscheint ein Hinweis.Wähle hier den Titel für den Hinweis.
**Hinweis Text:** Hier kannst du eine erklärende Nachricht für den Kunden hinterlegen. *Standardwert:* "Dieses Element ist dadurch leider ausgeblendet."
Wenn dein Script von Cookies abhängig ist und diese deaktiviert wurden, erscheint ein Hinweis.Wähle hier eine kurze Erklärung für den Hinweis.
**Icon für Cookiehinweis:** Wähle ein passendes Icon aus der Bibliothek, das neben deinem Hinweistext angezeigt wird (z.B. ein Warnschild oder ein Cookie-Symbol). Du kannst die Suchleiste nutzen, um schneller das richtige Icon zu finden.
**Standard Styles entfernen:**
* **Aktiviert:** Das Portlet lädt keine eigenen CSS-Styles für den Platzhalter-Container. Dies ist nützlich, wenn du das Aussehen komplett selbst über eigenes CSS steuern möchtest.
* **Deaktiviert:** Der Platzhalter wird im Standard-Design des Plugins angezeigt.
***
***
# Section
Source: https://docs.dreizack-medien.de/OPC-Plus/Section
# Allgemeine Beschreibung
Mit dem "Section" Portlet kannst du Abschnitte auf deiner Webseite erstellen und diesen eine minimale Höhe zuweisen. Zusätzlich kannst du einen Boxenschatten verwenden, um deine Inhalte optisch hervorzuheben und ihnen Tiefe zu verleihen.
# Einsatzmöglichkeiten (Inspiration)
* **Übersichtliche Abschnitte:** Nutze das "Section" Portlet, um Inhalte auf deiner Webseite in klar definierten Abschnitten darzustellen, die den Fokus der Besucher auf bestimmte Informationen lenken
* **Hervorgehobene Bereiche:** Verwende es, um bestimmte Bereiche deiner Webseite, wie etwa Angebote, Ankündigungen oder Neuigkeiten, hervorzuheben und ihnen einen visuellen Rahmen zu verleihen
* **Abschnittsübergänge:** Nutze das "Section" Portlet, um Übergänge zwischen verschiedenen Teilen deiner Webseite zu gestalten und den Inhalt optisch zu trennen
# Featureübersicht:
* **Mindesthöhe:** Du hast die Möglichkeit, eine Mindesthöhe für den Abschnitt festzulegen, um sicherzustellen, dass der Inhalt ausreichend Platz hat und gut dargestellt wird
* **Boxenschatten:** Ein Boxenschatten kann hinzugefügt werden, um die Inhalte des Abschnitts optisch hervorzuheben und ihnen Tiefe zu verleihen
* **Kreative Freiheit:** Du kannst Inhalte nach Belieben innerhalb des Abschnitts platzieren und das Erscheinungsbild individuell anpassen
***
# Settings:
## Allgemein
***
**Breite der Section:** Hier legst du fest, wie breit deine Section auf der Seite dargestellt werden soll. Du hast die Auswahl zwischen:
* Boxed klein (Standard Container) = Die Section erhält eine standardmäßige Maximalbreite und wird mittig auf der Seite platziert.
* Boxed groß (Container Fluid XL) = Die Section ist breiter als der Standard-Container, hat aber dennoch eine feste Begrenzung.
* Fluid - volle Bildschirmbreite = Die Section erstreckt sich über die komplette Breite des Bildschirms, ohne Ränder an den Seiten.
Der klassische Standard Container hat auf den meisten Bildschirmgrößen mehr Platz zum Rand und bietet so ein dokumentenähnliches Layout, was auf den meisten kleinen Bildschirmen gut funktioniert und etwas Luft zum Rand lässt. Der große Container richtet je nach Template seine Breite auf 1650px aus und lässt nur auf großen Bildschirmen Luft zum Rand. Der ideale Container für moderne Layouts, die auf allen Bildschirmenn funktionieren. Der Fluid Container geht immer bis zum Rand und eignet sich vereinzelt als Stilmittel für randlose Slider, Heroimages oder ähnliches. Achte hier aber auf ein Layout, welches auch auf großen Bildschirmen funktionieren muss.
**Abstandsloser Container:** Wenn du dieses Häkchen setzt, werden die standardmäßigen Abstände (Paddings/Margins) des Containers entfernt. Der Inhalt schließt dann direkt und bündig mit den Rändern ab.
Wenn aktiv, wird der Standard-Abstand des Containers deaktiviert und vollflächiger Inhalt wird ermöglicht
**HTML-Tag der Section:** Wähle hier das passende HTML-Tag für das umschließende Element aus. Dies ist vor allem für die technische Strukturierung deiner Seite und für Suchmaschinen relevant. Auswahl zwischen:
* section
* div
* span
**Mindest Höhe:** In diesem Feld kannst du eine feste minimale Höhe (z. B. in Pixeln) eintragen. Das stellt sicher, dass deine Section immer eine gewisse Größe behält, selbst wenn nur sehr wenig Text oder Inhalt darin platziert wurde.
**Boxschatten verwenden?:** Aktivierst du diese Option durch Setzen des Häkchens, erhält deine Section einen leichten, optischen Schatten nach außen. Dadurch hebt sie sich plastisch vom restlichen Seitenhintergrund ab.
***
***
# Sichtbarkeitscontainer
Source: https://docs.dreizack-medien.de/OPC-Plus/Sichtbarkeitscontainer
# Allgemeine Beschreibung
Der "Sichtbarkeits-Container" ist ein äußerst flexibles Portlet, mit dem du Bereiche auf deiner Webseite erstellen kannst, die je nach Kundengruppe entweder sichtbar oder ausgeblendet sind. Für die ausgeblendeten Gruppen kannst du alternative Inhalte festlegen. Das Portlet kann mit OPC-Portlets bestückt werden, um spezifische Informationen oder Angebote nur für ausgewählte Kundengruppen anzuzeigen.
# Einsatzmöglichkeiten (Inspiration)
* **Kundenexklusive Angebote:** Biete spezielle Angebote oder Rabatte nur für bestimmte Kundengruppen an, um die Kundenbindung zu stärken.
* **Premium-Inhalte:** Zeige exklusive Inhalte oder Premium-Produkte nur für registrierte und eingeloggte Kunden an.
* **Kundensegmentierung:** Passe deine Marketingbotschaften an verschiedene Kundengruppen an, indem du maßgeschneiderte Inhalte je nach Gruppenzugehörigkeit anzeigst.
* **VIP-Zugang:** Gewähre VIP-Kunden besondere Vorteile und exklusive Informationen, die für andere Besucher nicht sichtbar sind.
# Featureübersicht:
* **Kundenspezifische Sichtbarkeit:** Definiere, welche Kundengruppen den Bereich sehen können und welche Gruppen ihn nicht sehen dürfen.
* **Alternativinhalt:** Für die ausgeblendeten Kundengruppen kannst du alternative Inhalte hinterlegen, die anstelle des ausgeblendeten Bereichs angezeigt werden.
* **OPC-Portlet-Befüllung:** Befülle den sichtbaren Bereich mit OPC-Portlets, um relevante und spezifische Informationen für jede Kundengruppe bereitzustellen.
* **Benutzerfreundliche Segmentierung:** Leicht verständliche Einstellungen ermöglichen es dir, Kunden gezielt anzusprechen, ohne komplexe Konfigurationen vornehmen zu müssen.
***
# Tutorial
***
# Settings:
## Allgemein
***
**Kundengruppen:**
Hier siehst du eine Auflistung aller in deinem Shop aktiven Kundengruppen (z.B. Endkunden, B2B, Händler).
Die Logik funktioniert nach dem Ausschlussprinzip: **Wähle die Gruppen aus, für die der Inhalt NICHT sichtbar sein soll.** Alle ausgeblendeten Kundengruppen bekommen den Alternativ Inhalt präsentiert.
*Beispiele für Auswahlmöglichkeiten:*
* **Endkunden:** Haken setzen = Endkunden sehen den Inhalt nicht.
* **B2B:** Haken setzen = B2B-Kunden sehen den Inhalt nicht.
* **Unangemeldete Besucher:** Haken setzen = Gäste (nicht eingeloggte Nutzer) sehen den Inhalt nicht.
***
# Social Share
Source: https://docs.dreizack-medien.de/OPC-Plus/Social-Share
# 
# Allgemeine Beschreibung
Dieses Portlet bietet deinen Kunden die Möglichkeit, die aktuelle Seite schnell und einfach zu teilen. Entweder es öffnet sich direkt die entsprechende App oder der Link wird als Text in die Zwischenablage kopiert. Der geteilte Inhalte bezieht sich immer auf die aktuelle Seite. So kannst du das Portlet sowohl in deinen Blogbeiträgen als auch auf deinen Produktseiten nutzen.
# Einsatzmöglichkeiten (Inspiration)
* **Schnelles Teilen von Inhalten und Produkten:** Mit diesem Portlet bietest du deinen Kunden die Möglichkeit, die aktuelle Shopseite schnell und unkompliziert über die gängigsten sozialen Medien zu teilen.
# Featureübersicht:
* **Frei Wahl aus verschiedenen Kanälen:** Entscheide selbst, welche Kanäle du deinen Kunden anbieten möchtest, um Inhalte zu teilen
* **Schnelles Teilen der aktuellen Seite:** Der geteilte Link bezieht sich automatisch auf die aktuelle Seite des Besuchers. Wenn du das Portlet bspw. mit unserem Vererber auf verschiedene Seiten überträgst, musst du es nur einmal konfigurieren und nicht für jede einzelne Seite selbst den Link hinterlegen.
***
# Settings:
## Share Buttons
***
**Text auf dem "Teilen"-Link:** Hier kannst du ein passendes Icon für deinen Teilen-Button auswählen. Klicke einfach auf das gewünschte Symbol in der Übersicht. Um schneller das passende Icon zu finden, kannst du auch einen Suchbegriff in das Textfeld ("Type to filter") eingeben.
***
## Darstellung
***
### Plattformen aktivieren
**Wähle hier aus, welche Plattformen du aktivieren möchtest:** Bestimme ganz einfach durch das Setzen von Häkchen, über welche Kanäle deine Kunden die Inhalte deines Shops teilen können. Dir stehen folgende Optionen zur Verfügung:
* Whatsapp
* Telegram
* Twitter
* Facebook
* E-Mail
* Link kopieren
**Größe der Social-Media-Icons in px:** Trage in dieses Feld einen Zahlenwert ein (Standardwert: 23px) um die feste Größe deiner Social-Media-Icons in Pixeln zu definieren. So stellst du sicher, dass sich die Buttons harmonisch in das Design deines Onlineshops einfügen.
***
***
# Störer Container
Source: https://docs.dreizack-medien.de/OPC-Plus/Stoerer-Container
# Allgemeine Beschreibung
Das "Störer Container" Portlet ist ein Container innerhalb eines Grids, in den du beliebige andere Portlets einfügen kannst. Der Inhalt erscheint dann als Störer (hervorgehobenes Element) zwischen den regulären Karten, z. B. in Artikellisten.
# Einsatzmöglichkeiten (Inspiration)
* **Störer in Artikellisten:** Füge ein beliebiges Portlet (z. B. Bild, Text oder Button) in den Container ein, um Hinweise, Angebote oder Ankündigungen zwischen deinen Produktkarten zu platzieren.
* **Responsive Breite:** Steuere je Bildschirmgröße individuell, wie viele Spalten der Container im Grid einnehmen soll.
***
# Settings:
## Allgemein
Wähle hier die Anzahl an Spalten je Displaygröße, innerhalb eines Grids, über die sich das Element erstrecken soll. Erlaubte Werte sind 1-5.
* **\<576px:** Spaltenanzahl für sehr kleine Bildschirme.
* **>576px:** Spaltenanzahl ab kleinen Bildschirmen (SM).
* **>768px:** Spaltenanzahl ab mittleren Bildschirmen (MD).
* **>992px:** Spaltenanzahl ab großen Bildschirmen (LG).
* **>1200px:** Spaltenanzahl ab sehr großen Bildschirmen (XL).
***
***
# Strukturierte Daten-Container
Source: https://docs.dreizack-medien.de/OPC-Plus/Strukturierte-Daten-Container
# Allgemeine Beschreibung
Mit dem "Strukturierte Daten-Container" ermöglichst du Google (und anderen Suchmaschinen) das richtige Auslesen bzw. indexieren deiner Daten. Innerhalb dieses Containers kannst du beliebig vielle Fragen & Antworten mit unserem [FAQ-Portlet](https://app.clickup.com/4655718/v/dc/4e2k6-13450/4e2k6-14390) platzieren. Achte aber unbedingt darauf, dass pro Seite nur ein "Strukturierte Daten-Container" verwendet wird, damit deine Daten richtig ausgelesen bzw. indexiert werden können.
# Featureübersicht:
* Google (und anderen Suchmaschinen) ermöglichen, deine hinterlegten Daten richtig auszulesen bzw. zu indexieren
***
# Settings:
## Allgemein
\[DEPRECATED] Manche Portlets wie das FAQ Portlet benötigen ein einzelnes Element als Container, welches bezeichnet, um welchen Datentypen es sich folgend handelt. Alle FAQ Elemente müssen beispielsweise einer FAQ Page angehören. Hier kannst du einen Container erstellen, der mehrere FAQ Elemente enthält, damit diese von Google korrekt eingelesen werden können. Bitte beachte, dass du für einen FAQPage Container nur ein mal pro Seite haben darfst. Benutzt du mehrere Container des gleichen Typs, wertet Google das als Fehler.
***
**Datentyp:** Wähle hier den richtigen Datentyp für deine hinterlegten Inhalte.
***
***
Wir haben uns für ein JSON LD Markup entschieden, welches sich besser mit anderen Seitentypen verträgt. Der Strukturierte Daten Container ist nicht mehr notwendig. Lasse diese Funktionen deaktiviert. Solltest du Probleme mit dem Markup haben, kannst du es hier wieder aktivieren. Das JSON LD wird in dem Fall deaktiviert und du musst deine Fragen weiterhin in einem Strukturierte Daten Container aufbewahren.
***
***
# Text Content Box
Source: https://docs.dreizack-medien.de/OPC-Plus/Text-Content-Box
# Allgemeine Beschreibung
Die "Text Content Box" ist ein vielseitiges Portlet, das speziell zur strukturierten Darstellung von Textinhalten entwickelt wurde. Es besteht aus einer Überschrift, einem Untertitel, einer Trennlinie und einem Textinhalt, um Informationen klar und ansprechend zu präsentieren.
# Einsatzmöglichkeiten (Inspiration)
* **Produktvorstellungen:** Nutze die "Text Content Box", um Produkte oder Dienstleistungen mit einer aussagekräftigen Überschrift, einem Untertitel und informativem Textinhalt vorzustellen
* **Anleitungen und Erklärungen:** Erstelle Anleitungen oder informative Abschnitte, indem du klare Überschriften, Untertitel und gut strukturierte Textinhalte verwendest
* **Storytelling:** Verwende die "Text Content Box", um Geschichten zu erzählen oder Hintergrundinformationen über dein Unternehmen zu teilen
# Featureübersicht:
* **Strukturierte Darstellung:** Die "Text Content Box" ermöglicht eine strukturierte Darstellung von Informationen mit klaren Überschriften und Untertiteln, um die Lesbarkeit zu verbessern
* **Trennlinie:** Eine Trennlinie kann verwendet werden, um visuell zwischen der Überschrift/Untertitel und dem Textinhalt zu trennen und eine klare Abgrenzung zu schaffen
***
# Settings:
## Allgemein
***
**Untertitel:** Trage hier den Textinhalt des Untertitels ein
**Typ Untertitel:** Wähle den Typ des Untertitels, den Suchmaschinen beim Indexieren "erkennen" sollen
**Größe Untertitel:** Lege die tatsächliche Größe des Untertitels fest (h1 kleinste, h6 größte)
**Farbe des Untertitels:** Setze die Textfarbe für den Untertitel
**Position des Untertitels:** Auswahl zwischen:
* über Überschrift
* unter Überschrift
* unter Trennlinie
**Überschrift:** Trage hier den Textinhalt des Überschrift ein
**Typ Überschrift:** Wähle den Typ der Überschrift, den Suchmaschinen beim Indexieren "erkennen" sollen
**Größe Überschrift:** Lege die tatsächliche Größe des Überschrift fest (h1 kleinste, h6 größte)
**Farbe des Überschrift:** Setze die Textfarbe für den Überschrift
**Position:** Auswahl zwischen:
* links
* zentriert
* rechts
***
## Elemente
***
**Linie Position:** Auswahl zwischen:
* left = linksbünding
* center = zentriert
* right = rechtsbündig
**Linie Farbe:** Lege die Farbe der Trennlinie fest. Entweder per Colorpicker oder mithilfe von RGB-Werten
**Linie Dicke in px:** Lege die Dicke der Trennlinie in Pixeln fest. 0 sorgt dafür, dass keine Trennlinie angezeigt wird
**Linie Breite in %:** Lege die Breite der Linie fest. Die Prozentanzahl bezieht sich dabei auf die gesamte Breite des Portlets (nicht der Bildschirmbreite)
***
***
# Textwrapper
Source: https://docs.dreizack-medien.de/OPC-Plus/Textwrapper
# Allgemeine Beschreibung
Der "Textwrapper" dient als intelligenter Container zur Erstellung von variablen Texten in deinem Onlineshop. Er ermöglicht es dir, statischen Fülltext spielend leicht mit dynamischen Inhalten (wie z. B. Smarty Portlets) zu kombinieren. So kannst du personalisierte und dynamische Textelemente erzeugen, völlig ohne eigene Smarty-Code-Kenntnisse oder Programmieraufwand.
# Einsatzmöglichkeiten (Inspiration)
* **Persönliche Kundenansprache:** Kombiniere ein normales Textfeld (z. B. "Herzlich willkommen zurück, ") mit einem Smarty-Portlet, das den Vornamen des angemeldeten Kunden ausgibt.
* **Dynamische Hinweistexte:** Erstelle Sätze, die sich dynamisch an den Kunden anpassen, wie etwa "Du hast aktuell X Treuepunkte in deinem Konto", indem du statischen Text um eine dynamische Punkte-Variable herum baust.
* **Flexible Kategorie-Texte:** Baue strukturierte SEO-Texte auf, die automatisch den jeweiligen Kategorienamen an der passenden Stelle im Fließtext einfügen.
# Featureübersicht:
* **No-Code Dynamik:** Erstelle komplexe, variable Texte ganz ohne Programmierkenntnisse.
* **Nahtlose Kombination:** Verknüpfe ganz einfach statischen Fließtext mit dynamischen Shop-Variablen (Smarty Portlets) in einem gemeinsamen Container.
* **Hohe Flexibilität:** Nutze den Wrapper überall dort, wo sich Inhalte je nach Kunde oder aufgerufener Seite automatisch anpassen sollen.
***
# Settings:
## Allgemein
In diesem Reiter nimmst du keine direkten Einstellungen vor.
***
Dieser Block dient der Erstellung von variablen Texten. Verwende in diesem Block eine Kombination aus Smarty Portlets und Fülltext, um so dynamischen Inhalt zu erzeugen ohne Smarty Code programmieren zu müssen.
*Tipp für die Praxis: Der Textwrapper dient im OPC (OnPage Composer) in erster Linie als schützende "Hülle" (Container). Du ziehst im Editor einfach deine gewünschten Text-Elemente und Variablen in diesen Wrapper hinein, um den fertigen dynamischen Satz zusammenzubauen.*
***
***
# Time Container
Source: https://docs.dreizack-medien.de/OPC-Plus/Time-Container
# Allgemeine Beschreibung
Dieses Portlet ermöglicht es, Inhalte zu bestimmten Zeiten automatisch anzuzeigen oder zu verbergen. Dies ist besonders nützlich für zeitlich begrenzte Angebote, saisonale Kampagnen oder zeitgesteuerte Ankündigungen. Du kannst mehrere Container anlegen und jeden Container mit einem Startdatum und einer Uhrzeit versehen, um die Sichtbarkeit zu steuern.
# Einsatzmöglichkeiten (Inspiration)
* **Flash Sales:** Verwende dieses Portlet, um zeitlich begrenzte Angebote automatisch zu starten und zu beenden.
* **Saisonale Angebote:** Plane saisonale Promotions und lasse sie automatisch erscheinen, wenn die Zeit reif ist.
* **Events und Ankündigungen:** Zeige bevorstehende Events oder wichtige Ankündigungen genau dann an, wenn sie relevant sind.
* **Sonderaktionen:** Steuere die Sichtbarkeit von Sonderaktionen oder Rabatten basierend auf deinen Verkaufsstrategien.
* **Feiertagsgrüße:** Automatisiere die Anzeige von Feiertagsgrüßen und speziellen Inhalten zu festgelegten Zeiten.
# Featureübersicht:
* **Einfache Zeitsteuerung:** Lege genau fest, wann Inhalte angezeigt oder verborgen werden sollen.
* **Automatische Aktivierung:** Inhalte werden basierend auf den festgelegten Zeiten automatisch aktiviert oder deaktiviert.
* **Unendliche Aktivität:** Container ohne nachfolgenden zeitgesteuerten Container bleiben dauerhaft aktiv.
* **Leere Container:** Füge leere Container hinzu, um an bestimmten Tagen keine Inhalte anzuzeigen.
***
# Settings:
## Allgemein
***
#### Format
Das Format für das Anlegen eines zeitgesteuerten Containers ist Jahr-Monat-Tag-Stunde-Minute. Dies muss genau eingehalten werden, um eine korrekte Funktion zu gewährleisten. Beispiele:
* 2024-06-31-02-03
* 2024-07-03-15-30 Achte darauf, dass Monat, Tag, Stunden und Minuten immer 2-stellig sein müssen und die Uhrzeit im 24-Stunden-Format geschrieben wird.
#### Anwendung
1. **Startzeit festlegen:** Das Datum des Containers ist die Startzeit, ab der dieser Container sichtbar wird.
2. **Darstellung:** Der Container mit dem spätesten Datum, welches nicht in der Zukunft liegt, wird dargestellt.
3. **Leere Container:** Möchtest du, dass ab einem Tag X nichts mehr angezeigt wird, dann füge einen Container hinzu mit dem Datum, aber im OPC keinen Inhalt in den Container ein.
4. **Endlos aktive Container:** Folgt kein Container hinter deinem letzten Container mit einer späteren Zeit, dann bleibt dieser unendlich aktiv.
### Bedienung und Funktionsweise
1. **Container anlegen:** Gehe zu deinem OPC Editor und füge einen neuen zeitgesteuerten Container hinzu. Trage das gewünschte Datum und die Uhrzeit im richtigen Format ein.
2. **Inhalt einfügen:** Füge den gewünschten Inhalt in den Container ein, der zu dem festgelegten Zeitpunkt angezeigt werden soll.
3. **Zusätzliche Container hinzufügen:** Nach Bedarf kannst du jetzt noch zusätzliche Container hinzufügen, die zu einem späteren Zeitpunkt aktiviert werden sollen. *Siehe mehr unter Anwendung.*
4. **Speichern:** Speichere die Änderungen und der Container wird zur festgelegten Zeit automatisch aktiviert.
***
***
# Titel Box
Source: https://docs.dreizack-medien.de/OPC-Plus/Titel-Box
# Allgemeine Beschreibung
Das "Titel Box" Portlet ermöglicht es dir, auffällige Titelboxen auf deiner Webseite zu erstellen. Du kannst einen Titel vergeben, die Farbe des Titels individuell anpassen, die Hintergrundfarbe der Titelbox festlegen und ein Icon hinzufügen. Es stehen zahlreiche vorgefertigte Icons zur Verfügung, deren Farbe ebenfalls anpassbar ist.
# Einsatzmöglichkeiten (Inspiration)
* **Angebote und Aktionen:** Hebe Angebote, Sonderaktionen oder Rabatte mit ansprechenden Titelboxen hervor, die auffällige Icons und passende Farben enthalten
* **Serviceübersichten:** Nutze die Titelboxen, um deine Dienstleistungen oder Produkte in einer klaren und ansprechenden Weise zu präsentieren
* **Feature-Highlights:** Betone wichtige Funktionen oder Features deiner Produkte oder Dienstleistungen mit auffälligen Titelboxen
# Featureübersicht:
* **Anpassbarer Titel:** Du kannst einen individuellen Titel vergeben, um die Botschaft deiner Titelbox klar zu kommunizieren
* **Farbanpassung für Titel:** Die Farbe des Titels kann nach deinen Wünschen angepasst werden, um zum Gesamtdesign deiner Webseite zu passen
* **Hintergrundfarbe:** Du kannst die Hintergrundfarbe der Titelbox festlegen, um die visuelle Wirkung zu verstärken und den Inhalt hervorzuheben
* **Icons:** Wähle aus einer breiten Auswahl vorgefertigter Icons und passe die Farbe des Icons an, um deinen Anforderungen gerecht zu werden
* **Kreative Gestaltungsfreiheit:** Mit dem "Titel Box" Portlet kannst du beeindruckende Titelboxen erstellen, die deinen Inhalt wirkungsvoll präsentieren und visuell ansprechend sind
***
# Settings:
## Allgemein
***
**Titel:** Legt den Textinhalt der Titel Box fest
**Hintergrundfarbe Tiitelleiste:** Definiert die Hintergrundfarbe der Titel Box. Auswahl entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
**Textfarbe Titelleiste:** Definiert die Textfarbe des hinterlegten Titels. Auswahl entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
**Icon verwenden:** Auswahl zwischen:
* Nein = Kein Icon wird verwenden
* Ja = Ein Icon wird vor dem hinterlegten Titel platziert; ist dieser leer so wird nur das Icon angezeigt
* **Icon** = Auswahl des Icons
* **Icon Farbe =** Auswahl der Farbe des Icons entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
***
***
# Tutorials
Source: https://docs.dreizack-medien.de/OPC-Plus/Tutorials
Video-Anleitungen für DZM OPC Plus
# Videotutorials
Lerne OPC Plus in unseren Video-Tutorials kennen. Wir zeigen dir Schritt für Schritt, wie du die verschiedenen Portlets einrichtest und optimal nutzt.
Erste Schritte mit OPC Plus - Eine umfassende Einführung in alle Features
Detaillierte Anleitungen zu den einzelnen Portlets
Tabellen im JTL-Shop erstellen – ganz ohne HTML
Newsticker mit dem OnPage-Composer in deinem JTL-Shop
Infos/USPs als Icon und Text mit dem JTL OnPage-Composer
Logos als Slider mit dem OnPage-Composer in deinem JTL-Shop
Call-to-Action Buttons mit dem OnPage-Composer
Inhalte als Pop-Up darstellen mit dem OnPage-Composer
Kategorien aus der JTL-Wawi als Slider im OnPage-Composer
Hintergründe, Höhenoptionen und mehr im OPC (Container Plus V3)
Tab-basierte Inhalte mit dem OnPage-Composer
Kunden die Markensuche erleichtern
OPC-Inhalte gezielt nach Kundengruppe anzeigen
Optimale Darstellung auf allen Endgeräten
Bilder, Banner, Teaser – unendlich viele Einsatzmöglichkeiten
Weitere Tutorials werden regelmäßig hinzugefügt. Abonniere unseren YouTube-Kanal, um keine Updates zu verpassen!
# USP-Line
Source: https://docs.dreizack-medien.de/OPC-Plus/USP-Line
# Allgemeine Beschreibung
Das "UPS-Line" Portlet bietet eine effektive Möglichkeit, die einzigartigen Verkaufsargumente deines Unternehmens oder deiner Angebote hervorzuheben und sie visuell ansprechend zu präsentieren. Mit individuellen Icons und anpassbaren Farben kannst du sicherstellen, dass deine USPs optimal zur Geltung kommen.
# Einsatzmöglichkeiten (Inspiration)
* **Produktvorteile:** Verwende das "UPS-Line" Portlet, um die wichtigsten Vorteile und Eigenschaften deiner Produkte oder Dienstleistungen hervorzuheben
* **Dienstleistungsübersicht:** Präsentiere eine Übersicht deiner Dienstleistungen oder Angebote mit klaren USPs, um potenzielle Kunden zu überzeugen
* **Unternehmensphilosophie:** Betone die Kernwerte und die Philosophie deines Unternehmens durch ansprechende USP-Elemente
* **Angebotsübersicht:** Zeige die wichtigsten Merkmale und Vorteile deiner Angebote auf einen Blick, um die Aufmerksamkeit deiner Besucher zu gewinnen
# Featureübersicht:
* **Mehrere USP-Elemente:** Du kannst mehrere Unique Selling Propositions angeben, die in einer horizontalen Linie angezeigt werden
* **Einzelnes Icon:** Wähle ein einzelnes Icon aus einer Auswahl vorgefertigter Icons aus, das vor den USP-Elementen angezeigt wird
* **Anpassbare Icon-Farbe:** Passe die Farbe des Icons nach deinen Wünschen an, um es perfekt in das Design deiner Webseite zu integrieren
***
# Settings:
## Allgemein
***
**USP:** Trage hier deine USP-Items ein. Durch Klicken auf das weiße Kreuz entfernst du das jeweilige USP. Durch Klicken auf das blaue Plus fügst du neue hinzu.
**Icon verwenden:** Auswahl zwischen:
* Nein = Kein Icon wird verwenden
* Ja = Ein Icon wird vor dem hinterlegten Titel platziert; ist dieser leer so wird nur das Icon angezeigt
* **Icon** = Auswahl des Icons
* **Icon Farbe =** Auswahl der Farbe des Icons entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
***
***
# Überschrift Plus
Source: https://docs.dreizack-medien.de/OPC-Plus/Ueberschrift-Plus
## 
# Allgemeine Beschreibung
Das "Überschrift Plus" Portlet ermöglicht dir die Erstellung ansprechender und individuell gestalteter Überschriften und Untertitel, die deine Webseite professionell und attraktiv erscheinen lassen. Nutze die vielfältigen Anpassungsoptionen, um deinen Inhalten den gewünschten visuellen Ausdruck zu verleihen.
# Einsatzmöglichkeiten (Inspiration)
* **Abschnittsüberschriften:** Verwende das "Überschrift Plus" Portlet, um Abschnitte auf deiner Webseite mit ansprechenden Überschriften und Untertiteln zu versehen, die den Inhalt klar strukturieren
* **Produktpräsentation:** Betone Produkte oder Dienstleistungen mit individuell gestalteten Überschriften und Untertiteln, die deine Botschaft unterstreichen
* **Feature-Highlights:** Hervorhebung von Funktionen, Vorteilen oder Angeboten durch auffällige Überschriften und Untertitel
# Featureübersicht:
* **Anpassbare Überschriften und Untertitel:** Du kannst die Schriftdicke, den Überschriftstyp, die Textfarbe und die horizontale Ausrichtung sowohl für Überschriften als auch für Untertitel individuell festlegen
* **Position des Untertitels:** Du hast die Freiheit, die Position des Untertitels zu wählen - unter der Überschrift, über der Überschrift oder unterhalb einer anpassbaren Trennlinie
* **Trennlinie:** Definiere die Trennlinie nach deinen Wünschen, einschließlich Dicke, Farbe, horizontaler Ausrichtung, Breite und Möglichkeit zur Deaktivierung der Trennlinie
***
# Settings:
## Allgemein
***
**Überschrift Inhalt:** Legt den Textinhalt der Überschrift fest
**HTML-Tag der Überschrift:** Bestimmt den HTML-Tag der Überschrift. Also wie er von Suchmaschinen indexiert wird
**Größe der Überschrift:** Bestimmt die tatsächliche Größe der Überschrift (h1 größte, h6 kleinste)
**Textfarbe der Überschrift:** Definiert die Farbe der Überschrift. Auswahl entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
**Schriftdicke:** Bestimmt die Dicke der Überschrift
**Position:** Definiert die horizontale Position der Überschrift (links, zentriert oder rechts)
**Untertitel Inhalt:** Legt den Textinhalt des Untertitels fest
**HTML-Tag des Untertitels:** Bestimmt den HTML-Tag des Untertitels. Also wie er von Suchmaschinen indexiert wird
**Größe des Untertitels:** Bestimmt die tatsächliche Größe des Untertitels (h1 größte, h6 kleinste)
**Textfarbe des Untertitels:** Definiert die Farbe des Untertitels. Auswahl entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
**Schriftdicke:** Bestimmt die Dicke des Untertitels ´
**Position des Untertitels:** Definiert, wo der Untertitel ausgegeben werden soll.
\*\*Standard Abstände deaktivieren: \*\*Hier kannst du die bereits hinterlegten Abstände deaktivieren.
***
## Elements
***
**Linie Position:** Bestimmt die horizontale Ausrichtung der Trennlinie (links, zentriert oder rechts)
**Linie Farbe:** Definiert die Farbe der Trennlinie. Auswahl entweder per ColorPicker oder durch Hinterlegen von RGB-Farbwerten
**Linie Dicke in px:** Legt die Dicke der Trennlinie in Pixeln fest. 0 = deaktivieren der Trennlinie
**Linie Breite in %:** Legt die Breite der Trennlinie in % fest. 100% = maximale Breite
***
***
# Versand Countdown
Source: https://docs.dreizack-medien.de/OPC-Plus/Versand-Countdown
# Allgemeine Beschreibung
Das "Versand Countdown" Portlet zeigt deinen Kunden dynamisch an, wie viel Zeit ihnen noch bleibt, um eine Bestellung aufzugeben, damit diese noch am selben Tag versendet wird. Dies schafft Vertrauen und Dringlichkeit.
***
**Hinweis:** Die Einstellungen für dieses Portlet werden im Backend vorgenommen.
# Einsatzmöglichkeiten (Inspiration)
* **Conversion-Steigerung:** Die ablaufende Zeit ("Bestelle innerhalb von 2 Std...") motiviert Kunden, den Kauf sofort abzuschließen.
* **Transparenz:** Kunden wissen genau, wann ihre Ware das Lager verlässt.
* **Service-Versprechen:** Hebe deine schnellen Logistikprozesse hervor.
***
***
# Portlet: Video Block
Source: https://docs.dreizack-medien.de/OPC-Plus/Video-Block
# Allgemeine Beschreibung
Das "Video Block" Portlet bietet eine einfache und effektive Möglichkeit, Videos in deinen JTL-Shop zu integrieren und die visuelle Darstellung deiner Produkte oder Dienstleistungen zu verbessern. Mit seinen vielseitigen Optionen kannst du sicherstellen, dass die Videos nahtlos in dein Webdesign passen und Besucher auf überzeugende Weise ansprechen.
# Einsatzmöglichkeiten (Inspiration)
* **Produktvorstellungen:** Präsentiere deine Produkte durch Videos, um ihre Funktionen und Vorteile auf anschauliche Weise zu zeigen.
* **Tutorials und Anleitungen:** Teile informative Videos, die deine Kunden durch die Verwendung deiner Produkte führen oder ihnen Tipps und Tricks geben.
* **Kundenbewertungen:** Zeige Videos von zufriedenen Kunden oder Experten, um Vertrauen in deine Marke oder Produkte zu stärken.
* **Veranstaltungsberichte:** Teile Videos von Events, Messen oder anderen Veranstaltungen, um Kunden einen Einblick in dein Unternehmen zu geben.
# Featureübersicht:
* **Flexible Einbettung:** Integriere Videos durch verschiedene Methoden wie Links, Einbettungscodes oder Hochladen, um maximale Flexibilität zu bieten.
* **Vorschaubild:** Lege ein ansprechendes Vorschaubild für das Video fest, das Besucher zum Abspielen des Videos anregt.
* **Play-Button-Anpassung:** Passe die Farbe des Play-Buttons an, um ihn perfekt in das Design deiner Webseite zu integrieren.
***
# Settings:
## Allgemein
***
**Vorschaubild:** Klicke auf das angezeigte Bild, um ein eigenes Vorschaubild (Thumbnail) für dein Video aus der Mediathek auszuwählen oder ein neues hochzuladen. Dieses Bild sehen deine Kunden als Platzhalter, bevor sie das Video abspielen.
**Alternativ Text:** Trage hier eine kurze Beschreibung des Vorschaubildes ein. Dies ist wichtig für die Barrierefreiheit und hilft Suchmaschinen (SEO) dabei, den Inhalt zu verstehen, falls das Bild aus technischen Gründen einmal nicht geladen werden sollte.
**Title Tag:** Gib hier einen kurzen Titel für dein Vorschaubild ein. Dieser Text erscheint in der Regel als kleiner Hinweis (Tooltip), wenn ein Besucher mit der Maus über das Bild fährt.
Wenn du eine fixe Höhe wählst, wird das Bildformat ignoriert. Fixe Höhe bitte mit Einheit angeben (zBsp.: 300px, 40vh)
**Bildformat:** Bestimme hier das Seitenverhältnis deines Videos, in dem es standardmäßig angezeigt werden soll (z. B. "16 / 9" für das klassische Breitbildformat).
**Fixe Höhe:** Falls du dem Video eine feste, unveränderliche Höhe geben möchtest, trage diese hier ein, dabei wird das Bildformat ignoriert. Vergiss dabei nicht, eine entsprechende CSS-Einheit mit anzugeben (wie z. B. 300px oder 40vh).
**Video stummschalten:** Wenn du dieses Häkchen setzt, wird das Video beim Abspielen standardmäßig ohne Ton (Mute) gestartet.
**Video automatisch wiederholen:** Ist diese Option aktiv, wird das Video in einer Endlosschleife abgespielt (Loop) und beginnt nach dem Ende automatisch wieder von vorn.
**Video Quelle:** Lege über das Dropdown-Menü fest, woher dein Video bezogen wird. Du hast die Auswahl zwischen:
* link = Nutze diese Option, um direkt auf eine externe Videodatei (URL) zu verweisen.
* eingebettet = Wähle dies für Videos, die über einen iFrame-Code eingebunden werden (z. B. von YouTube oder Vimeo).
* hochladen = Wähle diese Option, wenn du eine Videodatei direkt aus den Medien deines Shops laden möchtest.
**Video URL:** Trage hier – passend zu deiner vorherigen Auswahl bei "Video Quelle" – den genauen Link, den Einbettungscode oder den Dateipfad zu deinem Video ein.
**Button Farbe:** Wähle hier über den Color-Picker (oder durch Eingabe eines Hex-Codes wie z. B. #525252) eine individuelle Farbe für den Play-Button aus, damit er sich optimal in dein Shop-Design einfügt.
***
***
# Video Hero
Source: https://docs.dreizack-medien.de/OPC-Plus/Video-Hero
# Allgemeine Beschreibung
Das "Video Hero" Portlet ist ideal, um deine Kunden direkt beim Betreten deines Onlineshops mit einem großflächigen, emotionalen Video im Kopfbereich (Hero-Sektion) zu begrüßen. Du kannst Texte, Call-to-Action-Buttons und Farbüberlagerungen nutzen, um deine Botschaft perfekt in Szene zu setzen und sofort Aufmerksamkeit zu generieren.
# Einsatzmöglichkeiten (Inspiration)
* **Startseiten-Hero:** Nutze ein beeindruckendes Hintergrundvideo direkt oben auf deiner Startseite, um den perfekten ersten Eindruck von deiner Marke zu vermitteln.
* **Emotionale Kampagnen:** Präsentiere neue Kollektionen, Produkt-Launches oder saisonale Highlights mit bewegten Bildern und einem direkten Link zur Aktionsseite.
* **Storytelling:** Erzähle die Geschichte hinter deinen Produkten durch ein stimmungsvolles Video, auf dem du deine wichtigste Kernbotschaft als Text platzierst.
# Featureübersicht:
* **Vollflächige Videos:** Binde Videos per Link oder Upload ein und steuere die Höhe flexibel für alle Geräte (z. B. über dynamische vh-Werte).
* **Integrierte Textinhalte:** Lege aussagekräftige Überschriften und Fließtexte direkt über das Video.
* **Auffällige Call-to-Actions:** Nutze hochgradig anpassbare Buttons, um Besucher gezielt auf wichtige Seiten zu lenken.
* **Darstellungs-Optionen:** Nutze anpassbare Farb-Overlays, um sicherzustellen, dass deine Texte auf dem Bewegtbild immer gut lesbar bleiben.
***
# Settings:
## Videos
***
**Quelle:** Wähle hier aus, wie dein Video eingebunden werden soll. Du hast die Auswahl zwischen:
* **Link** = Füge eine externe URL (z. B. von einem Cloud-Speicher oder Server) zu deiner Videodatei ein.
* **Hochladen** = Lade eine Videodatei direkt aus den Dateien in deinen Shop.
**Video URL:** Trage hier, abhängig von deiner zuvor gewählten Quelle, den direkten Link oder den Dateipfad zu deinem Hauptvideo ein.
**Vorschauvideo URL:** Hier kannst du optional einen Link für ein kürzeres oder komprimierteres Vorschauvideo eintragen.
***
## Textinhalte
***
**Überschrift:** Gib hier eine prägnante Überschrift ein, die prominent und groß über deinem Video angezeigt wird.
**Text:** Über den integrierten Texteditor kannst du einen zusätzlichen Beschreibungstext frei formatieren, der unter der Überschrift auf dem Video erscheint.
**Playbutton text:** Falls du einen Playbutton verwendest, kannst du hier den Text eintragen, der für den Abspiel-Button angezeigt werden soll (z. B. "Video abspielen").
***
## Button
***
### Button Eigenschaften und Styles
**Button verwenden?:** Lege hier über das Dropdown-Menü fest, ob ein klickbarer Button auf deinem Video Hero angezeigt werden soll ("Ja" oder "Nein").
**Button als Link oder Funktionsbutton verwenden?:** Bestimme die Art des Buttons. Ein Linkbutton verweist klassisch auf eine Ziel-URL, während ein Funktionsbutton dafür genutzt werden kann, bestimmte Events im Shop (wie z. B. ein Pop-up) auszulösen.
**Buttonlink:** Trage hier die genaue Ziel-URL ein, zu der der Kunde nach dem Klick geleitet werden soll.
**Button Text:** Gib den Text ein, der auf dem Button stehen soll (z. B. "Mehr erfahren" oder "Jetzt entdecken").
**Button Typ:** Wähle den optischen Stil deines Buttons (z. B. "Full" für einen komplett ausgefüllten Button).
**Button Farbe:** Bestimme die Grundfarbe des Buttons (z. B. Primary), die aus deinem Shop-Template bezogen wird.
**Button Breite:** Wähle, ob sich die Breite an den Inhalt anpasst ("Content Width") oder ob der Button vollflächig dargestellt wird.
### Button Ausrichtung nach Breakpoints
Hier kannst du die Ausrichtung deines Buttons (links, zentriert, rechts) ganz detailliert für verschiedene Bildschirmgrößen festlegen, um ein perfektes responsives Design zu garantieren:
* **XS:** Sehr kleine Bildschirme (Smartphones)
* **SM:** Kleine Bildschirme
* **MD:** Mittlere Bildschirme (Tablets)
* **LG:** Große Bildschirme (Laptops)
* **XL:** Sehr große Bildschirme (Desktop-PCs)
**Link in neuen Tab öffnen?:** Setze ein Häkchen, wenn sich die beim Button hinterlegte Zielseite in einem neuen Browser-Fenster öffnen soll.
**Icon vor oder nach dem Text:** Wähle, an welcher Stelle ein mögliches Icon im Button platziert werden soll (vor oder nach dem Button-Text).
**Icon verwenden?:** Entscheide hier per Dropdown, ob der Button zusätzlich mit einem Symbol (Icon) versehen werden soll.
***
## Darstellung
***
Lege eine Höhe in vh oder px an. Vh ist eine dynamische Größe und orientiert sich prozentual an der Displayhöhe. 50vh entspricht damit 50% der aktuellen Displayhöhe. Du kannst aber auch einen fixen Pixelwert angeben.
**Videohöhe:** Trage hier die gewünschte Höhe deines Video Heros ein. Nutze z. B. `50vh` für die halbe Bildschirmhöhe, `100vh` für Vollbild oder Werte wie `500px` für eine festgeschriebene, unveränderliche Höhe.
**Playbutton Farbe:** Wähle über den Color-Picker (oder durch direkte Eingabe des Hex-Codes, z. B. #edf2f4) die Farbe für deinen Playbutton aus.
Bitte beim Einstellen der Farbe für das Overlay den Deckkraftregler/Alphakanal beachten und auf einen geringen Wert stellen.
**Overlay:** Wähle hier eine Farbe für die Überlagerung (den Farbfilter) deines Videos aus. Dieser Filter wird über das Video gelegt und hilft enorm dabei, den darauf platzierten Text lesbar zu machen. Achte im Farbwähler darauf, die Deckkraft (Transparenz) entsprechend niedrig einzustellen, damit das Video noch gut durchscheint!
***
***
# Viewport Container
Source: https://docs.dreizack-medien.de/OPC-Plus/Viewport-Container
# Allgemeine Beschreibung
Der "Viewport Container" ermöglicht es dir, Inhalte gezielt nur auf bestimmten Gerätetypen (Desktop, Tablet oder Mobil) auszuspielen.
Der entscheidende Vorteil gegenüber dem einfachen "Ausblenden" per CSS ist die Performance: Inhalte, die für das aktuelle Gerät nicht bestimmt sind, werden technisch gar nicht erst geladen ("gerendert"). Das spart Datenvolumen und macht deinen Shop schneller, insbesondere auf Smartphones.
# Einsatzmöglichkeiten (Inspiration)
* **Bild-Optimierung:** Lade auf dem Desktop hochauflösende, breite Banner, während Smartphone-Nutzer automatisch ein kleineres, datensparendes Bild im Hochformat erhalten.
* **Usability:** Zeige komplexe Tabellen oder detaillierte technische Daten nur auf großen Bildschirmen an, während mobile Nutzer eine vereinfachte Zusammenfassung sehen.
* **Navigation:** Erstelle unterschiedliche Menü-Strukturen oder Button-Layouts, die perfekt auf die jeweilige Daumengröße und Bedienung abgestimmt sind.
# Featureübersicht:
* **Performance-Boost:** Nicht benötigte Inhalte werden vom Server gar nicht erst an den Browser gesendet.
* **Geräte-Logik:** Klare Trennung zwischen Mobil- und Desktop-Ansichten.
* **Tablet-Flexibilität:** Du entscheidest selbst, ob Tablets eher wie große Smartphones oder wie kleine Desktop-PCs behandelt werden sollen (oder ganz eigene Inhalte bekommen).
***
# Tutorial
***
# Settings:
## Allgemein
***
**Info zur Vorschau:** Bitte beachte, dass die Inhalte für Mobil- und Tablet-Ansichten im Editor (OPC) oft nur sichtbar sind, wenn du die Seite auch tatsächlich mit einem solchen Gerät aufrufst oder die Simulation in den Entwickler-Tools deines Browsers nutzt.
**Modus für Tablet:** Tablets sind eine "Zwitter-Größe". Hier legst du fest, welchen Inhalt Tablet-Nutzer sehen sollen. Auswahl zwischen:
Bitte beachte, dass der Mobile- und Tablet-Content nur in der Vorschau angezeigt werden, wenn du die Seite mit einem entsprechenden Gerät öffnest oder in den Dev Tools deines Browsers ein solches simulierst. Teste die Seite am besten mit dem Smartphone oder Tablet. Die Shopseitige Prüfung ist auch wenig zuverlässig was die Tablet Größe angeht. Wir empfehlen die Nutzung der Kopie von Mobil oder Desktop.
* **Mobile Content übernehmen:** Das Tablet zeigt denselben Inhalt wie das Smartphone. (Sinnvoll bei Touch-optimierten Elementen).
* **Desktop Content übernehmen:** Das Tablet zeigt denselben Inhalt wie der Desktop-PC. (Sinnvoll bei Inhalten, die Platz in der Breite benötigen).
* **Eigener Inhalt:** Erzeugt einen dritten, separaten Container speziell für Tablets, den du individuell befüllen kannst.
***
# Zuletzt angesehen
Source: https://docs.dreizack-medien.de/OPC-Plus/Zuletzt-angesehen
# Allgemeine Beschreibung
Das "Zuletzt angesehen" Slider Portlet zeigt die zuletzt vom Besucher angesehenen Artikel als Slider an, damit dieser einfach zu vorherigen Produkten zurückfinden kann.
# Einsatzmöglichkeiten (Inspiration)
* **Wiedereinstieg erleichtern:** Hilf Besuchern, zuvor betrachtete Artikel schnell wiederzufinden.
* **Cross-Selling:** Platziere den Slider z. B. am Ende der Produktdetailseite oder im Warenkorb.
***
# Settings:
## Allgemein
**Anzahl von Produkten:** Lege fest, wie viele zuletzt angesehene Produkte maximal im Slider angezeigt werden sollen.
Diese Einstellung wird nur funktionieren, wenn der Wert in der Portleteinstellung kleiner oder gleich dem Wert in der Shopeinstellung *559* ist.
***
## Darstellung
**Slider Typ:** Lege fest, ob die Slider sich endlos wiederholen oder mit dem letzten Element enden sollen (Standardwert: Endlos (wiederholend)).
**Design:** Wähle das Design der Produktkachel:
* Clean
* Bordered
* Cards
### Darstellung Einstellen
**Vor- und Zurückbutton anzeigen?:** Aktiviere die Navigationsbuttons des Sliders.
**Seitenindexierung anzeigen?:** Aktiviere die Punktnavigation unter dem Slider.
**Vor- und Zurückbutton Typ:** Wähle die Darstellung der Navigationsbuttons (z. B. Chevron (>)).
***
## Größe und Abstände
### Slides - Darstellung
**Anzahl der sichtbaren Slides je Displaygröße:** Lege für die folgenden Breakpoints fest, wie viele Slides gleichzeitig sichtbar sein sollen:
* **XS:** \<576px
* **S:** ≥576px
* **M:** ≥768px
* **L:** ≥992px
* **XL:** ≥1200px
**Anzahl der Slides, um die verschoben wird:** Lege für dieselben Breakpoints fest, um wie viele Slides pro Klick oder Wisch weitergeschaltet wird.
### Slides - Größe und Abstände
**Lücke zwischen Slides:** Wähle den Abstand zwischen den einzelnen Slides (z. B. M (1rem)).
**Produkte rechts anschneiden:** Schneidet Produkte rechts ab, um zu zeigen, dass es noch mehr gibt.
***
## Bewegung
**Ausrichtung Slider:** Bestimmt die Laufrichtung des Sliders (z. B. links nach rechts).
**Übergangsgeschwindigkeit in Millisekunden:** Geschwindigkeit des Übergangs zwischen den Slides.
**Ziehen per Maus:** Lege fest, ob und wie der Slider per Maus gezogen werden kann:
* Erlauben mit Einrastpunkten
* Erlauben ohne Einrastpunkte
* Verbieten
### Optionen für Automatisches abspielen
**Automatisch abspielen aktivieren?:** Aktiviert das automatische Weiterschalten des Sliders.
**Abspielintervall in Millisekunden:** Zeitabstand zwischen den automatischen Übergängen.
**Pausieren bei Hover?:** Pausiert das automatische Abspielen, sobald der Nutzer mit der Maus über den Slider fährt.
Für weitere Einstellungen zum Layout, siehe den Tab **Layout** im Portlet selbst.
***
# Beispiel
So erscheint der "Zuletzt angesehen" Slider im Frontend:
***
# Abstandshalter
Source: https://docs.dreizack-medien.de/OPC-Plus/abstandshalter
# Allgemeine Beschreibung
Das Abstandshalter-Portlet ist ein praktisches Tool zur Strukturierung von Webseiten. Es ermöglicht die einfache Anpassung von Abständen zwischen Elementen, um eine optimale Darstellung auf verschiedenen Displaygrößen sicherzustellen.
# Einsatzmöglichkeiten (Inspiration)
* Verbesserte Seitenstrukturierung
* Responsive Webseitengestaltung
* Anpassung von Abständen für verschiedene Geräte
* Konsistente Darstellung auf allen Bildschirmgrößen
# Featureübersicht:
* Abstände zwischen Inhalten flexibel anpassen
* Abstände je nach Displaygröße festlegen, um responsive Designs zu erzeugen
***
***
# Settings:
## Allgemein
***
**Höhe des Abstands in Pixel:** Legt die verschiedenen Abstände je Displaygröße fest (XS kleinste, XL größte)
***
# Changelog
Source: https://docs.dreizack-medien.de/OPC-Plus/changelog
Alle Updates und Änderungen für OPC Plus
### Features
* Neues Portlet „Produkt Slider" (ProductStream V2): Die Produktkarten kommen aus dem Template und sehen im Slider genauso aus wie im Listing – in NIU Plus mit Kartenstil und Theme v2, in NOVA nativ. Datenquelle wählbar: gefilterter ProductStream, zuletzt gekauft oder zuletzt gesehen. Filter und Slider-Einstellungen des Vorgängers lassen sich unverändert weiterverwenden
* Die bisherigen Portlets Produkt Slider, Rebuy Slider und Zuletzt angesehen Slider bleiben aktiv und rendern weiter, sind im Editor aber als „Legacy" gekennzeichnet
* Theme v2: Die Tabelle folgt unter NIU Plus dem Dark Mode, im Portlet gesetzte Farben bleiben erhalten
### Verbesserungen
* Backend folgt dem Dark Mode
### Bugfixes
* OPC-Vorschau: Bild und Text - Wide, Bild Content Box, Inhaltsverzeichnis, Vertical Nav Tabs (mit Klick-Logik und Farben), Customer Service und Vergleich-Schieber erscheinen im Editor wieder korrekt; der Produkt Slider rendert in der Vorschau wieder als Slider
* Inhaltsverzeichnis: Mehrere Verzeichnisse auf einer Seite funktionieren, vorher füllte sich nur das erste
* Richtext Plus: Gekürzter Text lässt sich auch ohne eigenen Button wieder aufklappen
* Customer Service: Die Kartenstile wirkten auf jede Karte im Shop statt nur im eigenen Bereich
* Blog Excerpt: Fehler beim Laden der News-Einträge behoben
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.0 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Bugfix
* Tabellenkopfzeile übernimmt Formatierung nicht
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Features
* Neues Portlet: Tabelle: Erstelle responsive Tabellen in cleanem Design
* Container V3 mit Gradient Background-color
* Codeblock verbessert
### Bugfix
* Zuletzt angesehen Slider checkt jetzt, ob Produkt noch vorhanden ist
### Kompatibilität
* JTL-Shop 5.5.0+
* Benötigt mindestens DZM Resources & Health 1.10.7
### Kompatibilität
* JTL-Shop 5.3.1 - 5.7.0
* Benötigt mindestens DZM Resources & Health 1.10.0
### Features
* Neues Admin Frontend
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.9.20
### Features
* Container Plus hat jetzt eine Option für ein Seitenverhältnis
* Schema Optionen für ProductStream und ProductItemBox
* FAQ Strukturierte Daten verbessert: Kombination aus Microdata und JSON+LD
### Bugfixes
* Hero Slider Pagination Position gefixt
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.9.19
### Features
* Lazyload, Prefetch, Title und Alt Option für ImageTextboxWide
* Alternativer Kategoriename per Attribut für Kategorie-Grid
* Neuer Installationsprozess \[BETA], checkt die installierte Version von Resources & Health und installiert die neuste kompatible Version
### Bugfixes
* Leere Headline hat trotzdem ein Tag gesetzt
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.9.16
### Features
* FAQ Portlet: Optionen für die Headline, um diese als h2 zu verwenden - sinnvoll für KI Crawler
* Kategorieslider: Einstellungen erweitert
* Container V3 verbessert
* ImageTextBoxWide hat nun Optionen für Title, Alt, Lazy und Prefetch
* Das Overlay in der Bild Content Box lässt sich deaktivieren
* Hero hat Headline Settings erhalten
* BETA: Rebuy Slider
### Bugfixes
* 100% Height auf Viewportcontainer
* Review Slider Fixes
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.9.12
### Features
* Neues BETA Portlet: CSS Grid Container und CSS Grid Element
* Heroslider Optionen überarbeitet
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.9.6
### Features
* Blog Excerpt wurde völlig überarbeitet und bietet jetzt übersichtlichere Funktionen und Specials für NIU Plus Templates
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.9.1
### Features
* Neues Portlet: Hersteller Link
* Social Share: "Teilen" Text ist jetzt individuell anpassbar
### Bugfix
* KategorieGrid: Text nicht zentriert
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.9.1
### Features
* Icons ergänzt
* Slider Title gefixt
* Neues Portlet: Herstellerlink
* Verbesserungen im Marquee Portlet
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.8.14
### Features
* Container Plus V3: Völlig überarbeiteter Container mit zahlreichen neuen Einstellungen für präzisere Dimensionen, Verhalten und überarbeitete Hintergrundoptionen. Der alte Container Plus gilt als Deprecated.
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.8.12
### Bugfix
* Kategorie Grid prüft nicht, ob Kategorie noch vorhanden ist
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.8.12
### Features
* Min Shop Version angepasst für breitere Kompatibilität
### Kompatibilität
* JTL-Shop 5.3.1+
* Benötigt mindestens DZM Resources & Health 1.8.11
### Bugfix
* Anzahl der Blogbeiträge in Blogexcerpt gefixt
* Compareslider Labeldarstellung gefixt
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.8
### Bugfix
* Wichtige Resources & Health Abhängigkeit
* Textalignment und Abstände in Heroslider gefixt
* Textalignment in Image Content Box gefixt
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.5
### Features
* JTL Shop 5.4 Kompatibilität
### Bugfixes
* Abstände in Kategoriegrid gefixt
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.3
### Features
* Neues Portlet: Codeblock
### Bugfixes
* ProductStream Mischen Funktion läuft nicht bei Herstellerauswahl
### Kompatibilität
* JTL-Shop 5.3.3+
* Benötigt mindestens DZM Resources & Health 1.8.1
### Features
* Neues Portlet: Newsticker (Marquee)
* Neues Portlet: Flex Container - Mehr Freiheit für komplexe Layouts durch Flex Optionen
* ProductItemBox verbesserte Preview
### Bugfixes
* Image Button Box verbessert
* ProductItem Box funktioniert nicht im Snackys Template
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.8.0
### Features
* Neues Portlet: Kategorieslider
* Neues Portlet: Category Grid
* Neue Lazyload Optionen für Hero Slider
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.7.0
Im Zuge des neuen Dispatchers in DZM Resources wurde auch in OPC Plus das Javascript neu überarbeitet.
### Features
* Anpassungen an neuen Dispatcher
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.7.0
### Features
* Neues Portlet: Vertical Nav Tabs
* Überarbeitetes Portlet: Image Content Box (löst Image Text Box ab)
* Neues Portlet: Viewport Container - Unterschiedliche Designs für Desktop, Mobil und Tablet
* Überflüssiges Javascript entfernt
* Fontweight Optionen in Text Box ergänzt
### Bugfixes
* Hero Slider Border Radius
* USP Line Fontsize gefixt
* Icon Alignment gefixt in Icon Box
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.6.3
### Features
* Performance Update
* LazyLoad und Prefetch Option für Bilder
* CSS Files aufgeräumt
* Inline Styles entfernt
* Neues Portlet: Timecontainer - Inhalte nach Zeit steuern
* Verbesserte Alignment Optionen für QualityListBox
* Verbesserte Parallax Option für Container Plus
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.5.0
### Bugfix
* FAQ Portlet lädt nicht
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.13
### Features
* Überarbeitete Gruppierung
* Überarbeiteter Container Plus mit 3 Containergrößen
* Neues Portlet: Blog Excerpt Slider BETA
* Neues Portlet: Customer Support - Modal mit Kontaktinfos
* Spacer und Slider überarbeitet
* Neues Portlet: Social Share
* Alt- und Title Attributes für Portlets mit Bildern
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.13
### Features
* Neue Containeroptionen für breite Monitore in Container Plus und Section Plus
* Neues Portlet: Social Share
### Bugfixes
* Verbesserte Überprüfung auf Resources Plugin
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.0
### Features
* ProductSlider: Neue Style-Option Item Box mit Standard Template
* ProductSlider: Filterbar auf mehrere Kategorien
* Section: div oder span als HTML Tag optional
* Neues Portlet: Product Item Box
### Bugfixes
* Bild und Text - Link Decoration entfernt
* ProductSlider: Standard Darstellung auf Flat gesetzt
* Logo Slider: Beschreibung greift nicht
* Hero Slider: Rahmenabrundung der Textbox greift nicht
* Bild und Text Karte wird nicht verlinkt
* Container Plus: Block Id für alle Einstellungen übernommen
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.15
### Features
* Neues Portlet: DZM Icon
* Neue Filterfunktionen bei Produktslider: Filter kombinierbar
### Bugfix
* Kleinere Bugfixes
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.9
### Features
* Dokumentationstab in Plugineinstellungen
### Bugfix
* Cache Flush blockiert Shop Backend
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.7
### Features
* Neues Portlet: Sichtbarkeits Container - Inhalte nach Kundengruppe ein-/ausblenden
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* CSRF Token Validierung
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Automatische Funktionsprüfung auf Kompatibilität mit DZM Resources & Health
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Verbessertes Ressourcenmanagement
* Cookie Wrapper Portlet: Schließbarer Container mit Merken-Funktion, verzögertem Einblenden und ExitIntent
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Neues Portlet: Google Maps
* Neues Portlet: Abstandhalter
* Neues Portlet: Logo Slider
* Produktslider: Artikel per Option zufällig ausspielen
* Völlig überarbeitetes Design und verbesserte Usability
* Aktualisierte Ressourcen
### Bugfixes
* Fehlerbehebung bei Überprüfung des Resources Plugins
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt DZM Resources
### Bugfixes
* Resources blockiert Frontend
### Kompatibilität
* JTL-Shop 5.2.0 - 5.2.\*
### Features
* Warnung, wenn DZM Resources nicht installiert wurde
### Kompatibilität
* JTL-Shop 5.2.0 - 5.2.\*
### Features
* Neues Portlet: Google Maps
* Neues Portlet: Abstandhalter
* Neues Portlet: Logo Slider
* Produktslider: Artikel zufällig ausspielen
* Überarbeitetes Design und verbesserte Usability
### Kompatibilität
* JTL-Shop 5.2.0 - 5.2.\*
### Features
* Image Compare Viewer lokal eingebunden
### Bugfixes
* Sidebar wird ab JTL 5.2.0 rechts angezeigt
### Kompatibilität
* JTL-Shop 5.1.2 - 5.2.\*
### Features
* Kompatibilität mit JTL Shop 5.2.0
### Bugfixes
* Problem mit Lizenz behoben
### Kompatibilität
* JTL-Shop 5.1.2 - 5.2.\*
### Features
* Release
### Kompatibilität
* JTL-Shop 5.1.2 - 5.1.\*
# Einführung
Source: https://docs.dreizack-medien.de/OPC-Plus/einfuehrung
Entdecke DZM OPC Plus - Die mächtige Content Portlet Sammlung für JTL Shop 5
# Was ist DZM OPC Plus?
OPC Plus ist eine mächtige Sammlung aus über 30 einzigartigen Content Portlets mit hilfreichen Layoutelementen, Slidern, Bildern, Videoblöcken und mehr. Mit OPC Plus gestaltest du deinen JTL Shop professionell, flexibel und conversion-optimiert.
## Einsatzmöglichkeiten
Stelle deine Produkte mit ansprechenden Slidern, Grids und Feature-Listen optimal in Szene. Nutze das "Bestes Angebot" Portlet für Bestseller oder das Produkt Grid für Kategorieseiten.
Erstelle hochkonvertierende Landing Pages mit Hero-Bereichen, CTAs, Testimonials und USP-Elementen. Kombiniere verschiedene Portlets für maximale Wirkung.
Gestalte informative Blogbeiträge und Ratgeber mit Bild-Text-Kombinationen, Accordions für FAQs und Videoblöcken für multimediale Inhalte.
Automatisiere die Anzeige von Sonderaktionen, Events und saisonalen Inhalten mit zeitgesteuerten Containern. Perfekt für Black Friday, Weihnachten oder Produktlaunches.
Baue Vertrauen auf mit Logo Walls für Partner und Kunden, USP-Portlets für Alleinstellungsmerkmale und Bewertungs-Slidern.
Erhöhe das Engagement mit PopUp-Containern, Overlay-Effekten, Parallax-Scrolling und interaktiven Image Grids.
## Warum OPC Plus?
Von einfachen Textfeldern bis zu komplexen Produkt-Slidern - OPC Plus bietet dir alle Werkzeuge für moderne Shop-Gestaltung.
Alle Portlets lassen sich intuitiv per Drag & Drop im JTL Shop OPC-Editor konfigurieren. Umfangreiche Einstellungsmöglichkeiten ohne Code.
Alle Portlets sind vollständig responsive und für schnelle Ladezeiten optimiert. Deine Inhalte sehen auf allen Geräten perfekt aus.
Profitiere von kontinuierlichen Verbesserungen, neuen Features und Kompatibilitäts-Updates für aktuelle JTL Shop Versionen.
## Nächste Schritte
Folge der [Installationsanleitung](/OPC-Plus/installation), um OPC Plus in deinem Shop einzurichten.
Entdecke die verschiedenen Portlets und ihre Einsatzmöglichkeiten in der Dokumentation.
Starte mit einfachen Portlets wie dem Textfeld oder Bild-Text-Kombinationen.
***
***
# Flex-Container
Source: https://docs.dreizack-medien.de/OPC-Plus/flexcontainer
# Allgemeine Beschreibung
Mit dem Flex-Container-Portlet gestaltest du das Layout deiner Seite. Er dient als Rahmen für andere Elemente und hilft dir dabei, Inhalte präzise auszurichten, zu stapeln oder nebeneinander anzuordnen. Das Ganze funktioniert vollautomatisch für alle Displaygrößen (Desktop, Tablet, Smartphone).
# Einsatzmöglichkeiten (Inspiration)
* Aufbau von mehrspaltigen Inhalten
* Layouts, die sich flexibel an verschiedene Bildschirmbreiten anpassen
* Zentrieren von Logos, Texten oder Buttons
* Steuerung der Abstände zwischen verschiedenen Elementen
***
# Featureübersicht:
* Inhalte flexibel horizontal oder vertikal ausrichten
* Eigene Regeln für Handy, Tablet und Desktop festlegen
* Einfaches System für Zwischenräume (Gap)
* Einstellungen werden automatisch an größere Displays weitergegeben (Vererbung)
***
# Settings:
## Allgemein
In diesem Reiter nimmst du grundlegende Einstellungen vor, die bestimmen, wie sich der Container in sein direktes Umfeld einfügt.
***
### Inherit Height of parent element
Mit dieser Checkbox steuerst du die Höhenanpassung des Containers.
* **Aktiviert:** Der Flex-Container übernimmt automatisch die volle Höhe des Elements, in dem er sich befindet. Das ist besonders nützlich, wenn du einheitliche Kachel-Layouts erstellen möchtest, bei denen alle Boxen in einer Reihe gleich hoch sein sollen.
* **Deaktiviert:** Der Container ist nur so hoch, wie es sein eigener Inhalt erfordert.
***
## Parent Container
In diesem Reiter legst du fest, wie sich der äußere Rahmen verhält.
### Container als Elterncontainer nutzen
Damit die Flex-Eigenschaften auf die Inhalte wirken, muss hier **"ja"** ausgewählt sein.
### Flex Type
Hier aktivierst du das Flex-Layout-System.
* **use flex:** In der Regel auf **"Use setting"** stellen, um die darunterliegenden Optionen freizuschalten.
* **Main bis XL:** Hier legst du fest, ob das Flex-System auf bestimmten Displaygrößen aktiv sein soll.
* **inherit:** Übernimmt die Einstellung der kleineren Displaygröße.
### Flex Direction (Ausrichtung)
Bestimme, in welche Richtung deine Inhalte fließen.
* **row:** Deine Elemente werden nebeneinander (horizontal) angezeigt.
* **column:** Deine Elemente werden untereinander (vertikal) gestapelt.
### Align Items (Anordnung)
Steuert die Ausrichtung der Elemente innerhalb des Containers.
* **start:** Inhalte werden am Anfang des Containers ausgerichtet.
* **center:** Inhalte werden mittig platziert.
* **end:** Inhalte werden am Ende des Containers ausgerichtet.
### Gap (Abstände)
Mit der Gap-Funktion erzeugst du gleichmäßige Zwischenräume zwischen deinen Elementen.
* **use gap:** Aktiviere diese Option mit **"Use setting"**, um Abstände zu definieren.
* **Werte (1, 2, 3...):** Wähle die Stärke des Abstands. Höhere Zahlen bedeuten mehr Platz.
* **Main bis XL:** Du kannst für jede Displaygröße einen eigenen Abstand wählen oder via **inherit** den Wert der kleineren Stufe übernehmen.
***
## Child Container
In diesem Reiter stellst du ein, wie sich ein einzelnes Element innerhalb eines Flex-Containers verhält. Während der "Parent" den groben Rahmen vorgibt, bestimmst du hier die Details für das jeweilige Objekt.
***
### Container als Kindcontainer nutzen
Damit die folgenden Einstellungen für dieses Element greifen, setze diese Option auf **"ja"**.
### Align Self (Individuelle Ausrichtung)
Normalerweise folgen alle Elemente der Ausrichtung, die im Parent-Container eingestellt wurde. Mit "Align Self" kannst du für dieses eine Element eine Ausnahme machen.
* **auto:** Nutzt die Standard-Einstellung des Eltern-Containers.
* **start / center / end:** Richtet das Element oben, mittig oder unten aus – unabhängig von seinen Nachbarn.
### Flex Fill & Grow (Platz einnehmen)
Diese Optionen steuern, wie das Element freien Raum im Container nutzt.
* **Flex Fill:** Sorgt dafür, dass das Element den verfügbaren Platz in der Zeile komplett ausfüllt.
* **Flex Grow:** Bestimmt, wie stark das Element im Verhältnis zu anderen wächst, wenn Platz übrig ist. Ein Wert von `0` bedeutet: Das Element behält seine ursprüngliche Größe.
### Flex Shrink (Verkleinern)
Hier legst du fest, ob und wie stark das Element schrumpfen darf, wenn der Platz im Container knapp wird (z. B. auf kleinen Smartphone-Displays).
### Margin Auto (Automatischer Außenabstand)
Dies ist ein praktischer Trick, um Elemente innerhalb einer Zeile wegzuschieben.
* **r auto (Right):** Schiebt das Element nach links und hält alles andere auf Abstand nach rechts.
* **l auto (Left):** Schiebt das Element ganz nach rechts.
### Flex Wrap (Zeilenumbruch)
Bestimme hier, was passiert, wenn die Elemente breiter als der Container sind.
* **wrap:** Die Elemente brechen automatisch in die nächste Zeile um.
* **nowrap:** Alle Elemente werden in eine einzige Zeile gequetscht, auch wenn sie über den Rand hinausragen.
### Order (Reihenfolge)
Ein sehr hilfreiches Feature für die mobile Ansicht. Du kannst die visuelle Reihenfolge der Elemente ändern, ohne ihren Platz im Code zu verschieben.
* **Beispiel:** Du kannst ein Element, das am Desktop ganz rechts steht, auf dem Handy ganz oben anzeigen lassen, indem du ihm eine niedrigere Nummer (z. B. `-1` oder `0`) gibst.
***
**Hinweis zur Vererbung:** Auch hier kannst du für jede Displaygröße (**Main bis XL**) eigene Werte festlegen oder mit **"inherit"** dafür sorgen, dass die Einstellungen der kleineren Geräte übernommen werden.
***
***
# Installation
Source: https://docs.dreizack-medien.de/OPC-Plus/installation
Schritt-für-Schritt Anleitung zur Installation von DZM OPC Plus
**WICHTIG:** Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
## Schnellstart
Das kostenlose Basis-Plugin muss zuerst installiert werden
Lade das Plugin herunter und installiere es über den Plugin Manager
Aktiviere deine Lizenz in den Plugin-Einstellungen
***
## Vorbereitung
### Wo finde ich die Installationsfiles?
Die Installer-Pakete findest du jeweils am Produkt in unserem Store.
In der Sidebar findest du alle veröffentlichten Versionen.
Achte auf folgende Punkte:
* Benötigt das Plugin Resources & Health und in welcher Version?
* Ist die Version mit deiner JTL Shop Version kompatibel?
* Wähle zwischen JTL ExtStore Version und DZM Store Version, je nachdem woher du deine Lizenz bezogen hast
### Was ist Resources & Health?
**Resources & Health** ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop. Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
### Wo finde ich die Lizenzschlüssel?
Deine Lizenzschlüssel findest du direkt nach der Buchung in deinem Kundenkonto unter **Meine Lizenzen**.
Diesen Lizenzschlüssel trägst du im jeweiligen Plugin ein.
Einen Lizenzschlüssel findest du hier nur, wenn du das Produkt über unseren Store gebucht hast.
### Welche Lizenzen muss ich buchen?
* **Resources & Health:** Benötigt keine Lizenz und kann direkt heruntergeladen werden
* **OPC Plus:** Benötigt eine eigene Lizenz
#### OPC Suite Bundle
**OPC Suite** bietet eine Bundle-Lizenz für alle weiteren Produkte:
* OPC Plus
* OPC Conversion Booster
* OPC Smarty Portlets
* OPC Portlets vererben
Mit einer aktiven OPC Suite Lizenz werden automatisch auch alle enthaltenen Plugins aktiviert. In diesem Fall musst du in den anderen Plugins **keinen eigenen Schlüssel mehr hinterlegen**.
***
## Detaillierte Installation
### Schritt 1: Resources & Health installieren
Besuche [https://dreizack-medien.de/DZM-Resources-Health](https://dreizack-medien.de/DZM-Resources-Health) und lade das Plugin herunter.
Achte auf die Wahl der passenden Version für deine JTL Shop Installation.
Lade die heruntergeladene ZIP-Datei über den Plugin Manager in deinen Shop hoch.
Unter **Vorhanden** wählst du nun das hochgeladene Plugin aus, akzeptierst ggf. die Lizenzbedingungen und klickst auf **Installieren**.
### Schritt 2: OPC Plus Lizenz buchen
Registriere dich in unserem Store unter [https://dreizack-medien.de](https://dreizack-medien.de)
Wähle unter [https://dreizack-medien.de/DZM-OPC-Plus](https://dreizack-medien.de/DZM-OPC-Plus) die passende Kaufoption aus.
In diesem Beispiel ordern wir eine Lizenz für **OPC Plus** als **Vollversion** und tragen unsere Domain ein, ohne `https://` oder führendes `www.`
Diese Auswahl ist nur möglich, wenn du bereits angemeldet bist. Eine Bestellung ohne Registrierung ist ausgeschlossen!
Wenn du bereits eine Demo- oder Entwicklerlizenz hast und angemeldet bist, kannst du alternativ zur Registrierung einer neuen Domain einfach unten im Dropdown deine bestehende Lizenz auswählen und in eine Vollversion umwandeln. Die passende Domain wird dann automatisch übernommen.
Domains einer produktiven Lizenz kannst du später in deinem Kundenkonto bearbeiten und ändern. Wenn du also auf einer Staging-Domain gearbeitet hast, kannst du die Lizenz hier in eine Vollversion umwandeln und anschließend in deinem Kundenkonto auf die Live-Domain umschreiben.
### Schritt 3: OPC Plus downloaden und installieren
Kehre nach erfolgreicher Buchung auf die Produktseite zurück und lade hier die passende Version von OPC Plus herunter: [https://dreizack-medien.de/DZM-OPC-Plus](https://dreizack-medien.de/DZM-OPC-Plus)
Lade anschließend die ZIP-Datei wie oben bei Resources & Health über den **Plugin Manager** in deinen Shop hoch und installiere das Plugin.
### Schritt 4: Lizenz aktivieren
Wechsle in unserem Store in dein **Kundenkonto** unter **Meine Lizenzen** und kopiere dir den **Lizenzschlüssel** für deine Domain.
Unter Umständen kann es passieren, dass sich das OPC Plus Plugin so lange selbst deaktiviert, bis eine gültige Lizenz eingetragen wurde.
Aktiviere in diesem Fall das Plugin einfach wieder und wechsle **sofort** in die **Plugin-Einstellungen**.
Trage deinen Lizenzschlüssel unter **Lizenz** ein und klicke auf **Speichern**.
Das Plugin signalisiert dir, dass die Lizenz valide und aktiv ist.
In wenigen Ausnahmefällen kann es sein, dass sich das Plugin noch einmal selbst deaktiviert, nachdem du den Schlüssel eingetragen hast. Aber keine Sorge - nach letztmaliger Aktivierung bleibt es auch aktiviert. Versprochen! 😉
***
## Fertig!
Dein OPC Plus Plugin ist jetzt einsatzbereit. Du findest die neuen Portlets im OPC-Editor deines JTL Shops.
Erkunde jetzt alle verfügbaren Portlets und ihre Einsatzmöglichkeiten
# Blog Excerpt BETA
Source: https://docs.dreizack-medien.de/OPC-Plus/log-Excerpt-BETA
# Allgemeine Beschreibung
Das "Blog Excerpt BETA" Portlet ermöglicht es dir, eine ansprechende Vorschau deiner neuesten Blogbeiträge direkt in deinem Onlineshop darzustellen. Meistens wird dieses Portlet in Form eines Sliders (Karussells) genutzt, um Kunden auf aktuelle News, Ratgeber oder Hintergrundgeschichten aufmerksam zu machen, ohne dass sie direkt den Blog-Bereich aufrufen müssen.
# Einsatzmöglichkeiten (Inspiration)
* **Startseiten-News:** Präsentiere deine aktuellsten Beiträge direkt auf der Startseite, um deinen Kunden Mehrwert zu bieten und deine Expertise zu unterstreichen.
* **Kaufberatung in Kategorien:** Binde thematisch passende Blog-Artikel (wie z. B. Ratgeber oder Pflegehinweise) auf den jeweiligen Kategorie-Seiten ein.
* **SEO-Optimierung:** Halte deine Seiten durch dynamisch nachladende Blog-Inhalte frisch und stärke die interne Verlinkung zu deinen Textinhalten.
# Featureübersicht:
* **Flexibles Slider-Layout:** Präsentiere deine Blogartikel wahlweise im klaren "Clean"-Look oder als moderne "Cards" (Karten).
* **Responsives Design:** Bestimme für jede Displaygröße (vom Smartphone bis zum Desktop) ganz genau, wie viele Beiträge nebeneinander angezeigt werden sollen.
* **Exakte Textkontrolle:** Schneide Titel und Beschreibungstexte nach einer bestimmten Zeichen- oder Zeilenanzahl ab, um ein absolut einheitliches Erscheinungsbild (Raster) zu gewährleisten.
* **Interaktive Bedienung:** Nutze automatische Abspielfunktionen, Wischgesten (Maus-Ziehen) und klassische Pfeil-Navigationen.
***
# Settings:
## Darstellung
***
### Blogbeiträge
**Anzahl der Blogposts:** Lege hier fest, wie viele Blogartikel insgesamt aus deinem Blog geladen und in diesem Portlet angezeigt werden sollen (z. B. 5).
**Fixe Anzahl Titelzeilen (nur NIU Plus):** Bestimme eine feste Zeilenanzahl für die Überschriften deiner Blogbeiträge. Das verhindert, dass das Layout bei unterschiedlich langen Titeln unruhig wirkt.
**Titel abschneiden nach x Zeichen (nur NIU Plus):** Hier kannst du einstellen, nach wie vielen Zeichen die Überschrift rigoros abgeschnitten werden soll. Trägst du eine "0" ein, wird der Titel nicht nach Zeichen gekürzt.
**Fixe Anzahl Beschreibungszeilen (nur NIU Plus):** Ähnlich wie beim Titel kannst du hier festlegen, wie viele Zeilen der Vorschautext (Excerpt) maximal einnehmen darf, um ein sauberes Raster zu bilden.
**Beschreibungstext abschneiden nach x Zeichen (nur NIU Plus):** Definiere, nach wie vielen Zeichen der Einleitungstext deines Blogbeitrags abgeschnitten werden soll (z. B. nach 200 Zeichen).
**Bild Seitenverhältnis gem. CSS aspect Ratio (Format: x / y) (nur NIU Plus):** Bestimme das Format deiner Vorschaubilder, um eine einheitliche Optik zu erzwingen. Nutze Formate wie `1 / 1` für quadratische Bilder oder `16 / 9` für Querformat.
**Abdeckverhalten des Bildes im Container gem. CSS objectFit (nur NIU Plus):** Wähle hier per Dropdown aus, wie sich das Bild in dem von dir vorgegebenen Seitenverhältnis verhalten soll. Auswahl zwischen:
* **Bild passt in den Container** = Das Bild wird so skaliert, dass es komplett sichtbar ist (kann zu Rändern führen).
* **Bild füllt Container aus** = Das Bild füllt die Box komplett aus, dabei können jedoch Ränder des Bildes abgeschnitten werden.
***
## Größe und Abstände
***
### Indikatoren
**Vor- und Zurückbutton anzeigen?:** Setze dieses Häkchen, wenn du Pfeile zur Navigation durch den Slider anzeigen möchtest.
**Seitenindexierung anzeigen?:** Wenn aktiviert, werden kleine Punkte (Dots) unter dem Slider angezeigt, die dem Kunden zeigen, auf welcher Seite des Sliders er sich gerade befindet.
### Slides - Darstellung
**Design:** Wähle die grundsätzliche Optik deiner Blog-Vorschau. Du hast die Auswahl zwischen:
* **Clean** = Klares, nahtloses Design ohne abgesetzte Boxen.
* **Cards** = Die einzelnen Beiträge werden visuell in Form von Karten (Cards) voneinander abgegrenzt.
**Anzahl der sichtbaren Slides je Displaygröße:** Lege hier für verschiedene Bildschirmgrößen fest, wie viele Blog-Beiträge gleichzeitig nebeneinander sichtbar sein sollen (z.B. 1 auf Handys "XS", 5 auf großen Desktop-Monitoren "XL").
**Anzahl der Slides um die verschoben wird:** Bestimme, wie viele Beiträge beim Klick auf "Weiter" übersprungen werden sollen. Auch dies kannst du für jede Displaygröße (XS bis XL) einzeln festlegen (z. B. immer um 1 Slide weiterrutschen).
**Posts rechts anschneiden:** Hier kannst du per Dropdown einstellen, ob der jeweils letzte sichtbare Beitrag rechts leicht abgeschnitten dargestellt werden soll. Das ist ein beliebtes Mittel, um dem Nutzer zu signalisieren, dass man hier weiter scrollen/wischen kann.
**Lücke zwischen Slides:** Wähle hier den Abstand (den Weißraum) aus, der zwischen den einzelnen Blog-Karten gelassen werden soll (z. B. "Kein Abstand").
**Abstand zwischen Pfeilen und Slidercontent:** Definiere, wie viel Platz zwischen den Vor-/Zurück-Pfeilen und den eigentlichen Blog-Beiträgen liegen soll (z. B. "xl" für einen sehr großzügigen Abstand).
***
## Bewegung
***
**Übergangsgeschwindigkeit in Millisekunden:** Lege fest, wie schnell (oder langsam) die Animation beim Wechsel zum nächsten Slide sein soll. Ein Wert von "300" (Millisekunden) sorgt für einen flotten, flüssigen Übergang.
**Ziehen per Maus:** Wähle aus dem Dropdown, ob Nutzer den Slider mit der Maus (bzw. auf Touchscreens mit dem Finger) hin und her wischen können. (z. B. "erlauben mit Einrastpunkten").
### Optionen für Automatisches abspielen
**Automatisch abspielen aktivieren?:** Setze hier ein Häkchen, wenn sich dein Blog-Slider von ganz allein weiterbewegen soll, ohne dass der Kunde klicken muss.
**Abspielintervall in Millisekunden:** Falls das automatische Abspielen aktiv ist, legst du hier die Pausenzeit zwischen den Wechseln fest. "3000" entspricht dabei genau 3 Sekunden.
**Pausieren bei Hover?:** Wenn diese Option aktiviert ist, stoppt das automatische Abspielen, sobald der Kunde mit dem Mauszeiger über einem der Blog-Beiträge steht. Das gibt ihm in Ruhe Zeit, den Text zu lesen oder auf den Artikel zu klicken.
***
***
# NIU Spotlight Banner
Source: https://docs.dreizack-medien.de/OPC-Plus/niu-spotlight-banner
# Allgemeine Beschreibung
Der "NIU Spotlight Banner" (auch oft "Shop the Look" genannt) ist ein interaktives Portlet für den OnPage Composer. Er ermöglicht es dir, ein Bild hochzuladen und darauf spezifische Bereiche ("Hotspots") zu markieren. Diese Hotspots können mit Produkten oder beliebigen URLs verknüpft werden. Wenn ein Kunde auf einen Hotspot klickt oder tippt, öffnen sich weitere Informationen oder eine direkte Verlinkung zum Artikel. Dies schafft ein intuitives und visuelles Einkaufserlebnis.
# Einsatzmöglichkeiten (Inspiration)
* **Shop the Look (Mode):** Zeige ein Model, das ein komplettes Outfit trägt. Setze Hotspots auf die Hose, das Hemd und die Schuhe, um die einzelnen Artikel direkt verlinken.
* **Interior Design:** Präsentiere ein fertig eingerichtetes Wohnzimmer. Verlinke das Sofa, die Lampe und den Teppich direkt im Bild.
* **Technische Zeichnungen:** Nutze Explosionszeichnungen von Maschinen oder Geräten und verlinke die einzelnen Ersatzteile exakt an ihrer Position.
* **Interaktive Grafiken:** Erkläre Features eines Produktes, indem du Hotspots auf Details (z. B. Anschlüsse, Bedienelemente) legst und Info-Texte hinterlegst.
# Featureübersicht:
* **Visueller Editor:** Platziere Hotspots einfach per Klick direkt auf dem Vorschaubild.
* **Produktverknüpfung:** Verknüpfe Hotspots direkt mit Artikeln aus deinem Shop – Daten wie Name und Link werden automatisch gezogen.
* **Individuelle Anpassung:** Überschreibe Standard-Produktdaten mit eigenen Titeln und Beschreibungen, falls gewünscht.
* **Design-Kontrolle:** Passe Größe, Farbe und Transparenz der Hotspots sowie das Design der Popups an deinen Shop an.
***
# Settings:
## Banner
***
**Banner Bild:** Lade hier das Hauptbild hoch, auf dem die Hotspots platziert werden sollen.
**Alt-Text des Bildes:** Hinterlege einen alternativen Text für Screenreader und SEO.
**Spotlight Bereiche:** Hier siehst du die Vorschau deines Bildes. Klicke auf **Neue Zone**, um einen Hotspot zu erstellen, und ziehe ihn an die gewünschte Position im Bild. In der rechten unteren Ecke der Zone kannst du die Größe anpassen, indem du diese gedrückt hältst und ziehst.
**Einstellungen für die gewählte Zone:**
* **Titel:** Der Name des Hotspots.
* **URL:** Ein manueller Link (optional).
* **CSS-Klasse:** Für spezielle Styles.
* **Artikel:** Suche hier nach einem Produkt in deinem Shop, um es direkt zu verknüpfen.
* **Link in neuem Tab öffnen:** Entscheide, ob sich der Link in einem neuen Fenster öffnet.
* **Beschreibung:** Ein optionaler Text, der im Popup angezeigt wird.
*Hinweis:* Wenn du die Felder Titel, URL oder Beschreibung leer lässt, aber einen Artikel verknüpft hast, werden automatisch die Daten des Artikels verwendet. Eigene Einträge überschreiben die Artikeldaten.
***
## Hotspot
Hier definierst du das Aussehen der anklickbaren Punkte (Hotspots) auf dem Bild.
***
**Hotspot Größe:** Wähle die Größe des Kreises (z. B. MD (30px)).
**Hotspot Transparenz:** Lege fest, ob der Hotspot solide oder leicht durchsichtig sein soll.
**Hotspot Farbe:** Bestimme die Hintergrundfarbe des Kreises (z. B. deine Primärfarbe).
**Icon Farbe:** Bestimme die Farbe des Symbols (meist ein Plus-Zeichen) innerhalb des Hotspots.
***
## Popup
Hier gestaltest du das Fenster, das sich öffnet, wenn ein Hotspot angeklickt wird.
***
**Popup Border Radius:** Lege die Abrundung der Ecken des Popups in Pixeln fest (z. B. 8).
**Popup Inhalt:** Entscheide, was im Popup angezeigt werden soll (z. B. "Nur Text" oder Artikelinformationen).
**Beschreibung:** Steuere, ob und wie die Beschreibungstexte im Popup dargestellt werden sollen.
***
***
# Rebuy Slider
Source: https://docs.dreizack-medien.de/OPC-Plus/rebuy-slider
# Allgemeine Beschreibung
Der "Rebuy Slider" ist ein spezialisiertes Portlet für den OnPage Composer, mit dem du dynamische Produktlisten basierend auf Kundenverhalten oder Produktbeziehungen anzeigen kannst. Er eignet sich hervorragend, um Kunden auf ergänzende Artikel aufmerksam zu machen oder Bestseller prominent zu platzieren. Das Design ist dabei vollständig anpassbar und fügt sich nahtlos in dein Shop-Layout ein.
# Einsatzmöglichkeiten (Inspiration)
* **Cross-Selling im Warenkorb:** Platziere den Slider unter dem Warenkorb oder im Checkout, um passende Zubehörartikel (z. B. Batterien, Pflegeprodukte) anzubieten.
* **Ähnliche Artikel:** Nutze den Slider auf Produktdetailseiten, um Alternativen oder Varianten des aktuellen Artikels zu zeigen und den Kunden im Shop zu halten.
* **Zuletzt angesehen:** Erinnere Kunden auf der Startseite an Produkte, die sie sich bereits angesehen haben, um den Kaufabschluss zu fördern.
* **Bestseller-Listen:** Präsentiere die beliebtesten Produkte einer Kategorie direkt in einer Erlebniswelt oder auf der Landingpage.
# Featureübersicht:
* **Dynamische Produktanzeige:** Automatische Befüllung des Sliders basierend auf hinterlegten Logiken (z. B. "Kunden kauften auch").
* **Responsive Kontrolle:** Detaillierte Steuerung der sichtbaren Produkte pro Endgerät (vom Smartphone bis zum Desktop).
* **Design-Vielfalt:** Wähle aus verschiedenen Layout-Vorlagen (z. B. "Clean") und passe Abstände individuell an.
* **Intuitive Navigation:** Konfigurierbare Pfeil-Navigation und Paginierung (Seitenindex) für eine optimale User Experience.
***
# Settings:
## Allgemein
***
**Anzahl von Produkten:** Gib hier die maximale Anzahl der Produkte an, die in den Slider geladen werden sollen (z. B. 5). Diese Produkte werden basierend auf den Rebuy-Logiken ermittelt und im Slider dargestellt.
***
## Darstellung
***
**Design:** Wähle aus verschiedenen vordefinierten Designs (z. B. Clean), um den Look des Sliders an deinen Shop anzupassen.
**Vor- und Zurückbutton anzeigen?:** Aktiviere diese Checkbox, um Pfeile für die manuelle Navigation nach links und rechts einzublenden.
**Seitenindexierung anzeigen?:** Aktiviere diese Checkbox, um eine Paginierung (meist Punkte unter dem Slider) anzuzeigen, die dem Nutzer die aktuelle Position und die Gesamtanzahl der Seiten signalisiert.
**Vor- und Zurückbutton Typ:** Lege hier den Stil der Navigationspfeile fest (z. B. Chevron (>)). Dies bestimmt das Icon, das für die Buttons verwendet wird.
***
## Größe und Abstände
***
**Anzahl der sichtbaren Slides je Displaygröße:** Trage für jeden Breakpoint (XS, S, M, L, XL) ein, wie viele Produkte gleichzeitig sichtbar sein sollen.
* *Beispiel:* Mobil (XS) 1 Produkt, Desktop (XL) 5 Produkte.
**Anzahl der Slides um die verschoben wird:** Lege fest, um wie viele Produkte der Slider weiterspringt, wenn der Nutzer auf "Weiter" klickt oder wischt.
* *Beispiel:* 1 für schrittweises Blättern.
**Lücke zwischen Slides:** Wähle den Abstand zwischen den einzelnen Produktkacheln (Gutter), z. B. M (1rem).
**Produkte rechts anschneiden:** Entscheide, ob das nächste Produkt am rechten Rand bereits teilweise sichtbar sein soll ("angeschnitten"), um dem Nutzer visuell zu signalisieren, dass weitere Inhalte folgen (Einstellung: Nein oder Auswahl einer Größe).
***
***
# Tabellen
Source: https://docs.dreizack-medien.de/OPC-Plus/tabellen
Flexible Tabellen-Portlets für strukturierte Datendarstellung in OPC Plus
## Was sind Tabellen in OPC Plus?
Mit Tabellen in OPC Plus baust du deine Tabelle direkt im Editor auf – Spalte für Spalte, ganz ohne eine einzige Zeile HTML. In Minuten entsteht so eine Tabelle, die automatisch die Farben deines Templates übernimmt und auf dem Smartphone genauso sauber aussieht wie am Desktop, statt gequetscht oder mit Scrollbalken. Egal ob Produktvergleiche, Merkmalslisten oder Datenübersichten – einmal angelegt, ist die Tabelle fertig gepflegt, ganz ohne wiederholte HTML-Anpassungen.
Das Tutorial zum Video gibt es auch als Blogbeitrag: [Tabellen im JTL-Shop erstellen – ohne HTML](https://dreizack-medien.de/tutorials/tabellen-jtl-shop-erstellen-ohne-html).
***
## Inhalt
Im **Inhalt**-Tab legst du die Grundstruktur deiner Tabelle fest. Ganz oben steuerst du per Schalter drei Optionen:
* **Header-Zeile** – Aktiviert eine Kopfzeile, die sich farblich vom Rest der Tabelle abhebt. Die Farben werden im **Farben**-Tab eingestellt.
**Ohne Header-Zeile**
**Mit Header-Zeile**
* **Footer-Zeile** – Fügt optional eine Fußzeile am Ende der Tabelle hinzu, diese hebt sich in der gleichen Farbe wie die Header-Zeile ab.
**Ohne Footer-Zeile**
**Mit Footer-Zeile**
* **Erste Spalte als Header** – Behandelt die erste Spalte wie eine Kopfzeile, was sich für Merkmalslisten eignet.
Darunter vergibst du im Namensfeld einen internen Titel für die Tabelle (z. B. „Sitzgelegenheiten"). Dieser Titel erscheint als Überschrift über der Tabelle im Frontend.
Der Tabelleneditor zeigt dir das vollständige Raster. Für jede Spalte kannst du oben die **Ausrichtung** (links, zentriert, rechts) und eine **Mindestbreite in Pixel** festlegen. Die Inhalte trägst du direkt in die Zellen ein. Formatierungen sind per Markdown möglich – ein Hinweis dazu steht direkt unter dem Editor:
* `**fett**` → **fett**
* `*kursiv*` → *kursiv*
* `[Linktext](URL)` → klickbarer Link
Mit **+ Zeile** und **+ Spalte** erweiterst du die Tabelle nach unten oder rechts. Mit **– Letzte Spalte entfernen** löschst du die rechteste Spalte wieder. Jede Zeile lässt sich über das **Sechs-Punkte-Symbol** (⠿) am linken Rand per Drag-and-drop in der Reihenfolge verschieben. Mit dem **Mülleimer-Symbol** am rechten Rand wird die gesamte Zeile gelöscht.
## Style
Im **Style**-Tab steuerst du das visuelle Erscheinungsbild der Tabelle über Checkboxen und Auswahlfelder:
* **Zeilen abwechselnd einfärben (striped)** – Gerade und ungerade Zeilen erhalten unterschiedliche Hintergrundfarben. Die genaue Farbe legst du im Farben-Tab unter „Striped-Hintergrund" fest.
**Ohne Einfärben**
**Mit Einfärben**
* **Rahmen anzeigen** – Fügt sichtbare Trennlinien zwischen allen Zellen ein. Die Farbe der Linien ist ebenfalls im Farben-Tab einstellbar.
* **Hover-Effekt auf Zeilen** – Die Zeile, über die der Mauszeiger bewegt wird, wechselt zur Hover-Hintergrundfarbe. So können Besucher leichter verfolgen, welche Zeile sie gerade lesen.
**Mit Hover-Effekt**
* **Kompakt (weniger Innenabstand)** – Reduziert den Zellen-Innenabstand und macht die Tabelle kompakter, ohne den Inhalt zu verändern.
**Kompakt (weniger Innenabstand)**
**Weit (mehr Innenabstand)**
* **Schriftgröße** – Wähle eine einheitliche Textgröße für alle Zellen (z. B. Groß, Mittel, Klein).
* **Maximale Höhe** – Begrenzt die Tabellenhöhe in Pixel. Ist der Inhalt höher als der angegebene Wert, erscheint eine Scrollleiste.
* **Scroll-Lock (X/Y getrennt)** – Ermöglicht unabhängiges horizontales und vertikales Scrollen innerhalb der Tabelle. Besonders nützlich bei breiten Tabellen mit festem Header.
## Farben
Im **Farben**-Tab definierst du das komplette Farbschema der Tabelle. Die Eingabe erfolgt entweder direkt als RGB-Wert oder über den integrierten Farbwähler, der sich per Klick auf den Farbkreis neben dem jeweiligen Eingabefeld öffnet:
* **Header-Hintergrund** – Hintergrundfarbe der Kopfzeile.
* **Header-Textfarbe** – Schriftfarbe innerhalb der Kopfzeile.
* **Striped-Hintergrund (gerade Zeilen)** – Hintergrundfarbe für gerade Zeilen beim Zebrastreifen-Muster.
* **Rahmenfarbe** – Farbe aller Zelltrennlinien.
* **Hover-Hintergrund** – Hintergrundfarbe beim Überfahren einer Zeile mit der Maus.
## Mobile
Im **Mobile**-Tab legst du fest, wie sich die Tabelle auf kleinen Bildschirmen verhält. Zwei Einstellungen stehen zur Verfügung:
**Mobile-Strategie** – Bestimmt das Darstellungsverhalten auf mobilen Geräten:
* **Auto – Card unter Breakpoint, Scroll darüber** – Unterhalb des Breakpoints wird jede Tabellenzeile als eigene Karte angezeigt (Spaltenbezeichnung als Label links, Inhalt rechts). Auf Geräten oberhalb des Breakpoints bleibt die normale Tabellenstruktur erhalten und lässt sich horizontal scrollen.
* **Horizontal scrollbar, erste Spalte sticky** – Die Tabelle bleibt auf allen Bildschirmgrößen als Tabelle erhalten und ist horizontal scrollbar. Die erste Spalte bleibt dabei immer sichtbar (sticky), was bei vielen Spalten die Orientierung erleichtert.
* **Card-Modus (jede Zeile als Block)** – Jede Zeile wird unabhängig von der Bildschirmgröße immer als Karte dargestellt.
* **Keine Optimierung** – Die Tabelle wird ohne spezielle mobile Anpassung ausgegeben. Geeignet, wenn du das responsive Verhalten selbst per CSS steuerst.
**Breakpoint** – Die Bildschirmbreite, ab der die Mobile-Strategie greift (nur relevant für „Auto"):
* **Klein (\< 576 px)** – Greift bei sehr kleinen Smartphones im Hochformat.
* **Mittel (\< 768 px)** – Greift bei den meisten Smartphones.
* **Groß (\< 992 px)** – Greift auch auf kleinen Tablets.
**Tipp:** Tabellen sind sehr flexibel. Experimentiere mit verschiedenen Style- und Farbkombinationen, um die optimale Darstellung für deine Inhalte zu finden.
# Vergleich-Schieber
Source: https://docs.dreizack-medien.de/OPC-Plus/vergleich
Veranschauliche Unterschiede zwischen zwei Bildern mit einem interaktiven Slider.
## 
# Allgemeine Beschreibung
Der **Vergleich-Schieber** (oft auch "Vorher-Nachher-Slider" genannt) ist ein interaktives Tool, mit dem Nutzer zwei übereinanderliegende Bilder durch Verschieben eines Trennbalkens direkt vergleichen können. Dies eignet sich hervorragend, um visuelle Veränderungen, Varianten oder Zustände eindrucksvoll zu demonstrieren.
# Einsatzmöglichkeiten (Inspiration)
Du kannst den Vergleich-Schieber für verschiedene Zwecke nutzen:
* **Vorher-Nachher-Effekte:** Zeige die Wirkung von Reinigungsmitteln, Bildbearbeitung oder Renovierungen.
* **Produktvarianten:** Vergleiche zwei Farben oder Ausführungen desselben Artikels.
* **Technische Details:** Visualisiere das Innenleben eines Geräts im Vergleich zum geschlossenen Gehäuse.
* **Zeitsprünge:** Stelle historische und aktuelle Aufnahmen eines Ortes gegenüber.
# Featureübersicht:
Das Portlet bietet dir folgende Kernfunktionen:
* **Intuitive Bedienung:** Nutzer können den Schieberegler einfach mit der Maus oder dem Finger bewegen.
* **Anpassbares Design:** Steuere die Farbe und das Symbol des Griffs (Handle).
* **Flexible Ausrichtung:** Lege fest, in welche Richtung der Vergleich funktionieren soll.
***
## Inhalt
In diesem Reiter pflegst du die beiden Bilder ein, die miteinander verglichen werden sollen (das "Vorher"- und das "Nachher"-Bild).
***
**Bild Vorher:** Lade hier das erste Bild (das Ausgangsbild) hoch oder wähle es aus der Medienverwaltung aus. Dieses Bild liegt standardmäßig links oder oben.
**Bild Nachher:** Lade hier das zweite Bild (das Vergleichsbild) hoch. Dieses Bild wird über das erste gelegt und durch den Schieberegler sichtbar gemacht.
* **Bild lazy laden:** Aktiviere diese Option, um das "Vorher"-Bild verzögert zu laden. Dies verbessert die Ladezeit der Seite, wenn der Slider nicht sofort im sichtbaren Bereich ist.
* **Bild bevorzugt laden:** Aktiviere diese Option, um das "Vorher"-Bild mit hoher Priorität zu laden. Dies wird empfohlen, wenn der Slider ganz oben auf der Seite platziert ist ("Above the Fold"), um den LCP-Wert zu optimieren.
* **Alternativ Text:** Hinterlege einen beschreibenden Text für das "Vorher"-Bild. Dies ist wichtig für die Barrierefreiheit (Screenreader) und die Suchmaschinenoptimierung (SEO).
* **Title Tag:** Gib hier den Titel-Tag für das "Vorher"-Bild ein (wird oft beim Überfahren mit der Maus angezeigt).
* **Alternativ Text:** Hinterlege einen eigenen beschreibenden Text speziell für das "Nachher"-Bild.
* **Title Tag:** Gib hier den Titel-Tag für das "Nachher"-Bild ein.
***
## Darstellung
In diesem Reiter konfigurierst du das visuelle Erscheinungsbild des Sliders und seiner Bedienelemente.
***
* **Label verwenden?:** Entscheide hier, ob Textbeschriftungen (Labels) auf den Bildern angezeigt werden sollen (z. B. "Nein").
* **Farbe des Vergleichsliders:** Wähle über den Farbwähler oder durch Eingabe eines Hex-Codes, die Farbe für die Trennlinie und den Anfasser (Handle).
* **Darstellung des Vergleichsliders:** Bestimme das Symbol für den Anfasser in der Mitte des Sliders. Die Optionen sind:
* **Kreis mit Pfeilen**
* **Pfeile**
* **Ausrichtung des Vergleichsliders:** Lege die Bewegungsrichtung des Sliders fest (z. B. **Horizontal** für einen Vergleich von links nach rechts).
***
***
# Changelog
Source: https://docs.dreizack-medien.de/OPC-Portlets-vererben/changelog
Alle Updates und Änderungen für OPC Portlets vererben
### Verbesserungen
* Kompatibilität mit JTL-Shop 5.8 bis 5.8.1
* Backend folgt dem Dark Mode (Admin-Bundle mit den Theme-Fixes aus dzm\_vue\_base)
### Bugfixes
* OPC-Editor: Die Markierungen (Rahmen und Labels) griffen bei Container-Portlets nicht
* OPC-Editor: In Entwürfen wurden die vererbten Portlets aller Mastertemplates eingefügt statt nur die des zugehörigen
* Kategorien erschienen in der Auswahl doppelt
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.0 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Features
* Kompatibilität mit JTL Shop 5.7.x
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.10.7
### Features
* Neues Admin Frontend
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.20
### Features
* Allgemeine Verbesserung der Codequalität
* Neuer Installservice \[BETA], checkt die installierte Resources Version und lädt die aktuellste kompatible Version automatisch nach
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.16
### Bugfix
* Wichtige Resources & Health Abhängigkeit
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.5
### Features
* Kompatibilität JTL Shop 5.4
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.3
### Bugfixes
* Kindartikel erben nicht vom Vater
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.8.0
### Features
* Kompatibilitätsupdate zu Resources v1.6.3
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.6.3
### Features
* Kompatibilitätsupdate zu Resources v1.5.0
* Produktmastertemplate filterbar nach Hersteller
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.5.0
### Features
* Kompatibilitätsupdate zu Resources v1.4.13
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.13
### Features
* Verbessertes Layout im Adminpanel
* Anpassung an neue Schnittstelle
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.0
### Bugfixes
* Fehler, wenn Vaterartikel keinen Entwurf besitzt
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.9
### Features
* Völlig überarbeitete Version des OPC Portlet Vererbers
* Master Templates noch einfacher und intuitiver anlegen, gestalten und vererben
* Mastertemplates für Header, Footer, Seiten, Produktseiten und Kategorieseiten
* Mastertemplates pro Sprache oder sprachübergreifend
* Automatisches Vererben vom Vaterartikel auf Kindartikel
* Gefilterte Produktseiten nach Kategorie, Warengruppe, Vater oder Kindartikel
* Kombination mit Smarty Portlet Plugin möglich
* Dokumentationstab in Plugineinstellungen
* Check, ob Object Buffer aktiv ist
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.7
### Features
* CSRF Token Validierung
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Automatische Funktionsprüfung auf Kompatibilität mit DZM Resources & Health
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Verbessertes Ressourcenmanagement
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Anlegen von Mastertemplates für Header, Footer, Kategorie und Artikelseiten
* Automatisches Vererben der Seiteninhalte auf alle Seiten des gleichen Typs
* Intelligente Logik für konsistente vererbte Inhalte
* Vererbte Seiten weiterhin bearbeitbar
* Komplette Bereinigung aller vererbten Inhalte
* Automatische Übertragung der Mastertemplates auf neue Produkte
### Kompatibilität
* JTL-Shop 5.1.5 - 5.1.\*
# Einfuehrung
Source: https://docs.dreizack-medien.de/OPC-Portlets-vererben/einfuehrung
# Was ist OPC Portlets vererben?
DZM OPC Portlets vererben verwandelt den JTL OPC Editor in eine mächtige Template Engine, mit der du Mastertemplates für Header, Footer, Kategorie- und Produktseiten anlegen kannst. Statt jede Seite einzeln zu bearbeiten, pflegst du Inhalte zentral im Mastertemplate und vererbst sie mit nur einem Klick auf alle relevanten Seiten – Änderungen am Master werden automatisch überall übernommen. Besonders praktisch: Bei Produkten kannst du Inhalte vom Vaterartikel automatisch auf alle Kindartikel vererben, wobei individuelle Anpassungen jederzeit möglich bleiben. Das Plugin spart bis zu 90% Zeit bei der Contentpflege und gibt dir die volle Kontrolle über dein Shop-Template. Vererbte Inhalte, die du auf einzelnen Seiten anpasst, werden als individuell markiert und nicht mehr überschrieben – so hast du maximale Flexibilität bei minimalem Aufwand.
## Einsatzmöglichkeiten
Editieren eines Headers und Footers für den gesamten Shop
Einfügen von Popups oder anderen OPC Elementen global im ganzen Shop
Anlegen von Produkt Content Vorlagen
Mastertemplates als Wire Frame für Produkt Content
Countdowns oder andere Elemente auf allen oder ausgewählten Produktseiten
Supportinformationen global auf allen Produkt und/oder Kategorieseiten
Einheitliche Produktinformationen für Produktgruppen global pflegen
Deiner Kreativität sind keine Grenzen gesetzt
***
## Featureübersicht
* Mastertemplates anlegen und global pflegen
* Automatische Übernahme der Inhalte eines Mastertemplates auf entsprechende Seiten
* Mastertemplates für Header
* Mastertemplates für Footer
* Mastertemplates für Seiten
* Mastertemplates für Produkte
* Mastertemplates für Kategorien
* Automatisch von Vaterartikel auf Kindartikel vererben
* Alle Inhalte individualisierbar
* Vererbte Inhalte bleiben mit Mastertemplates synchronisiert
* Individuelle Anpassungen werden respektiert
***
## Bedienung und Funktionsweise
### Begrifflichkeiten
In der folgenden Dokumentation reden wir stets über Entwürfe. Entwürfe sind OPC Pages, die mit dem OPC Editor angelegt werden. Jede Seite kann mehrere individuelle Entwürfe haben, aber es ist immer nur maximal einer aktiv. Wenn wir also von Entwürfen reden, meinen wir immer den gerade aktiven Entwurf der jeweiligen Seite. Entwurf, Page, Template oder OPC Page sind in diesem Zusammenhang synonym.
Portlets sind die Bausteine, die du im OPC Editor in die verschiedenen Bereiche ziehen kannst, um Inhalt darzustellen. Portlet und Block sind synonym zu verstehen.
Mountpoints sind die Bereiche in die du im OPC Editor Portlets ziehen kannst. Mountpoints tauchen nicht immer auf allen Seiten auf. Es gibt spezielle Mountpoints, die nur dann auftauchen, wenn auch anderer Inhalt geladen wird. zB werden bei der Artikelbeschreibung 2 Mountpoints vor und nach der Beschreibung nur dann geladen, wenn eine Artikelbeschreibung vorhanden ist. Als Artikelbeschreibung genügt dann zwar ein Leerzeichen, aber sie muss vorhanden sein.
### Vererbungslogik
Der OPC Vererber arbeitet mit Mastertemplates, die auf den OPC Entwürfen beruhen. Statt also für jede Seite einen eigenen Entwurf anlegen zu müssen, können Inhalte, die auf mehreren Seiten dargestellt werden sollen in einem Mastertemplate gepflegt werden. Diese können dann im Nachgang auch noch bearbeitet werden, sodass sich die Inhalte global pflegen lassen, ohne dass jede Seite einzeln bearbeitet werden muss.
#### Vererbungslogik und Anpassung
Der Vererber vereint den aktuellen Entwurf der jeweiligen Seite mit allen passenden Mastertemplates. Die jeweiligen Inhalte der Mastertemplates werden je nach Priorität an bestehende Inhalte angehangen.
Hat eine Seite noch keinen Entwurf, werden nur die Inhalte der Mastertemplates angezeigt, nach Priorität
Öffnet man im OPC Editor eine Seite, werden vererbte Inhalte farblich gekennzeichnet
Verändert man Inhalte in den Mastertemplates, werden diese automatisch auf den Erben übernommen
Vererbte Inhalte können auf individuellen Seiten angepasst werden. Der Vererber weiß dann, dass das Portlet aus einem Master stammt, überschreibt diese Inhalte aber nicht mehr
Vererbte Inhalte können nur komplett oder gar nicht angepasst werden. Die Änderung eines verschachtelten Portlets, zB innerhalb eines vererbten Containers, führt dazu, dass der Originalcontainer aus dem Mastertemplate den Inhalt überschreibt. Der Vererbte Container muss als ganzes bearbeitet werden, damit er als individueller Inhalt gespeichert wird. Dann können auch verschachtelte Portlets bearbeitet werden.
Individuelle Inhalte können auf individuellen Seiten weiterhin gepflegt werden.
Inhalte aus Vaterartikeln können nach Einstellung automatisch auf Kinder übernommen werden. Die Logik zur Vererbung und Individualisierung von Vater auf Kindartikeln ist gleich wie die von Mastertemplates auf Individuelle Seiten
**VERERBTE PORTLETS NIEMALS IM EDITOR DUPLIZIEREN ODER ALS BLUEPRINT SPEICHERN!**
Vererbte Portlets arbeiten mit speziellen Tags, die eine exakte Zuordnung garantieren. Würde man ein bereits vererbtes Portlet in einem Mastertemplate oder einem Entwurf duplizieren, kann das unvorhersehbare Auswirkungen auf den Entwurf haben. Bitte kopiere daher keine bereits gespeicherten Portlets, die eine Markierung besitzen.
***
## Kennzeichnungen im OPC Editor

Auf der Grafik sieht man ein mal alle Zustände, die ein Vererbtes Portlet annehmen kann. Auch wenn der Vererber so konstruiert wurde, dass er intuitiv funktioniert, möchten wir euch hier einmal alle Zustände und Kennzeichnungen erklären.
### Ursprung: Mastertemplate | Verändert: nein
Das Portlet wurde in einem Mastertemplate angelegt und ist im aktuellen individuellen Entwurf unverändert. Der Inhalt lässt sich im Mastertemplate anpassen und so automatisch auf alle anderen Seiten übertragen. Solange dieses Portlet im individuellen Entwurf nicht bearbeitet wird, bleibt die Eigenschaft erhalten, dass der Inhalt im Mastertemplate bearbeitet werden kann.
**Portlets mit dieser Markierung können auf individuellen Seiten nicht gelöscht werden**. Diese Portlets müssen im Mastertemplate angepasst werden.
Wird ein Portlet dieser Art bearbeitet und gespeichert, wird es als **individualisiert** angesehen und erhält beim nächsten Öffnen des Editors die Markierung **Urprung: Mastertemplate | Verändert: ja**
Der Inhalt wird dann nicht mehr vom Mastertemplate überschrieben. Der Inhalt kann zurückgesetzt werden indem man das individualisierte Portlet löscht.
### Ursprung: Mastertemplate | Verändert: ja
Das Portlet stammt ursprünglich aus einem Mastertemplate, wurde aber auf der individuellen Seite verändert. Der Vererber registriert beim Seitenaufbau, dass dieser Block nicht mit Inhalt aus dem Master überschrieben werden soll. Änderungen müssen fortan am individuellen Entwurf erfolgen. Löschen des Portlets im Master hat keine Auswirkung. Löschen des Portlets im individuellen Entwurf führt dazu, dass das Original aus dem Master wiederhergestellt wird.
### Ursprung: Content aus Vaterartikel
Dieses Portlet ist individueller Inhalt eines Vaterartikels. Wenn du dich gerade im Entwurf des Vaterartikels befindest, kannst du den Block bearbeiten. Bei gesetzter Einstellung werden alle Portlets aus dem Vaterartikel auf die Kindartikel übertragen. Du kannst dir das so vorstellen, als ob jeder Vaterartikel ein Mastertemplate für seine Kinderartikel ist mit allen Auswirkungen und Konsequenzen, die auch ein unverändertes Portlet eines Mastertemplates hat. Unveränderter Content kann also nur im Vaterartikel bearbeitet werden. Löschen hat im Kindartikel keine Auswirkung. Das Portlet muss im Vater gelöscht werden, damit es auch in den Kindern nicht mehr auftaucht.
### Ursprung: Content aus Vaterartikel | Verändert
Dieses Portlet wurde im Vaterartikel angelegt und nun im Entwurf eines seiner Kinder bearbeitet und gespeichert. Ähnlich wie bei veränderten Masterportlets registriert der Vererber, dass der Inhalt aus dem Vaterartikel stammt und überschreibt seinen Inhalt nicht. Individueller Inhalt kann nun nur noch im Kind bearbeitet werden. Wird der Block gelöscht, übernimmt der Entwurf wieder den Block des Vaterartikels. Wird der Block im Vater gelöscht, bleibt individueller Inhalt bestehen.
### Ursprung: Mastertemplate verändert in Vaterartikel | Verändert in Kindartikel
Der sehr komplex klingende Fall ist das einfache Ergebnis einer Bearbeitungskette. Ein Portlet wurde in einem Mastertemplate für Produkte angelegt, im Vaterartikel wurde dieser verändert und anschließend noch mal im Kind verfeinert. Der Inhalt verhält sich so wie jeder individuelle Block. Er wird als Vererbter Block erkannt, aber sein Inhalt wird nicht überschrieben.
Ein Praktischer Anwendungsfall wäre, dass das Mastertemplate nur als grobe Vorlage dient, damit jeder Artikel grundsätzlichen Inhalt hat. Anschließend werden im Vatertemplate Inhalte für den Artikel allgemein gepflegt. Da das Mastertemplate schon die Struktur vorgibt, sind die Inhalte schneller erarbeitet. Im letzten Schritt werden Zusatzinformationen zu einzelnen Kindartikeln nur noch verfeinert, was einerseits massiv Zeit einspart und darüber hinaus bewirkt, dass neue Artikelvariationen bereits die Basic Informationen des Vaters erben, ohne dass man diesen Inhalt individuell anlegen musste.
### Keine Markierung
Ganz normaler individueller Inhalt, der nicht vererbt wird.
***
# Installation
Source: https://docs.dreizack-medien.de/OPC-Portlets-vererben/installation
Schritt-für-Schritt Anleitung zur Installation von DZM OPC Portlets vererben
## Einführung
### Was ist DZM OPC Portlets vererben?
Mit OPC Portlets vererben erhältst du ein mächtiges Tool, welches den OPC Editor zur ultimativen Template Engine aufrüstet. Jetzt kannst du Mastertemplates für Header, Footer, Kategorie und Artikelseiten anlegen und mit nur einem Klick vererben.
Vererbte Inhalte kannst du in deinem Mastertemplate ein mal anpassen und wieder neu vererben. Individuelle Inhalte auf Einzelseiten bleiben dabei unberührt.
Mit nur einem Klick, kannst du vererbten Content auch direkt wieder auf allen Seiten entfernen. Jetzt hast du die absolute Kontrolle über dein Template.
***
## Vor der Installation
**BEVOR DU BEGINNST**
Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
### Schnellübersicht
Das kostenlose Basis-Plugin muss als erstes installiert sein
Das Haupt-Plugin herunterladen und hochladen
Den Lizenzschlüssel in den Plugineinstellungen aktivieren
***
## Vorbereitung
### Wo finde ich die Installationsfiles?
Die Installer Pakete findest du jeweils am Produkt.


In der Sidebar findest du alle veröffentlichten Versionen.
**Wichtige Hinweise bei der Versionsauswahl:**
* Achte auf die Info, ob das Plugin Resources & Health benötigt und in welcher Version
* Achte auf die kompatible Version
* Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast
**Resources & Health ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop.** Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
### Wo finde ich die Lizenzschlüssel?
Deine Lizenzschlüssel findest du direkt nach der Buchung in deinem Kundenkonto unter **Meine Lizenzen**

Diesen Lizenzschlüssel trägst du im jeweiligen Plugin ein.
Einen Lizenzschlüssel findest du hier nur, wenn du das Produkt über unseren Store gebucht hast.
### Welche Lizenzen muss ich buchen?
Resources & Health benötigt keine Lizenz und kann direkt runter geladen und verwendet werden.
Alle anderen Plugins benötigen eine Lizenz.
Für **OPC Suite** benötigst du einen Lizenzschlüssel.
**OPC Suite** bietet eine Bundle Lizenz für alle weiteren Produkte:
* OPC Plus
* OPC Conversion Booster
* OPC Smarty Portlets
* OPC Portlets vererben
Das bedeutet, dass nur allein mit der Aktivierung einer OPC Suite Lizenz automatisch auch die Plugins OPC Plus, OPC Conversion Booster, OPC Smarty Portlets und OPC Portlets vererben aktiviert hast. **In diesem Fall musst du in den anderen Plugins keinen eigenen Schlüssel mehr hinterlegen.**
***
## Installation
### 1. Resources & Health installieren
Lade unter [https://dreizack-medien.de/DZM-Resources-Health](https://dreizack-medien.de/DZM-Resources-Health) unser Plugin **Resources & Health**


Achte auf die Wahl der passenden Version

Lade die eben herunter geladene Zipdatei über den Plugin Manager in deinen Store hoch

Unter **Vorhanden** wählst du nun das hochgeladene Plugin aus, akzeptierst ggfs die Lizenzbedingungen und klickst auf **Installieren**.
### 2. OPC Portlets Vererben Lizenz buchen
Registriere dich in unserem Store.
Wähle unter [https://dreizack-medien.de/DZM-OPC-Portlets-vererben](https://dreizack-medien.de/DZM-OPC-Portlets-vererben) die passende Kaufoption aus.
In diesem Beispiel ordern wir eine Lizenz für **OPC Portlets Vererben** als **Vollversion** und tragen unsere Domain ein, ohne https\:// oder führendes [www](http://www).

Diese Auswahl ist nur möglich, wenn du bereits angemeldet bist. Eine Bestellung ohne Registrierung ist ausgeschlossen!
Wenn du bereits eine Demo- oder Entwicklerlizenz hast und angemeldet bist, kannst du alternativ zur Registrierung einer neuen Domain einfach unten im Dropdown deine bestehende Lizenz auswählen und in eine Vollversion umwandeln. Die passende Domain wird dann automatisch übernommen.
Domains einer produktiven Lizenz kannst du später in deinem Kundenkonto bearbeiten und ändern. Wenn du also auf einer Staging Domain gearbeitet hast, kannst du die Lizenz hier in eine Vollversion umwandeln und anschließend in deinem Kundenkonto auf die Live Domain umschreiben.
### 3. OPC Portlets Vererben downloaden und installieren
Kehre nach erfolgreicher Buchung auf die Produktseite zurück und lade hier die passende Version von OPC Portlets Vererben herunter
[https://dreizack-medien.de/DZM-OPC-Portlets-vererben](https://dreizack-medien.de/DZM-OPC-Portlets-vererben)

Lade anschließend die Zipdatei wie oben bei Resources & Health über den **Pluginmanager** in deinen Store hoch, und installiere das Plugin
### 4. Lizenz aktivieren
Wechsel in unserem Store in dein **Kundenkonto** unter **Meine Lizenzen** und kopiere dir den **Lizenzschlüssel** für deine Domain.
Unter Umständen kann es passieren, dass sich das OPC Portlets Vererben Plugin so lange selbst deaktiviert, bis eine gültige Lizenz eingetragen wurde.
Aktiviere in diesem Fall das Plugin einfach wieder und wechsle **sofort** in die **Plugineinstellungen** und trage den Lizenzschlüssel ein. In wenigen Ausnahmefällen kann es sein, dass sich das Plugin noch ein mal selbst deaktiviert, nachdem du den Schlüssel eingetragen hast. Aber keine Sorge. Nach letztmaliger Aktivierung bleibt es auch aktiviert. Versprochen ;)


Trage deinen Lizenzschlüssel unter **Lizenz** ein und klick auf **Speichern**

Das Plugin signalisiert dir, dass die Lizenz valide und aktiv ist.
**Glückwunsch!** Die Installation ist abgeschlossen. Du kannst jetzt mit der Konfiguration beginnen.
# Mastertemplates
Source: https://docs.dreizack-medien.de/OPC-Portlets-vererben/mastertemplates
Mastertemplates erstellen, verwalten und Best Practices
## Übersicht
Im Menüpunkt **Mastertemplates** kannst du Mastertemplates für verschiedene Seitenarten anlegen, bearbeiten und steuern. Im Oberen Teil befindet sich die Maske zur Erstellung neuer Mastertemplates. Im unteren Bereich findest du eine Tabelle mit allen angelegten Templates. Diese kannst du von dort aus steuern und bearbeiten.
***
## Mastertemplate anlegen
Wähle hier zwischen Header, Footer, Seiten, Produkt und Kategorie. Das Template wird entsprechend seines Typs auf einen oder mehrere Seitentypen angewandt.
* **Header** und **Footer** werden nach Ihrer Art auf allen Seiten geladen
* **Seiten** beschränkt sich auf alle Inhaltsseiten wie die Startseite, Blogposts, Impressum, Kontakt, AGB, etc. Dieser Typ eignet sich insbesondere für Zusatzinformationen, die auf allen Seiten interessant sind (zB. ein Kontaktformular oder eine Supporthotline)
* **Produkt** und **Kategorie** sind selbsterklärend
Bei Auswahl von Produkt oder Kategorie erweitert sich der Bereich **Filter**, um die Templates auf spezielle Kategorien oder Produkte einzuschränken. Du kannst mehrere Templates aktiv haben. Alle Templates werden entsprechend ihrer Priorität zusammen mit dem individuellen Entwurf einer Seite zusammengefügt.
Hier kannst du einen individuellen Namen vergeben, um dein Template schnell wieder zu erkennen.
Wähle hier die Sprache für die das Template gelten soll. Wenn du die Checkbox **Auf alle Sprachen anwenden** aktivierst, gilt dieses Template für alle deinen Sprachen. Das ist sinnvoll für Inhalt, der keinen Text hat wie eine Karte oder ein Bild.
Produkt und Kategorieseiten können genauer gefiltert werden. Siehe dazu den Abschnitt **Mastertemplates filtern**
Da jedes Mastertemplate auf einem OPC Entwurf basiert, musst du ein Objekt auswählen auf dem du entwickeln möchtest. Der Entwurf wird nicht veröffentlicht und dient nur als Rahmen.
Beachte, dass JTL-seitig manche Mountpoints erst dann auftauchen, wenn bereits Inhalt auf der Seite existiert. zB im Bereich Artikelbeschreibung werden 2 Mountpoints vor und nach der Beschreibung erst dann geladen, wenn der Artikel über eine Artikelbeschreibung verfügt.
* Eine Vorschauseite mit allen Mountpoints bietet maximale Flexibilität, aber möglicherweise werden die Inhalte nicht auf allen vererbten Seiten ausgespielt
* Eine Vorschauseite mit wenigen Mountpoints bietet zwar weniger Flexibilität, dafür ist es sicherer, dass du Mountpoints bestückst, die überall auftauchen
**Hierbei handelt es sich um einen Mechanismus, der aus dem JTL Shop stammt und auf den wir keinen Einfluss haben.**
Klick auf den Button, wenn du mit deinen Einstellungen zufrieden bist. Filter kannst du später noch ändern. Die Sprache kannst du nicht mehr ändern, aber dafür die Einstellung, ob auf alle Sprachen angewandt werden soll oder nicht. Später kannst du Templates auch noch aktivieren und deaktiveren, priorisieren und für andere Sprachen duplizieren.
***
## Mastertemplates filtern
Je nach Vorlagentyp hast du spezielle Filtermöglichkeiten:
* Kategorien
* Produktgruppen
* Vaterartikel
* Kindartikel
* Kategorien
### Kategorien
Wähle hier auf welche Kategorien sich das Template beschränken soll.
**Für Produkte:** Nur Produkte der ausgewählten Kategorien erben das Template. Wenn du die Option aktivierst **Unterkategorien mit einbeziehen,** findet das Template auch auf Produkte Anwendung, die in Unterkategorien liegen. Für die Anwendung muss das Produkt in mindestens einer der Kategorien liegen.
**Für Kategorien:** Du kannst hier einzelne Kategorien und, je nach Einstellung, ihre Unterkategorien auswählen auf die das Template Anwendung finden soll.
Wähle nichts aus, damit alle Kategorien Anwendung finden.
### Produktgruppen
Wähle hier Produktgruppen aus, für die das Template angewandt werden soll. Das Template findet dann nur Anwendung auf ein Produkt, wenn es die Produktgruppe besitzt. Du kannst mehrere Produktgruppen auswählen.
Wähle nichts aus, damit alle Produktgruppen angewandt werden
### Auf Vaterartikel anwenden
Das Template wird auf Vaterartikel angewandt (Standard)
### Auf Kindartikel anwenden
Das Template wird auf Kindartikel angewandt (Standard).
Wenn du ohnehin die Einstellung gewählt hast, dass vom Vaterartikel auf Kindartikel vererbt werden soll, hat diese Einstellung keine Auswirkung, wenn das Template bereits auf den Vaterartikel angewandt wird.
***
## Tabelle angelegter Mastertemplates
In der Tabelle siehst du deine angelegten Mastertemplates.
**Allgemeines zum Speichern von Änderungen:**
Du kannst an allen Zeilen Änderungen vornehmen. Am Ende musst du aber deine geänderten Spalten mit der Checkbox am Anfang der Zeile auswählen und oben auf den Button **Ausgewählte Templates speichern** klicken, damit die Änderungen übernommen werden.
### Bedienelemente
Klicke auf den Pfeil ganz links in der Zeile, um die erweiterten Optionen des Templates aufzuklappen. Dort findest du folgende Einstellungen:
* **Für Sprache kopieren** – Wähle eine Sprache aus dem Dropdown und klicke auf **Für gewählte Sprache kopieren**, um das Template für eine andere Sprache zu duplizieren.
* **Auf alle Sprachen anwenden?** – Aktiviere diesen Schalter, damit das Template sprachübergreifend gilt.
* **Aktiv** – Aktiviere oder deaktiviere das Template direkt hier.
* **Änderungen übernehmen** – Klicke auf **Speichern**, um alle vorgenommenen Änderungen zu sichern.
* **Mastertemplates löschen** – Klicke auf **Template löschen**, um das Template zu entfernen.
Beachte, dass bereits individualisierte, vererbte Inhalte nicht vom Deaktivieren oder Löschen betroffen sind – nur unangetastete, vererbte Portlets werden beeinflusst.
Öffnet das Template im OPC Editor zur Bearbeitung. Hier kannst du Portlets in die Mountpoints ziehen und den Entwurf speichern.
Zeigt an, für welche Sprache das Template gilt. Wurde **Auf alle Sprachen anwenden** aktiviert, gilt das Template sprachübergreifend.
Zeigt den aktuellen Aktivstatus des Templates. Inaktive Templates werden nicht geladen.
Zeigt Datum und Uhrzeit der letzten Bearbeitung des Templates.
Klicke auf **Speichern**, um alle vorgenommenen Änderungen an dem Template zu sichern.
Klicke auf **Template löschen**, um das Template zu entfernen.
Bereits individualisierte, vererbte Inhalte auf einzelnen Seiten werden vom Löschen nicht beeinflusst – nur unangetastete, vererbte Portlets werden entfernt.
***
## Mastertemplates bearbeiten

Nachdem du dein Template angelegt hast, kannst du mit einem Klick auf **Bearbeiten** mit dem Entwurf beginnen. Wie du siehst, sieht der OPC Editor etwas anders aus. Der Entwurf kann hier auch nicht veröffentlicht, sondern nur gespeichert werden. Ansonsten ist alles wie gehabt. Ziehe einfach deine Portlets in die Mountpoints und speichere deinen Entwurf.
Je nach Seitentyp, werden nur relevante Bereiche angezeigt. So werden zB bei **Produkt** kein Header und Footer geladen, bei **Header** aber wiederum nur der Header.
**Beachte die Markierungen!**
Lies den Abschnitt zum Thema Markierungen sorgfältig durch. Bitte kopiere niemals einen bereits markierten Block. Die Markierung eines vererbten Portlets wird wirksam und sichtbar, wenn du das Template speicherst und die Editor Seite ein mal neu lädst. Von da an solltest du bitte diese Blöcke nicht mehr duplizieren oder als Blueprint speichern.
### Verschachtelte Portlets
Du kannst alle Portlets verwenden und auch ganze Blueprints hier verwenden. Beachte bitte dabei folgendes:
Die Vererbung funktioniert immer nur ab der ersten Ebene. Ein vererbter Block merkt sich zwar, dass er Inhalt hat und das können auch verschachtelte Portlets sein, ein vererbter Block wird aber immer als ganze Einheit betrachtet. Komplexe Teilvererbungen teilverschachtelter Portlets sind nicht möglich. Die Vererbung beginnt immer ab der obersten Ebene und nimmt alles mit was in diesem Block steckt.
**Beispiel:** Du kannst einen Container in einen Mountpoint ziehen und in den Container ein Grid und in das Grid wiederum ein Bild und so weiter. Der Container gilt als der Block, samt Inhalt, der vererbt wird.
### Änderungslogik
Sobald du die Seite ein mal gespeichert hast, werden die Inhalte auf den entsprechenden Seiten mit dargestellt.
**Kurzum: Unveränderte Portlets bearbeitest du im Mastertemplate, alles andere sind individuelle Blöcke, die wie gewohnt auf der individuellen Seite bearbeitet werden.**
***
## Best Practice
In diesem Abschnitt wollen wir dir ein paar Anwendungsbeispiele mitgeben mit denen du das Meiste aus dem Vererber herausholen kannst und so weit mehr als 90% Zeitersparnis erzielen kannst bei der Contentpflege und dein Wunschtemplate einfach selbst gestalten kannst.
### Header und Footer - Herz jedes Templates
Der Header ist das was deine Kunde als aller erstes zu Gesicht bekommen. Schon hier kannst du überzeugen oder abschrecken. Aber auch ein aufgeräumter Footer erfreut deine Besucher. Hier ist viel Platz für nützliche Hilfselemente oder Platz für die Darstellung deines Unternehmens.
Darüber hinaus eignen sich Header und Footer auch sehr für die Platzierung von übergreifendem Content wie Popups oder schwebenden Widgets.
Überlade deinen Header nicht, aber ein paar kleine Accessoires dürften nicht schaden. Nutze zB. die USP Line aus OPC Plus für die Darstellung deiner 3 - 4 Kernkompetenzen oder bau dir eine kleine Topbar über der Navigation. Die USP Line passt auch hervorragend unter die Navigation.
Kurz überm Footer kannst du mit ein paar Handgriffen deine Nutzer noch mal abholen. Vielleicht mit einer Google Maps, auf der dein Ladengeschäft mit einem Klick zu finden ist, oder platziere einen Block mit Informationen zu Kontaktmöglichkeiten. Wenn Besucher so weit runter scrollen, dass sie deinen Footer sehen, wollen sie dich vermutlich kontaktieren. Hilf ihnen dabei und biete auf jeder Seite einen kleinen Informationscontainer mit Kontaktinformationen.
Nutze den Footer auch, um Popups und Widgets per Portlet zu installieren. Diese Inhalte sind nicht an den Platz gebunden wo du sie einpflegst. Ein Popup mit unserem kostenfreien Portlet **Popupcontainer** kannst du so mit nur einer Vorlage auf jeder Seite platzieren. Nutze das Popup zum Beispiel für einen Exit Intent. In das Popup baust du ein ansprechendes Bild ein und sprichst deine Besucher noch mal an, bevor sie die Seite verlassen, zB. mit einem Gutscheincode. Durch das Footertemplate wird das Popup auf jeder Seite wirksam. Und wenn du unser **Elfsight** Widgets Plus Plugin verwendest, kannst du das Footertemplate auch verwenden, um beispielsweise einen Whatsapp Chat auf allen Seiten einzubauen.
***
### Produktinformationen pflegen
Mit der richtigen Vorgehensweise kannst du die Pflege deiner Produktbeschreibungen nicht nur ansprechender gestalten, sondern dabei auch noch 90% Zeit sparen. Und so gehst du dabei vor:
Ein Wireframe ist eine skizzenartige Vorlage für den Seitenaufbau. Hier geht es noch nicht um konkreten Inhalt, aber schon um den Aufbau und die Struktur deiner Produktseite.
Lege dir also ein Mastertemplate vom Typ Produkt an und fang an deine Produktseite zu gestalten. Verwende Bilder und Texte, aber ohne konkreten Inhalt, nur als Platzhalter. Du kannst dafür auch Bilder und Texte verwenden, die ausdrücken, dass es sich um Platzhalter handelt.
Da Mastertemplates sich direkt auf alle Seiten auswirken, sehen deine Kunden dann schon eine Struktur und dass du aktiv an deinen Inhalten arbeitest. Das Mastertemplate ist hier etwas mehr als nur ein Wireframe. Du kannst schon die richtigen Styles setzen und sparst dir so Zeit auf jeder einzelnen Produktseite. So schnell bist du nicht mal mit Blueprints.
Lege dir beliebige weitere Mastertemplates für Informationen an, die nicht weiter bearbeitet werden müssen, aber auch allen Seiten gleich sind.
Beispielsweise ist es sinnvoll am Ende noch eine Kontaktmöglichkeit zu hinterlegen oder ein Kontaktformular. Oder du hast besondere Informationen für eine Produktgruppe, die überall gleich ist. Dann leg dir ein Mastertemplate pro Produktgruppe an und pflege dort die speziellen Inhalte, die für diese Produktgruppe passend ist.
Nachdem du dein Wireframe angelegt hast, und die allgemeinen Produktinformationen über die Mastertemplates gepflegt werden gehst du nun in deine Vaterartikel.
Hier findest du nun schon alle Portlets vererbt aus deinem Mastertemplate. Du musst jetzt nur noch in die einzelnen Bereiche gehen und die Inhalte anpassen. Das geht deutlich schneller, oder?
Egal, ob du spezielle Inhalte in den Kindartikeln hast oder nicht, geh in die Einstellungen von OPC Portlets Vererben und setze unter **Settings** die Einstellung **Vaterarikel auf Kinder vererben**.
**Der gigantische Vorteil:** Alle Kindartikel haben jetzt bereits die Informationen vom Vaterartikel geerbt. Wenn du keine besonderen Anpassungen mehr hast, bist du hier fertig. Und noch besser: Wenn du eine neue Variation hinzufügst, erbt diese automatisch den Inhalt vom Vater.
Du kannst aber jetzt auch noch in die Kinder gehen und dort die Inhalte spezifizieren. Editiere den bestehenden Content oder füge einzelne, individuelle Portlets hinzu.
**MERKE DIR:**
Versuch so viel Content wie möglich auf Master- und Vaterartikelseiten zu belassen. So hast du auch im Nachgang weniger zu pflegen, weil die Inhalte vererbt werden können. Wenn du nur kleine Anpassungen hast, füge lieber einen individuellen Block hinzu und belasse vererbte Inhalte so wie sie sind. Auf diese weise erben die Kinder auch noch vom Vater oder Master, wenn diese Inhalte verändert werden.
#### Zusätzliche Tipps
Einen Produktabschnitt kannst du zB in einen allgemeinen und einen speziellen Abschnitt teilen. Halte den speziellen Abschnitt aber getrennt vom allgemeinen Abschnitt, damit du die Anpassungen am allgemeinen Abschnitt nur im Vater ändern musst und diese sich dann automatisch auf die Kinder übertragen.
Gestalte allgemeine Informationen zu Produktgruppen oder Kontaktmöglichkeiten so, dass du sie nicht speziell im Vater oder im Kind anpassen musst. So kannst du mit einer Änderung im Master alle Seiten gleichzeitig beeinflussen.
***
### Allgemeine Hinweise für Produktgruppen
COMING SOON...
***
### Verschachtelte Inhalte für Vererber vorbereiten
COMING SOON...
***
### Automatische Produktbeschreibungen
COMING SOON...
# Settings & Konfiguration
Source: https://docs.dreizack-medien.de/OPC-Portlets-vererben/settings
Alle Einstellungen und Funktionsweise von OPC Portlets vererben
## Plugin Settings
### Vater auf Kindartikel vererben
Wenn aktiviert, werden die Inhalte eines aktiven Vaterartikelentwurfs von den Kindartikeln übernommen. Die Inhalte können dann noch auf den jeweiligen Kindartikelseiten individualisiert werden. Veränderungen im Vaterartikel werden automatisch auf unveränderte Portlets in Kindartikeln übernommen. Vererbte Portlets lassen sich nur im Vater endgültig löschen. Veränderte Portlets auf Kindartikelseiten bleiben unabhängig vom Vater als individueller Content bestehen, auch wenn dieser im Vater gelöscht wird.
Aktiviere hier die Vererbung von Portlets vom Vaterartikel auf alle Kindartikel.
### Templates bereinigen
**VORSICHT MIT DIESER OPTION!**
Sämtliche Entwürfe werden auf Portlets mit spezieller Markierung durchsucht. Entsprechende Portlets werden aus den Entwürfen entfernt. **Das gilt auch für veränderte, vererbte Portlets**. Unberührt bleiben NUR individuelle Portlets. Bitte beachte, dass auch individueller Inhalt von Vaterartikeln getagged werden und der Bereinigung zum Opfer fallen kann.
Klicke auf „Alle Templates bereinigen", um sämtliche vererbten Portlets aus allen Entwürfen zu entfernen. Dieser Vorgang kann nicht rückgängig gemacht werden.
### Cache Optionen
Manchmal kann es hilfreich sein, den speziellen Cache für die vererbten Seiten zu leeren – zum Beispiel wenn sich eine Änderung nicht sofort im Shop-Frontend zeigt. Der Cache speichert die komplexe Berechnung der individuellen Seiten, um die Performance aufrechtzuerhalten.
Klicke auf „Cache leeren", um den Cache für vererbte Seiten zurückzusetzen.
# Artikel-Variablen
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/artikel-variablen
Artikelvariablen per Drag & Drop auf der Produktdetailseite platzieren
## Allgemeine Beschreibung
Mit dem Artikel-Variablen-Portlet kannst du Artikelvariablen überall auf der Produktdetailseite an den jeweiligen Mountpoints platzieren. Die Inhalte kommen in der Regel aus Deiner JTL-Wawi und werden mit dem Smarty-Template-System an der jeweiligen Stelle ausgegeben - und das ganze vollkommen ohne Code und intuitiv per Drag & Drop.
## Settings
### Allgemein
**Variable wählen:** Wähle hier aus einer Vielzahl an Variablen, die ausgegeben werden können:
* Name
* Kurzbezeichnung
* Beschreibungstext
* Kurzbeschreibung
* Hersteller
* Warengruppe
* SKU
* EAN
* UPC
* ISBN
* Gefahrnr.
* Taric
Damit Inhalt ausgegeben werden kann, müssen die entsprechenden Felder natürlich beim Artikel in der Wawi mit Inhalt gefüllt sein.
**Block Style:** Wähle hier aus verschiedenen Darstellungsoptionen für den ausgegebenen Inhalt.
# Breadcrumb
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/breadcrumb
Brotkrümelnavigation für bessere Usability und SEO
## Allgemeine Beschreibung
Das Breadcrumb-Portlet (auch Brotkrümelnavigation genannt) fügt eine sekundäre Navigationsleiste ein, die deinen Besuchern den Pfad zur aktuellen Seite anzeigt (z. B. Startseite > Kategorie > Produkt).
Dies ist ein essentielles Element für die Benutzerfreundlichkeit und hilft auch Suchmaschinen, die Struktur deines Shops besser zu verstehen.
## Einsatzmöglichkeiten
* **Orientierung:** Hilf deinen Kunden, sich in tiefen Kategoriestrukturen zurechtzufinden und immer zu wissen, wo sie sich gerade befinden.
* **SEO-Boost:** Suchmaschinen wie Google nutzen Breadcrumbs, um die Hierarchie deiner Webseite zu verstehen und zeigen diese oft direkt in den Suchergebnissen an.
* **Schnellzugriff:** Ermögliche Kunden, mit nur einem Klick zur übergeordneten Kategorie zurückzuspringen, ohne den "Zurück"-Button des Browsers nutzen zu müssen.
## Featureübersicht
Der Pfad wird vollautomatisch und dynamisch basierend auf der aktuellen Position des Kunden im Shop generiert.
Das Markup ist technisch so gestaltet, dass es von Suchmaschinen optimal ausgelesen werden kann (Schema.org).
Passt sich der Bildschirmgröße an und wird auf mobilen Geräten automatisch angepasst dargestellt.
# Changelog
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/changelog
Alle Updates und Änderungen für OPC Smarty Portlets
### Verbesserungen
* Backend folgt dem Dark Mode
### Bugfixes
* Artikelbilder Slider: Im OPC-Editor erschien statt des Platzhalters nichts, und das Slider-Skript lief dort ins Leere. Der Platzhalter ist wieder da
* Artikelbilder Slider: Eine vergessene Debug-Ausgabe in der Browser-Konsole der Besucher ist entfernt
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.0 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Features
* Kompatibilität mit JTL Shop 5.7.x
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.10.7
### Features
* Neues Admin Frontend
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.20
### Features
* Allgemeine Verbesserung der Codequalität
* Neuer Installservice \[BETA], checkt die installierte Resources Version und lädt die aktuellste kompatible Version automatisch nach
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.16
### Bugfix
* Wichtige Resources & Health Abhängigkeit
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.12
### Features
* JTL Shop 5.4 Kompatibilität
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.3
### Features
* Neues Portlet: Newsletter Form einfach überall einbinden und ohne Pagereload direkt Feedback bekommen
* Neues Portlet: Custom Smarty: Schreibe noch einfacher Smarty Code direkt in den Plugin Konfigurationen und binde custom Templates überall ein wo du willst
### Kompatibilität
* JTL-Shop 5.3.3+
* Benötigt mindestens DZM Resources & Health 1.8.1
### Features
* Neues Portlet: Custom Templates - Mit Custom Templates stellen wir dir ein Portlet zur Verfügung mit dem du eigene TPL-Files anlegen und dynamisch mit OPC platzieren kannst. Damit kannst du dir eigene kleine Komponenten bauen und diese schnell und gezielt einsetzen und immer wieder verwenden, ohne ein Childtemplate anlegen zu müssen.
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.6.3
### Features
* Kompatibilitätsupdate
### Kompatibilität
* JTL-Shop 5.2.4+
* Benötigt mindestens DZM Resources & Health 1.5.0
### Features
* Neue Portlet Gruppierung
* Neues Portlet: Breadcrumb - Platziere eine Breadcrumb wo du sie haben möchtest
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.13
### Features
* Anpassung an neue Resources Version
* Admin Panel Layout Anpassungen
* Verbesserter Resources Check
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.0
### Features
* Dokumentationstab in Plugineinstellungen
* Warengruppe kann jetzt als Variable ausgegeben werden bei Artikeln
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.6
### Features
* CSRF Token Validierung
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Automatische Funktionsprüfung auf Kompatibilität mit DZM Resources & Health
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Verbessertes Ressourcenmanagement
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.0
### Features
* Smarty Variablen ganz einfach als Portlet integrieren
* Schreibe dynamische Texte, die sich an deine Seiteninhalte anpassen
* Wähle aus wählbaren Smartyvariablen per Dropdown aus oder nutze den erweiterten Richtexteditor, der auch Smartyvariablen auswertet
* Schreibe in voller Smarty Syntax Bedingungen bis hin zu komplexen Templates, ohne an den Shopcode ran zu müssen
* Begrüße deine Kunden persönlich mit Namen, wenn sie sich eingelogged haben
### Kompatibilität
* JTL-Shop 5.2.0+
# Custom Template
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/custom-template
Vorgefertigte .tpl-Dateien direkt im OPC einbinden
## Allgemeine Beschreibung
Das Custom-Template-Portlet bietet dir eine effiziente Möglichkeit, vorgefertigte Template-Dateien (`.tpl`) direkt in deinem Onlineshop über den OPC zu platzieren. Dies ist besonders nützlich, um wiederkehrende Designelemente oder komplexe Smarty-Strukturen zentral zu verwalten und einfach einzubinden.
## Einsatzmöglichkeiten
* **Zentrale Designelemente:** Nutze das Portlet, um speziell entwickelte Templates für Teaser, Banner oder spezielle Sektionen an verschiedenen Stellen deiner Seite konsistent anzuzeigen.
* **Komplexe Datenanzeigen:** Binde Templates ein, die komplexe Smarty-Logiken oder Datenbankabfragen enthalten, ohne den Code jedes Mal neu schreiben zu müssen.
* **Modularer Aufbau:** Erstelle eine Bibliothek an Custom-Templates, die du flexibel in dein Layout integrieren kannst, um die Wartbarkeit deines Shops zu erhöhen.
## Featureübersicht
Du kannst bequem aus einer Liste deiner im Dateisystem hinterlegten Template-Dateien wählen.
Statt Code manuell zu kopieren, wählst du einfach die gewünschte Datei aus, was Fehlerquellen minimiert.
Wie bei allen Portlets kannst du auch für das Custom Template individuelle Layout-Einstellungen und Animationen definieren.
## Settings
### Allgemein
**Wähle dein Template:** In diesem Dropdown-Menü werden dir alle verfügbaren `.tpl`-Dateien angezeigt, die im entsprechenden Verzeichnis deines Shops liegen. Wähle einfach die gewünschte Datei aus, die an dieser Stelle ausgegeben werden soll.
Lege deine Custom Templates im Plugin-Verzeichnis **frontend/custom** ab, damit sie in der Auswahlliste erscheinen.
# Einführung
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/einfuehrung
## Was ist DZM OPC Smarty Portlets?
Mit OPC Smarty Portlets erhältst du eine Sammlung mächtiger Portlets, die direkten Zugriff auf Smarty Variablen haben. So kannst du, auch ohne die Template Variablen beim Namen zu kennen direkt auf diese zugreifen und in deine Produkttexte einarbeiten. Erstelle so dynamische Texte, die sich je Produkt oder andere Seite mit anpassen. Oder sprich deine Kunden persönlich an, sobald diese sich eingelogged haben. Und mit dem Smarty Richtext Editor kannst du noch komplexere Konstrukte bauen, denn der Editor wertet auch Smarty Variablen aus. So kannst du nicht nur auf alle Smarty Variablen zugreifen, sondern auch komplexe Logiken erstellen, als Blueprint speichern, wiederverwenden und alles ohne ein mal in dein Template schreiben zu müssen.
### Schnellanleitung
Resources & Health muss installiert sein
Installiere OPC Smarty Portlets
Trag den Lizenzschlüssel in den Plugineinstellungen ein
## Allgemeine Infos - Vorbereitung
Die folgenden Anweisungen gelten für alle DZM Plugins.
### Wo finde ich die Lizenzschlüssel?
Deine Lizenzschlüssel findest du direkt nach der Buchung in deinem Kundenkonto unter **Meine Lizenzen**.
Diesen Lizenzschlüssel trägst du im jeweiligen Plugin ein.
Einen Lizenzschlüssel findest du hier nur, wenn du das Produkt über unseren Store gebucht hast.
### Welche Lizenzen muss ich buchen?
Resources & Health benötigt keine Lizenz und kann direkt runter geladen und verwendet werden. Alle anderen Plugins benötigen eine Lizenz.
Für **OPC Suite** benötigst du einen Lizenzschlüssel.
**OPC Suite** bietet eine Bundle Lizenz für alle weiteren Produkte:
* OPC Plus
* OPC Conversion Booster
* OPC Smarty Portlets
* OPC Portlets vererben
Das bedeutet, dass nur allein mit der Aktivierung einer OPC Suite Lizenz automatisch auch die Plugins OPC Plus, OPC Conversion Booster, OPC Smarty Portlets und OPC Portlets vererben aktiviert hast. **In diesem Fall musst du in den anderen Plugins keinen eigenen Schlüssel mehr hinterlegen.**
## Inhaltsübersicht
Wrppe Inhalte mit Smarty-Logik
Artikelvariablen per Drag & Drop platzieren
Zugriff auf Kategorievariablen im OPC
Personalisierte Kundenansprache mit Smarty
Komplexe Smarty-Logiken im RichText Editor
# Fülltext
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/fuelltext
Statischen Text im OPC gestalten und mit Smarty-Portlets kombinieren
## Allgemeine Beschreibung
Das Fülltext-Portlet ist das Standard-Werkzeug für die Textgestaltung in deinem Onlineshop. Es bietet dir einen klassischen WYSIWYG-Editor (What You See Is What You Get), mit dem du Texte ohne Programmierkenntnisse formatieren und mit Medien anreichern kannst.
## Einsatzmöglichkeiten
* **Storytelling & Markenbotschaft:** Nutze den Editor, um deine Markengeschichte mit emotionalen Texten und passenden Bildern zum Leben zu erwecken und so eine Bindung zu deinen Kunden aufzubauen.
* **Visuelle Ratgeber:** Kombiniere detaillierte Anleitungen mit Icons und formatierten Listen, um deinen Besuchern einen echten Mehrwert zu bieten.
* **Interaktive Content-Bereiche:** Gestalte Blog-Beiträge oder News-Sektionen, indem du Zitate hervorhebst und Call-to-Actions direkt in den Fließtext integrierst.
## Featureübersicht
Dir stehen alle gängigen Optionen wie Schriftart, Größe, Farben und Ausrichtungen zur Verfügung.
Integriere einfach Bilder, Emojis oder Links direkt in deinen Textfluss.
Erstelle strukturierte Daten mithilfe von Tabellen-Tools sowie ungeordneten und geordneten Listen.
Für fortgeschrittene Nutzer gibt es die Möglichkeit, direkt in den HTML-Code zu wechseln.
## Settings
### Allgemein
**Text:** Hier befindet sich das Hauptfenster für deine inhaltliche Gestaltung.
Dieser Baustein dient als Fülltext. Kombiniere diesen Block in einem TextWrapper zusammen mit Smarty-Variablen-Portlets wie Artikel- oder Kunden-Variablen, und bau dir so dynamischen Text, ohne Smarty-Code programmieren zu müssen.
Die Formatierungsleiste bietet folgende Werkzeuge:
* **Schriftstil** – Fett, Kursiv, Unterstrichen, Durchgestrichen sowie Tief- und Hochstellen
* **Listen** – Aufzählungszeichen oder nummerierte Listen
* **Zitate & Ausrichtung** – Einrücken sowie linksbündig, zentriert, rechtsbündig oder Blocksatz
* **Einfügen-Optionen** – Links, Bilder, Emojis, Tabellen und horizontale Linien
* **Stile** – Absatzformate (z. B. Überschriften), Schriftarten und Schriftgrößen
* **Farben** – Textfarbe und Hintergrundfarbe (Markierung)
* **Quellcode (`<>`)** – Umschalten zwischen visueller Ansicht und HTML-Quellcode
# Installation
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/installation
## Installationsprozess
**BEVOR DU BEGINNST**
Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
### 1. Resources & Health
Lade unter [https://store.dreizack-medien.de/DZM-Resources-Health](https://store.dreizack-medien.de/DZM-Resources-Health) unser Plugin **Resources & Health**.
Achte auf die Wahl der passenden Version.
Lade die eben herunter geladene Zipdatei über den Plugin Manager in deinen Store hoch.
Unter **Vorhanden** wählst du nun das hochgeladene Plugin aus, akzeptierst ggfs die Lizenzbedingungen und klickst auf **Installieren**.
### 2. OPC Smarty Portlets Lizenz buchen
1. Registriere dich in unserem Store.
2. Wähle unter [https://store.dreizack-medien.de/DZM-OPC-Smarty-Portlets](https://store.dreizack-medien.de/DZM-OPC-Smarty-Portlets) die passende Kaufoption aus.
3. In diesem Beispiel ordern wir eine Lizenz für **OPC Smarty Portlets** als **Vollversion** und tragen unsere Domain ein, ohne `https://` oder führendes `www.`
**Achtung!** Diese Auswahl ist nur möglich, wenn du bereits angemeldet bist. Eine Bestellung ohne Registrierung ist ausgeschlossen!
Wenn du bereits eine Demo- oder Entwicklerlizenz hast und angemeldet bist, kannst du alternativ zur Registrierung einer neuen Domain einfach unten im Dropdown deine bestehende Lizenz auswählen und in eine Vollversion umwandeln. Die passende Domain wird dann automatisch übernommen.
Domains einer produktiven Lizenz kannst du später in deinem Kundenkonto bearbeiten und ändern. Wenn du also auf einer Staging Domain gearbeitet hast, kannst du die Lizenz hier in eine Vollversion umwandeln und anschließend in deinem Kundenkonto auf die Live Domain umschreiben.
### 3. OPC Smarty Portlets Downloaden und installieren
Kehre nach erfolgreicher Buchung auf die Produktseite zurück und lade hier die passende Version von OPC Smarty Portlets herunter: [https://store.dreizack-medien.de/DZM-OPC-Smarty-Portlets](https://store.dreizack-medien.de/DZM-OPC-Smarty-Portlets)
Lade anschließend die Zipdatei wie oben bei Resources & Health über den **Pluginmanager** in deinen Store hoch, und installiere das Plugin.
### 4. Lizenz aktivieren
Wechsel in unserem Store in dein **Kundenkonto** unter **Meine Lizenzen** und kopiere dir den **Lizenzschlüssel** für deine Domain.
Unter Umständen kann es passieren, dass sich das OPC Smarty Portlets Plugin so lange selbst deaktiviert, bis eine gültige Lizenz eingetragen wurde.
Aktiviere in diesem Fall das Plugin einfach wieder und wechsle **sofort** in die **Plugineinstellungen** und trage den Lizenzschlüssel ein. In wenigen Ausnahmefällen kann es sein, dass sich das Plugin noch ein mal selbst deaktiviert, nachdem du den Schlüssel eingetragen hast. Aber keine Sorge. Nach letztmaliger Aktivierung bleibt es auch aktiviert. Versprochen ;)
Trage deinen Lizenzschlüssel unter **Lizenz** ein und klick auf **Speichern**.
Das Plugin signalisiert dir, dass die Lizenz valide und aktiv ist.
### Wo finde ich die Installationsfiles?
Die Installer Pakete findest du jeweils am Produkt.
In der Sidebar findest du alle veröffentlichten Versionen.
* **Achte auf die Info, ob das Plugin Resources & Health benötigt und in welcher Version.**
* **Achte auf die kompatible Version**
* **Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast**
**Resources & Health ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop.** Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
# Kategorie-Variablen
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/kategorie-variablen
Zugriff auf Kategorievariablen im OPC
## Allgemeine Beschreibung
Mit dem Kategorie-Variablen-Portlet kannst du dynamische Informationen der aktuell aufgerufenen Kategorie direkt in dein Layout einbinden. So entstehen automatisierte Inhalte, die sich je nach besuchter Kategorie im Shop aktualisieren.
## Einsatzmöglichkeiten
* **Dynamische SEO-Texte:** Nutze die Kategoriebeschreibung, um auf jeder Kategorieseite individuellen Content anzuzeigen, ohne für jede Seite ein eigenes Portlet pflegen zu müssen.
* **Automatisierte Überschriften:** Verwende den Kategorienamen als zentrale Überschrift in deinem Banner oder Hero-Bereich.
* **Individuelle Kategorieseiten:** Baue dir ein Master-Layout für deine Kategorien, das die spezifischen Daten der jeweiligen Kategorie automatisch an der richtigen Stelle ausgibt.
## Featureübersicht
Greift direkt auf die Datenbankinformationen der jeweiligen Kategorie zu – immer aktuell ohne manuellen Pflegeaufwand.
Durch verschiedene Block-Styles passt sich die Variable nahtlos in dein bestehendes Design ein.
Wie alle Portlets lässt sich dieses Element in Grids oder Containern platzieren und über den Layout-Reiter feinjustieren.
## Settings
### Allgemein
**Variable wählen:** Hier entscheidest du, welche Information der Kategorie angezeigt werden soll.
Die Variablen können nur auf Kategorieseiten ausgegeben werden.
Folgende Variablen stehen zur Auswahl:
* **Name** – Gibt den offiziellen Namen der Kategorie aus
* **Beschreibung** – Zeigt den im Backend hinterlegten Beschreibungstext der Kategorie an
**Block Style:** Hier legst du fest, wie die Variable technisch und optisch in die Seite eingebunden wird:
* **Inline** – Das Element verhält sich wie Text im Fluss und nimmt nur so viel Platz wie nötig ein
* **Container** – Erzeugt einen Block, der die volle verfügbare Breite nutzt
* **Kleiner Text** – Formatiert die Ausgabe in einer dezenten, kleineren Schriftgröße
* **Fetter Text** – Hebt die Variable durch eine fette Schriftart hervor
* **Normaler Text** – Standard-Textformatierung ohne zusätzliche Hervorhebung
* **Überschrift 1 bis 6** – Formatiert die Variable als HTML-Überschrift (H1 bis H6), besonders relevant für die SEO-Struktur
# Kunden-Variablen
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/kunden-variablen
Personalisierte Kundenansprache mit Smarty-Variablen
## Allgemeine Beschreibung
Mit dem Kunden-Variablen-Portlet kannst du dynamische Kundendaten flexibel in deinem Onlineshop anzeigen lassen. So kannst du angemeldete Kunden persönlich ansprechen oder spezifische Konto-Informationen (wie die Kundennummer oder das aktuelle Guthaben) an passender Stelle ausgeben.
## Einsatzmöglichkeiten
* **Persönliche Begrüßung:** Nutze Variablen wie Vor- und Nachname, um deine Kunden auf bestimmten Seiten direkt und persönlich willkommen zu heißen.
* **Profil-Informationen:** Zeige dem Kunden schnell und unkompliziert seine hinterlegten Kontaktdaten (wie Adresse, E-Mail oder Telefonnummer) oder sein aktuelles Guthaben an.
* **Individuelle Ansprache:** Steigere die Kundenbindung durch maßgeschneiderte Textelemente, die sich dynamisch an den jeweils eingeloggten Nutzer anpassen.
## Featureübersicht
Dir stehen zahlreiche Variablen von den grundlegenden Adressdaten bis hin zum Kundenguthaben zur Verfügung.
Passe die Textdarstellung direkt über vordefinierte Block-Stile (wie verschiedene Überschriften oder fetten Text) an das Design deines Shops an.
Die Variablen lassen sich nahtlos als Inline-Elemente im Fließtext platzieren oder als eigenständige Blöcke (Container) integrieren.
## Settings
### Allgemein
**Variable wählen:** Wähle hier die Kundeneigenschaft aus, die an der gewünschten Stelle ausgegeben werden soll.
Bestimmte Variablen setzen voraus, dass der Kunde im Shop angemeldet ist, und können unter Umständen nur auf bestimmten Seiten ausgegeben werden.
Folgende Datenfelder stehen zur Auswahl:
* Vorname
* Nachname
* Anrede
* Titel
* Firma
* Straße
* Hausnummer
* Adresszusatz
* PLZ
* Ort
* Bundesland
* Land
* E-Mail
* Telefon
* Mobil
* Fax
* Geburtstag
* Kundennummer
* Guthaben
**Block Style:** Hier legst du fest, wie das ausgewählte Element strukturiert und formatiert werden soll:
* **Inline** – Element reiht sich mit anderen Elementen ein
* **Container** – Element nimmt eine Zeile in Anspruch
* Kleiner Text
* Fetter Text
* Normaler Text
* Überschrift 1 bis 6
# RichText-Variablen
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/richtext-variablen
Komplexe Smarty-Logiken im RichText Editor erstellen
## Allgemeine Beschreibung
Mit dem RichText-Variablen-Portlet kannst du formatierte Texteingaben mit dynamischen Inhalten kombinieren. Dir steht ein vollwertiger Texteditor zur Verfügung, in dem du nicht nur klassischen Text verfassen und formatieren, sondern auch Smarty-Variablen (wie z. B. den Kundennamen) und Logiken (wie If-Else-Bedingungen) direkt einsetzen kannst – ohne ein einziges Mal in dein Template schreiben zu müssen.
## Einsatzmöglichkeiten
* **Persönliche Ansprache:** Begrüße eingeloggte Kunden direkt mit ihrem Vornamen (z. B. "Hallo Max! Schön, dass du da bist!") und zeige Gästen stattdessen einen allgemeinen Text ("Hi! Bitte melde dich an.").
* **Dynamische Hinweise:** Blende spezifische Informationen, Rabattcodes oder Hinweise ein, die sich dynamisch an den jeweiligen Nutzer oder die Session anpassen.
* **SEO-Texte platzsparend einbinden:** Nutze die Ausklapp-Funktion ("Mehr lesen"), um lange Info- oder SEO-Texte unterzubringen, ohne dass diese das Seitenlayout überladen.
## Featureübersicht
Formatiere deinen Text ganz einfach über die Werkzeugleiste (fett, kursiv, Listen etc.), ohne HTML-Kenntnisse zu benötigen.
Binde Shop-Variablen ein und nutze Programmierlogiken direkt im Textfeld, um personalisierte Inhalte auszuspielen.
Kürze sehr lange Textblöcke automatisch auf eine definierte Höhe und lasse deine Kunden den restlichen Text bei Bedarf über einen Button aufklappen.
## Settings
### Allgemein
**Text:** Hier findest du den Texteditor, um deine Inhalte zu erstellen und zu formatieren. Neben normalem Text kannst du hier auch dynamischen Smarty-Code einfügen.
Du kannst eine Abfrage einbauen, die prüft, ob ein Kunde angemeldet ist. Ist dies der Fall, wird er persönlich mit Vornamen angesprochen. Ist er nicht angemeldet, sieht er einen alternativen Text.
### Options
**Langen Text kürzen und ausklappbar machen?** Aktiviere diese Option, um sehr lange Texte platzsparend darzustellen. Der Textblock wird auf eine bestimmte Höhe reduziert und der Rest vorerst ausgeblendet.
**Maximale Höhe des Textausschnittes:** Falls du die Kürzungsfunktion aktiviert hast, wählst du hier aus dem Dropdown-Menü, wie viel des Textes anfangs sichtbar sein soll (z. B. "M (10vh)" für einen mittleren Ausschnitt, der sich dynamisch an die Displayhöhe anpasst).
**Button verwenden?** Lege fest, ob für die Ausklapp-Funktion ein eigener Button angezeigt werden soll. Bei "Ja" öffnen sich weitere Optionen, um den Button-Text (z. B. "Weiterlesen") und sein Design anzupassen.
# TextWrapper
Source: https://docs.dreizack-medien.de/OPC-Smarty-Portlets/textwrapper
Wrappe Inhalte mit Smarty-Logik
## Allgemeine Beschreibung
Der TextWrapper dient als intelligenter Container zur Erstellung von variablen Texten in deinem Onlineshop. Er ermöglicht es dir, statischen Fülltext mit dynamischen Inhalten – wie zum Beispiel Artikel-, Kunden- oder Kategorie-Variablen-Portlets – zu kombinieren. So kannst du personalisierte und dynamische Textelemente erzeugen, ganz ohne eigene Smarty-Code-Kenntnisse oder Programmieraufwand.
## Einsatzmöglichkeiten
* **Persönliche Kundenansprache:** Kombiniere ein normales Textfeld (z. B. "Herzlich willkommen zurück, ") mit einem Kunden-Variablen-Portlet, das den Vornamen des angemeldeten Kunden ausgibt.
* **Dynamische Hinweistexte:** Erstelle Sätze, die sich dynamisch an den Kunden anpassen, wie etwa "Du hast aktuell X Treuepunkte in deinem Konto", indem du statischen Text um eine dynamische Punkte-Variable herum baust.
* **Flexible Kategorie-Texte:** Baue strukturierte SEO-Texte auf, die automatisch den jeweiligen Kategorienamen an der passenden Stelle im Fließtext einfügen.
## Featureübersicht
Erstelle komplexe, variable Texte ganz ohne Programmierkenntnisse direkt im OPC-Editor.
Verknüpfe statischen Fließtext mit dynamischen Smarty-Portlets (Artikel-, Kunden- oder Kategorie-Variablen) in einem gemeinsamen Container.
Nutze den Wrapper überall dort, wo sich Inhalte je nach Kunde oder aufgerufener Seite automatisch anpassen sollen.
## Settings
### Allgemein
In diesem Reiter nimmst du keine direkten Einstellungen vor. Der TextWrapper fungiert als Container – du befüllst ihn im OPC-Editor mit den gewünschten Portlets.
Dieser Block dient der Erstellung von variablen Texten. Verwende in diesem Block eine Kombination aus Smarty-Portlets und Fülltext, um so dynamischen Inhalt zu erzeugen, ohne Smarty-Code programmieren zu müssen.
Der TextWrapper dient im OPC (OnPage Composer) in erster Linie als schützende "Hülle". Du ziehst einfach deine gewünschten Text-Elemente und Variablen-Portlets in diesen Wrapper hinein, um den fertigen dynamischen Satz zusammenzubauen.
# Einführung
Source: https://docs.dreizack-medien.de/OPC-Suite/Einfuehrung
Die DZM OPC Suite - Deine komplette Lösung für professionelle Landingpages und Produktseiten
## Was ist DZM OPC Suite
Die OPC Suite beinhaltet alle OPC Produkte von DREIZACK Medien und entfaltet zusammen mit dem Blueprintstore das volle Potential des OPC Editors. Baue starke Landingpages und Produktseiten, die deine Kunden überzeugen.
Über 25 einzigartige Content Portlets
Verkaufsfördernde Portlets für deine Produkte
Dynamische Texte mit Smarty Templatevariablen
Mastertemplates für seitenübergreifende Gestaltung
Im Bundle erhältst du alle Plugins zu einem vergünstigten Preis und bist so immer up-to-date, denn unsere OPC Produkte werden ständig erweitert.
***
## Tools im Überblick
Sammlung aus über 25 einzigartigen Content Portlets mit hilfreichen Layoutelementen, Slidern, Bildern, Videoblöcken und mehr.
[Zur Dokumentation →](https://doc.clickup.com/4655718/d/4e2k6-13450/dzmopc-plus-dokumentation)
Sammlung von verkaufsfördernden Portlets, die deine besonderen Produkte in Szene setzen.
[Zur Dokumentation →](https://doc.clickup.com/4655718/p/h/4e2k6-11381/e12573ce1c040f2)
Sammlung von Portlets, die direkt mit Smarty Templatevariablen zusammenarbeiten. Kreiere dynamische Texte oder sprich deine Kunden persönlich an.
[Zur Dokumentation →](https://doc.clickup.com/4655718/d/4e2k6-13510/dzmopc-smarty-portlets-dokumentation)
Das mächtigste Tool in Kombination. Baue mit allen OPC Produkten fantastische Mastertemplates und vererbe diese auf alle Seiten des gleichen Typs. So kannst du seitenübergreifende Header und Footer gestalten, meisterhafte Artikeldetailseiten inszenieren und hast immer die Kontrolle über deine Templates.
[Zur Dokumentation →](https://doc.clickup.com/4655718/d/4e2k6-12661/dzmopc-portletsvererben-dokumentation)
***
## Video-Tutorials
### OPC Suite Übersicht
### Installation Schritt-für-Schritt
# Installation
Source: https://docs.dreizack-medien.de/OPC-Suite/Installation
Schritt-für-Schritt Anleitung zur Installation der DZM OPC Suite
**Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.**
[Resources & Health herunterladen →](https://www.jtl-software.de/extension-store/dzm-resources-health-jtl-shop-5)
Die Installation funktioniert einfach per JTL Shop, so wie du es gewohnt bist. Nachdem du [Resources & Health](https://www.jtl-software.de/extension-store/dzm-resources-health-jtl-shop-5) installiert und/oder geupdated hast, kann es losgehen.
***
## Installation der OPC Suite
Besuche die [Storeseite](https://www.jtl-software.de/extension-store/dzm-opc-suite-jtl-shop-5) und buche dir deine OPC-Suite-Lizenz.
Binde die Lizenz im Shopbackend unter **Meine Käufe** → **Ungebundene Lizenzen** an deinen Onlineshop.
Installiere die OPC Suite direkt über den JTL-Extensionstore.
[Besuche unseren Store](https://dreizack-medien.de/DZM-OPC-Suite) und buche dir deine OPC-Suite-Lizenz.
Lade die Software über den Reiter **"Installer Download"** herunter.
Lade das Verzeichnis im Backend über **Plugin-Manager** → **Upload** manuell hoch.
Installiere das Plugin über den Plugin-Manager im Reiter **"Vorhanden"**.
***
## Hinzufügen der OPC-Plugins
Nach der Installation der OPC Suite müssen die einzelnen OPC-Plugins hinzugefügt werden.
Besuche den DZM-Store und lade die Software für die OPC-Plugins über den Reiter **"Installer Download"** herunter:
Content Portlets & Layoutelemente
Verkaufsfördernde Portlets
Mastertemplates erstellen
Dynamische Smarty-Inhalte
Lade die Software über das Backend → **Plugin-Manager** → **Upload** manuell in deinen Onlineshop hoch.
Installiere die Plugins über den Plugin-Manager im Reiter **"Vorhanden"**.
**Geschafft!** Deine OPC-Suite ist jetzt erfolgreich installiert!
***
## Video-Anleitung
Folge dieser detaillierten Video-Anleitung für die Installation:
***
## Nächste Schritte
Lerne alle Features von OPC Plus kennen
Erstelle deine ersten Mastertemplates
Optimiere deine Produktseiten
Nutze dynamische Inhalte
# Changelog
Source: https://docs.dreizack-medien.de/OPC-Suite/changelog
Alle Updates und Änderungen für OPC Suite
### Verbesserungen
* Kompatibilität mit JTL-Shop 5.8 bis 5.8.1
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.5.0 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.11.5
### Features
* Kompatibilität mit JTL Shop 5.7.x
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.2
* Benötigt mindestens DZM Resources & Health 1.10.7
### Features
* Neues Admin Frontend
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.20
### Features
* Neuer Installationsprozess \[BETA], installiert automatisch die notwendige Resources & Health Version, sowie alle kompatiblen OPC Plugins
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.9.16
### Bugfix
* Wichtige Resources & Health Abhängigkeit
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.5
### Features
* JTL Shop 5.4 Kompatibilität
### Kompatibilität
* JTL-Shop 5.3.2+
* Benötigt mindestens DZM Resources & Health 1.8.3
### Features
* Kompatibilität zu Resources 1.6.3
### Kompatibilität
* JTL-Shop 5.2.4 - 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.6.3
### Features
* Anpassung an neue Schnittstelle
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.4.0
### Features
* Verbesserter Installationshinweis
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.9
### Features
* Komplette OPC Suite als Bundle
* Alle OPC Plugins direkt aus einem Plugin installieren
* Eine Lizenz für alle Produkte
* OPC Plus, OPC Salesbooster, OPC Smarty Portlets, OPC Portlets vererben
* Nutze das volle Potential zusammen mit dem Blueprintstore
### Kompatibilität
* JTL-Shop 5.2.0+
* Benötigt mindestens DZM Resources & Health 1.3.7
# Einführung
Source: https://docs.dreizack-medien.de/Reloadify/Einfuehrung
Erfahre, was DZM Reloadify ist und wie es deinen JTL Shop mit Reloadify verbindet
## Was ist DZM Reloadify?
DZM Reloadify ist ein Integrationsplugin, um deinen JTL Shop mit deinem Reloadify Konto zu verknüpfen und Kontakte, Bestellungen und Interaktionen zu übertragen.
Mit Reloadify automatisierst du deinen Marketingkanal.
## Funktionsumfang
Das Plugin synchronisiert automatisch folgende Daten zwischen deinem JTL Shop und Reloadify:
Übertragung von Kundenprofilen, Newsletter-Abonnenten und deren Interaktionen
Automatische Synchronisation aller Bestelldaten für personalisierte Marketing-Kampagnen
Vollständiger Abgleich deines Produktkatalogs inklusive Kategorien und Varianten
Tracking von abgebrochenen Warenkörben für gezielte Remarketing-Aktionen
## Vorteile der Integration
* **Automatisiertes Marketing**: Setze personalisierte E-Mail-Kampagnen basierend auf Kundenverhalten auf
* **Warenkorbabbrecher zurückgewinnen**: Reaktiviere potenzielle Kunden mit abgebrochenen Käufen
* **Produktempfehlungen**: Nutze Kaufhistorie für intelligente Cross- und Upselling-Strategien
* **Kundensegmentierung**: Erstelle zielgruppenspezifische Kampagnen basierend auf Kaufverhalten
## Voraussetzungen
Bevor du mit der Installation beginnst, stelle sicher, dass du Folgendes hast:
* Einen aktiven JTL Shop (Version siehe Kompatibilität)
* Einen Reloadify Account ([jetzt registrieren](https://www.reloadify.com/de/demo))
* Administratorzugang zu deinem JTL Shop
* Das Plugin **Resources & Health** (wird vor DZM Reloadify installiert)
Wenn du noch keinen Reloadify Account hast, kannst du eine [unverbindliche Demo buchen](https://www.reloadify.com/de/demo), um herauszufinden, ob Reloadify zu deinem Webshop passt.
# Installation
Source: https://docs.dreizack-medien.de/Reloadify/Installation
Schritt-für-Schritt Anleitung zur Installation und Einrichtung von DZM Reloadify
**BEVOR DU BEGINNST**
Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
## Schnellübersicht
Hier ist ein Überblick über die wichtigsten Schritte zur Einrichtung von DZM Reloadify:
Erstelle einen Account auf reloadify.com oder buche eine Demo
Generiere ClientID und Client Secret in deinem Reloadify Account
Installiere das Plugin in deinem JTL Shop
Verknüpfe den Shop mit ClientID und Client Secret
Ordne die Sprachen zwischen JTL und Reloadify zu
Übertrage bestehende Kundenprofile (optional)
Erstelle Feeds und übertrage Produkte und Kategorien
Synchronisiere bisherige Bestellungen (optional)
Richte automatische Synchronisation ein
***
## Vorbereitung: Reloadify
### Reloadify Account erstellen
Wenn du noch keinen Reloadify Account hast, erstelle dir jetzt einen auf [reloadify.com](http://reloadify.com) oder buche dir eine unverbindliche Demo.
Um herauszufinden, ob dein Webshop und Reloadify gut zusammenpassen, würden wir dich gerne etwas besser kennenlernen. Fordere eine Demo an.
### API Credentials generieren
Zur Integration mit deinem JTL Shop benötigst du die API Credentials.
Melde dich in deinem Reloadify Account an
Navigiere zu **Einstellungen**
Klicke auf **API-Anmeldeinformationen**

Klicke auf den Button **Neuer API Key**
In der Übersicht siehst du deine **ClientID** (Kunden ID) und dein **ClientSecret** (Secret Key)
Bewahre diese Daten sicher auf – du benötigst sie für die Einrichtung im JTL Shop.
***
## Vorbereitung: JTL Shop Plugins
### Plugin-Dateien herunterladen
Die Installer-Pakete findest du jeweils am Produkt in der Sidebar mit allen veröffentlichten Versionen.


Achte beim Download auf folgende Punkte:
* **Resources & Health Anforderung**: Prüfe, ob das Plugin Resources & Health benötigt und in welcher Version
* **Kompatible Shop-Version**: Stelle sicher, dass die Plugin-Version mit deiner JTL Shop Version kompatibel ist
* **Lizenzquelle**: Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast
**Resources & Health** ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop. Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
### Plugins installieren
Lade **Resources & Health** und **DZM Reloadify** von unserer Seite herunter
Lade die ZIP-Dateien über den Pluginmanager in deinem JTL Shop hoch
Installiere **zuerst** Resources & Health
Resources & Health muss immer als erstes Plugin installiert werden!
Installiere anschließend DZM Reloadify
***
## Setup und Konfiguration
### Schritt 1: API anbinden
Wechsle in die Pluginsettings von **DZM Reloadify**.

Öffne den Reiter **Integration**
Trage die **ClientID** und das **ClientSecret** ein, die du in deinem Reloadify Account erstellt hast
**Bestätige die Eingabe durch Klick auf Speichern**
Wenn alles passt, hat sich dein AccessToken automatisch generiert
### Schritt 2: Language Mapping
Bleibe im Tab **Integration** und scrolle ein Stück weiter nach unten.

Wir müssen die Sprachschlüssel zwischen JTL und Reloadify verknüpfen.
Wähle eine Sprache deines JTL Shops aus der Dropdown-Liste
Wähle anschließend die entsprechende Sprache in Reloadify aus
Bestätige mit dem Button **Hinzufügen**
Wiederhole den Vorgang für alle weiteren Sprachen deines Shops
### Schritt 3: Profile übertragen (optional)
Mit **DZM Reloadify** werden deine Kontakte automatisch zu Reloadify übertragen, wenn sie einen Kauf getätigt haben oder sich für den Newsletter registriert haben.
Der Tab **Profile** zeigt dir eine Liste mit allen Kontakten, die für eine Übertragung in Frage kommen.

In der Tabelle siehst du:
* Ob die Kontakte für den Newsletter registriert sind
* Ob sie Bestellungen getätigt haben
Überprüfe die Liste der zu übertragenden Kontakte
Klicke auf **Übertragung starten**, um diese Kontakte zu Reloadify zu übertragen
Bereits in Reloadify vorhandene Kontakte werden aktualisiert, nicht dupliziert.
Dieser Schritt ist optional. Neue Kontakte werden ab sofort automatisch synchronisiert, sobald sie eine Bestellung aufgeben oder sich für den Newsletter anmelden.
### Schritt 4: Datafeed anlegen und Produkte übertragen
Wechsle in den Tab **Produktdaten** und erstelle deinen Datafeed.
**Wichtige Hinweise zum Datafeed:**
* Du benötigst einen Feed pro Sprache, wenn du verschiedene Sprachversionen deiner Produkte hast (Beschreibungen, Titel)
* Du brauchst mindestens einen Feed
* Der als **Standard** festgelegte Feed wird immer dann herangezogen, wenn es keinen spezielleren Feed gibt
**Achte auf volle Sichtbarkeit deiner Produkte!**
Wähle eine Kundengruppe, die alle Produkte sehen kann, da es sonst zu Problemen beim Bestellabgleich kommen kann. Im Zweifel kannst du eine neue Kundengruppe anlegen (z.B. mit dem Namen **Reloadify**), die du nur für den Produktfeed verwendest. So hast du volle Kontrolle über Sichtbarkeit und Preise.

Wähle **Sprache**, **Kundengruppe** und **Währung** aus
**Dein erster Feed sollte als Standard behandelt werden** – aktiviere den Schalter
Bestätige abschließend mit Klick auf **Hinzufügen**
Wiederhole den Vorgang für weitere Sprachen/Kundengruppen/Währungen (falls benötigt)
#### Produkte synchronisieren

Deine Produkte werden zusammengesucht und pro Feed angezeigt.
Klicke auf **Synchronisierung starten**, um deine Kategorien und Produkte zu übertragen
Je nach Umfang deines Katalogs kann der Vorgang einige Zeit in Anspruch nehmen
**Lasse das Fenster bitte geöffnet**, bis die Synchronisierung abgeschlossen ist.
In den beiden Grafiken siehst du den Stand der Synchronisation:
* **Grün** = Produkte synchronisiert
* **Rot** = Produkte noch nicht übertragen
* **Orange** = Produkt übertragen, aber Änderungen stehen aus
**Hinweis zur Produktzählung:**
Mit **Produkte im Feed** sind Einzel- und Vaterartikel gemeint. Jeder Artikel wird übertragen. Hat ein Artikel Kindartikel, werden diese als Variante übertragen. Daher tauchen sie in der Zählung nicht mit auf.
**Automatisierung durch Cronjobs:**
Du musst die Übertragung nicht manuell anstoßen. Wir haben dir dafür einen Cronjob angelegt, der regelmäßig:
* Neue Produkte überträgt
* Geänderte Produkte aktualisiert
* Gelöschte Produkte aus Reloadify entfernt
Siehe dazu die Beschreibung unter **Schritt 6: Cronjobs einrichten**.
### Schritt 5: Bestelldaten abgleichen (optional)
Dein Setup steht und neue Bestellungen werden bereits in die Liste zu übertragender Bestellungen aufgenommen und übermittelt (Cronjob vorausgesetzt, siehe unten).
Im Tab **Bestelldaten** hast du die Möglichkeit, auch vergangene Bestellungen zu übertragen, damit du mit Reloadify direkt eine gute Datenbasis hast.

Wechsle in den Tab **Bestelldaten**
Klicke auf den Button **Start**, um vergangene Bestellungen zu übertragen
Die Übertragung läuft automatisch. Je nach Anzahl der Bestellungen kann dies einige Zeit dauern.
Dieser Schritt ist optional, aber empfehlenswert, um von Anfang an mit vollständigen Daten arbeiten zu können.
### Schritt 6: Cronjobs einrichten
Damit Produkte, Bestellungen, Warenkörbe und Profile regelmäßig und automatisch synchronisiert werden, haben wir einige Cronjobs vorbereitet.

Gehe zu **System › Cron**
Wechsle in den Tab **Queue-Eintrag erstellen**
Lege für jeden der folgenden Cronjobs einen Eintrag an
#### Empfohlene Cronjob-Konfiguration
**Häufigkeit:** Stündlich
Überträgt neue Produkte, aktualisiert geänderte Produkte und entfernt gelöschte Produkte aus Reloadify.
**Häufigkeit:** Stündlich
Synchronisiert neue Bestellungen zu Reloadify für Marketing-Automatisierung und Kundenprofile.
**Häufigkeit:** Stündlich
Überträgt abgebrochene Warenkörbe für Remarketing-Kampagnen.
**Häufigkeit:** Täglich
Aktualisiert den Newsletter-Status in Reloadify, um Abmeldungen zu berücksichtigen.
**Häufigkeit:** Täglich
Entfernt Produkte und Kategorien aus Reloadify, die im Shop gelöscht wurden.
***
## Installation abgeschlossen
Glückwunsch! Du hast DZM Reloadify erfolgreich installiert und eingerichtet.
Dein JTL Shop ist nun mit Reloadify verbunden und synchronisiert automatisch:
* Kundenprofile und Newsletter-Abonnenten
* Bestellungen und Transaktionen
* Produktkatalog und Kategorien
* Abgebrochene Warenkörbe
Du kannst jetzt in deinem Reloadify Account personalisierte Marketing-Kampagnen erstellen und von automatisierten E-Mail-Workflows profitieren.
Bei Fragen oder Problemen steht dir unser Support-Team gerne zur Verfügung.
# API-Calls
Source: https://docs.dreizack-medien.de/Reloadify/api-calls
Protokoll aller ausgehenden API-Anfragen an Reloadify mit Filterfunktion
Im Bereich **API-Calls** siehst du alle ausgehenden HTTP-Anfragen, die das Plugin an Reloadify gesendet hat – mit Status, Dauer und Details. Damit lassen sich Übertragungsfehler gezielt analysieren.
## Filter
Zeitraum einschränken, um nur API-Calls in einem bestimmten Zeitfenster anzuzeigen.
Filtert nach dem Typ des Syncs, der den API-Call ausgelöst hat (z.B. Katalog, Profile, Bestellungen).
Filtert nach HTTP-Statuscode. Beispiele: `200` für Erfolg, `404` für nicht gefunden, `0` für Verbindungsfehler.
Sucht nach einem Teilstring in der URL oder im Request-Body – nützlich um Calls zu einem bestimmten Endpunkt zu finden.
Zeigt ausschließlich fehlgeschlagene API-Calls an.
Klicke auf **Filter anwenden**, um die Ergebnisse zu filtern, oder auf **Zurücksetzen** um alle Filter zu löschen.
## API-Call-Tabelle
| Spalte | Beschreibung |
| ------------ | ----------------------------------------------------- |
| **Zeit** | Zeitpunkt der Anfrage |
| **Method** | HTTP-Methode (GET, POST, PUT etc.) |
| **URL** | Aufgerufener Reloadify-API-Endpunkt |
| **Status** | HTTP-Statuscode der Antwort |
| **Dauer** | Antwortzeit in Millisekunden |
| **Sync-Typ** | Typ des Syncs (Katalog, Profile etc.) |
| **Trigger** | Auslöser (Cron, manuell, extern) |
| **Detail** | Link zur Detailansicht mit Request- und Response-Body |
Die Aufbewahrungsdauer der API-Calls kannst du in den [Einstellungen](/Reloadify/einstellungen) unter „API-Log Aufbewahrung (Tage)" konfigurieren.
# Bestellungen
Source: https://docs.dreizack-medien.de/Reloadify/bestellungen
Bestelldaten aus dem JTL Shop mit Reloadify synchronisieren
Im Bereich **Bestellungen** werden Transaktionen aus deinem JTL Shop an Reloadify übertragen. Reloadify nutzt diese Daten für Trigger-E-Mails (z.B. Versandbestätigung, Bewertungsanfragen) und zur Analyse des Kaufverhaltens.
## Synchronisation
Über **Bestellungen syncen** überträgst du alle ausstehenden Bestellungen manuell an Reloadify.
| Button | Funktion |
| ----------------------- | ------------------------------------------ |
| **Fehler zurücksetzen** | Setzt fehlgeschlagene Sync-Versuche zurück |
| **Reset** | Setzt den gesamten Bestellungs-Sync zurück |
## Bestellungsübersicht
Die Tabelle zeigt alle zu übertragenden Bestellungen:
| Spalte | Beschreibung |
| -------------- | ---------------------------------------------------- |
| **ID** | Interne Datenbank-ID |
| **BestellNr** | JTL-Bestellnummer |
| **Kunde** | E-Mail-Adresse des Bestellers |
| **Datum** | Datum und Uhrzeit der Bestellung |
| **JTL-Status** | Aktueller Status im JTL Shop (z.B. „In Bearbeitung") |
| **Reloadify** | Übertragungsstatus bei Reloadify |
| **Sync** | Sync-Status (z.B. „Ausstehend") |
| **Fehler** | Aufgetretene Fehler mit Resync-Button |
Über das Suchfeld kannst du nach BestellNr, E-Mail oder ID filtern.
Ältere Bestellungen (älter als 24h) werden nur übertragen, wenn die Option **Ältere Bestellungen syncen** in den [Einstellungen](/Reloadify/einstellungen) aktiviert ist.
In der Reloadify Web-App kannst du auf Basis der Bestelldaten statusbasierte Trigger einrichten – z.B. eine automatische E-Mail bei „Versandt" oder eine Bewertungsanfrage nach Lieferung.
# Changelog
Source: https://docs.dreizack-medien.de/Reloadify/changelog
Alle Updates und Änderungen für Reloadify
### Verbesserungen
* Kompatibilität mit JTL-Shop 5.8 bis 5.8.1
### Bugfixes
* Abmelde-Abgleich: Der Zeitpunkt des letzten Abgleichs wurde nicht gespeichert, jeder Lauf glich deshalb alle An- und Abmeldungen von Anfang an ab. Der Stand liegt jetzt in einer eigenen Tabelle (neue Migration, läuft beim Update automatisch)
### Hinweise
* Benötigt DZM Resources & Health 1.11.17 – bitte zuerst aktualisieren
### Kompatibilität
* JTL-Shop 5.3.2 - 5.8.1
* Benötigt mindestens DZM Resources & Health 1.11.17
### Verbesserungen
* Vollständiges Rebuild
* starke Performanceverbesserungen
* völlig neue Admin UI
* Detailliertes Logging
* Explorer Ansicht, um Daten aus Reloadify abzurufen und zu prüfen
* Neue Endpoints
* Eigene Cronjob Endpunkte für gezieltes Triggern von wichtigen Abgleichen
* Eigene Einstellungen für die Anzahl zeitgleich abzugleichender Datensätze
* Eigener Endpunkt für Warenkorblinks, die den abgebrochenen Warenkorb wiederherstellen
### WICHTIG!
* Das Plugin wurde grundlegend verändert und komplett neu aufgesetzt.
* Überprüfe die Konfiguration vor dem ersten Sync.
* Entferne alle alten Cronjobs, auch externe!
* Führe zuerst einen vollständigen Katalogabgleich durch, der Reihe nach: Kategorien, Brands, Produkte, Varianten, Kategoriezuordnungen.
* Checke die Abgleiche erst manuell. Nutze die Logs und den Explorer, um die Daten auf Vollständigkeit zu überprüfen.
* Richte dann die Cron Jobs ein.
* Empfehlung 1: Nutze die neuen Externen Endpoints für Bestellungen und abgebrochene Warenkörbe per Parameter über deinen Server oder cron-job.org für einen schnelleren Abgleich. Die übrigen Cronjobs kannst du über JTL laufen lassen
* Empfehlung 2: Genereller Hinweis: Nutze serverseitige Cronjob Trigger auf [https://deine-domain.tld/includes/cron\_inc.php](https://deine-domain.tld/includes/cron_inc.php), um einen zuverlässigen Cronjob Trigger zu setzen und deaktiviere die Pseudo Cron Methode in JTL
* Empfehlung 3: Nutze den Cron Job Manager in Resources & Health, um verwaiste Cronjobs zu entdecken und hart zu beenden.
* Empfehlung 4: Profile und Bestellungen müssen neu abgeglichen werden. Das ist problemlos möglich, da Reloadify die Bestellungen nicht doppelt anlegt, aber spar dir den Profilabgleich, denn diese werden mit Bestellabgleich ohnehin übertragen.
### Kompatibilität
* JTL-Shop 5.3.2 - 5.7.1
* Benötigt mindestens DZM Resources & Health 1.10.5
### Verbesserungen
* Vollständige Überarbeitung von Produktabgleich, Bestellabgleich und Abgleich abgebrochener Warenkörbe
* Eigene Cronjob Endpunkte für gezieltes Triggern von wichtigen Abgleichen
* Eigene Einstellungen für die Anzahl zeitgleich abzugleichender Datensätze
* Eigener Endpunkt für Warenkorblinks, die den abgebrochenen Warenkorb wiederherstellen
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.9.9
### Verbesserungen
* Verbessertes Errorhandling
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.9.5
### Verbesserungen
* Cronjobs überarbeitet für mehr Syncaufträge pro Durchgang
* Logginginformationen eingefügt
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.17
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.1
* Benötigt mindestens DZM Resources & Health 1.8.11
### Verbesserungen
* Verbesserte Überprüfung der zu synchronisierenden Bestellungen
* Schnittstelle überträgt nun neuste Bestellungen zuerst für direkten Einsatz bei großem Backlog
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.17
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.1
* Benötigt mindestens DZM Resources & Health 1.8.11
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.1
* Benötigt mindestens DZM Resources & Health 1.8.11
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.1
* Benötigt mindestens DZM Resources & Health 1.8.11
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.1
* Benötigt mindestens DZM Resources & Health 1.8.11
### Neue Features
* Cronjobs ergänzt
* Gelöschte Produkte auf Reloadify entfernen
* Kleinere Bugfixes
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.12
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.0
* Benötigt mindestens DZM Resources & Health 1.8.11
### Neue Features
* Verbinde deinen Reloadify Account
* Lege mehrere Feeds für verschiedene Sprachen an
* Übertrage Produkte und Kategorien
* Übertrage Newsletterempfänger aus JTL zu Reloadify
* Übertrage Käufer deiner Produkte an Reloadify
* Übertrage automatisch abgebrochene Warenkörbe
* Übertrage automatisch Bestellungen und zugehörige Produkte
### Kompatibilität
* JTL-Shop 5.3.\*
* Benötigt mindestens DZM Resources & Health 1.8.11
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.0
* Benötigt mindestens DZM Resources & Health 1.8.10
### Kompatibilität
* JTL-Shop 5.3.2 - 5.4.0
* Benötigt mindestens DZM Resources & Health 1.8.10
# Dashboard
Source: https://docs.dreizack-medien.de/Reloadify/dashboard
Überblick über alle Sync-Bereiche und manuelle Synchronisation starten
Das **Dashboard** ist die Übersichtsseite der Reloadify-Integration. Hier siehst du den aktuellen Sync-Status aller Datenbereiche auf einen Blick und kannst Synchronisationen manuell anstoßen.
## Sync-Karten
Für jeden Datenbereich gibt es eine eigene Karte:
| Bereich | Beschreibung |
| ---------------- | ------------------------------------------ |
| **Katalog** | Produkte, Kategorien, Brands und Varianten |
| **Profile** | Kundenprofile und Newsletter-Abonnenten |
| **Bestellungen** | Transaktionen aus dem JTL Shop |
| **Warenkörbe** | Abgebrochene Warenkörbe für Remarketing |
| **Abmeldungen** | Newsletter-Abmeldungen synchronisieren |
Jede Karte zeigt den Status des letzten Sync-Laufs. Über **Jetzt syncen** startest du die Synchronisation für diesen Bereich manuell. Der Pfeil-Link führt direkt in den jeweiligen Bereich.
## Letzte Sync-Läufe
Unterhalb der Karten werden die zuletzt protokollierten Sync-Läufe angezeigt. Details zu jedem Lauf findest du im [Sync-Log](/Reloadify/sync-log).
Die automatische Synchronisation läuft über den JTL-Cron. Manuelle Syncs über das Dashboard sind für Tests und einmalige Initialisierungen gedacht.
# Einstellungen
Source: https://docs.dreizack-medien.de/Reloadify/einstellungen
Sync-Verhalten, Warenkorb-Sync und DataFeeds konfigurieren
Im Bereich **Einstellungen** steuerst du das technische Verhalten der Synchronisation – von der Chunk-Größe über Retry-Versuche bis hin zu DataFeeds für verschiedene Sprache-Kundengruppen-Kombinationen.
## Sync-Verhalten
Anzahl der Datensätze, die pro Chunk übertragen werden (manuell + Cron). Empfehlung: **5–10** für Shared Hosting, höher nur bei dediziertem Server. Bei Bestellungen multipliziert sich die Last (Profil + Order + N Positionen pro Bestellung). Standard: `5`
Anzahl paralleler HTTP-Verbindungen zu Reloadify. Das System drosselt bei Server-Last automatisch und erhöht bei Erfolg wieder bis zum Maximum. Standard: `5`
Nach so vielen Fehlversuchen wird ein Datensatz als permanent fehlgeschlagen markiert. Standard: `5`
Wie lange ein CronJob-Tick mehrere Chunks abarbeiten darf, bevor er für den nächsten Tick stoppt. Default: `90` Sekunden (Puffer zu PHP-Timeout 120).
Wie lange API-Calls in der Datenbank gespeichert werden. Der Cleanup läuft automatisch im CleanupJob. Standard: `90`
## Warenkorb-Sync
Erst nach dieser Zeit ohne Änderung gilt ein Warenkorb als abgebrochen und wird zu Reloadify übertragen. Standard: `15` Minuten
Wie oft ein Restore-Link maximal aufgerufen werden darf, bevor er ungültig wird. Standard: `3`
Wenn aktiv, werden beim initialen Sync auch Bestellungen älter als 24 Stunden übertragen.
## DataFeeds
Ein DataFeed definiert eine Kombination aus **Sprache**, **Kundengruppe** und **Währung**. Reloadify nutzt diese Feeds, um Produktdaten differenziert nach Zielgruppe zu übertragen.
Klicke auf **+ Anlegen**, um einen neuen Feed zu erstellen. Vergib einen beschreibenden Namen (z.B. `Standard DE`) und wähle die gewünschte Kombination aus.
Für jeden aktiven Markt (Sprache + Kundengruppe + Währung) sollte ein eigener DataFeed angelegt werden.
# Explorer
Source: https://docs.dreizack-medien.de/Reloadify/explorer
Synchronisierte Daten zwischen JTL Shop und Reloadify vergleichen und prüfen
Der **Explorer** gibt dir einen detaillierten Einblick in die synchronisierten Daten. Du kannst gezielt prüfen, ob ein Datensatz lokal im Shop und in Reloadify übereinstimmt – nützlich zur Fehlerdiagnose.
## DataFeed & Aktionen
Oben wählst du den **DataFeed** aus (Sprache/Kundengruppe/Währung-Kombination), dessen Daten du prüfen möchtest. Über **Katalog leeren** kannst du den Reloadify-Katalog für diesen Feed zurücksetzen.
**Katalog leeren** löscht alle Produktdaten bei Reloadify für diesen Feed. Führe danach einen vollständigen Katalog-Sync durch.
Alle Artikel mit ID, Name, ArtNr, lokalem Status und Reloadify-Status. Suche nach Name, ArtNr oder ID.
Alle Kategorien mit ID, Name, lokalem Status und Reloadify-Status.
Alle Hersteller/Marken mit ID, Name und Reloadify-Status.
Alle Kundenprofile mit E-Mail, Name, Übertragungsgrund und Reloadify-Status.
Alle Bestellungen mit ID, BestellNr, Kunde, Datum, Sync-Status und Reloadify-Status.
Warenkörbe werden über die Cart-View erkannt und synchronisiert. Über **Alle prüfen** kannst du kontrollieren, was bei Reloadify vorhanden ist.
Nutze **Alle prüfen** in einem Tab, um den lokalen Stand mit Reloadify abzugleichen – ohne einen erneuten Sync auszulösen.
# Integration
Source: https://docs.dreizack-medien.de/Reloadify/integration
API-Zugangsdaten, Sprach-Mappings und Cron-Key für die Reloadify-Verbindung konfigurieren
Im Bereich **Integration** verbindest du deinen JTL Shop mit deinem Reloadify-Konto. Hier hinterlegst du die API-Zugangsdaten, konfigurierst Sprach-Mappings und findest den Cron-Key für externe Trigger.
## API-Credentials
Deine Reloadify Client ID. Diese findest du in deinem Reloadify-Konto unter den API-Einstellungen.
Dein Reloadify Client Secret. Wird zusammen mit der Client ID zur Authentifizierung genutzt.
Klicke auf **Speichern**, um die Verbindung zu aktivieren.
Gib Client ID und Client Secret nicht weiter. Mit diesen Zugangsdaten können Daten aus deinem Shop an Reloadify übertragen werden.
## Sprach-Mappings
Hier verknüpfst du JTL-Sprachen mit den entsprechenden Sprachen in Reloadify. Wähle links die JTL-Sprache und rechts die passende Reloadify-Sprache, dann klicke auf **+**, um das Mapping hinzuzufügen.
Fehlende Sprach-Mappings führen dazu, dass Produkte und Inhalte nicht in der richtigen Sprache an Reloadify übertragen werden.
## Cron-Key
Der Cron-Key ermöglicht es, den Sync-Prozess von außen zu triggern – z.B. über einen externen Cron-Dienst. Die Authentifizierung erfolgt wahlweise:
* Per HTTP-Header: `X-RELOADIFY-CRON-KEY: `
* Per Query-Parameter: `?cronKey=`
Über das Reload-Icon rechts kannst du einen neuen Cron-Key generieren.
# Katalog
Source: https://docs.dreizack-medien.de/Reloadify/katalog
Produkte, Kategorien, Brands und Varianten mit Reloadify synchronisieren
Im Bereich **Katalog** überträgst du alle Produktdaten aus deinem JTL Shop an Reloadify. Dazu gehören Produkte, Kategorien, Brands, Varianten und Kategorie-Zuordnungen.
## Synchronisation
Über **Alles syncen** überträgst du den gesamten Katalog auf einmal. Alternativ kannst du einzelne Bereiche gezielt syncen:
| Button | Was wird übertragen |
| ------------------- | --------------------------------------------- |
| **Kategorien** | Alle Produktkategorien |
| **Brands** | Alle Hersteller/Marken |
| **Produkte** | Alle Artikel inkl. Beschreibungen und Preisen |
| **Varianten** | Produktvarianten (Größe, Farbe etc.) |
| **Kat-Zuordnungen** | Zuordnungen von Produkten zu Kategorien |
## Kategorien
Die Tabelle zeigt alle synchronisierten Kategorien mit ID, Name, Sync-Status, Anzahl der Retry-Versuche und aufgetretenen Fehlern.
## Produkte
Die Produktliste zeigt alle Artikel mit ID, Name, Artikelnummer (ArtNr), Sync-Status, Retries und Fehlern. Über die Suche im [Explorer](/Reloadify/explorer) kannst du einzelne Produkte prüfen.
Führe nach größeren Sortimentsänderungen im JTL Shop einen manuellen Katalog-Sync durch, damit Reloadify stets aktuelle Produktdaten für Kampagnen nutzt.
# Profile
Source: https://docs.dreizack-medien.de/Reloadify/profile
Kundenprofile und Newsletter-Abonnenten mit Reloadify synchronisieren
Im Bereich **Profile** werden Kundendaten aus dem JTL Shop an Reloadify übertragen. Profile sind das Herzstück von Reloadify – sie repräsentieren alle Kontakte (Kunden, Newsletter-Abonnenten), die E-Mails erhalten sollen. Reloadify nutzt diese Profile zur Segmentierung, für personalisierte Kampagnen und für Marketing-Automationen.
## Synchronisation
Über **Profile syncen** überträgst du alle übertragbaren Profile manuell an Reloadify.
| Button | Funktion |
| ----------------------- | ------------------------------------------------------------------------------------------------ |
| **Fehler zurücksetzen** | Setzt fehlgeschlagene Sync-Versuche zurück, sodass sie beim nächsten Lauf erneut versucht werden |
| **Abmeldungen syncen** | Überträgt Newsletter-Abmeldungen an Reloadify |
## Einzelnes Profil resyncen
Gib die E-Mail-Adresse eines Kunden ein und klicke auf **Resync**, um dieses Profil gezielt neu zu übertragen – nützlich zur Fehlerdiagnose bei einzelnen Kunden.
## Übertragbare Profile
Die Tabelle zeigt alle Kunden, die an Reloadify übertragen werden, mit folgenden Spalten:
| Spalte | Beschreibung |
| ---------------- | ---------------------------------------------------- |
| **E-Mail** | E-Mail-Adresse des Kunden |
| **Name** | Vor- und Nachname |
| **Grund** | Warum das Profil übertragen wird (z.B. „Bestellung") |
| **Newsletter** | Newsletter-Status des Kunden |
| **Bestell.** | Anzahl der Bestellungen |
| **Sync** | Aktueller Sync-Status |
| **Letzter Sync** | Datum des letzten erfolgreichen Syncs |
Über die Suche kannst du nach Name oder E-Mail filtern. Das Dropdown rechts filtert nach Sync-Status.
In der Reloadify Web-App kannst du Profile mit **Tags** versehen, in dynamische **Segmente** einteilen (z.B. per RFM-Analyse) und einzeln oder per CSV-Import anlegen. Die vollständige Profilverwaltung erfolgt direkt in Reloadify.
# Sync-Log
Source: https://docs.dreizack-medien.de/Reloadify/sync-log
Protokoll aller Synchronisierungsläufe zwischen JTL Shop und Reloadify
Im **Sync-Log** findest du ein vollständiges Protokoll aller Sync-Läufe. Hier kannst du nachvollziehen, wann welche Daten übertragen wurden, wie lange es dauerte und ob Fehler aufgetreten sind.
## Spalten
| Spalte | Beschreibung |
| ------------- | --------------------------------------------------- |
| **Zeitpunkt** | Datum und Uhrzeit des Sync-Laufs |
| **Typ** | Art des Syncs (z.B. Katalog, Profile, Bestellungen) |
| **Trigger** | Auslöser des Syncs (Cron, manuell, extern) |
| **Ergebnis** | Ob der Lauf erfolgreich war oder Fehler enthält |
| **Dauer** | Laufzeit des Sync-Vorgangs in Sekunden |
## Filter & Aktionen
Über das Dropdown **Typ filtern** kannst du die Ansicht auf einen bestimmten Sync-Typ einschränken. Mit dem Refresh-Button rechts oben aktualisierst du die Ansicht.
Über **Sync-Log leeren** löschst du alle Einträge aus dem Protokoll.
Der Sync-Log hilft bei der Diagnose von Synchronisierungsproblemen. Prüfe bei Fehlern zuerst hier, bevor du die [API-Calls](/Reloadify/api-calls) analysierst.
# Warenkörbe
Source: https://docs.dreizack-medien.de/Reloadify/warenkoerbe
Abgebrochene Warenkörbe erkennen und für Reloadify-Remarketing synchronisieren
Im Bereich **Warenkörbe** erkennt das Plugin abgebrochene Warenkörbe in deinem JTL Shop und überträgt sie mit einem personalisierten Wiederherstellungs-Link an Reloadify. Damit kannst du automatisierte Warenkorbabbrecher-Kampagnen in Reloadify starten.
## Erkennung & Synchronisation
Das System erkennt Warenkörbe, die älter als das konfigurierte Zeitlimit sind und noch nicht bestellt wurden, und sendet diese an Reloadify mit einem personalisierten Wiederherstellungs-Link.
Über **Jetzt prüfen & syncen** startest du die Erkennung und Übertragung manuell.
Über **Fehler zurücksetzen** werden fehlgeschlagene Sync-Versuche zurückgesetzt und beim nächsten Lauf erneut versucht.
## Erkannte abgebrochene Warenkörbe
Die Tabelle zeigt alle erkannten abgebrochenen Warenkörbe:
| Spalte | Beschreibung |
| ---------------- | ------------------------------------------ |
| **Warenkorb** | ID des abgebrochenen Warenkorbs |
| **Kunde** | E-Mail des Kunden |
| **Status** | Aktueller Übertragungsstatus |
| **Letzter Push** | Datum der letzten Übertragung an Reloadify |
| **Pushes** | Anzahl der Übertragungsversuche |
| **Aufgerufen** | Wie oft der Restore-Link aufgerufen wurde |
| **Erster Push** | Datum der ersten Übertragung |
Über das Suchfeld kannst du nach E-Mail oder Warenkorb-ID filtern.
Das Mindestalter für abgebrochene Warenkörbe und die maximale Anzahl Restore-Token-Aufrufe konfigurierst du in den [Einstellungen](/Reloadify/einstellungen) unter „Warenkorb-Sync".
In der Reloadify Web-App richtest du auf Basis der übertragenen Warenkörbe automatische Erinnerungs-E-Mails ein – mit konfigurierbarem Timing (z.B. nach 30 Min., 1 Std. oder 1 Tag) und dynamischen Produktblöcken, die den genauen Warenkorbinhalt des Kunden anzeigen.
# Config.ini Optionen
Source: https://docs.dreizack-medien.de/Resources-and-Health/Config-Optionen
## Übersicht
In diesem Tab kannst du die `config.JTL-Shop.ini.php`-Einstellungen schnell aus dem Shop heraus anpassen, ohne diese direkt auf deinem FTP-Server aufrufen zu müssen. So kannst du hier Log- und Debug-Einstellungen direkt vornehmen. Wenn du Logfiles schreiben lässt, kannst du diese außerdem direkt hier ausgeben lassen.
**Kein FTP-Zugriff nötig!**
Alle wichtigen Debug- und Log-Einstellungen können komfortabel über das Backend konfiguriert werden - ideal für Shop-Betreiber ohne technische Kenntnisse oder FTP-Zugang.
## Features
Bearbeite Debug- und Log-Einstellungen direkt aus dem Shop-Backend ohne FTP-Zugriff.
Schreibe Logfiles und lese sie direkt im Backend aus - perfekt für Fehleranalyse.
Wähle zwischen Standard-Config-File oder individuellen Einstellungen im Tool.
Detaillierte Kontrolle über welche Fehlertypen geloggt werden sollen.
## Konfigurationsoptionen
### Config File Modus
**Config File verwenden (Standard)**
Bei aktivierter Option werden die Einstellungen aus der `config.JTL-Shop.ini.php` verwendet.
Dies ist die Standardeinstellung und empfohlen für die meisten Anwendungsfälle. Änderungen an der Config-Datei werden automatisch übernommen.
**Vorteile:**
* Konsistenz mit Shop-Einstellungen
* Änderungen persistent auf Dateiebene
* Kompatibel mit allen Shop-Features
**Nachteile:**
* Weniger flexibel für temporäre Debug-Sessions
* Erfordert FTP-Zugriff für erweiterte Optionen
**Individuelle Tool-Einstellungen**
Bei deaktivierter Option erscheinen alle konfigurierbaren Optionen direkt im Tool.
Diese Einstellungen überschreiben die `config.JTL-Shop.ini.php` nur für DZM-Plugins. Shop-Core-Funktionen nutzen weiterhin die Config-Datei.
**Vorteile:**
* Schnelle Anpassungen ohne FTP
* Granulare Kontrolle über jeden Fehlertyp
* Ideal für temporäres Debugging
**Nachteile:**
* Einstellungen gelten nur für DZM Plugins
* Können bei Plugin-Updates überschrieben werden
### Log-Einstellungen
Wenn aktiviert, werden Fehler in das JTL-Shop Logbuch geschrieben.
**Zugriff:** Backend → Fehlerbehebung → Logbuch
Sollte im Live-Betrieb **immer aktiviert** sein, um Probleme nachvollziehen zu können.
Bestimmt, welche Meldungstypen geloggt werden:
* **3** = Alle Meldungen (Debug, Info, Warning, Error)
* **2** = Errors und Warnings (empfohlen)
* **1** = Nur Errors
* **0** = Keine Meldungen
**Verwendung:** Nur bei aktiver Fehlersuche
**Vorteil:** Maximale Information für Debugging
**Nachteil:** Sehr große Logfiles, kann Performance beeinträchtigen
Nicht für Live-Shops empfohlen! Logfiles können sehr schnell sehr groß werden.
**Verwendung:** Standard für Live-Shops
**Vorteil:** Balance zwischen Information und Performance
**Nutzen:** Erfasst alle relevanten Probleme ohne zu viel Overhead
**Empfohlen** für den Produktivbetrieb.
**Verwendung:** Minimalistisches Logging
**Vorteil:** Kleinste Logfiles, beste Performance
**Nachteil:** Warnungen werden nicht erfasst, erschwert Problemdiagnose
**Verwendung:** Nur in Ausnahmefällen
Nicht empfohlen! Ohne Logs ist Fehlerdiagnose nahezu unmöglich.
### Fehlertyp-Filter
Granulare Kontrolle über welche PHP-Fehlertypen geloggt werden:
**Errors ausschließen**
Aktiviere diese Option, wenn du keine Fehlermeldungen erfassen möchtest.
Wird **nicht empfohlen**! Errors sind kritische Probleme, die unbedingt erfasst werden sollten.
**Beispiel-Errors:**
* Fatal Errors (Script-Abbruch)
* Undefined Variables
* Function not found
* Database Connection Errors
**Warnungen ausschließen**
Warnungen sind Hinweise auf mögliche Probleme, die nicht zum Abbruch führen.
Warnungen sollten erfasst werden, da sie oft auf zukünftige Probleme hinweisen.
**Beispiel-Warnings:**
* Deprecated Functions
* Include/Require Warnings
* Division by Zero
* Invalid Arguments
**Hinweise ausschließen**
Informative Hinweise können Logfiles überladen, besonders in Entwicklungs-Umgebungen.
Im Live-Betrieb können Notices deaktiviert werden. Bei Debugging sollten sie aktiviert sein.
**Beispiel-Notices:**
* Undefined Index
* Undefined Offset
* Use of undefined constant
**Parse Fehler**
Parse-Fehler treten auf, wenn PHP-Code syntaktisch nicht korrekt ist.
Sollten **nicht ausgeschlossen** werden - Parse-Errors sind kritisch!
**Strict Verstöße**
Strict-Standards-Meldungen für optimale Code-Qualität.
Können im Live-Betrieb deaktiviert werden.
**Deprecated Meldungen**
Warnungen über veraltete Funktionen.
Sollten erfasst werden, um rechtzeitig vor PHP-Updates zu reagieren.
### Frontend-Ausgabe
**Fehler im Frontend ausgeben**
Bestimmt, ob Fehlermeldungen direkt für Besucher sichtbar sein sollen.
**Im Live-Betrieb sollte diese Option IMMER deaktiviert sein!**
**Gründe:**
* **Sicherheit:** Fehler können sensible Informationen preisgeben
* **Professionalität:** Fehlermeldungen wirken unprofessionell
* **User Experience:** Verwirrt und verunsichert Kunden
**Stattdessen:**
* Nutze Logfiles für Fehleranalyse
* Zeige generische Fehlerseiten
* Überwache Logs regelmäßig
**In Entwicklungs-Umgebungen kann diese Option aktiviert sein.**
**Vorteile:**
* Sofortiges visuelles Feedback
* Schnellere Entwicklung
* Detaillierte Stack Traces
**Wichtig:**
* Nur auf Test-/Staging-Systemen
* Niemals auf Live-Shops
* Zugriff idealerweise IP-beschränkt
### Logfile-Verwaltung
**Zusätzliches Logfile schreiben**
Erstellt ein separates Logfile zusätzlich zum JTL-Shop Logbuch.
Aktiviere "Logfile schreiben?" um ein separates DZM-Logfile zu erstellen.
Das Logfile wird im Plugin-Verzeichnis unter `/plugins/dzm_resources/logs/` gespeichert.
Klicke auf "Logfiles laden", um die Inhalte direkt im Backend anzuzeigen.
Die Ansicht zeigt die neuesten Einträge zuerst für schnelleren Zugriff.
Jeder Log-Eintrag enthält:
* **Timestamp:** Wann trat der Fehler auf
* **Level:** Error, Warning, Notice, etc.
* **Message:** Fehlerbeschreibung
* **File & Line:** Wo trat der Fehler auf
* **Stack Trace:** Aufruf-Kette (bei Errors)
Regelmäßig alte Logs archivieren oder löschen, um Speicherplatz zu sparen.
Große Logfiles können den Speicher füllen und die Performance beeinträchtigen.
## Empfohlene Konfigurationen
**Produktionsumgebung**
```ini theme={null}
Config File verwenden: ✓ (aktiviert)
Fehler loggen: ✓
DZM Plugin Loglevel: 2 (Errors + Warnings)
Errors ausschließen: ✗
Warnungen ausschließen: ✗
Hinweise ausschließen: ✓
Parse Fehler ausschließen: ✗
Strict Verstöße ausschließen: ✓
Deprecated ausschließen: ✗
Fehler im Frontend ausgeben: ✗ (WICHTIG!)
Logfile schreiben: ✗ (optional ✓)
```
Diese Konfiguration bietet optimale Balance zwischen Überwachung und Performance.
**Test- und Staging-Umgebung**
```ini theme={null}
Config File verwenden: ✗ (deaktiviert)
Fehler loggen: ✓
DZM Plugin Loglevel: 3 (Alle Meldungen)
Errors ausschließen: ✗
Warnungen ausschließen: ✗
Hinweise ausschließen: ✗
Parse Fehler ausschließen: ✗
Strict Verstöße ausschließen: ✗
Deprecated ausschließen: ✗
Fehler im Frontend ausgeben: ✓
Logfile schreiben: ✓
```
Maximale Logging-Stufe für umfassende Tests und Debugging.
**Lokale Entwicklungsumgebung**
```ini theme={null}
Config File verwenden: ✗ (deaktiviert)
Fehler loggen: ✓
DZM Plugin Loglevel: 3 (Alle Meldungen)
Errors ausschließen: ✗
Warnungen ausschließen: ✗
Hinweise ausschließen: ✗
Parse Fehler ausschließen: ✗
Strict Verstöße ausschließen: ✗
Deprecated ausschließen: ✗
Fehler im Frontend ausgeben: ✓
Logfile schreiben: ✓
```
Vollständiges Logging hilft bei der Entwicklung und beim Debugging neuer Features.
**Temporäre Konfiguration für Fehlersuche**
```ini theme={null}
Config File verwenden: ✗ (deaktiviert)
Fehler loggen: ✓
DZM Plugin Loglevel: 3 (Alle Meldungen)
Alle Ausschlüsse: ✗ (nichts ausschließen)
Fehler im Frontend ausgeben: ✗ (nur wenn nötig)
Logfile schreiben: ✓
```
Nach Problemlösung **unbedingt** auf Live-Konfiguration zurückstellen!
## Best Practices
**Warum wichtig:**
* Probleme frühzeitig erkennen
* Trends identifizieren
* Performance-Probleme aufdecken
**Empfehlung:**
* Täglich: Kurzer Blick auf neue Errors
* Wöchentlich: Review aller Warnings
* Monatlich: Vollständiger Log-Audit
Richte automatische Reports ein, die dich bei kritischen Errors benachrichtigen.
**Problem:** Logfiles wachsen unbegrenzt
**Lösung:**
* Implementiere automatische Log-Rotation
* Archiviere alte Logs monatlich
* Lösche Logs älter als 6-12 Monate
**Beispiel-Script (Cron):**
```bash theme={null}
# Logs älter als 30 Tage archivieren
find /path/to/logs -name "*.log" -mtime +30 -exec gzip {} \;
# Archive älter als 180 Tage löschen
find /path/to/logs -name "*.log.gz" -mtime +180 -delete
```
**Logfiles schützen:**
* Nicht öffentlich zugänglich machen
* Berechtigungen korrekt setzen (640 oder 600)
* Sensible Daten filtern (Passwörter, API-Keys)
**.htaccess Schutz:**
```apache theme={null}
Order Deny,Allow
Deny from all
```
Logfiles können sensible Informationen enthalten - immer vor öffentlichem Zugriff schützen!
**Loggen kostet Performance:**
* Level 3 nur bei Bedarf
* Frontend-Ausgabe niemals im Live-Betrieb
* Große Logs regelmäßig bereinigen
**Optimierung:**
* Nutze Log-Level 2 im Produktivbetrieb
* Schreibe Logs asynchron (wenn möglich)
* Überwache Logfile-Größen
## Troubleshooting
**Mögliche Ursachen:**
1. Logging ist deaktiviert
2. Keine Schreibrechte im Log-Verzeichnis
3. PHP-Konfiguration verhindert Logging
4. Disk-Speicher voll
**Lösung:**
```bash theme={null}
# Prüfe Verzeichnis-Berechtigungen
ls -la /plugins/dzm_resources/logs/
# Setze korrekte Berechtigungen
chmod 755 /plugins/dzm_resources/logs/
chmod 644 /plugins/dzm_resources/logs/*.log
# Prüfe Speicherplatz
df -h
```
**Problem:** Logfile füllt sich sehr schnell
**Diagnose:**
1. Welcher Fehlertyp dominiert?
2. Kommt der Fehler von einem bestimmten Plugin?
3. Ist es ein wiederkehrendes Problem?
**Lösung:**
* Behebe die Ursache des Fehlers
* Erhöhe temporär den Loglevel
* Schließe unwichtige Fehlertypen aus
* Implementiere Log-Rotation
**Fehlermeldung:** "Permission denied" oder "File not found"
**Lösung:**
```bash theme={null}
# Prüfe Dateiberechtigungen
ls -l /plugins/dzm_resources/logs/plugin.log
# Korrigiere Berechtigungen
chmod 644 /plugins/dzm_resources/logs/plugin.log
# Prüfe Besitzer
chown www-data:www-data /plugins/dzm_resources/logs/plugin.log
```
**Tipp:** Führe nach jeder größeren Änderung (Plugin-Updates, Shop-Updates, Config-Änderungen) einen kurzen Log-Check durch, um sicherzustellen, dass alles korrekt läuft.
## Weiterführende Ressourcen
Offizielle PHP-Dokumentation zu Error Handling und Logging
JTL-Shop Guide zur Fehlerdiagnose und Log-Verwaltung
Best Practices für professionelles Log-Management
Xdebug für erweiterte PHP-Debugging-Möglichkeiten
# Error-Tracking
Source: https://docs.dreizack-medien.de/Resources-and-Health/Error-Tracking
## Was macht das Error-Tracking?
JTL speichert Core- und DB-Fehler im Systemlog (`tjtllog`) oft nur als **Halb-Log**: die SQL-Query, aber ohne Stacktrace und ohne den Hinweis, welcher Code den Fehler ausgelöst hat. Das DZM-Logsystem schreibt strukturiert nach `tDZMLogEntries` (Level, Kontext, Stacktrace, Request-ID) und zeigt die Einträge unter [Logs](/Resources-and-Health/Logs) an.
Zwei Bausteine erweitern das gezielt:
* **Core-Log-Mirror** (in `dzm_resources`): spiegelt JTLs eigene Fehler angereichert um einen **rekonstruierten Aufrufer-Stack** ins DZM-Log. Das ist der einzige Weg, an die *gefangenen* DB-Fehler heranzukommen.
* **Plugin-freies Snippet** (ohne `dzm_resources`): fängt Fatals/OOM/weißen Screen und uncaught Exceptions mit vollem Stack in eine Log-Datei – als frühes Netz oder für Shops ganz ohne DZM-Plugins.
Bound-Params und der strukturierte MySQL-Fehler bleiben weg (JTL wirft sie vor dem Logger weg). Geliefert werden SQL + MySQL-Message + Stack. Das plugin-freie Snippet sieht die gefangenen DB-Fehler gar nicht – dafür den Core-Log-Mirror aktivieren.
## Core-Log-Mirror aktivieren
Ein Einzeiler in der `config.JTL-Shop.ini.php`. Danach landen JTLs Core-/DB-Fehler zusätzlich als Plugin "jtl\_core" in den Logs – inklusive Stack.
```php theme={null}
define('DZM_LOGGER_MIRROR_CORE', true);
```
Ans Ende der `includes/config.JTL-Shop.ini.php`. Voraussetzung: JTL loggt den Fehler überhaupt (DB-Fehler-Logging hängt an `ES_DB_LOGGING`). Nur Error-Level wird gespiegelt.
## Logger-Konfiguration
Aktuelle Werte der `DZM_LOGGER_*`-Konstanten. Gesetzt in `config.JTL-Shop.ini.php`; ohne `defined()` gilt der Default.
Master-Switch. `false` → `log()` kehrt sofort ohne Aktion zurück.
Speicher-Ziel. `db` = nur DB (mit File-Fallback bei DB-Fehler), `file` = nur Datei, `both` = beides.
Möglich: `db` | `file` | `both`
PSR-3-Mindestlevel. Einträge unterhalb werden verworfen (Performance-Guard, ohne Context-Serialisierung).
Möglich: `emergency` | `alert` | `critical` | `error` | `warning` | `notice` | `info` | `debug`
Aufbewahrungsdauer in Tagen für DB-Einträge und Log-Files. Cleanup mit Wahrscheinlichkeit 1/500 pro Write.
Rotation-Schwelle pro Log-Datei in MB. Bei Überschreitung wird -1, -2 … angehängt.
Zielverzeichnis für Log-Files (Trailing-Slash). Wird beim ersten File-Write angelegt inkl. `.htaccess`.
CrashHandler aktivieren: uncaught Throwables + Fatal Errors via `set_exception_handler`/`shutdown_function` erfassen.
Zusätzlich `set_error_handler` für Warnings/Notices/Deprecated registrieren (respektiert @-Suppression).
JTL-Core-Systemlog (`tjtllog`, z.B. "Error executing query …") zusätzlich als Plugin "jtl\_core" in `tDZMLogEntries` spiegeln – angereichert um einen rekonstruierten Aufrufer-Stack. Nur Error-Level.
## Plugin-freies Error-Tracking (ohne dzm\_resources)
Für Shops ohne DZM-Plugins oder als frühes Netz. Fängt Fatals/OOM + uncaught Exceptions mit Stack, schreibt nach `jtllogs/dzm-selfcheck/`.
Ans Ende der `includes/config.JTL-Shop.ini.php` einfügen.
Erfasst genau die Fehler, die JTL selbst verschluckt oder nur als Halb-Log speichert:
1. Fatal Errors / Out-of-Memory / weißer Screen (Shutdown, zuverlässig)
2. uncaught Exceptions mit vollem Stacktrace (chained)
Schreibt nach `shop_root/jtllogs/dzm-selfcheck/` (JTLs `jtllogs`-Ordner ist per `.htaccess` vor Web-Zugriff geschützt; zusätzlich legt der Block ein eigenes Deny-`.htaccess` an).
**Grenzen (bewusst):** Gefangene DB-Fehler (JTLs "Error executing query …") tauchen hier NICHT auf – die fängt JTL intern ab, kein globaler Handler sieht sie. Dafür braucht es den [Core-Log-Mirror](#core-log-mirror-aktivieren) (`DZM_LOGGER_MIRROR_CORE`) in `dzm_resources`.
**Deaktivieren:** `define('DZM_ERRORLOG_ENABLED', false);` oder diesen Block löschen.
**Eigener Pfad:** `define('DZM_ERRORLOG_DIR', '/absoluter/pfad/');` (vor diesem Block setzen)
# Logs
Source: https://docs.dreizack-medien.de/Resources-and-Health/Logs
## Übersicht
Einige Logs werden direkt in der Datenbank mit nützlichen Zusatzinformationen erfasst. In diesem Tab kannst du diese zentral einsehen, analysieren und verwalten.
**Zentrale Log-Verwaltung**
Alle DZM Plugins schreiben ihre Logs in ein zentrales System. So hast du alle wichtigen Ereignisse, Fehler und Informationen an einem Ort - ohne durch verschiedene Logfiles navigieren zu müssen.
## Features
Alle Logs von allen DZM Plugins an einem einzigen Ort übersichtlich dargestellt.
Datenbank-Logs enthalten Zusatzinformationen wie User-Context, Request-Daten und Stack Traces.
Logs aktualisieren, filtern, durchsuchen und mit einem Klick löschen.
Paginierung und intelligente Indexierung sorgen für schnellen Zugriff auch bei vielen Einträgen.
## Log-Übersicht
### Interface-Elemente
**Spalten in der Übersicht:**
| Spalte | Beschreibung |
| ----------------- | ----------------------------------------- |
| **#** | Laufende Nummer des Log-Eintrags |
| **Plugin** | Welches DZM Plugin hat geloggt? |
| **Auslöser** | Was hat den Log-Eintrag ausgelöst? |
| **Datum** | Wann wurde der Eintrag erstellt? |
| **Beschreibung** | Kurzbeschreibung des Events |
| **Fehlermeldung** | Technische Fehlermeldung (wenn vorhanden) |
| **Level** | Error, Warning, Info, Debug |
Klicke auf eine Zeile um detaillierte Informationen und den vollständigen Stack Trace zu sehen.
**Verfügbare Filter:**
**Nach Level filtern:**
* Errors only
* Warnings only
* Info only
* Debug only
* Alle anzeigen
**Nach Plugin filtern:**
* Dropdown mit allen DZM Plugins
* Zeigt nur Logs des gewählten Plugins
**Nach Zeitraum filtern:**
* Letzte 24 Stunden
* Letzte 7 Tage
* Letzte 30 Tage
* Benutzerdefiniert
**Suchfunktion:**
* Durchsuche Message-Text
* Suche nach User
* Suche nach IP-Adresse
* Volltextsuche in Details
**Aktualisieren**
Lädt die neuesten Log-Einträge und aktualisiert die Ansicht.
Logs werden in Echtzeit geschrieben - nutze diese Funktion bei aktiver Fehlersuche.
**Logs löschen**
Löscht **alle** bisherigen Log-Einträge aus der Datenbank.
Diese Aktion kann nicht rückgängig gemacht werden! Exportiere wichtige Logs vorher.
**Exportieren** (geplant)
Exportiere Logs als CSV oder JSON für externe Analyse.
**Seitennavigation:**
* Standardmäßig 50 Einträge pro Seite
* Pfeile für Vor/Zurück
* Direkteingabe der Seitenzahl
* "Zur letzten Seite" Button
**Einträge pro Seite:**
* 25 Einträge
* 50 Einträge (Standard)
* 100 Einträge
* 250 Einträge
Bei sehr vielen Einträgen (>10.000) kann die Ladezeit bei hohen Seitenzahlen etwas länger sein.
## Log-Levels verstehen
ERROR - Kritische Fehler>}>
**Was bedeutet es:**
Ein schwerwiegender Fehler ist aufgetreten, der die Funktionalität beeinträchtigt.
**Typische Beispiele:**
* Datenbankfehler
* Failed API Calls
* Fehlende Dateien oder Berechtigungen
* Unerwartete Exceptions
**Was tun:**
* Sofort prüfen und beheben
* Prüfe ob Funktionalität betroffen ist
* Bei Wiederholung: Ursache identifizieren
Errors sollten niemals ignoriert werden - sie deuten auf echte Probleme hin!
WARNING - Warnungen>}>
**Was bedeutet es:**
Etwas funktioniert nicht wie erwartet, aber der Betrieb läuft weiter.
**Typische Beispiele:**
* Deprecated Functions verwendet
* Fehlende optionale Konfiguration
* Performance-Probleme
* Ungewöhnliche aber handhabbare Zustände
**Was tun:**
* Bei Gelegenheit prüfen
* Wenn wiederkehrend: beheben
* Bei Deprecated: für zukünftige Updates vorbereiten
Warnings sind Hinweise auf potenzielle Probleme - sollten mittelfristig behoben werden.
INFO - Informationen>}>
**Was bedeutet es:**
Wichtige Ereignisse oder Statusmeldungen zur Nachvollziehbarkeit.
**Typische Beispiele:**
* Erfolgreiche Datenimporte
* Konfigurationsänderungen
* Benutzeraktionen (Login, Käufe)
* System-Events
**Was tun:**
* Zur Kenntnis nehmen
* Bei Analysen hilfreich
* Für Audits relevant
Info-Logs sind besonders nützlich für Business Intelligence und Audit-Trails.
DEBUG - Debug-Informationen>}>
**Was bedeutet es:**
Detaillierte technische Informationen für Entwickler und Support.
**Typische Beispiele:**
* Variablenwerte
* Methodenaufrufe
* SQL-Queries
* API-Request/Response-Details
**Was tun:**
* Nur bei aktiver Fehlersuche relevant
* Im Live-Betrieb meist nicht nötig
* Für Support-Anfragen hilfreich
Debug-Logs werden nur geschrieben, wenn Debug-Modus aktiviert ist.
## Log-Details ansehen
Klicke in der Log-Tabelle auf einen Eintrag, um die Detail-Ansicht zu öffnen.
Die Detail-Ansicht zeigt:
**Grundinformationen:**
* Vollständige Message
* Genauer Timestamp
* Log-Level und Plugin
**Technische Details:**
* Stack Trace (bei Errors)
* Betroffene Datei und Zeile
* Function/Method Context
**Request-Kontext:**
* URL die aufgerufen wurde
* HTTP-Method (GET, POST, etc.)
* User Agent
* Session-ID (wenn verfügbar)
**Zusatzdaten:**
* Custom Data (Plugin-spezifisch)
* Related IDs (Order, Product, etc.)
* Performance Metrics
Basierend auf den Informationen:
* Problem identifizieren
* Reproduktionsschritte erkennen
* Fix implementieren oder Support kontaktieren
## Häufige Log-Einträge
**Typische Einträge:**
```
[INFO] Plugin XYZ successfully installed
[INFO] Database tables created for plugin XYZ
[INFO] Plugin configuration initialized
```
**Normal:** Installation-Logs zeigen erfolgreichen Setup
**Problem-Indikatoren:**
```
[ERROR] Failed to create database table: XYZ
[ERROR] Plugin installation rolled back
[WARNING] Missing dependencies for plugin XYZ
```
**Typische Einträge:**
```
[INFO] Configuration updated by user@example.com
[INFO] Setting 'feature_x' changed from false to true
[INFO] Cache cleared after configuration change
```
**Nutzen:**
* Audit Trail für Änderungen
* Nachvollziehbarkeit bei Problemen
* Compliance-Dokumentation
**Typische Einträge:**
```
[WARNING] Query execution time exceeded 1000ms
[WARNING] Memory usage above 80%: 205MB/256MB
[WARNING] High request count: 500 req/min
```
**Maßnahmen:**
* Queries optimieren
* Memory Limit erhöhen
* Rate Limiting prüfen
* Server-Ressourcen skalieren
**Typische Einträge:**
```
[INFO] API request to example.com successful
[ERROR] API request failed: Connection timeout
[WARNING] API response slow: 3500ms
[DEBUG] API Request: {"endpoint": "/api/v1/..."}
```
**Analyse:**
* Externe Dienst-Verfügbarkeit prüfen
* API-Credentials validieren
* Rate Limits beachten
## Best Practices
**Empfohlene Routine:**
**Täglich:**
* Neue Errors durchsehen (5 min)
* Kritische Warnings prüfen
**Wöchentlich:**
* Alle Warnings reviewen (15 min)
* Muster in Errors erkennen
* Performance-Logs analysieren
**Monatlich:**
* Vollständiger Log-Audit (30-60 min)
* Alte Logs archivieren/löschen
* Trends identifizieren
Richte dir wiederkehrende Termine ein - regelmäßige Log-Reviews verhindern, dass kleine Probleme zu großen werden.
**Wann Logs löschen:**
* Vor großen Änderungen (für klare Before/After-Ansicht)
* Nach erfolgreicher Problembehebung
* Bei zu vielen Einträgen (>100.000)
* Regelmäßig (z.B. vierteljährlich)
**Was vorher tun:**
* Wichtige Errors dokumentieren
* Bei Bedarf exportieren (wenn verfügbar)
* Screenshots kritischer Einträge
Lösche Logs nur, wenn du sicher bist, dass keine wichtigen Informationen verloren gehen!
**Strategie bei Problemen:**
* Problem nachstellen
* Genau dokumentieren was passiert
* Logs während Reproduktion beobachten
* Nach relevanten Plugin filtern
* Zeitraum eingrenzen (letzten 10 Minuten)
* Nur Errors/Warnings anzeigen
* Stack Trace durchgehen
* Request-Kontext prüfen
* Ähnliche Einträge suchen
* Fix implementieren
* Erneut testen
* Logs prüfen ob Problem behoben
**Logs können Performance beeinflussen:**
**Bei vielen Einträgen:**
* Regelmäßig alte Logs löschen
* Database-Indizes prüfen
* Log-Level anpassen (nicht alles loggen)
**Debug-Modus:**
* Nur temporär aktivieren
* Im Live-Betrieb deaktivieren
* Kann viele Einträge generieren
Die Log-Datenbank-Tabelle sollte idealerweise unter 100.000 Einträgen bleiben für optimale Performance.
## Logs für Support-Anfragen
Wenn du Support kontaktierst:
* Filtere nach dem betroffenen Plugin
* Setze Zeitraum auf "letzten 24h"
* Zeige nur Errors und Warnings
Mache Screenshots von:
* Der Log-Übersicht mit Filtern
* Detail-Ansicht relevanter Errors
* Stack Traces (vollständig)
Nutze Browser-Tools um vollständige Screenshots zu erstellen (auch von langem Content).
Informiere den Support über:
* Wann trat das Problem auf?
* Was hast du gemacht?
* Ist es reproduzierbar?
* Welche Plugins sind installiert?
* PHP/Shop-Version
* Screenshots in Support-Ticket anhängen
* Oder: Export-Funktion nutzen (wenn verfügbar)
* Sensitive Daten schwärzen (IPs, User-IDs)
## Troubleshooting
**Mögliche Ursachen:**
1. Noch keine Logs geschrieben
2. Logging deaktiviert
3. Database-Verbindung Problem
4. Filter zu restriktiv
**Lösung:**
* Prüfe [Config.ini Optionen](/Resources-and-Health/Config-Optionen) ob Logging aktiv ist
* Setze alle Filter zurück
* Aktualisiere die Ansicht
* Teste Logging mit Debug-Modus
**Problem:** Neue Einträge erscheinen nicht
**Checks:**
* Browser-Cache leeren
* Hard Reload (Strg+Shift+R)
* Prüfe ob Auto-Refresh aktiv ist
* Manuelle Aktualisierung klicken
**Falls weiter Problem:**
* Prüfe Browser-Console auf JS-Errors
* Teste in anderem Browser
* Cache-System prüfen
**Ursache:** Zu viele Log-Einträge in Datenbank
**Sofort-Maßnahme:**
* Reduziere Einträge pro Seite auf 25
* Nutze Filter um Datenmenge zu reduzieren
**Langfristig:**
* Alte Logs löschen
* Implementiere automatische Log-Rotation
* Reduziere Log-Level
Bei >250.000 Einträgen können Performance-Probleme auftreten.
**Mögliche Ursachen:**
* Keine Berechtigung
* Database-Lock
* Timeout bei vielen Einträgen
**Lösung:**
```sql theme={null}
-- Manuell via phpMyAdmin (als Notlösung)
TRUNCATE TABLE `dzm_plugin_logs`;
```
Nur als letzter Ausweg - normalerweise sollte der Button funktionieren!
## Erweiterte Features (geplant)
**Coming Soon**
Exportiere Logs als CSV oder JSON für:
* Externe Analyse-Tools
* Langzeit-Archivierung
* Compliance-Reports
* Custom Analytics
**Coming Soon**
Erhalte Benachrichtigungen bei:
* Kritischen Errors
* Ungewöhnlich vielen Warnings
* Performance-Problemen
* Plugin-Fehlern
**Coming Soon**
Visualisierung und Trends:
* Error-Rate über Zeit
* Plugin-Performance-Vergleich
* Häufigste Fehlertypen
* User-Activity-Tracking
**Coming Soon**
Konfigurierbare Auto-Deletion:
* Logs älter als X Tage löschen
* Maximale Anzahl Einträge
* Intelligente Priorisierung
* Archivierung vor Löschung
**Pro-Tipp:** Kombiniere die Log-Ansicht mit den [Config.ini Optionen](/Resources-and-Health/Config-Optionen), um temporär detailliertes Logging zu aktivieren, wenn du ein Problem analysierst. Vergiss nicht, es danach wieder zu deaktivieren!
# Mountpoints
Source: https://docs.dreizack-medien.de/Resources-and-Health/Mountpoints
## Übersicht
In diesem Tab kannst du zusätzliche Mountpoints (Ankerpunkte) für den OnPage Composer aktivieren. So kannst du Portlets an vielen zusätzlichen Stellen in deinem Onlineshop platzieren und erhältst dadurch mehr Gestaltungsfreiheit in deinem Shop.
**Was sind Mountpoints?**
Mountpoints sind vordefinierte Positionen im Shop-Template, an denen du über den OnPage Composer (OPC) Inhalte platzieren kannst. Standardmäßig bietet JTL-Shop bereits viele Mountpoints - mit diesem Tool erhältst du Zugriff auf zusätzliche, erweiterte Positionen.
## Features
Platziere OPC-Portlets an zusätzlichen Stellen, die standardmäßig nicht verfügbar sind.
Erhalte volle Kontrolle über die Positionierung deiner Inhalte im gesamten Shop-Layout.
Aktiviere nur die Mountpoints, die du tatsächlich benötigst - kein unnötiger Overhead.
Funktioniert mit allen Standard-Templates und den meisten Custom-Templates.
## Mountpoint-Verwaltung
### Mountpoints aktivieren
Aktiviere den Toggle neben den Mountpoints, die du verwenden möchtest.
Du kannst mehrere Mountpoints gleichzeitig aktivieren. Aktiviere nur die, die du wirklich benötigst.
Klicke auf "Speichern", um die Änderungen zu übernehmen.
Die Mountpoints sind sofort im OnPage Composer verfügbar - kein Cache-Leeren erforderlich.
Öffne den OnPage Composer und wähle die neue Position aus der Mountpoint-Liste aus.
## Verfügbare Mountpoints
Fügt einen Mountpoint direkt vor der Topbar ein. Geeignet für Announcement-Bars oder Info-Leisten.
Fügt einen Mountpoint direkt nach der Topbar ein.
Fügt einen Mountpoint oberhalb der Sidebar ein. Ideal für Filter-Erweiterungen oder Featured-Content.
Fügt einen Mountpoint unterhalb der Sidebar ein. Geeignet für zusätzliche Widgets oder Infos.
Fügt einen Mountpoint vor dem Haupt-Content-Bereich ein. Nützlich für seitenweite Hinweise oder Banner.
Fügt einen Mountpoint direkt vor dem Footer ein. Beliebt für Newsletter-Boxen oder Instagram-Feeds.
Fügt einen Mountpoint vor der Footer-Fußnote ein.
Fügt einen Mountpoint nach der Footer-Fußnote ein.
Fügt einen Mountpoint direkt nach dem Footer ein. Geeignet für Bottom-Banner oder Copyright-Erweiterungen.
Fügt einen Mountpoint vor der Preisanzeige auf der Artikeldetailseite ein. Ideal für Trust-Elemente oder Garantie-Hinweise.
Fügt einen Mountpoint nach der Preisanzeige auf der Artikeldetailseite ein. Geeignet für Zusatzinfos oder Cross-Selling.
Fügt einen Mountpoint nach der Seitenpagination ein. Nützlich für zusätzliche Inhalte am Ende von Listenansichten.
## Template-Kompatibilität
**Voll kompatibel ✓**
Alle Mountpoints funktionieren out-of-the-box mit dem NOVA Template.
* Keine zusätzliche Konfiguration nötig
* Responsive Design automatisch übernommen
* Alle Positionen visuell optimal integriert
**Voll kompatibel ✓**
Das EVO Template unterstützt alle erweiterten Mountpoints.
* Automatische Integration in das Grid-System
* Mobile-First Ansatz wird beibehalten
* Styling passt sich automatisch an
**Eingeschränkt kompatibel ⚠**
Bei Custom Templates hängt die Kompatibilität vom Template-Aufbau ab.
**Was funktioniert:**
* Alle Standard-Hook-Positionen
* Container-basierte Mountpoints
**Was möglicherweise angepasst werden muss:**
* CSS-Styling für optimale Darstellung
* Responsive Breakpoints
* Z-Index bei Overlays
Teste neue Mountpoints zunächst im Staging-System, bevor du sie live schaltest.
**Voll kompatibel ✓**
Child Templates erben die Mountpoint-Unterstützung vom Parent Template.
* Kann in Child Template überschrieben werden
* Styling kann angepasst werden
* Funktionalität bleibt erhalten
## Best Practices
**Grundregel:** Aktiviere nur Mountpoints, die du wirklich nutzt
**Warum:**
* Jeder aktive Mountpoint bedeutet zusätzliche DOM-Nodes
* Kann minimale Performance-Auswirkungen haben
* Übersichtlichkeit im OPC bleibt erhalten
**Empfehlung:**
Starte mit 2-3 Mountpoints und erweitere nach Bedarf
**Bei der Platzierung bedenken:**
* Wie sieht der Mountpoint auf mobilen Geräten aus?
* Ist der Inhalt auch mobil sinnvoll?
* Beeinträchtigt es die User Experience?
**Testing:**
* Teste auf echten Mobilgeräten
* Prüfe verschiedene Bildschirmgrößen
* Achte auf Touch-Bedienbarkeit
Nutze im OPC die mobile Vorschau, um Inhalte zu optimieren.
**Kritische Bereiche:**
* Header-Mountpoints: Können above-the-fold Performance beeinflussen
* Sidebar-Mountpoints: Bei vielen Elementen CPU-intensive
* Checkout-Mountpoints: Sollten leichtgewichtig sein
**Optimierung:**
* Bilder lazy loaden
* Scripts asynchron laden
* CSS inline für critical content
* Minimale DOM-Struktur verwenden
**Design-Prinzipien:**
* Halte das Design konsistent
* Verwende Shop-Farben und -Fonts
* Achte auf einheitliche Abstände
* Befolge das Grid-System des Templates
**Content-Strategie:**
* Klare Hierarchie beachten
* Nicht zu viele Call-to-Actions
* Fokus auf User Journey
## Anwendungsbeispiele
**Ziel:** Vertrauen beim Checkout steigern
**Mountpoint:** Checkout Top
**Inhalt:**
* Zahlungsarten-Icons
* SSL-Verschlüsselung Badge
* "Käuferschutz" Siegel
* "30 Tage Rückgabe" Hinweis
Aktiviere "Checkout Top" im Resources & Health Dashboard
Erstelle ein HTML-Portlet im OPC mit Trust-Elementen
Wähle "Checkout Top" als Position im OPC
Passe CSS an für optimale Darstellung
**Ziel:** Kategorieseiten visuell aufwerten
**Mountpoint:** Before Content
**Inhalt:**
* Hero-Image für Kategorie
* Kategoriebeschreibung
* Featured Products
* Filter-Shortcuts
**Vorteile:**
* Bessere SEO durch mehr Content
* Visuell ansprechender
* Höhere Conversion
**Ziel:** Alleinstellungsmerkmale kommunizieren
**Mountpoint:** Top Header
**Inhalt:**
* "Versandkostenfrei ab 50€"
* "24h Express-Versand"
* "100 Tage Rückgabe"
* "Kauf auf Rechnung"
**Design:**
* Schmal und kompakt
* Auffällige Farben
* Icons für visuelle Unterstützung
* Optional: Slider für mehrere USPs
**Ziel:** Zusatzverkäufe generieren
**Mountpoint:** After Product Details
**Inhalt:**
* "Kunden kauften auch"
* Produkt-Bundles
* Zubehör-Empfehlungen
* "Ähnliche Produkte"
**Strategie:**
* Relevante Produkte zeigen
* Attraktive Bundle-Preise
* Social Proof ("X Kunden kauften")
## Troubleshooting
**Mögliche Ursachen:**
1. Mountpoint nicht aktiviert
2. Cache nicht geleert
3. Template nicht kompatibel
4. OPC-Editor nicht neu geladen
**Lösung:**
Kontrolliere ob der Haken gesetzt und gespeichert wurde
Leere Shop-Cache und OPC-Cache
Schließe den OPC-Editor komplett und öffne ihn neu
Teste mit Standard-Template ob es funktioniert
**Diagnose:**
* Ist das Portlet korrekt zugewiesen?
* Sind Sichtbarkeits-Regeln gesetzt?
* Gibt es CSS-Konflikte?
* Ist der Inhalt vorhanden?
**Debugging:**
```css theme={null}
/* Temporär zum Testen hinzufügen */
[data-mountpoint="your-mountpoint"] {
background: red !important;
min-height: 50px !important;
display: block !important;
}
```
Nutze die Browser-Entwicklertools um zu prüfen ob der Container gerendert wird.
**Symptome:**
* Überlappende Elemente
* Falsche Breiten
* Responsive Probleme
* Z-Index Konflikte
**Fixes:**
```css theme={null}
/* Container korrekt einbinden */
.your-mountpoint-content {
width: 100%;
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
/* Responsive anpassen */
@media (max-width: 768px) {
.your-mountpoint-content {
padding: 10px;
}
}
```
## Erweiterte Konfiguration
Für fortgeschrittene Nutzer können Mountpoints auch programmatisch erweitert werden:
**Template-Datei bearbeiten:**
```php theme={null}
// In deiner Template-Datei (z.B. index.tpl)
{if $dzm_mountpoint_custom_position}
{$dzm_mountpoint_custom_position}
{/if}
```
**Im Plugin registrieren:**
```php theme={null}
// In deinem Plugin oder Child-Template
Shop::Smarty()->assign('dzm_mountpoint_custom_position',
$opc->renderMountpoint('custom_position'));
```
Dies erfordert PHP- und Smarty-Kenntnisse. Für Standard-Anwendungsfälle nutze die vordefinierten Mountpoints.
**Erfolg:** Du hast jetzt volle Kontrolle über die Platzierung deiner Inhalte im Shop. Nutze die zusätzlichen Mountpoints, um dein Shop-Design auf das nächste Level zu heben!
## Weiterführende Ressourcen
Offizielle JTL-Dokumentation zum OnPage Composer
Template-Entwicklung und -Anpassung
Eigene Portlets erstellen und anpassen
Best Practices für responsives Design
# Ressourcen und Performance
Source: https://docs.dreizack-medien.de/Resources-and-Health/Ressourcen-und-Performance
## Übersicht
Im Tab **Ressourcen und Performance** steuerst du, wie JavaScript- und CSS-Ressourcen im Shop geladen werden. Ziel ist es, unnötige Requests zu reduzieren und die Ladezeit zu optimieren – ohne manuelle Eingriffe in den Code.
## Einstellungen
Wenn aktiviert, übernimmt das Plugin die Kontrolle darüber, welche Ressourcen geladen werden. Nicht benötigte Dateien werden unterdrückt. Empfohlen für optimale Performance.
Prüft beim Laden der Seite aktiv, ob Ressourcen korrekt erreichbar sind. Hilft dabei, fehlgeschlagene Requests frühzeitig zu erkennen.
Fasst mehrere Ressourcen zu einer gebündelten Datei zusammen, um die Anzahl der HTTP-Requests zu reduzieren. Diese Funktion befindet sich noch in der Beta-Phase.
Trage hier Ressourcen ein, die vom manuellen Laden ausgeschlossen werden sollen – z. B. `splide.min.js` oder `splide.min.css`. Diese Dateien werden immer normal geladen, unabhängig von den übrigen Einstellungen.
Ressourcen, die hier eingetragen sind, werden immer geladen – auch wenn das Plugin sie als nicht benötigt einstufen würde. Nützlich für spezielle Scripts, die auf jeder Seite verfügbar sein müssen.
## Ressourcen
Die Ressourcentabelle zeigt dir alle bekannten Skript- und CSS-Dateien im Shop – inklusive ihres aktuellen Installationsstatus und ob sie vom manuellen Laden ausgeschlossen sind.
### Spalten
| Spalte | Beschreibung |
| ------------------ | ---------------------------------------------------------------------- |
| **#** | Interne Priorität / Ladereihenfolge der Ressource |
| **Ressource** | Dateiname der Ressource |
| **Status** | Zeigt an, ob die Ressource korrekt installiert oder nicht benötigt ist |
| **Ausgeschlossen** | Gibt an, ob die Ressource manuell vom Laden ausgeschlossen wurde |
### Status-Badges
* **korrekt installiert** – Die Ressource ist vorhanden und wird wie erwartet geladen.
* **nicht benötigt** – Die Ressource wird auf der aktuellen Seite nicht verwendet und kann übersprungen werden.
Klicke auf den Pfeil links einer Zeile, um weitere Details zur jeweiligen Ressource einzusehen.
# Scripts & Consent
Source: https://docs.dreizack-medien.de/Resources-and-Health/Script-und-Consent
## Übersicht
Das Feature "Scripts & Consent" vereinfacht die Integration externer Skripte wie Tracking-Codes, Social Media Feeds oder Kundenchat-Widgets in deinen Online-Shop, und das völlig codefrei. Es gewährleistet, dass solche Einbindungen stets den Datenschutzvorschriften der DSGVO entsprechen.
Mit dieser Funktion kannst du nicht nur externe Dienste leicht in deinen Shop integrieren, sondern auch CSS-Eigenschaften anpassen, um das Erscheinungsbild dieser Dienste nahtlos an dein Shop-Design anzupassen. Dieses Tool erleichtert die Personalisierung deines Shops und die Verbesserung des Kundenerlebnisses, während es gleichzeitig den Datenschutz respektiert.
## Features
Binde Skripte im Header, Footer, als Portlet oder per CSS-Selektor ein - je nach Anforderung des externen Dienstes.
Erstelle Consent-Items und binde Skripte daran - so werden externe Dienste erst nach Zustimmung geladen.
Integriere komplexe Skripte ohne Programmierkenntnisse durch intuitive Benutzeroberfläche.
Passe das Erscheinungsbild externer Dienste mit Custom CSS an dein Shop-Design an.
## Script-Einbindung
### Script erstellen
Öffne den Tab **Scripts & Consent** und klicke auf "Neues Script hinzufügen".
Vergebe einen eindeutigen, aussagekräftigen Namen für das Script, z.B. "Google Analytics" oder "Facebook Pixel".
Wähle Namen, die du auch in 6 Monaten noch verstehst. Das hilft bei der späteren Verwaltung.
Wähle die passende Position für dein Script aus den vier verfügbaren Optionen.
Füge die Code-Snippet des externen Dienstes in den schwarzen Codeblock ein.
Entscheide, ob das Script DSGVO-konform erst nach Zustimmung geladen werden soll.
Ohne gesetzten Haken wird das Script **immer** geladen - auch ohne Zustimmung!
Klicke auf "Hinzufügen", um das Script mit den gewählten Einstellungen zu speichern.
### Ausgabetypen erklärt
**Verwendung:** Scripte oder Styles, die möglichst früh aufgerufen werden sollen
**Typische Anwendungsfälle:**
* Analytics-Tracking-Codes (Google Analytics, Matomo)
* Meta-Tags für Social Media
* CSS-Dateien, die vor dem Seitenaufbau geladen werden müssen
* Font-Loader
Der Header ist **kein** Platz für sichtbare Elemente! Nutze stattdessen Footer, Portlet oder Selektor.
**Beispiel:**
```html theme={null}
```
**Verwendung:** Scripts, die am Ende der Seite geladen werden oder schwebende Widgets
**Typische Anwendungsfälle:**
* Chat-Widgets (z.B. Userlike, Zendesk)
* Marketing-Pixel (Facebook, TikTok)
* A/B-Testing-Tools
* Cookie-Banner-Scripts
* Schwebende Social Media Buttons
Der Footer ist der richtige Platz für die meisten externen Scripts, da sie die initiale Seitenladezeit nicht beeinflussen.
**Beispiel:**
```html theme={null}
```
**Verwendung:** Flexibles Einbinden für sichtbare Elemente im OnPage Composer
**Typische Anwendungsfälle:**
* Social Media Feeds (Instagram, Facebook)
* Bewertungs-Widgets (Trustpilot, ProvenExpert)
* Newsletter-Anmeldeformulare
* Countdown-Timer
* Custom Content-Bereiche
Nach dem Anlegen erscheint das Script als Portlet im OPC-Editor unter "Script Portlet". Du kannst es dann beliebig auf deinen Seiten platzieren.
**Beispiel:**
```html theme={null}
```
**Verwendung:** Dynamisches Einfügen in bestehende Template-Elemente
**Typische Anwendungsfälle:**
* Zusätzliche Buttons in bestehenden Bereichen
* Custom Badges auf Produktseiten
* Erweiterte Produktinformationen
* Dynamische Preisanzeigen
Nutze als Selektor eine **ID** (#meine-id) oder eine **Klasse** (.meine-klasse). Der Code wird in dieses Element injiziert.
**Beispiel für Selektor:**
```css theme={null}
#product-actions
```
**Beispiel-Code:**
```html theme={null}
```
## Script-Einstellungen
### Grundeinstellungen
Vergebe hier einen eindeutigen Namen für das Script, z.B. "Google Analytics Tracking" oder "Facebook Pixel".
Wähle den Ausgabetyp:
* **Header** - Für früh zu ladende Scripts/Styles
* **Footer** - Für die meisten Scripts und schwebende Widgets
* **Portlet** - Für flexible Platzierung im OPC
* **Selektor** - Für dynamisches Einfügen in Template-Elemente
Nur bei Ausgabetyp "Selektor": CSS-Selektor als ID (#meine-id) oder Klasse (.meine-klasse)
Füge hier das Script oder CSS-Stylesheet ein. Unterstützt HTML, JavaScript und CSS.
### Vorhandene Scripts
Alle angelegten Scripts werden in der Tabelle unterhalb des Formulars aufgelistet. Die Tabelle zeigt auf einen Blick die wichtigsten Informationen zu jedem Script:
Der vergebene Name des Scripts.
Eindeutige ID des Scripts, wird automatisch aus dem Namen generiert.
Der gewählte Ausgabetyp (z.B. Header, Footer, Portlet).
Der CSS-Selektor, sofern der Ausgabetyp "Selektor" gewählt wurde.
Das verknüpfte Consent-Item. Ein Strich (–) bedeutet, das Script wird ohne Consent-Bindung geladen.
Über die Icons am Ende jeder Zeile kannst du ein Script **bearbeiten** oder **löschen**. Per Klick auf den Pfeil links öffnet sich die aufgeklappte Detailansicht mit dem hinterlegten Code.
## Consent Item bearbeiten
Jedes Feld bietet zwei Eingabemöglichkeiten: einen **direkten Textwert** (links) und eine **Sprachvariable** (rechts). Du kannst beides kombinieren – wird eine Sprachvariable angegeben, hat sie Vorrang.
Sprachvariablen sind besonders praktisch für mehrsprachige Shops. Lege sie unter **Sprachvariablen** im Resources & Health Dashboard mit der Sektion "custom" an.
Setzt alle Felder des Formulars auf ihre Ausgangswerte zurück.
Name des Consent-Items, z.B. "Google Analytics". Alternativ eine Sprachvariable im rechten Feld eintragen.
Beschreibt, was der Dienst macht – wird dem Nutzer im Consent-Banner angezeigt. Alternativ Sprachvariable verwenden.
Zweck der Datenerhebung, z.B. "Analyse des Nutzerverhaltens". Alternativ Sprachvariable verwenden.
Link zur Datenschutzerklärung des Dienstes (optional). Alternativ Sprachvariable verwenden.
Name des datenverarbeitenden Unternehmens, z.B. "Google Ireland Limited, Dublin, Irland".
Speichert das Consent-Item. Es steht anschließend in der Dropdown-Liste bei der Script-Konfiguration zur Verfügung.
## Verwaltung
### Consent-Item-Verwaltung
Hier findest du eine Übersicht zu allen angelegten Consent-Items:
* **Name und Details:** Alle wichtigen Informationen auf einen Blick
* **Gebundene Scripts:** Anzahl der Scripts, die an dieses Item gebunden sind
* **Bearbeiten:** Klicke auf ein Item, um dessen Einstellungen anzupassen
* **Löschen:** Hake Items an und klicke auf den gelben Button zum Entfernen
**Achtung beim Löschen!**
Wenn du ein Consent-Item löschst, das an Scripts gebunden ist, werden diese Scripts automatisch ohne Consent-Abhängigkeit geladen. Prüfe vorher die Anzahl der gebundenen Scripts!
## Best Practices
**Grundregeln:**
* Alle Marketing- und Tracking-Scripts MÜSSEN an Consent-Items gebunden sein
* Erstelle aussagekräftige Consent-Beschreibungen in einfacher Sprache
* Verlinke immer auf die Datenschutzerklärung des Dienstes
* Gib das verarbeitende Unternehmen vollständig an
**Scripts ohne Consent:**
Nur technisch notwendige Scripts (z.B. Shop-Funktionalität) dürfen ohne Consent geladen werden.
**Header sparsam nutzen:**
Nur kritische Scripts in den Header, da sie die Ladezeit beeinflussen
**Async/Defer verwenden:**
```html theme={null}
```
**Footer bevorzugen:**
Die meisten Scripts funktionieren auch im Footer und verbessern so die Performance
**Klare Namen verwenden:**
"Google Analytics 4 - Tracking" statt "Script 1"
**Kommentare hinzufügen:**
```html theme={null}
```
**Änderungen dokumentieren:**
Notiere wichtige Änderungen als Kommentar im Code
**Checklist:**
* [ ] Script lädt korrekt im gewählten Bereich
* [ ] Consent-Bindung funktioniert (Script wird erst nach Zustimmung geladen)
* [ ] Keine Fehler in der Browser-Konsole
* [ ] Funktionalität des Scripts ist gegeben
* [ ] Mobile Ansicht geprüft
* [ ] Performance-Impact akzeptabel
## Häufige Anwendungsfälle
**Ausgabetyp:** Header\
**Consent:** Marketing/Analytics
```html theme={null}
```
**Ausgabetyp:** Header\
**Consent:** Marketing
```html theme={null}
```
**Ausgabetyp:** Portlet\
**Consent:** Nicht erforderlich (zeigt nur Bewertungen)
```html theme={null}
```
**Ausgabetyp:** Footer\
**Consent:** Funktional (optional, je nach Datenschutzstrategie)
```html theme={null}
```
## Fehlerbehebung
**Mögliche Ursachen:**
* Consent wurde noch nicht erteilt (prüfe Consent-Bindung)
* JavaScript-Fehler blockiert Ausführung (Browser-Konsole prüfen)
* Falscher Ausgabetyp gewählt
* Script-URL ist nicht erreichbar
**Lösung:**
1. Öffne die Browser-Konsole (F12)
2. Prüfe auf Fehlermeldungen
3. Teste ohne Consent-Bindung
4. Prüfe, ob die externe URL erreichbar ist
**Typische Probleme:**
* Abhängigkeiten fehlen (z.B. jQuery wird benötigt)
* Script lädt zu früh/spät (Ausgabetyp ändern)
* Konflikte mit anderen Scripts
* Falsche Konfiguration im Script-Code
**Lösung:**
1. Prüfe die Dokumentation des externen Dienstes
2. Teste verschiedene Ausgabetypen (Header vs. Footer)
3. Lade benötigte Bibliotheken zuerst
4. Prüfe die Browser-Konsole auf Fehler
**Prüfe:**
* Wurde das Consent-Item gespeichert?
* Ist es an ein Script gebunden?
* Cache geleert?
* Consent Manager aktiv im Template?
**Lösung:**
1. Leere den Shop-Cache
2. Prüfe unter "Consent-Item-Verwaltung" die Übersicht
3. Stelle sicher, dass der JTL Consent Manager aktiviert ist
**Häufige Ursachen:**
* Plugin-Cache nicht geleert
* OPC-Cache aktiv
* Falscher Ausgabetyp
**Lösung:**
1. Leere den Plugin-Cache
2. Leere den OPC-Cache
3. Öffne den OPC-Editor neu
4. Suche nach "Script Portlet" in der Portlet-Liste
**Pro-Tipp:** Erstelle eine Testseite in deinem Shop, auf der du neue Scripts erst testest, bevor du sie live schaltest. So vermeidest du Fehler auf produktiven Seiten.
# Shopstruktur
Source: https://docs.dreizack-medien.de/Resources-and-Health/Shopstruktur-und-systeminfo
## Übersicht
In diesem Tab kannst du dir alle verwaisten Kindartikel (=Artikel ohne Vater) anzeigen und als CSV-Datei ausgeben lassen. Hintergrund dafür ist, dass verwaiste Kindartikel den Export des Google Feeds blockieren und ohne dieses Tool sehr schwer zu identifizieren sind. Mit diesem Tool erhältst du eine schnelle Übersicht und kannst die entsprechenden Artikel in der Wawi anpassen.
Außerdem findest du hier alle Infos zu deinem PHP-Setup.
## Features
Identifiziere alle Kindartikel ohne zugeordneten Vaterartikel, die Probleme beim Google Feed Export verursachen können.
Exportiere die Liste der verwaisten Kindartikel als CSV-Datei zur weiteren Bearbeitung oder Dokumentation.
Vollständige Übersicht über dein PHP-Setup direkt im Backend - keine FTP-Zugriff oder phpinfo()-Datei nötig.
Behebe Google Feed Probleme schnell und effizient durch gezielte Identifikation problematischer Artikel.
## Warum sind verwaiste Kindartikel problematisch?
**Google Feed blockiert?**
Verwaiste Kindartikel (Varianten ohne Vaterartikel) können den Export des Google Shopping Feeds blockieren. Google erwartet, dass Varianten immer einem Hauptartikel zugeordnet sind.
Typische Szenarien für verwaiste Kindartikel:
* Vaterartikel wurde in der Wawi gelöscht, Kindartikel blieben erhalten
* Fehlerhafte Datenimporte
* Manuelle Datenbankoperationen
* Probleme bei der Synchronisation zwischen Wawi und Shop
## Verwaiste Kindartikel verwalten
Öffne den Tab **Shopstruktur und Systeminfo** im Resources & Health Dashboard.
Klicke auf den Button, um die Liste aller verwaisten Kindartikel anzuzeigen.
Die Anzeige erfolgt übersichtlich mit allen wichtigen Artikelinformationen wie Artikel-ID, Name und SKU.
Nutze die Export-Funktion, um die Liste als CSV-Datei herunterzuladen.
Der CSV-Export ist besonders praktisch, wenn du die Liste mit deinem Team teilen oder in der Wawi systematisch abarbeiten möchtest.
Öffne die betroffenen Artikel in der JTL-Wawi und ordne sie einem passenden Vaterartikel zu oder lösche sie.
Führe einen vollständigen Abgleich zwischen Wawi und Shop durch, um die Änderungen zu übernehmen.
## PHP-Informationen einsehen
Die PHP-Informationen geben dir einen vollständigen Überblick über:
* **PHP-Version:** Welche PHP-Version auf deinem Server läuft
* **Geladene Extensions:** Alle aktiven PHP-Module
* **Konfiguration:** PHP.ini Einstellungen
* **Umgebungsvariablen:** Server- und Systeminformationen
* **Performance-Settings:** Memory Limit, Max Execution Time, etc.
Diese Informationen sind besonders hilfreich bei der Fehlersuche oder wenn du mit dem Support kommunizierst.
**Typische Anwendungsfälle:**
1. **Support-Anfragen:** Teile relevante PHP-Infos mit dem Support-Team
2. **Plugin-Kompatibilität:** Prüfe, ob alle erforderlichen PHP-Extensions geladen sind
3. **Performance-Optimierung:** Analysiere Memory Limits und Ausführungszeiten
4. **Server-Umzug:** Vergleiche PHP-Konfigurationen zwischen Servern
Du kannst die PHP-Info-Seite direkt im Browser aufrufen und bei Bedarf als PDF speichern.
Diese PHP-Einstellungen sind für JTL-Shop besonders wichtig:
| Einstellung | Empfohlen | Beschreibung |
| --------------------- | --------- | ------------------------------- |
| `memory_limit` | 256M+ | Arbeitsspeicher pro PHP-Prozess |
| `max_execution_time` | 300+ | Maximale Skript-Laufzeit |
| `upload_max_filesize` | 64M+ | Maximale Upload-Größe |
| `post_max_size` | 64M+ | Maximale POST-Größe |
| `max_input_vars` | 10000+ | Maximale Anzahl Input-Variablen |
Bei Abweichungen von den empfohlenen Werten kontaktiere deinen Hoster oder Server-Administrator.
## Best Practices
Prüfe regelmäßig (z.B. monatlich) auf verwaiste Kindartikel, besonders nach:
* Größeren Änderungen im Artikelstamm
* Datenimporten
* Umfangreichen Löschaktionen in der Wawi
Führe vor jedem wichtigen Google Shopping Feed Export eine Überprüfung durch, um Probleme zu vermeiden.
Nutze den CSV-Export zur Dokumentation deiner Bereinigungsaktionen. So kannst du nachvollziehen, welche Artikel du wann korrigiert hast.
Überprüfe regelmäßig deine PHP-Version und plane Updates ein. Ältere PHP-Versionen sind nicht nur langsamer, sondern auch ein Sicherheitsrisiko.
**Tipp:** Kombiniere die Shopstruktur-Prüfung mit einer regelmäßigen Wartungsroutine für deinen Shop. So bleiben Datenbankstruktur und Feed-Exporte immer optimal.
# Sprachvariablen
Source: https://docs.dreizack-medien.de/Resources-and-Health/Sprachvariablen
## Übersicht
In diesem Tab kannst du alle Sprachvariablen zentral an einem Ort verwalten. Sprachvariablen sind Platzhalter für Texte, die anpassbar sind und entweder von JTL oder von uns (wenn es um Plugins geht) vorkonfiguriert wurden. Dazu gehören beispielsweise Texte für Buttons, Hinweise oder Fehlermeldungen. Diese Sprachvariablen lassen sich in verschiedenen Sprachen anpassen. Außerdem kannst du hier neue Sprachvariablen anlegen und den Inhalt nach Belieben anpassen.
**Was sind Sprachvariablen?**
Sprachvariablen (auch Language Variables oder Lang Vars) sind Platzhalter im Code, die zur Laufzeit durch tatsächliche Texte ersetzt werden. Der Vorteil: Texte können einfach angepasst und in mehreren Sprachen gepflegt werden, ohne den Code zu ändern.
## Features
Verwalte alle Sprachvariablen (sowohl aus Plugins als auch alle JTL-Sprachvariablen) zentral an einem Ort.
Exportiere und importiere Sprachvariablen als JSON - ideal für Backups und Massenbearbeitung.
Erstelle eigene Sprachvariablen schnell und einfach über das Tool.
Verwalte alle Sprachen deines Shops gleichzeitig - perfekt für internationale Shops.
## Plugin-Sprachvariablen
Hier findest du alle Sprachvariablen, die aus Plugins kommen - sowohl von DZM als auch von anderen Plugin-Entwicklern.
### Interface-Bedienung
Wähle die Sprache der Sprachvariablen, die du bearbeiten möchtest.
**Verfügbare Sprachen:**
* Deutsch (Standard)
* Englisch
* Weitere Sprachen (abhängig von deiner Wawi-Konfiguration)
Die verfügbaren Sprachen werden in der JTL-Wawi definiert und dann in den Shop übertragen. Neue Sprachen müssen zuerst in der Wawi aktiviert werden.
**Workflow für mehrsprachige Shops:**
Beginne immer mit der Hauptsprache (meist Deutsch) und pflege alle Texte.
Wechsle dann zur zweiten Sprache und übersetze/passe die Texte an.
Stelle sicher, dass alle Sprachen vollständig gepflegt sind.
Durchsuche Sprachvariablen nach Namen, Werten, Standardwerten oder Beschreibungen.
**Suchstrategien:**
* Nach Variablen-Namen: `btn_submit`
* Nach Inhalt: "Jetzt kaufen"
* Nach Plugin: `dzm_`
* Nach Funktion: "error", "success", "button"
Die Suche ist case-insensitive und durchsucht alle Felder gleichzeitig. Du musst nicht wissen, ob ein Text im Namen oder Wert steht.
**Beispiel-Suchen:**
```
"in den warenkorb" → Findet alle Warenkorb-Buttons
"dzm_resources" → Findet alle Resources-Plugin-Variablen
"error" → Findet alle Fehlermeldungen
```
**Sprachvariablen ändern:**
Nutze die Suche oder scrolle durch die Liste.
Klicke in das Textfeld unter "Wert" und ändere den Text.
Der "Standardwert" zeigt dir den Original-Text - ändere nur den "Wert", nicht den Standard!
Klicke auf "Speichern" um alle Änderungen zu übernehmen.
Änderungen werden erst nach dem Speichern übernommen!
Leere den Shop-Cache damit die Änderungen im Frontend sichtbar werden.
**Weg:** Backend → System → Cache → Cache leeren
**Formatierung beachten:**
* HTML ist erlaubt: `Text`
* Platzhalter erhalten: `{0}`, `{1}`, etc.
* Sonderzeichen escapen wenn nötig
**Alle Werte zurücksetzen**
Setzt alle Sprachvariablen auf ihre Standardwerte zurück.
**ACHTUNG:** Diese Aktion ist nicht rückgängig zu machen! Exportiere vorher ein Backup.
**Speichern**
Speichert alle vorgenommenen Änderungen in der Datenbank.
**Exportieren**
Exportiert alle Plugin-Sprachvariablen der aktuellen Sprache als JSON-Datei.
Perfekt für Backups vor größeren Änderungen oder zum Übertragen auf andere Shops.
**Select Files (Import)**
Importiert eine zuvor exportierte JSON-Datei mit Sprachvariablen.
Bestehende Werte werden überschrieben - sichere vorher den aktuellen Stand!
### Wichtiger Hinweis zum Cache
**Sprachvariablen-Änderungen nicht sichtbar?**
Manchmal werden Änderungen der Sprachvariablen im Frontend nicht sofort sichtbar, da diese noch im Shop-Cache hängen.
**Lösung:** Leere deinen Shop-Cache im Backend unter **System → Cache → Cache leeren**.
## Shop Sprachvariablen
Hier findest du alle Sprachvariablen, die aus dem JTL-Shop Core kommen - also alle Standard-Texte des Shops.
### Funktionsweise
Die Bedienung ist identisch zu den Plugin-Sprachvariablen:
Wähle die zu bearbeitende Sprache aus dem Dropdown.
**Tipp:** Bearbeite zuerst die Hauptsprache komplett, bevor du zu anderen Sprachen wechselst.
Nutze die Suchfunktion um spezifische Variablen zu finden.
**Häufige Suchbegriffe:**
* "add to cart" → Warenkorb-Buttons
* "checkout" → Checkout-Prozess-Texte
* "shipping" → Versand-bezogene Texte
* "error" → Fehlermeldungen
* "success" → Erfolgsmeldungen
Ändere Werte und klicke auf "Speichern".
JTL-Sprachvariablen beeinflussen das Core-Verhalten des Shops. Sei vorsichtig bei Änderungen!
Exportiere für Backups oder zum Übertragen auf andere Shops.
Für vollständige Backups: Exportiere sowohl Plugin- als auch JTL-Sprachvariablen!
### Best Practices für JTL-Variablen
**Unbedenklich:**
* Button-Beschriftungen anpassen
* Hinweistexte optimieren
* Fehlermeldungen kundiger formulieren
* Marketing-Texte personalisieren
**Beispiele:**
```
"In den Warenkorb" → "Jetzt kaufen"
"Zur Kasse" → "Zur sicheren Kasse"
"Weiter einkaufen" → "Weiterstöbern"
```
**Kritische Texte:**
* Rechtliche Hinweise (Widerruf, AGB, etc.)
* System-Meldungen
* Variablen mit Platzhaltern
* Technical Labels
Änderungen an rechtlichen Texten sollten immer mit einem Anwalt abgestimmt werden!
**Platzhalter erhalten:**
```
❌ Falsch: "Hallo Max" (hart codiert)
✅ Richtig: "Hallo {0}" (Platzhalter bleibt)
```
**Shop-Updates beachten:**
Nach JTL-Shop Updates können:
* Neue Sprachvariablen hinzukommen
* Bestehende Variablen geändert werden
* Alte Variablen entfernt werden
**Vorgehen:**
1. Vor Update: Sprachvariablen exportieren
2. Update durchführen
3. Eigene Anpassungen prüfen
4. Bei Bedarf neu anpassen
Führe ein Log über alle geänderten Sprachvariablen, um nach Updates schnell wieder den gewünschten Zustand herzustellen.
## Neue Sprachvariablen anlegen
Erstelle eigene Sprachvariablen für Custom-Entwicklungen oder individuelle Texte.
### Schritt für Schritt
Vergebe einen eindeutigen Namen für die Sprachvariable.
**Naming Conventions:**
* Kleinbuchstaben verwenden
* Wörter mit Unterstrichen trennen
* Aussagekräftig benennen
* Präfix nutzen (z.B. `custom_`, `dzm_`)
**Beispiele:**
```
✅ dzm_custom_banner_text
✅ custom_checkout_note
✅ my_shop_welcome_message
❌ Banner1 (nicht aussagekräftig)
❌ CUSTOM TEXT (Leerzeichen, Großbuchstaben)
❌ customBannerText (CamelCase vermeiden)
```
Wähle eine Sektion zur Gruppierung und schnelleren Auffindbarkeit.
**Verfügbare Sektionen:**
* **custom** (empfohlen für eigene Variablen)
* global
* checkout
* product
* account
* ... (weitere system-spezifische Sektionen)
In der Regel ist "custom" die richtige Wahl für neue benutzerdefinierte Sprachvariablen.
Trage den Text in allen verfügbaren Sprachen ein.
**Deutsch:** Hauptsprache, sollte immer gepflegt werden
**Englisch:** Fallback für internationale Kunden
**Weitere Sprachen:** Je nach Shop-Konfiguration
Wenn du eine Sprache nicht ausfüllst, bleibt das Feld leer oder zeigt den Variablen-Namen an.
Klicke auf "Variable hinzufügen", um die neue Sprachvariable zu speichern.
Die Variable ist ab sofort in Templates, Plugins und Scripts verwendbar!
### Verwendung in Templates
Nach dem Anlegen kannst du die Variable in Smarty-Templates verwenden:
```smarty theme={null}
{* In .tpl Dateien *}
{lang key="dzm_custom_banner_text" section="custom"}
{* Mit Fallback *}
{lang key="dzm_custom_banner_text" section="custom" default="Fallback Text"}
{* Mit Platzhaltern *}
{lang key="dzm_welcome_user" section="custom" printf=$userName}
```
### Verwendung in PHP
In PHP-Code kannst du Sprachvariablen so nutzen:
```php theme={null}
// Einfache Verwendung
$text = Shop::Lang()->get('dzm_custom_banner_text', 'custom');
// Mit Platzhaltern
$text = Shop::Lang()->get('dzm_welcome_user', 'custom');
$text = sprintf($text, $userName);
// In der aktuellen Sprache
$currentLang = Shop::getLanguageID();
$text = Shop::Lang()->get('dzm_custom_banner_text', 'custom', $currentLang);
```
## Export & Import
### Backup erstellen
Gehe zum Tab "Plugin Sprachvariablen" → Klicke "Exportieren"
**Dateiname:** `plugin_langvars_de_2024-02-06.json`
Gehe zum Tab "JTL-Sprachvariablen" → Klicke "Exportieren"
**Dateiname:** `jtl_langvars_de_2024-02-06.json`
Wiederhole für jede aktive Sprache (EN, FR, etc.)
Speichere alle JSON-Dateien an einem sicheren Ort:
* Cloud-Speicher (Dropbox, Google Drive)
* Lokale Backup-Festplatte
* Versionskontrolle (Git)
**Vollständiges Backup:**
Wenn du alle Sprachvariablen als Backup sichern möchtest, achte unbedingt darauf **sowohl** die Plugin-Sprachvariablen **als auch** die JTL-Sprachvariablen zu exportieren!
### Import durchführen
Stelle sicher, dass du die richtige JSON-Datei hast:
* Richtige Sprache?
* Richtiger Tab (Plugin vs. JTL)?
* Aktuelles Backup?
Klicke auf "Select Files" und wähle die JSON-Datei aus.
Bestätige, dass bestehende Werte überschrieben werden sollen.
Der Import überschreibt alle Werte in der JSON-Datei - aktuelle Änderungen gehen verloren!
Prüfe stichprobenartig ob der Import erfolgreich war.
Leere anschließend den Cache.
### JSON-Datei-Struktur
Für Massenbearbeitung kannst du die JSON-Datei manuell bearbeiten:
```json theme={null}
{
"dzm_custom_banner_text": {
"name": "dzm_custom_banner_text",
"section": "custom",
"value": "Willkommen in unserem Shop!",
"default": "Welcome to our shop!",
"description": "Banner text on homepage"
},
"dzm_another_variable": {
...
}
}
```
Nutze einen JSON-Editor oder VS Code mit JSON-Plugin für komfortables Bearbeiten großer Dateien.
## Best Practices
**Naming Convention festlegen:**
```
[prefix]_[bereich]_[funktion]_[typ]
Beispiele:
custom_checkout_button_continue
custom_product_label_sale
custom_error_msg_invalid_email
dzm_banner_text_homepage
```
**Vorteile:**
* Schnelles Auffinden
* Klare Zuordnung
* Keine Konflikte
* Team-freundlich
**Externe Dokumentation führen:**
Erstelle eine Tabelle mit allen Custom-Variablen:
| Variable | Verwendung | Geändert am | Geändert von |
| ---------------------- | ---------------- | ----------- | ------------ |
| custom\_banner\_text | Homepage Banner | 2024-02-06 | Max M. |
| custom\_checkout\_note | Checkout Hinweis | 2024-01-15 | Lisa S. |
**Oder nutze Kommentare im Code:**
```smarty theme={null}
{* Custom Variable für Sommer-Aktion 2024
Angelegt: 2024-02-06
Kontakt: marketing@firma.de *}
{lang key="custom_summer_banner" section="custom"}
```
**Backup-Routine etablieren:**
**Vor wichtigen Änderungen:**
* Immer ein Backup erstellen
* Datiert und versioniert speichern
* An sicheren Ort ablegen
**Regelmäßig (monatlich):**
* Vollständiger Export aller Sprachen
* Beide Tabs (Plugin + JTL)
* Zusammen mit anderen Shop-Backups speichern
**Nach großen Anpassungen:**
* Sofort neues Backup
* Mit Changelog dokumentieren
* Team informieren
**Änderungen immer testen:**
Teste Änderungen zuerst auf Test-/Staging-System
Stelle sicher dass alle Sprachen korrekt sind
Prüfe alle Stellen wo die Variable verwendet wird
Teste auch auf mobilen Geräten
Prüfe nach Live-Schaltung nochmal alle Stellen
## Häufige Anwendungsfälle
**Saisonale Anpassungen:**
```
custom_banner_winter_sale
→ "❄️ Winter-Sale: Bis zu 50% Rabatt!"
custom_banner_summer_sale
→ "☀️ Sommer-Aktion: Jetzt zugreifen!"
```
**A/B-Testing:**
* Teste verschiedene Button-Texte
* Optimiere Call-to-Actions
* Verbessere Conversion
**Vorteil:** Schnelles Ändern ohne Code-Deployment
**Personalisierte Ansprache:**
```
custom_greeting_registered
→ "Willkommen zurück, {0}!"
custom_greeting_guest
→ "Herzlich willkommen! Schön, dass Sie da sind."
```
**Service-Hinweise:**
```
custom_shipping_info
→ "Versandkostenfrei ab 50€"
custom_return_policy
→ "100 Tage Rückgaberecht"
```
**Professionelle Übersetzungen:**
```
DE: "In den Warenkorb legen"
EN: "Add to cart"
FR: "Ajouter au panier"
ES: "Añadir al carrito"
```
**Lokalisierung:**
```
DE: "Versandkosten: 4,99 €"
EN: "Shipping: £4.99"
FR: "Frais de port: 4,99 €"
```
Nutze professionelle Übersetzer für wichtige Texte - maschinelle Übersetzungen reichen oft nicht aus!
**Custom Template Texte:**
```smarty theme={null}
{* Im Template *}
```
**Vorteil:**
* Texte zentral änderbar
* Mehrsprachig ohne Template-Änderung
* Wartungsfreundlich
## Troubleshooting
**Problem:** Sprachvariablen-Änderungen erscheinen nicht im Frontend
**Lösung:**
Backend → System → Cache → Cache leeren
Im Browser: Strg + Shift + R (Windows) oder Cmd + Shift + R (Mac)
Lösche Template-Cache im Dateisystem: `/templates_c/` Ordner leeren
Leere Browser-Cache oder teste im Incognito-Modus
**Symptom:** Variable zeigt Schlüssel statt Text: `custom_my_variable`
**Ursachen:**
1. Variable wurde nicht gespeichert
2. Falsche Sektion angegeben
3. Schreibfehler im Variablen-Namen
4. Cache-Problem
**Überprüfen:**
```smarty theme={null}
{* Mit Fallback testen *}
{lang key="custom_my_variable" section="custom" default="Fallback Text"}
{* Wenn Fallback erscheint → Variable existiert nicht *}
{* Wenn Variablen-Name erscheint → Cache Problem *}
```
**Mögliche Fehler:**
* Falsche Dateiformat (muss JSON sein)
* Korrupte JSON-Struktur
* Falsche Sprache gewählt
* Datei zu groß
**Debugging:**
1. JSON-Datei in Validator prüfen: jsonlint.com
2. Datei in Text-Editor öffnen und Struktur prüfen
3. Kleinere Test-Datei versuchen
4. Browser-Console auf Fehler prüfen
**JSON validieren:**
```bash theme={null}
# Mit Node.js
node -e "JSON.parse(require('fs').readFileSync('file.json', 'utf8'))"
```
**Problem:** `{0}`, `{1}` werden nicht ersetzt
**In Smarty:**
```smarty theme={null}
{* Falsch *}
{lang key="welcome_user" section="custom"}
{* Richtig *}
{lang key="welcome_user" section="custom" printf=$userName}
{* Mehrere Platzhalter *}
{lang key="order_confirmation" section="custom"
printf=$orderNumber|cat:"|":$orderDate}
```
**In PHP:**
```php theme={null}
// Falsch
$text = Shop::Lang()->get('welcome_user', 'custom');
// Richtig
$text = Shop::Lang()->get('welcome_user', 'custom');
$text = sprintf($text, $userName);
```
## Erweiterte Tipps
**Zu viele Variablen vermeiden:**
* Gruppiere ähnliche Texte
* Nutze Platzhalter statt separate Variablen
* Lösche ungenutzte Custom-Variablen
**Cache-Strategie:**
* Ändere Sprachvariablen in Batches
* Leere Cache nur einmal am Ende
* Plane Änderungen für wartungsarme Zeiten
**Meta-Texte als Sprachvariablen:**
```
custom_meta_title_home
custom_meta_description_home
custom_meta_keywords_category
```
**Vorteile:**
* Schnelle A/B-Tests
* Einfache Mehrsprachigkeit
* Zentrale Verwaltung
**Aber beachte:** Individuelle Produkt-/Kategorie-Texte sollten besser in den Stammdaten gepflegt werden!
**Versionskontrolle für Variablen:**
1. Exportiere regelmäßig als JSON
2. Commite in Git-Repository
3. Tracke Änderungen über Git
4. Deploy mit CI/CD-Pipeline
**Git-Workflow:**
```bash theme={null}
# Export
php -r "/* Export-Script */" > langvars.json
# Commit
git add langvars.json
git commit -m "Update language variables"
# Deploy
git push origin main
```
**Erfolg!** Du hast jetzt volle Kontrolle über alle Texte in deinem Shop. Nutze Sprachvariablen für professionelle, wartungsfreundliche und mehrsprachige Shop-Texte.
## Weiterführende Ressourcen
Offizielle Smarty-Dokumentation für Template-Entwicklung
JTL-Shop Guide für Entwickler und Template-Designer
W3C Internationalisierung Best Practices
Online Tool zum Validieren von JSON-Dateien
# Analyse [ALPHA]
Source: https://docs.dreizack-medien.de/Resources-and-Health/analyse
## Übersicht
**Du bist gefragt!**
Hier entsteht ein Analysedashboard. Der dargestellte Bericht dient vorerst nur Testzwecken und wird in kommenden Versionen erweitert. Wenn du Wünsche und Ideen für Analysen hast, lass sie uns gerne zukommen.
## Features
Anonymisiertes Tracking direkt in deiner Datenbank – ohne externe Dienste.
Markiere Zeitpunkte in den Statistiken, um Ereignisse im Dashboard nachzuvollziehen.
Schnelle Übersicht über Kategorietiefe und Produktdaten-Qualität.
Besucher, Conversions, Conversionrate und durchschnittlicher Warenkorbwert im Zeitverlauf.
## Internes Tracking
### Internes Tracking aktivieren
Aktiviert das interne Tracking-Script. Alle Daten bleiben lokal in deiner Datenbank und werden anonymisiert gespeichert. Aktuell sammelt das Script Daten, aus denen wir bald Auswertungen für dich erstellen. Ziel ist es, dass du wiederkehrende Besucher, Conversions und Potenziale besser verstehen und erkennen kannst.
Erfasst werden: Besucher, Seitenaufrufe und E-Commerce Events. Alles wird in deiner Datenbank gespeichert.
Aktiviere den Toggle und klicke auf **Speichern**, um das interne Tracking zu starten.
## Marker
Nutze die Marker, um Zeitpunkte in den Statistiken auf dem Dashboard zu markieren – zum Beispiel für Kampagnenstarts, Updates oder andere relevante Ereignisse.
### Neuen Marker anlegen
Trage einen **Titel** ein, wähle ein **Datum** und klicke auf **Hinzufügen**, um den Marker zu setzen.
### Marker entfernen
Wähle einen vorhandenen Marker aus dem Dropdown aus und klicke auf **Entfernen**.
## Bericht
### Analyse laden
Klicke auf **Bericht laden / aktualisieren**, um den Analysebericht manuell zu laden oder auf den neuesten Stand zu bringen. Dies ist insbesondere dann nötig, wenn der Shop-Cache inaktiv ist oder du frische Daten abrufen möchtest.
## Shopstruktur-Analyse
Schneller Überblick über die Struktur und Datenqualität deines Shops.
### Kategorietiefe
Zeigt die Verschachtelungstiefe deiner Kategorien an. Eine zu hohe Tiefe kann die Navigation und SEO beeinträchtigen.
### Anzahl Produkte
Die Gesamtzahl der Produkte im Shop.
### davon ohne GTIN/EAN
Produkte ohne hinterlegte GTIN- oder EAN-Nummer. Fehlende GTINs können die Sichtbarkeit in Preisvergleichsportalen und Google Shopping einschränken.
### davon ohne Kurzbeschreibung
Produkte ohne Kurzbeschreibung. Eine Kurzbeschreibung verbessert die Lesbarkeit auf Kategorie- und Suchergebnisseiten.
### davon ohne Beschreibungstext
Produkte ohne ausführlichen Beschreibungstext. Vollständige Beschreibungen sind wichtig für SEO und Kaufentscheidungen.
## Sales Performance
Übersicht über die wichtigsten Verkaufskennzahlen im Zeitverlauf.
### Tabelle
Zeigt tagesweise die Werte für Besucher, Conversions, Warenkorbanzahl und Conversionrate.
### Diagramm
Das Salesperformance-Diagramm visualisiert die folgenden Kennzahlen im Verlauf:
* **Besucher** – Anzahl der Besucher im Zeitraum
* **Conversions** – Abgeschlossene Käufe
* **Conversionrate** – Anteil der Besucher, die einen Kauf abgeschlossen haben
* **Avg Cartvalue** – Durchschnittlicher Warenkorbwert
# Backups
Source: https://docs.dreizack-medien.de/Resources-and-Health/backups
## Übersicht
Hier kannst du komplette oder partielle Backups deines Shops erstellen und auch wieder entpacken. Außerdem kannst du generell ZIP-Archive entpacken, z.B. für Shop-Updates.
**Kein professionelles Backup!** Das Tool erstellt kein professionelles Backup. Wir übernehmen keinen Support und keine Haftung für möglichen Datenverlust. Du verwendest dieses Tool auf eigene Verantwortung. Es dient lediglich als Hilfe für erfahrene Benutzer.
## Features
Wähle gezielt einzelne Ordner für dein Backup aus – kein vollständiges System-Backup nötig.
Vergib einen eigenen Namen und Pfad für dein Backup-Archiv.
Entpacke ZIP-Archive direkt aus dem Shop Root – ideal für Shop-Updates und Plugin-Installationen.
Bestimme selbst, in welches Verzeichnis das ZIP entpackt werden soll.
## Backup erstellen
Wähle hier die Ordner aus, die du in dein Backup einschließen möchtest. Die aufgelisteten Ordner entsprechen den lesbaren Ordnern aus deinem Shop Root Verzeichnis. Der letzte Eintrag `root` entspricht allen Files, die sich innerhalb des Root Verzeichnisses befinden.
Vor der Erstellung des Backups wird eine Lese- und Schreib-Rechte-Prüfung durchgeführt. Das Backup wird nur erstellt, wenn alle enthaltenen Files gelesen und beschrieben werden dürfen.
### Ordner auswählen
Aktiviere oder deaktiviere die Toggles für jeden Ordner. Mit **Alle abwählen** kannst du alle Ordner auf einmal deaktivieren, wenn du nur Teile sichern willst.
| Ordner | Inhalt |
| ------------- | ------------------------------------ |
| `admin` | Backend-Dateien des JTL-Shops |
| `archive` | Archivierte Dateien |
| `bilder` | Produktbilder und Medien |
| `dbeS` | dbeS-Dateien |
| `downloads` | Download-Dateien |
| `export` | Export-Dateien |
| `gfx` | Grafiken und Icons |
| `includes` | PHP Include-Dateien |
| `jtllogs` | JTL-Logdateien |
| `media` | Medien-Dateien |
| `mediafiles` | Weitere Mediendateien |
| `plugins` | Installierte Plugins |
| `templates` | Shop-Templates |
| `templates_c` | Kompilierte Templates (Smarty-Cache) |
| `update` | Update-Dateien |
| `uploads` | Hochgeladene Dateien |
| `root` | Alle Dateien im Root-Verzeichnis |
### Backupname
Wähle einen Namen für dein Backup. Wenn du das Backup in einem Unterordner erstellen willst, trage den Pfad relativ zu Root ein und hänge den gewünschten Dateinamen an.
Achte auf korrekte Schreibweise und dass das Verzeichnis wirklich existiert. Verzichte auf Sonderzeichen. Das Backup wird als ZIP gespeichert.
**Beispiel:** `backups/2025meinbackup`
### Backup durchführen
Erstellt ein Backup aus den gewählten Ordnern und Files (`root`) unter dem angegebenen Dateinamen. Wenn du den gleichen Namen verwendest wie ein bereits existierendes Backup, wird dieses ergänzt oder bereits enthaltene Dateien überschrieben.
Klicke auf **Backup jetzt erstellen**, um den Vorgang zu starten.
## ZIP Archive entpacken
Hier kannst du ZIP-Archive, die sich in deinem Shop Root-Verzeichnis befinden, entpacken. Existierende Files werden überschrieben. Du kannst mit dieser Funktion z.B. Shop-Updates installieren oder versehentlich gelöschte Backups wiederherstellen.
**Benutzung auf eigene Gefahr!** Existierende Dateien werden beim Entpacken überschrieben. Das Tool ist KEIN professionelles Backup. Wir übernehmen weder Support noch Haftung für Datenverlust.
### ZIP Archiv wählen
Wähle über das Dropdown ein ZIP-Archiv aus, das sich im Shop Root-Verzeichnis befindet.
### Zielverzeichnis
Gibt das Zielverzeichnis an, wohin das ZIP entpackt werden soll. Lasse das Feld leer, wenn das Paket im Shop Root Verzeichnis entpackt werden soll.
Das Zielverzeichnis muss auf `/` enden.
**Beispiel für Unterverzeichnis:** `meinVerzeichnis/`
Klicke auf **Entpacken**, um das Archiv zu entpacken.
# Bewertungen
Source: https://docs.dreizack-medien.de/Resources-and-Health/bewertungen
Produktbewertungen einsehen, freischalten, beantworten und Kunden direkt aufrufen
Der Bereich **Produktbewertungen** zeigt alle neuesten Bewertungen mit zugeordnetem Kunden und Artikel. Du kannst Bewertungen freischalten, sperren, beantworten und direkt zum Kundenprofil springen.
Gastbewertungen (ohne Kundenkonto) lassen sich nicht mit einem Kunden verknüpfen.
## Suche und Filter
Über das Dropdown kannst du Bewertungen nach Status filtern (z.B. alle, freigeschaltet, gesperrt). Das Suchfeld durchsucht nach **Artikel**, **Art-Nr**, **Kunde** oder **Bewertungstext**. Mit **Zurücksetzen** leerst du die Filter wieder.
## Tabellenspalten
| Spalte | Beschreibung |
| ------------- | --------------------------------------------- |
| **Datum** | Datum der Bewertung |
| **Artikel** | Artikelname und Art-Nr |
| **Sterne** | Sternebewertung (1–5) |
| **Kunde** | Name und E-Mail des Kunden |
| **Bewertung** | Titel und Text der Bewertung |
| **Status** | Aktueller Status (z.B. **Freigeschaltet**) |
| **Antwort** | Zeigt an, ob eine Shop-Antwort hinterlegt ist |
## Aktionen pro Bewertung
Am rechten Rand jeder Zeile stehen drei Icons:
Bewertung sperren oder wieder aktivieren
Antwort auf die Bewertung schreiben
Kundendetails öffnen
## Detailansicht
Ein Klick auf eine Bewertungszeile öffnet die Detailansicht des Artikels – dieselbe Ansicht erscheint auch beim Klick auf das Pfeil-Icon.
In der Detailansicht siehst du:
* **Sternebewertung**, Status-Badge und Datum
* **Kundendaten**: Name, E-Mail und angezeigter Name – über **Kunde öffnen** gelangst du direkt zur [Kundendetailansicht](/Resources-and-Health/kunden#detailansicht) (Person-Icon)
* **Bewertungstext**: Titel und Kommentar des Kunden
* **Sperren**-Button: Bewertung deaktivieren, ohne sie zu löschen
* **Antwort des Shops**: Textfeld für eine öffentliche Antwort, die direkt unter der Bewertung im Shop erscheint – mit **Antwort speichern** bestätigen
# Changelog
Source: https://docs.dreizack-medien.de/Resources-and-Health/changelog
Alle Updates und Änderungen für Resources & Health
### Bugfixes
* Die Pfeile der Splide-Slider ragten ab 991px Breite links und rechts über den Container hinaus und erzeugten horizontalen Seitenscroll, besonders bei Viewports zwischen 992 und 1080px sowie 1200 und 1370px. Die Regel ist entfernt, die Pfeile sitzen jetzt innen an der Sliderkante. Wer die Außenposition behalten möchte, setzt sie im Child-Template
### Kompatibilität
* JTL-Shop ab 5.3.2, keine Obergrenze
* PHP 8.2 - 8.5
### Bugfixes
* Beim Update der NIU-Plus-Template-Suite bleiben jetzt auch die eigenen SCSS-Variablen (`_variables.scss` mit Farbpalette und Schriftfamilien) sowie die Favicons des Shops erhalten. Bisher kamen an diesen drei Stellen die Vorgabewerte des Child-Templates zurück
### Kompatibilität
* JTL-Shop ab 5.3.2, keine Obergrenze
* PHP 8.2 - 8.5
### Features
* Plugins können Sprachvariablen jetzt zur Laufzeit anlegen und wieder entfernen – Grundlage für Plugins, die ihre Texte aus eigenen Daten erzeugen
### Verbesserungen
* Backend-Theme „Auto": die linke Navigationsleiste folgt jetzt dem Dark Mode des Systems, statt hell zu bleiben
* PluginHub listet DZM Bonus Plus
### Bugfixes
* Der Shop-Cache wird nicht mehr täglich vollständig geleert. Der Ressourcen-Abgleich verwirft jetzt nur noch gezielt die betroffenen Einträge, und nur dann, wenn sich wirklich etwas geändert hat. Besonders spürbar mit Redis als Cache-Backend, wo bisher die komplette Cache-Datenbank verworfen wurde
* Die Angabe einer maximal unterstützten Shop-Version ist entfallen. Sie hätte ein Update auf einen neueren JTL-Shop blockiert, obwohl das Plugin damit läuft
* Aufklappbare Textblöcke: das Chevron-Symbol wird jetzt mitgeliefert und beim Aufklappen mitgedreht, Screenreader bekommen den Auf- und Zuklapp-Zustand mit, überflüssige Debug-Ausgaben in der Browser-Konsole entfernt
### Kompatibilität
* JTL-Shop ab 5.3.2, keine Obergrenze
* PHP 8.2 - 8.5
### Verbesserungen
* Neue Schnittstelle für Plugins, um Merkmale mit eindeutiger ID abzufragen – Grundlage für die getrennte Auswahl von Hersteller und Marke in NIU Plus
### Kompatibilität
* JTL-Shop 5.3.2 - 5.7.2
### Features
* Error-Tracking im Backend: neue Übersicht über Fehler und Log-Einträge, inklusive Spiegelung der JTL-Core-Logs
* Umstellung auf den neuen Release- und Lizenzserver, inklusive automatischem Rückfall auf das Altsystem
### Verbesserungen
* PluginHub zeigt neuere, noch nicht kompatible Versionen wieder an (Verhalten wie im Altsystem)
* NIUplus-Template-Installation wählt die passende Version über den Release-Feed statt über einen festen Versionssprung
* Kategorieabfragen liefern deterministische Ergebnisse und sind spürbar schneller
### Bugfixes
* Fehlerhafte Ausgabe im Seitenkopf behoben
### Kompatibilität
* JTL-Shop 5.3.2 - 5.7.2
### Features
* Kundenübersicht mit Insights zu Bestellungen
* Bewertungsübersicht mit Kundenzuordnung
### Kompatibilität
* JTL-Shop 5.3.2 - 5.7.2
### Features
* Ausbesserungen für NIU Plus Progressbar und Conversion Booster Progressbar
### Kompatibilität
* JTL-Shop 5.3.2 - 5.7.2
### Features
* Wichtig! Wechsel unseres Lizenzservers
* Ausbesserungen am Installservice + Logging
* Hinweiskarten zur Loggerkonfiguration
### Kompatibilität
* JTL-Shop 5.3.2 - 5.7.2
### Features
* Custom Input Type für Tabellen
* Code Block Input Type verbessert
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.1
### Features
* Cron Job Manager verbessert
### Kompatibilität
* JTL-Shop 5.5.0 - 5.7.1
### Features
* Verbesserter Installwizard \[beta]
* Dispatcher verbessert
* Dynamische Aktivierung von Consent Scripten ohne Reload
* Neuer Logger und Loggerübersicht
* Neues Feature: Cron-Jobs Manager für mehr Kontrolle
### Kompatibilität
* JTL-Shop 5.3.2 - 5.7.0
### Features
* Neues Backend
* Core Funktionen für NIU Plus CSV Importer
* Core Funktionen für Billiger gesehen Plugin
### Features
* Tracker verbessert
* Dispatcher aus dynamischen Ressourcen entfernt und fest in Header eingebaut
* Sprachvariablen Tool verbessert
* Kompatibilitätsverbesserungen
### Kompatibilität
* JTL-Shop 5.3.2+
### Features
* Neue interne Trackingvorbereitung für einheitliches Tracking über mehrere Kanäle hinweg: Integriertes Trackingsystem nach Vorbild der GA4 Standard E-Commerce Events als Grundlage für künftige Tracking-Integrationen in NIU Plus
### Kompatibilität
* JTL-Shop 5.3.2+
### Features
* Allgemeine Kompatibilitätsfunktionen
* Vorbereitungen auf erweiterte Analysefunktionen
### Kompatibilität
* JTL-Shop 5.3.2+
### Features
* Allgemeine Kompatibilitätsfunktionen
* \[BETA] Neuer Installationsservice und Pluginübersicht mit Möglichkeit kompatible Versionen direkt zu installieren
* \[BETA] Vorbereitung einer lokalen, consent-freien Trackinglösung ohne Weitergabe an Dritte. Anonyme E-Commerce-Events analog zu Google Analytics in der eigenen Shopdatenbank.
### Kompatibilität
* JTL-Shop 5.3.2+
### Features
* Statistik Dashboard für Umsatz, Bestellungen und WK Wert über 3 Jahre und im Jahresvergleich
* Marker in den Statistiken setzen, um Veränderungen besser zu verfolgen
* Popup Container nach Zeit funktioniert nun auch ab 0 Sekunden
* Kompatibilität mit Shop 5.6.0 und neuer Installservice für NIU Plus Template
### Bugfixes
* Popup Container merkt sich erst nach Reload, dass er geschlossen wurde per Cookie
* Hersteller Query gefixt für OPC Portlets vererben
### Kompatibilität
* JTL-Shop 5.3.2+
### Features
* Kompatibilitätsupdate für DZM Plugins
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Neues Event für Event Dispatcher - betrifft nur NIU Plus
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Backup Tool
* SQL Query Tool
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Kleinere Anpassungen für Elfsight Widgets Plugin
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Neues Portlet: Request Container - Zeige oder verstecke Content anhand von URL Parametern. Ideal für AB-Testing, Kampagnen oder custom Content.
### Kompatibilität
* JTL-Shop 5.3.1+
### Bugfix
* Icon Position der Buttons konnte nicht in jeder Option eingestellt werden
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Wichtige Event Updates für NIU Plus
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Installservice für NIU Plus verbessert
* Analysetabelle für Produktaufrufe
* Kompatibilitätsupdates
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Vorbereitungen für ein neues Feature
* Anpassungen für NIU Plus Update
* Vorbereitung für Produktanalyse
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Dashboard in Pluginsettings verschoben
* Verbesserungen in internen Funktionen
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Codebase Erweiterung für neue Plugins
* Min Shop Version herabgesetzt für breitere Kompatibilität
### Kompatibilität
* JTL-Shop 5.3.1+
### Features
* Einige Core Funktionalitäten hinzugefügt
* dzmCountdown.js verbessert
* CountdownPlusV2 mit besseren Funktionen löst den alten CountdownPlus ab
### Bugfixes
* DZM Resources & Health Dashboard wird nicht geladen, wenn die Fehlerausgabe aktiviert ist
* Image Comparer Library versteckt Nav, wenn der Vergleichsschieber deaktiviert
### Kompatibilität
* JTL-Shop 5.3.2+
### Bugfixes
* Dispatcher wird im Novatemplate nicht rechtzeitig geladen
### Kompatibilität
* JTL-Shop 5.3.2+
### Bugfixes
* Kleinere Bugfixes und globale Styleanpassungen
### Kompatibilität
* JTL-Shop 5.2.4+
Javascripte wurden komplett überarbeitet. Nach Installation/Update darauf achten, dass die Ressourcen installiert werden: Im Dashboard auf `Resources & Performance` gehen und `Probleme beheben` klicken.
### Features
* Neuer globaler Javascript Dispatcher für modulare Scripte und mehr Erweiterbarkeit
### Kompatibilität
* JTL-Shop 5.2.4+
Im Zuge der Neugestaltung der NIU Plus Pakete wurde die NIU Plus Lizenz als Bundlelizenz für OPC Plugins entfernt. Ab Template Version 1.2.2/2.2.2 wird zusätzlich eine OPC Suite Lizenz benötigt.
### Features
* Installationsservice für NIU Plus verbessert
### Kompatibilität
* JTL-Shop 5.2.4+
### Features
* Bundling Option für Resources Javascripte im Resources Panel
* Testlauf für Analysefunktionen
### Bugfixes
* Lizenzprüfung zu oft getriggert
* Einige Console Logs entfernt
### Kompatibilität
* JTL-Shop 5.2.4+
### Features
* Performance Update
* Neues Parallax Script für Container Plus - bessere Ladezeit
* Kleinere Kompatibilitätsverbesserungen
### Kompatibilität
* JTL-Shop 5.2.4+
### Features
* Funktionsupdate für Conversion Booster und NIUplus
* Portletsortierung angepasst
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Neuer Bereich: Shopstruktur und Systeminformation
* PHP Info: PHP Infos direkt im Backend einsehen
* Verwaiste Kinder: Liste verwaister Kindartikel anzeigen, die den Google Feed Export blockieren können
### Bugfix
* Kleinere Ausbesserungen
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Anpassung an neue einheitliche Schnittstelle
* Allgemeine Verbesserungen in der Performance
* Global alle Sprachvariablen pflegen, finden und neu anlegen
### Bugfix
* Reports werden nicht richtig geladen
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Globale Funktionen für Plugins
### Bugfix
* Kleinere Fehlerbehebungen
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Neue Mountpoints in Kategorie und Produktdetailansicht
* Neues Portlet: Countdown Plus
### Bugfix
* Fehlende Sprachvariable für UVP
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Status, ob Object Buffer aktiv ist oder nicht im Report Panel
* Darstellungsoptimierung des Popup Containers
* Dokumentationstab in Plugineinstellungen
* Verbesserung der Ressourcen
* Neues Portlet: Popup Container - Individuelle Popups per Click, ExitIntent, Scrollposition oder bei Sichtbarkeit eines Elements
* OPC Plugin Buttons: Funktionsbutton-Option mit EventID
### Bugfix
* Fehler in Erweiterung der Datenbanktabelle bei Neuinstallation
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Erweiterung der Datenbankabfragen für OPC Plus
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* CSRF Token Validierung
### Kompatibilität
* JTL-Shop 5.2.0+
### Bugfix
* Pluginliste wurde nicht dargestellt
### Kompatibilität
* JTL-Shop 5.2.0+
### Features
* Umfassendes Adminwidget
* Script & Consent: Scripte, Styles und Widgets ohne Templateanpassung integrieren
* Report: Status über JTL Shop System und Server mit Empfehlungen
* Debugsettings: Debug und Logeinstellungen direkt aus dem Admin
* Logs einsehen: Zentrale Übersicht aller DZM Plugin Logs
* Pluginübersicht: Übersicht aller Plugins, Updates, bekannter Probleme und Kompatibilitäten
### Kompatibilität
* JTL-Shop 5.2.0+
# Cronjobs
Source: https://docs.dreizack-medien.de/Resources-and-Health/cronjobs
Verwalte automatisierte Cronjobs und Wartungstasks in deinem JTL-Shop
## Was sind Cronjobs?
Cronjobs sind automatisierte Aufgaben, die in regelmäßigen Abständen ausgeführt werden. Im JTL-Shop werden sie über eine Job-Queue verwaltet und sind essenziell für Routineaufgaben wie Bestandsaktualisierungen, Datenbereinigung und andere Hintergrundprozesse. Mit Resources & Health hast du volle Kontrolle über diese Prozesse.
Die Cronjob-Verwaltung ist im Resources & Health Plugin integriert und startet automatisch nach der Installation. Es gibt keine zusätzliche Einrichtung erforderlich – das Plugin verwaltet alle Cronjobs zentral.
Achte nur darauf, dass:
* Das Plugin korrekt installiert ist
* Dein Hoster regelmäßige Cron-Aufrufe erlaubt
* Die Job-Queue regelmäßig abgerufen wird
Einen ausführlichen Überblick zum Thema Cronjobs im JTL-Shop findest du in unserem Blogartikel [JTL-Shop Cronjobs verwalten](https://dreizack-medien.de/blog/jtl-shop-cron-jobs-verwalten).
## Status-Übersicht
### Cronjob-Status und Zombies
Die Status-Übersicht zeigt den aktuellen Status aller Cronjobs. Besonders wichtig ist das Verständnis von sogenannten **Zombies** – das sind Cronjobs, die einmal gestartet wurden, aber nie richtig beendet wurden. Sie bleiben mit dem Status `running` stecken, obwohl sie nicht mehr aktiv sind.
**Zombie-Erkennung:**
Zombies entstehen normalerweise durch:
* Timeouts bei langen Operationen
* Serverabstürze während Job-Ausführung
* Lockfile-Probleme
* Speichererschöpfung
**Zombie beheben:**
Nutze den "Status reset (soft)" Button, um den Job wieder in den Normalzustand zu versetzen. Die bestehenden Daten bleiben erhalten.
## Konfiguration
### Cronjob-Felder und Einstellungen
Die Tabelle zeigt alle verfügbaren Cronjobs mit ihren aktuellen Informationen:
| Spalte | Erklärung |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| **Jobtitel** | Name/Bezeichnung des Cronjobs |
| **Frequenz** | Zeitintervall, in dem der Job automatisch ausgeführt wird (z.B. stündlich, täglich, wöchentlich) |
| **Status** | Aktueller Status: queued (wartet), idle (inaktiv), running (läuft), completed (fertig), failed (Fehler) |
| **Letzte Ausführung** | Zeitstempel der letzten erfolgreichen Ausführung |
| **Nächste Ausführung** | Zeitstempel, wann der Job das nächste Mal ausgeführt wird |
| **Trigger** | Art der Auslösung (automatisch, manuell, ASAP) |
| **Timeout** | Maximale Zeit, die der Job laufen darf, bevor er abgebrochen wird |
| **Aktionen** | Verfügbare Steuerbefehle (ausführen, zurücksetzen, löschen) |
### Aktionen
Für jede Cronjob-Aufgabe stehen dir verschiedene Aktionen in der Aktionsleiste zur Verfügung:
Umgeht die JTL-Queue und den Job-Shuffle und führt den Job sofort aus. Der Listener startet automatisch für Live-Logs. Nutze das, wenn du einen Job sofort ausgeführt haben möchtest, ohne auf den nächsten regulären Durchlauf zu warten.
Setzt `nextStart=NOW()`. Der Job läuft beim nächsten regulären Queue-Durchlauf mit. Nicht so aggressiv wie "direkt ausführen", aber schneller als der reguläre Rhythmus. Ideal für zeitkritische Jobs.
Setzt `isRunning=0` in der `tjobqueue` Tabelle. Der Job macht bei `tasksExecuted` weiter. Der Fortschritt bleibt erhalten. Nutze das, wenn ein Job hängen bleibt, aber du ihn nicht komplett neu starten möchtest.
Löscht alle `tjobqueue`-Einträge komplett. Der Cron-Job bleibt in der `tcron` Tabelle und startet beim nächsten Lauf von vorne. Setzt den Job auf den Anfang zurück. Nutze das bei hartnäckigen Problemen.
Entfernt den Job aus `tcron` **und** `tjobqueue`. **Irreversibel!** Plugin-eigene Jobs werden beim nächsten Plugin-Boot wieder angelegt. Vorsicht – nutze das nur, wenn du den Job wirklich nicht mehr brauchst!
## Live-Logs
Wenn du einen Cronjob startest, erscheinen die Live-Logs automatisch und geben dir einen detaillierten Einblick in die Ausführung des Jobs. Dies ist besonders hilfreich beim Debugging und zum Überwachen von zeitkritischen Aufgaben.
Die Live-Logs zeigen:
* Echtzeit-Status der Job-Ausführung
* Detaillierte Fehler- und Warnmeldungen
* Fortschritt bei mehrstufigen Jobs
* Timestamp für jede Aktion
**Wichtig:** Nutze die harten Resets und Löschungen mit Bedacht. Für die meisten Probleme reicht ein softerer Reset vollkommen aus. Nur wenn nichts anderes hilft, nutze die härteren Optionen.
# Einführung
Source: https://docs.dreizack-medien.de/Resources-and-Health/einfuehrung
DZM Resources & Health - Das zentrale Plugin für Performance und Shop-Management
## Was ist DZM Resources & Health?
Resources & Health ist unser zentrales Plugin für alle notwendigen Ressourcen für all unsere Plugins. Da sich einige Ressourcen unter den verschiedenen Plugins überschneiden, haben wir alle Skripte, Styles und Einstellungen, die von mehreren Plugins benötigt werden, in einem Plugin vereint. Dadurch kommt es nicht zu unnötigen Überlagerungen, wenn du mehrere Plugins gleichzeitig im Betrieb hast. Das pusht deine Performance und hilft uns bei der schnelleren und wartungsfreundlicheren Entwicklung.
## Mehr als nur Ressourcen
Als Goodie für dich...und für uns...haben wir einige Features mit eingebaut, die dir helfen sollen deinen Shop besser zu managen. Wir bieten diese Funktionen kostenlos an, weil sie auch uns das Leben einfacher machen und wir sie quasi bei jedem Kunden benötigen.
Als Bonus erhältst du automatisierte Bewertungen zu deinen Systemeigenschaften. So helfen wir dir, dir selbst zu helfen.
## Einsatzmöglichkeiten
Behalte alle wichtigen Systeminfos im Blick: Hoster, PHP-Version, Shopversion, aktiver Cache, installierte Plugins und Datenbankzugang - alles zentral an einem Ort.
Binde externe Skripte DSGVO-konform ein. Von Tracking-Codes über Social Media Feeds bis hin zu Chat-Widgets - alles ohne Code-Kenntnisse und mit vollständiger Consent-Verwaltung.
Vermeide Ressourcen-Überlagerungen und optimiere die Ladezeiten deines Shops durch intelligentes Ressourcen-Management über alle DZM Plugins hinweg.
Greife auf erweiterte Entwickler-Tools zu: Config.ini Bearbeitung, zusätzliche OPC-Mountpoints, zentrale Log-Verwaltung und umfassende Sprachvariablen-Kontrolle.
Finde und exportiere verwaiste Kindartikel, die deinen Google Feed blockieren können. Erhalte schnellen Zugriff auf alle wichtigen Shop-Strukturen.
Verwalte alle DZM-Plugin-Logs zentral, konfiguriere Debug-Einstellungen direkt im Backend und bearbeite Sprachvariablen komfortabel an einem Ort.
## Quick Info: Was kannst du alles tun?
* Welcher Hoster?
* Welche PHP und Shopversion?
* Welcher Cache ist aktiviert?
* Welche Plugins sind installiert?
* Wie ist der Datenbankzugang?
* Und vieles mehr...
* Scripts im Header, Footer, als Portlet oder per CSS-Selektor einbinden
* DSGVO-konforme Consent-Items erstellen und verwalten
* Scripts an Consent-Items binden
* Keine Code-Kenntnisse erforderlich
* Verwaiste Kindartikel identifizieren
* Als CSV exportieren
* Google Feed Probleme beheben
* PHP-Informationen einsehen
* Config.ini Optionen direkt im Backend bearbeiten
* Zusätzliche OPC-Mountpoints aktivieren
* Debug- und Log-Einstellungen zentral verwalten
* Logfiles direkt im Backend auslesen
* Alle JTL- und Plugin-Sprachvariablen zentral verwalten
* Neue Sprachvariablen anlegen
* Import/Export für Backup und Massenbearbeitung
* Mehrsprachige Shops einfach verwalten
**Wichtig:** Resources & Health muss **vor** allen anderen DZM Plugins installiert und aktualisiert werden, da es die Basis für alle weiteren Plugins bildet.
# Installation
Source: https://docs.dreizack-medien.de/Resources-and-Health/installation
So installierst du DZM Resources & Health in deinem JTL-Shop
**Resources & Health muss dringend VOR allen anderen DZM Plugins installiert und aktualisiert werden.**
Dieses Plugin bildet die Basis für alle weiteren DZM Plugins und stellt gemeinsame Ressourcen bereit.
## Installationswege
Du hast zwei Möglichkeiten, DZM Resources & Health zu installieren:
### Installation aus dem JTL Extension Store
Öffne in deinem JTL-Shop Backend den Plugin-Manager unter **Plugins > Plugin-Manager**.
Wenn du das Plugin aus dem JTL Extension Store bezogen hast, kannst du im Plugin-Manager die Lizenz an deinen Shop binden.
Klicke auf **Installieren**, um das Plugin in deinem Shop zu aktivieren.
Das Widget mit allen Tools wird automatisch auf der Startseite deines Backends angelegt.
Du kannst das Widget nach der Installation auch auf anderen Backend-Seiten platzieren oder im Dashboard arrangieren.
### Installation aus dem Dreizack Medien Store
Lade dir von der Produktseite auf [dreizack-medien.de](https://dreizack-medien.de) die ZIP-Datei zur Installation herunter.
Stelle sicher, dass du die neueste Version des Plugins herunterlädst.
Gehe im JTL-Shop Backend zu **Plugins > Plugin-Manager > Upload** und lade die ZIP-Datei hoch.
Die ZIP-Datei muss nicht entpackt werden - lade sie direkt hoch.
Wechsle zum Reiter **Vorhanden** und wähle bei DZM Resources & Health die Option **Installieren**.
Das Widget mit allen Tools wird automatisch auf der Startseite angelegt und ist sofort einsatzbereit.
## Nach der Installation
Das Dashboard-Widget erscheint automatisch auf deiner Backend-Startseite. Du kannst es nach Bedarf verschieben oder anpassen.
Erkunde die verschiedenen Tabs im Widget, um alle Features kennenzulernen. Beginne am besten mit dem Report-Tab für einen Systemüberblick.
Nach erfolgreicher Installation von Resources & Health kannst du nun weitere DZM Plugins installieren. Diese nutzen die zentrale Ressourcen-Basis.
Bei Fragen oder Problemen steht dir unser Support-Team gerne zur Verfügung.
## Systemvoraussetzungen
* **JTL-Shop:** Version 5.0 oder höher
* **PHP:** Version 7.4 oder höher (8.0+ empfohlen)
* **Datenbankrechte:** Vollzugriff auf die Shop-Datenbank
* **Dateisystemrechte:** Schreibrechte im Plugin-Verzeichnis
**Installation erfolgreich?** Perfekt! Du kannst jetzt mit der Konfiguration beginnen und alle Features von DZM Resources & Health nutzen.
## Nächste Schritte
Besuche den Tab [Shopstruktur und Systeminfo](/Resources-and-Health/Shopstruktur-und-systeminfo), um einen ersten Überblick über dein System zu erhalten.
Falls du externe Scripts einbinden möchtest, schau dir den Bereich [Scripts & Consent](/Resources-and-Health/Script-und-Consent) an.
Konfiguriere die [Ressourcen und Performance](/Resources-and-Health/Ressourcen-und-Performance) Einstellungen nach deinen Bedürfnissen.
# Kunden
Source: https://docs.dreizack-medien.de/Resources-and-Health/kunden
Kundenübersicht mit Bestell-KPIs direkt in Resources & Health
Der Bereich **Kunden** zeigt eine vollständige Übersicht aller Kunden deines Shops inklusive relevanter Bestell-KPIs.
## Suche
Über das Suchfeld kannst du Kunden nach **E-Mail**, **Vorname** oder **Kundennummer** suchen – diese Felder sind im Klartext gespeichert und durchsuchbar. Mit **Zurücksetzen** leerst du den Suchfilter wieder.
Nachname und Firma werden nur angezeigt, sind aber verschlüsselt gespeichert und können daher nicht durchsucht oder sortiert werden.
## Tabellenspalten
| Spalte | Beschreibung |
| --------------------- | ------------------------------------------ |
| **Kd-Nr** | Interne Kundennummer |
| **Vorname** | Vorname des Kunden |
| **Nachname** | Nachname (nur Anzeige, nicht sortierbar) |
| **Firma** | Firmenname (nur Anzeige, nicht sortierbar) |
| **E-Mail** | E-Mail-Adresse des Kunden |
| **Ort** | Wohnort des Kunden |
| **Bestellungen** | Gesamtanzahl der Bestellungen |
| **Umsatz realisiert** | Tatsächlich realisierter Umsatz |
Spalten mit dem Symbol **↑↓** lassen sich auf- oder absteigend sortieren. Über das Filtersymbol bei „Umsatz realisiert" kannst du zusätzliche Filteroptionen aufrufen.
## Detailansicht
Ein Klick auf das rechts in einer Tabellenzeile öffnet die Detailansicht des Kunden.
### Stammdaten
Zeigt die Basisdaten des Kunden: Kunden-Nr, Name, Firma, E-Mail, Kundengruppe, Registrierungsdatum und Status (z.B. **Aktiv**). Daneben wird die hinterlegte **Stammadresse** angezeigt.
### Umsatz-Aufschlüsselung
Der Umsatz ist in vier Kategorien aufgeteilt:
| Badge | Beschreibung |
| ----------------------- | ----------------------------------------------------- |
| **Realisiert** (grün) | Bezahlte und vollständig versandte Bestellungen |
| **Teilversandt** (gelb) | Bestellungen, die nur teilweise versandt wurden |
| **Offen** (blau) | Bestellungen, die noch offen oder in Bearbeitung sind |
| **Storniert** (rot) | Stornierte Bestellungen |
### Weitere Lieferadressen
Alle beim Kunden hinterlegten Lieferadressen werden hier aufgelistet.
### Bestellungen
Eine chronologische Liste aller Bestellungen des Kunden mit Bestell-Nr, Datum, Status und Gesamtsumme. Über **Positionen** kannst du die einzelnen Artikel einer Bestellung einsehen.
# PluginHub
Source: https://docs.dreizack-medien.de/Resources-and-Health/pluginhub
Zentrale Übersicht und Verwaltung aller DZM Plugins direkt aus Resources & Health
Der PluginHub gibt dir eine vollständige Übersicht über alle verfügbaren DZM Plugins – inklusive Installationsstatus, Kompatibilität, verfügbarer Updates und direkter Installationsmöglichkeit. Du findest ihn im Resources & Health Dashboard.
## Status-Anzeige
Jedes Plugin zeigt zwei farbige Statuspunkte:
**Kompatibel** – zeigt an, ob das Plugin mit deiner aktuellen Shop-Version kompatibel ist.
**Installiert** – zeigt an, ob das Plugin in deinem Shop installiert ist (inkl. der installierten Version).
Die Farben bedeuten:
* **Grün** – aktiv und in Ordnung (kompatibel bzw. installiert)
* **Rot** – nicht erfüllt (nicht kompatibel mit deiner Shop-Version, oder nicht installiert)
Beide Punkte grün: Das Plugin ist kompatibel und aktuell installiert.
Beide Punkte rot: Das Plugin ist weder kompatibel noch installiert.
### Updates
Wenn für ein installiertes Plugin eine neuere Version verfügbar ist, wird der Badge **Update verfügbar** neben dem Installiert-Status angezeigt. Darunter erscheint ein Button zum direkten Installieren der neuen Version.
Bei Installationsproblemen kannst du das Plugin alternativ direkt über den **DZM Store** oder den **JTL-Extstore** herunterladen und manuell über den Pluginmanager installieren.
### BETA und DEPRECATED
Manche Plugins tragen besondere Kennzeichnungen:
**BETA** (orange Badge) – Das Plugin befindet sich noch in der Testphase. Funktionen können sich noch ändern; Einsatz auf eigene Verantwortung.
**DEPRECATED** (roter Badge) – Das Plugin wird nicht mehr aktiv weiterentwickelt und sollte nicht mehr neu eingesetzt werden.
***
## Plugin-Kategorien
Die Plugins sind im PluginHub in folgende Kategorien gegliedert:
### Resources
* DZM Resources & Health
### OPC Suite
* DZM OPC Plus
* DZM OPC Conversion Booster
* DZM Smarty Portlets
* DZM Portlets vererben
* DZM OPC Suite
### Template
* DZM NIU Plus Template
### Tools
* DZM Reloadify
* DZM Monitoring
* DZM Luigis Box Integration
* DZM Elfsight Plus
* DZM Copy Stop
* DZM Preorder Plus
* DZM Artikelanzeigefilter Plus
* DZM CLP Gefahrenhinweise
* DZM Event Animation *(DEPRECATED)*
### Hilfsplugins
# Report
Source: https://docs.dreizack-medien.de/Resources-and-Health/report
## Übersicht
Hier findest du schnell nützliche Informationen über dein System, deine Konfiguration und deine Plugins.
**Schnelle Systemübersicht**
Der Report zeigt dir auf einen Blick alle relevanten Informationen zu Cache, PHP, Datenbank und Domain – ohne dass du die Konfigdateien oder FTP öffnen musst.
Wenn der Shop-Cache inaktiv ist, wird der Bericht nicht automatisch geladen. Klicke auf den Hinweis oben im Report-Bereich, um ihn manuell zu aktualisieren.
## Features
Sofortiger Überblick über Cache-Status, Cache-Methode und Object Buffer.
PHP-Version, Shop-Version und Bewertung der Eignung für den Produktivbetrieb.
Schneller Blick auf DB-Verbindung, Stammverzeichnis, URL und HTTP-Version.
Informationen zu Domain, Basisdomain, IP-Adresse und erkanntem Hosting-Anbieter.
## CNX Verbindung
Zeigt den Verbindungsstatus zum DREIZACK Cloud Service (CNX). Dieser wird für lizenzpflichtige Features benötigt.
### Status
Zeigt an, ob der Shop aktuell mit dem DREIZACK Cloud Service verbunden ist. Mögliche Werte: **Verbunden** oder **Nicht verbunden**.
### Verbindung prüfen
Klicke auf den Button **„Verbindung prüfen"**, um die Verbindung zum Cloud Service manuell zu testen und den Status zu aktualisieren.
## Basics
### Cache aktiv
Zeigt an, ob der Shop-Cache aktiv ist.
### Aus Cache geladen
Zeigt an, ob die aktuelle Seite aus dem Cache geladen wurde.
### Object Buffer aktiv
Zeigt an, ob der Object Buffer aktiviert ist.
## Bewertungen
Die Bewertung erfolgt auf Grundlage von Erfahrungswerten für bekannte Werte und ist nicht verbindlich, kann aber Anhaltspunkt für Optimierungen sein.
### Cache Methode
Zeigt die verwendete Cache-Methode an (z.B. `file`). Die Bewertungsleiste gibt einen Hinweis auf die Performance-Eignung der Methode.
### PHP Version
Die installierte PHP-Version. Die Bewertungsleiste zeigt an, wie gut die Version für den Betrieb geeignet ist.
### Shop Version
Die installierte JTL-Shop-Version. Die Bewertungsleiste zeigt an, ob die Version aktuell und empfohlen ist.
## Domain-Informationen
Infos zu Domain, DNS, IP und Hoster.
### Hoster
Der erkannte Hosting-Anbieter. Kann `Unbekannt` sein, wenn der Hoster nicht automatisch erkannt wurde.
### Domain
Die vollständige Domain des Shops.
### Basisdomain
Die Basisdomain ohne Subdomain.
### IP
Die IP-Adresse des Servers.
## Shop Config
Schneller Blick auf nützliche Werte rund um die Shopkonfiguration.
Sensible Felder wie **Blowfish Key** und **DB Pass** sind standardmäßig ausgeblendet. Achte darauf, dass du den Report nicht auf öffentlich zugänglichen Bildschirmen anzeigst.
### Blowfish Key
Der Blowfish-Verschlüsselungsschlüssel des Shops. Aus Sicherheitsgründen standardmäßig ausgeblendet.
### DB User
Der Datenbankbenutzer, mit dem der Shop verbunden ist.
### DB Name
Der Name der verwendeten Datenbank.
### DB Host
Der Datenbankhost (z.B. `localhost`).
### DB Pass
Das Datenbankpasswort. Aus Sicherheitsgründen standardmäßig ausgeblendet.
### Stammverzeichnis
Der absolute Pfad zum Shop-Stammverzeichnis auf dem Server.
### URL
Die öffentliche URL des Shops.
### Protokoll
Das verwendete Protokoll (`http` oder `https`).
### HTTP Version
Die verwendete HTTP-Version (z.B. `HTTP/2.0`).
## Log Levels
Zeigt die aktuelle Konfiguration der Logsettings, ob im Plugin oder in der Konfigdatei gesetzt.
### Fehler im Frontend ausgeben
Nützlich zum Debuggen im Frontend. Sollte im Produktivbetrieb deaktiviert sein.
### Config File verwenden
Gibt an, ob für den Fehlerlog die Konfigdatei oder die Plugineinstellungen verwendet werden. Weitere Infos unter [Config.ini Optionen](/Resources-and-Health/Config-Optionen).
# SQL
Source: https://docs.dreizack-medien.de/Resources-and-Health/sql
## Übersicht
Du kannst hier SQL-Abfragen schreiben und ausführen. Die Ergebnisse kannst du gruppieren, filtern und exportieren.
**Nur lesende Zugriffe erlaubt.** Es sind ausschließlich `SELECT`-Abfragen möglich – keine schreibenden oder strukturverändernden Operationen. Wenn du nicht jedem Zugriff geben möchtest, beschränke den Zugriff auf dieses Plugin für andere Benutzergruppen außer Admin.
## Features
Schreibe Abfragen direkt im integrierten Code-Editor mit Syntax-Highlighting.
Greife schnell auf zuletzt verwendete Abfragen zurück.
Ergebnisse werden übersichtlich in einer Tabelle dargestellt.
Exportiere Abfrageergebnisse zur weiteren Verarbeitung.
## SQL Abfragen
### Neue SQL Abfrage
Gib deine SQL-Abfrage direkt im Code-Editor ein. Starte mit `SELECT`, um Daten aus einer Tabelle abzurufen.
### Letzte Abfragen
Über das Dropdown **Letzte Abfragen** kannst du auf zuvor ausgeführte Abfragen zugreifen und sie erneut laden.
### Query ausführen
Klicke auf **Ausführen**, um die Abfrage zu starten. Das Ergebnis erscheint direkt darunter im Bereich **Ergebnis**.
## Beispiel-Abfragen
```sql theme={null}
SELECT
kArtikel,
cArtNr,
cName,
fLagerbestand
FROM tartikel
WHERE fLagerbestand <= 5
AND cLagerBeachten = 'Y'
ORDER BY fLagerbestand ASC
```
```sql theme={null}
SELECT
DATE_FORMAT(dErstellt, '%Y-%m') AS Monat,
COUNT(*) AS Anzahl,
SUM(fGesamtsumme) AS Umsatz
FROM tbestellung
GROUP BY Monat
ORDER BY Monat DESC
```
```sql theme={null}
SELECT
a.cArtNr,
a.cName,
SUM(p.nAnzahl) AS Verkauft
FROM tbestellpos p
JOIN tartikel a ON p.kArtikel = a.kArtikel
GROUP BY p.kArtikel
ORDER BY Verkauft DESC
LIMIT 10
```
## Hinweise
**Tipp:** Teste Abfragen zuerst mit einem `LIMIT 10`, um die Ergebnisstruktur zu prüfen, bevor du große Datenmengen abrufst.
### Erlaubte Befehle
Nur lesende SQL-Befehle sind erlaubt:
* `SELECT` – Daten abfragen
* `SHOW` – Tabellenstruktur anzeigen
* `DESCRIBE` – Spalten einer Tabelle beschreiben
### Nicht erlaubte Befehle
Schreibende und strukturverändernde Befehle werden blockiert:
* `INSERT`, `UPDATE`, `DELETE` – Datensätze verändern
* `DROP`, `ALTER`, `CREATE` – Struktur verändern
* `TRUNCATE` – Tabellen leeren
# Home
Source: https://docs.dreizack-medien.de/index
# Dokumentation: Dreizack Medien GmbH
Willkommen in der offiziellen Dokumentation der DZM Plugins. Hier findest du alles, was du brauchst, um das Maximum aus deinem JTL-Shop herauszuholen – von der Installation über die Konfiguration bis hin zu Best Practices und Troubleshooting.
## Plugins & Template
Dokumentation zum NIU Plus Template für JTL Shop 5
Zentrale Ressourcenverwaltung, Monitoring und Performance-Optimierung für JTL Shop 5
Conversion-optimierte Portlets und Widgets für JTL Shop 5
Über 30 Content-Portlets für den OPC Page Builder in JTL Shop 5
Master-Template-Vererbung für Header, Footer und Seiten in JTL Shop 5
Smarty-Variablen als Portlets im OPC Page Builder für JTL Shop 5
OPC Plus und OPC Conversion Booster als Bundle für JTL Shop 5
Marketing-Automation und Kundenbindung für JTL Shop 5
CLP-konforme Gefahren- und Sicherheitshinweise für JTL Shop 5
Intelligente Suchfunktion für JTL Shop 5
Shop-Monitoring mit Echtzeit-Alerts, Checkout-Tracking und Performance-Metriken für JTL Shop 5
Erweiterter E-Mail-Editor mit Template-Verwaltung und Test-Fixture-Pool für JTL Shop 5
Externe Widgets einfach in JTL Shop 5 einbinden – ohne Programmierkenntnisse
Progressive Web App mit Push Notifications für JTL Shop 5
Macht deinen JTL-Shop für KI-Agenten lesbar – mit llms.txt, AI-Feed und MCP-Server
Bonuspunkteprogramm: Punkte sammeln beim Kauf, einlösen im Checkout
## Was dich erwartet
Unsere Plugins helfen dir dabei, deinen JTL-Shop effizienter, schneller und benutzerfreundlicher zu gestalten. Jedes Plugin wurde mit Fokus auf Performance, Benutzerfreundlichkeit und nahtlose Integration entwickelt.
Step-by-step Installationsanleitungen, detaillierte Feature-Beschreibungen und praktische Anwendungsbeispiele für jedes Plugin.
Profitiere von unserer Erfahrung: Bewährte Strategien, Performance-Tipps und Optimierungsempfehlungen.
Fertige Code-Snippets und Templates für gängige Anwendungsfälle – direkt einsetzbar in deinem Shop.
Lösungen für häufige Probleme und detaillierte Debugging-Anleitungen.
## Du brauchst Hilfe?
Du hast Fragen oder brauchst Unterstützung? Unser Support-Team steht dir gerne zur Verfügung:
* 📧 **E-Mail:** [support@dreizack-medien.de](mailto:support@dreizack-medien.de)
* 🌐 **Website:** [dreizack-medien.de](https://dreizack-medien.de)
* 💬 **Community:** [JTL-Community Forum](https://forum.jtl-software.de)
Diese Dokumentation wird kontinuierlich erweitert und aktualisiert. Hast du Verbesserungsvorschläge? Wir freuen uns über dein Feedback!