# norisk Shopware-Plugins

Shopware 6 Plugin-Dokumentation

***

<table data-column-title-hidden data-view="cards"><thead><tr><th data-type="content-ref"></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="/plugins/foundation">Foundation</a></td><td>v1.1.0</td><td>Basis aller norisk-Plugins für Shopware 6. Enthält grundlegende Funktionen sowie smarte Tools und Helper.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2Fsw5FicKrUWNjhP3Yv7i1%2FGitBook%20Card%20NRSWFN.png?alt=media&amp;token=389a8c54-f55f-4830-bfbc-c625646f3c9d">GitBook Card NRSWFN.png</a></td><td><a href="/plugins/foundation">Foundation</a></td></tr><tr><td><a href="/plugins/product-features">Product Features</a></td><td>(WIP)</td><td>Badges, Tags und gruppierte Anzeige von Eigenschaften und Custom Fields in definierbaren Sets.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FdxnDtr8fNX2LZ5HLAc0q%2FGitBook%20Card%20NRSWPF.png?alt=media&amp;token=b571ad57-d0c5-442a-ab81-3ba445b5a047">GitBook Card NRSWPF.png</a></td><td><a href="/plugins/product-features">Product Features</a></td></tr><tr><td><a href="/plugins/dynamic-pages">Dynamic Pages</a></td><td>(WIP)</td><td>Ausgabe von CMS-Content oder HTML auf diversen Shoppages - konfigurierbar und ohne Anpassung des Templates.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2Fcnb68grVdPmxg8IpLgYg%2FGitBook%20Card%20NRSWDP.png?alt=media&amp;token=0b1c1920-8d08-462c-ba48-7126bd3eb0cb">GitBook Card NRSWDP.png</a></td><td><a href="/plugins/dynamic-pages">Dynamic Pages</a></td></tr><tr><td><a href="/plugins/manufacturers">Manufacturers</a></td><td>(WIP)</td><td>Konfigurierbare Hersteller-Verzeichnisse und -Detailseiten mit spezifischen CMS-Elementen und Herstellerinformationen.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FcOh0o4XhM2qskLSSaXID%2FGitBook%20Card%20NRSWMF.png?alt=media&amp;token=dcd8c863-9f3e-439f-8ea6-e26c3714b25d">GitBook Card NRSWMF.png</a></td><td><a href="/plugins/manufacturers">Manufacturers</a></td></tr><tr><td><a href="/plugins/out-of-stock">Out of Stock</a></td><td>(WIP)</td><td>Verknappungs- und FOMO-Funktionalitäten sowie abonnierbare Restock-Notifications mit optionalem DOI.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FHUYDyAf5rEZU9MY59umP%2FGitBook%20Card%20NRSWOOS.png?alt=media&amp;token=95513cbd-66fb-4caf-8421-90a8aca50cb9">GitBook Card NRSWOOS.png</a></td><td><a href="/plugins/out-of-stock">Out of Stock</a></td></tr><tr><td><a href="/plugins/delivery-times">Delivery Times</a></td><td>(WIP)</td><td>Konfigurierbare Berechnung von Lieferzeiten unter Berücksichtigung von Wochenenden und auslieferfreien Tagen.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FvpNfvSZsrar2q6CUHIxl%2FGitBook%20Card%20NRSWDT.png?alt=media&amp;token=e07a5ac3-122c-4f11-bba8-502d398005ce">GitBook Card NRSWDT.png</a></td><td><a href="/plugins/delivery-times">Delivery Times</a></td></tr><tr><td><a href="/plugins/b2b-suite">B2B-Suite</a></td><td>(WIP)</td><td>Erweiterung der Shopware 6 Standard-Funktionalität mit spezifischen Lösungen für das B2B-Business.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FF5iL6Or0ju3QgQVPkel5%2FGitBook%20Card%20NRSWB2B.png?alt=media&amp;token=40fa24df-ba15-4de8-8aa4-6565bca6d8bc">GitBook Card NRSWB2B.png</a></td><td><a href="/plugins/b2b-suite">B2B-Suite</a></td></tr><tr><td><a href="/plugins/exporter">Exporter</a></td><td>(WIP)</td><td>Komfortable Konfiguration von Product Feeds mit Eigenschaften und Custom Fields sowie Erweiterungen für Datenexporte.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FC40oVbnq8AV8clXjEcHj%2FGitBook%20Card%20NRSWEXP.png?alt=media&amp;token=0457d8e3-5c9c-464a-89ae-a77165abb3bf">GitBook Card NRSWEXP.png</a></td><td><a href="/plugins/exporter">Exporter</a></td></tr><tr><td><a href="/plugins/i18n">i18n</a></td><td>(WIP)</td><td>Nützliche Werkzeuge für die Internationalisierung inkl. Länder-Sprachen-Währungswechsler.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FrhyyTmtuzSOuypV6zSuI%2FGitBook%20Card%20NRSWI18N.png?alt=media&amp;token=7a1bb0c2-b8db-4a1c-8d4e-9b5f8680048e">GitBook Card NRSWI18N.png</a></td><td><a href="/plugins/i18n">i18n</a></td></tr><tr><td><a href="/plugins/seo">SEO</a></td><td>(WIP)</td><td>SEO-Optimierung deines Shops und zusätzliche Features wie PDPs von Hauptprodukten.</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FRFgJgg5hEBLQD1GP6sOw%2FGitBook%20Card%20NRSWSEO.png?alt=media&amp;token=4a1e689f-31dd-4378-94fb-a1ecb9caae00">GitBook Card NRSWSEO.png</a></td><td><a href="/plugins/seo">SEO</a></td></tr><tr><td><a href="/plugins/shop-the-look">Shop the Look</a></td><td>(WIP)</td><td>tbc</td><td><a href="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FJnyLSPNA7TGxIopDTOSb%2FGitBook%20Card%20NRSWSTL.png?alt=media&amp;token=9938f83c-f26a-49fd-995a-14a1a5955ad1">GitBook Card NRSWSTL.png</a></td><td><a href="/plugins/shop-the-look">Shop the Look</a></td></tr></tbody></table>


# Installation & Update

Anleitung und Hinweise zur Installation von norisk Shopware-Plugins

### Installation

#### Shopware Extension Store

Sofern das Plugin über den Shopware Plugin Store erworben wurde, findest du es unter `Erweiterungen > Meine Erweiterungen` gelistet und kannst die Installation per Mausklick durchführen.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FfEOgz36rbJHdl7ZqvOKM%2Fimage.png?alt=media&amp;token=5299a8af-dfa4-4511-8a04-86b23c9ff1af" alt=""><figcaption></figcaption></figure>

Weiterführende Informationen zur Verwaltung von Erweiterungen in deinem Shop findest du im Shopware 6 Handbuch:

{% embed url="<https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen#meine-plugins>" %}

#### Manuelle Installation

Um das Plugin manuell in deinen Shop hochzuladen und zu installieren, klickst du unter `Erweiterungen > Meine Erweiterungen` auf den Button `Erweiterung hochladen` und wählst die entsprechende Zip-Datei aus.

#### Composer-Installation

Das Plugin kann auch per Composer aus dem Shopware Store eingebunden werden. Den Link zum Repository findest du in deinem Shopware Account.

Für die Composer-Installation muss dein System dazu in der Lage sein, die Admin-Oberfläche zu "bauen". Dazu stellst du bitte sicher, dass die aktuelle NPM LTS Version (bspw. NodeJS 16 und NPM 8.x) installiert ist.

### Aktivierung

Stelle über den Toggle vor dem Plugin-Icon in der Übersicht deiner installierten Erweiterungen sicher, dass das Plugin aktiviert ist, damit alle Funktionen und Einstellungen verfügbar sind und auch angewendet werden.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2F2UAlgmWmBjIAAQqCxQYf%2Fimage.png?alt=media&amp;token=d9cec91e-bd72-4682-a2fb-604f5a076570" alt=""><figcaption></figcaption></figure>

### Update

Die Möglichkeiten, das Plugin auf eine neue Version zu aktualisieren, ergeben sich aus der gewählten Installationsmethode.

Bei Installationen über den **Plugin-Store und bei manuellen Updates** über das Hochladen von ZIP-Archiven, nimmst du die Aktualisierung über einen Mausklick in der Übersicht deiner installierten Plugins vor.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FgFwjC4s0OexuH9n6C2N9%2Fimage.png?alt=media&amp;token=8ff916a7-1d0d-4dd0-a389-5ace3a89326d" alt=""><figcaption></figcaption></figure>

Verwaltest du die Plugins deines Shops via **Composer**, so passt du die Versions-Requirements in deiner composer.json an und nimmst das Update dann über die Shopware CLI vor.

Weiterführende Informationen zu den Shopware CLI Commands für Plugins:\
<https://docs.shopware.com/en/shopware-6-en/tutorials-and-faq/shopware-cli#plugin>


# Konfiguration

Anleitung und Hinweise zur Konfiguration von norisk Shopware-Plugins

Die Einstellungen aller norisk Plugins haben wir für dich ganz übersichtlich an einem Ort zusammengefasst, so dass du zur Konfiguration und zur Pflege von Daten nicht erst die erforderlichen Seiten im Shopware Admin-UI suchen musst.

Wird ein neues norisk Plugin im Shopsystem installiert, so erweitern sich automatisch die verfügbaren Optionen im norisk Cockpit.

### norisk Cockpit

Das norisk Cockpit findest du im Shopware Hauptmenü unter `Einstellungen`.

Zur Übersicht aller norisk Plugin-Konfigurationen gelangst du mit einem Klick auf `Einstellungen > norisk Cockpit > Einstellungen`.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FTMjB9JJxUsxYoft5wJEo%2Fimage.png?alt=media&amp;token=734b79e0-e87e-4288-93bd-14f2d575f03a" alt=""><figcaption></figcaption></figure>

### norisk Einstellungen

Hier siehst du nun alle zur Konfiguration und Datenpflege verfügbaren Menüpunkte übersichtlich in Cards je Plugin aufgelistet.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2F2HWZYTpNPL8DXGnYr39t%2Fimage%20(3).png?alt=media&amp;token=cfaf502b-ef39-4553-8d94-1d37d2d30c75" alt=""><figcaption></figcaption></figure>

Zusätzlich stehen dir die Links zu den Plugin-Konfigurationsseiten auch in den standardmäßigen Shopware-Einstellungen zur Verfügung.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FOqKFnOWGZjf8EX5YCnYG%2Fimage.png?alt=media&amp;token=4a6a600d-f6f8-4f88-a373-85ebe8543cbc" alt=""><figcaption></figcaption></figure>

### Verkaufskanal-spezifische Konfiguration

Alle norisk Plugin-Konfigurationen kannst du grundsätzlich spezifisch für jeden Verkaufskanal vornehmen.

Hier folgen wir dem Shopware Admin-UI Standard. Einstellungen im Scope `Alle Verkaufskanäle` werden vererbt, insofern sie nicht durch separate Einstellungen für einen spezifischen Verkaufskanal abweichend definitiert sind.

Beispiel:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FqbJK5WBYdq2qKbb2TlDe%2Fimage.png?alt=media&amp;token=c393de2c-d673-4209-8058-05e862a51aab" alt=""><figcaption></figcaption></figure>


# norisk Foundation

norisk Foundation stellt die Basis aller norisk-Plugins für Shopware dar. Daneben enthält sie grundlegende Funktionen ebenso wie smarte Tools und Helper.

### Allgemeine Informationen

{% content-ref url="/pages/eBGtLLbAZIHWqB2pYGBq" %}
[Erste Schritte](/plugins/foundation/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/KRpFHVaVD8u47k5HQTiM" %}
[Anforderungen / Release Notes](/plugins/foundation/release-notes)
{% endcontent-ref %}

### Features & Konfiguration

{% content-ref url="/pages/bbQMuXrOp2Zi3Ys7szLW" %}
[Mail-Einstellungen](/plugins/foundation/mail-einstellungen)
{% endcontent-ref %}

{% content-ref url="/pages/K6S3cE4DilUTvUGFFdJd" %}
[Scheduled Tasks](/plugins/foundation/scheduled-tasks)
{% endcontent-ref %}

{% content-ref url="/pages/rAs2qODluxSWNYlWYJSY" %}
[Monitoring](/plugins/foundation/monitoring)
{% endcontent-ref %}

{% content-ref url="/pages/DlbAklmqePncmAQrHLsO" %}
[Konsolenbefehle (CLI)](/plugins/foundation/konsolenbefehle-cli)
{% endcontent-ref %}

{% content-ref url="/pages/Psh6QlW2PpUaiB5TOFgW" %}
[Admin-UI](/plugins/foundation/admin-ui)
{% endcontent-ref %}

{% content-ref url="/pages/tPtwmyeCd8nQyPvPVdxC" %}
[Entwickler-Ressourcen](/plugins/foundation/entwickler-ressourcen)
{% endcontent-ref %}

### Links & Demo

{% embed url="<https://store.shopware.com/de/noris37746490971/norisk-foundation.html>" %}


# Erste Schritte

Einrichtung des norisk Foundation-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Foundation-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb existieren keine Abhängigkeiten zu anderen Plugins.

#### Kompatibilitätsmatrix

| Plugin-Version | Release-Datum | Shopware-Version            |
| -------------- | ------------- | --------------------------- |
| 1.1.0          | 01.07.2026    | min 6.7.0.0 \| max 6.7.11.0 |
| 1.0.0          | 19.06.2026    | min 6.7.0.0 \| max 6.7.11.0 |

### Release Notes

<details>

<summary>1.2.0 (in development)</summary>

* Neu: [Loading Spinner](/plugins/foundation/entwickler-ressourcen#loading-spinner)

</details>

<details>

<summary>1.1.0 vom 01.07.2026</summary>

* Neu: [Conditional Config Fields](/plugins/foundation/entwickler-ressourcen#conditonal-config-fields)
* Neu: [Config Section Headings](/plugins/foundation/entwickler-ressourcen#config-section-headings)
* Neu: [reply-to Adresse für Formularbenachrichtigungen](/plugins/foundation/mail-einstellungen#formulare-reply-to-adresse)
* Neu: [Dark Mode für das Admin-UI](/plugins/foundation/admin-ui#dark-mode)
* Neu: [Monitoring von Plugin-Versionen](/plugins/foundation/monitoring/plugins)

</details>

<details>

<summary>1.0.0 vom 19.06.2026</summary>

* Initiales Release im Shopware Plugin-Store

</details>

### Shopware Plugin-Store

{% embed url="<https://store.shopware.com/de/noris37746490971/norisk-foundation.html>" %}


# Mail-Einstellungen

Erweiterungen für den Mailversand in Shopware 6

Die erweiterten Mail-Einstellungen des Foundation Plugins erreichst du über das [norisk Cockpit](/plugins/konfiguration#norisk-cockpit).

Hier findest du einen Menüeintrag `E-Mail Einstellungen` in der Card `norisk System`.

### E-Mail Absender

Um global oder verkaufskanalspezifisch abweichende E-Mail Absenderinformationen zu verwenden, definierst du diese in folgenden Einstellungen:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FKOfjh04dMGIo8UTHGnmK%2FBildschirmfoto%202026-05-21%20um%2010.54.37.png?alt=media&amp;token=fdb69f7f-7e86-410c-aa8b-96d64fa2a8e7" alt=""><figcaption></figcaption></figure>

Beispiel:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FcPOShkaiyewgU8lBij9d%2FBildschirmfoto%202026-05-21%20um%2011.00.36.png?alt=media&amp;token=2f7238ae-58cc-4f74-b53a-7d2f9b015168" alt=""><figcaption></figcaption></figure>

### List-Help-Header

Um transaktionale E-Mails per SMTP über einen 3rd-Party Anbieter wie beispielsweise INXMAIL zu versenden, ist oftmals die Angabe eines List-Help-Headers im Mail-Header erforderlich.

Beim List-Help-Header handelt es sich beispielsweise um einen Link auf eine Seite deines Shops, welche klassischerweise Erläuterungen zur Abmeldung, zu Formularen oder andere Erklärungen zur Rechtssicherheit und Transparenz enthält oder um eine E-Mail Adresse.

{% hint style="warning" %}
Der konfigurierte List-Help-Header wird nach einschließenden, eckigen Klammern und

* valider URL (bspw. `<https://shop.example.com/page>`) bzw.
* valider E-Mail Adresse (bspw. `<mailto:contact@example.com>`) geprüft.

Weitere mögliche Werte (gemäß Spezifikation in <https://datatracker.ietf.org/doc/html/rfc2369#section-3.1>) fügen wir auf Anfrage gerne hinzu.
{% endhint %}

Du kannst den List-Help-Header in dieser Einstellung hinterlegen:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2ForXU3vXMafltUSOStmPx%2FBildschirmfoto%202026-05-27%20um%2016.34.26.png?alt=media&amp;token=b45460e8-3058-4dc8-8aca-27771f1e860c" alt=""><figcaption></figcaption></figure>

Beispiel:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FeAgJU7B6pPTPFZIN2JJd%2FBildschirmfoto%202026-05-27%20um%2016.36.45.png?alt=media&amp;token=2e3c3fd5-1129-4981-8270-6a8310b72f1b" alt=""><figcaption></figcaption></figure>

### Formulare: reply-to Adresse

Standardmäßig ist bei E-Mail Benachrichtigungen an den Shopbetreiber über Formulare keine explizite reply-to Adresse im Mail-Header definiert. Das bedeutet, im E-Mail Client kann dem Kunden nicht direkt geantwortet werden.

Um die E-Mail Adresse des Formular-Absenders bei Kontakt- und Widerrufsformularen als reply-to Adresse der Benachrichtigungsmail zu hinterlegen, aktivierst du die entsprechende Option:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FEpOEWsyemycRlxnKPpeN%2FBildschirmfoto%202026-05-21%20um%2010.55.06.png?alt=media&amp;token=5ad169e2-ac99-4d9f-ad07-490fd52b8e01" alt=""><figcaption></figcaption></figure>

Beispiel:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FYSqJecVc440FSvBsadoL%2FBildschirmfoto%202026-05-21%20um%2011.02.56.png?alt=media&amp;token=f120e145-3ab9-40f0-ac9e-b997f66610f4" alt=""><figcaption></figcaption></figure>


# Scheduled Tasks

Komfortables Verwaltungsinterface der Shopware Scheduled Tasks

Die Scheduled Tasks-Verwaltung des Foundation-Plugins erreichst du über das [norisk Cockpit](/plugins/konfiguration#norisk-cockpit).

Hier findest du einen Menüeintrag `Scheduled Tasks` in der Card `norisk System`.

### Task-Übersicht

In diesem Interface erhältst du einen einfachen Überblick der im Shop registrierten geplanten Aufgaben (Scheduled Tasks).

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FrDjUM0GyyDv17JMMod7B%2FBildschirmfoto%202026-05-20%20um%2000.02.59.png?alt=media&amp;token=ddaed7a1-506c-477a-bb86-529b9c8be3ab" alt=""><figcaption></figcaption></figure>

### Task-Bearbeitung

Mittels Doppelklick in eine Tabellenzeile kannst du das Intervall sowie den nächsten Ausführungszeitpunkt des gewünschten Scheduled Tasks inline editieren.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FNhz2JfSVNKREjLHoUAjI%2FBildschirmfoto%202026-05-20%20um%2000.02.32.png?alt=media&amp;token=d37d7706-ea78-4e69-a47e-0acce6613a5e" alt=""><figcaption></figcaption></figure>

### Task-Ausführung & Statusänderung

Über das Kontextmenü hast du die Möglichkeit, einen Task direkt auszuführen oder dessen Status zu ändern.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FzgzNcMvDidFiLTr33sR9%2FBildschirmfoto%202026-05-20%20um%2000.03.51.png?alt=media&amp;token=d3644652-3a96-4ef2-b766-4ce0d1fcb56f" alt=""><figcaption></figcaption></figure>

### Friends of Shopware Tools

Diese Scheduled Tasks-Verwaltung basiert auf der Implementierung von "Friends of Shopware", welche wir für projektspezifische Erweiterungen in der norisk Foundation adaptiert haben.

Für eine umfangreiche Sammlung an nützlichen Werkzeugen, empfehlen wir dir das ebenfalls kostenlose, komplette Friends of Shopware Tools-Plugin: <https://store.shopware.com/de/frosh12599847132f/tools.html>


# Monitoring

Status und Performance deines Shops im Auge behalten

Die Monitoring-Auswertungen und -Einstellungen erreichst du über das [norisk Cockpit](/plugins/konfiguration#norisk-cockpit).

Hier findest du einen Menüeintrag `Monitoring` in der Card `norisk System`.

### Monitoring-Bereiche

{% content-ref url="/pages/daoVEz1hY7Tt1dnC1j4o" %}
[Plugins](/plugins/foundation/monitoring/plugins)
{% endcontent-ref %}


# Monitoring: Plugins

Aktualisierungen für Shopware-Plugins im Auge behalten.

Bei Shops mit vielen installierten Plugins oder dem Betrieb mehrerer Shopware-Instanzen, verpasst du leicht einmal neu verfügbare Plugin-Versionen.

Mit Hilfe des Plugin-Monitorings der norisk Foundation, siehst du veraltete Plugins auf einen Blick und kannst dich zusätzlich automatisiert benachrichtigen lassen.

### Plugin-Übersicht

Nachdem du das Monitoring-Tool über einen Klick auf den Menüeintrag `Monitoring` in der Card `norisk System` im [norisk Cockpit](/plugins/konfiguration#norisk-cockpit) geöffnet hast, gelangst du direkt zur Übersichtsseite.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FHV4q3DImZlqOzXi05bny%2FBildschirmfoto%202026-07-03%20um%2015.17.34.png?alt=media&amp;token=91c42575-fd42-4292-98b5-ede172eeeb15" alt=""><figcaption></figcaption></figure>

#### Am Shopware-Store anmelden

Damit die aktuellen Versionen deiner installierten Plugins aus dem Plugin-Store abgerufen werden können, ist (genauso wie für die standardmäßige Übersicht unter `Erweiterungen`) eine Anmeldung mit deinem Shopware-Account erforderlich.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2F16FeBn0ezT86UDnw52g8%2FBildschirmfoto%202026-07-01%20um%2020.25.08.png?alt=media&amp;token=643dd7e3-b0cc-425e-a318-bbd7c6363593" alt=""><figcaption></figcaption></figure>

Dazu klickst du auf den Button "Shopware Account verbinden", der dich zum regulären Tab `Shopware Account` im SW-Modul `Meine Erweiterungen` leitet.

### Mail-Benachrichtigung

Um dich automatisiert benachrichtigen zu lassen, wenn aktuellere Plugin-Versionen bereitstehen, kannst du im Tab `Einstellungen` eine entsprechende E-Mail Benachrichtigung aktivieren.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FgcqO7Ai39Uwg40kPlHDm%2FBildschirmfoto%202026-07-01%20um%2020.32.33.png?alt=media&amp;token=9a6b3522-710d-4b35-8c54-0bb3c12ec01f" alt=""><figcaption></figcaption></figure>

**Mailbenachrichtigung aktivieren**

Wenn aktiviert, erhältst du Scheduler-gesteuert eine E-Mail der veralteten Plugin-Versionen deines Shops.

**Benachrichtigungsintervall**

Du kannst wählen, in welchen Abständen du per E-Mail informiert werden möchtest. Zur Auswahl stehen folgende Intervalle:

* täglich
* wöchentlich
* monatlich

**E-Mail-Adresse**

An die hier angegebene Adresse wird die Benachrichtigungsmail gesendet.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FijAyYHJEK2qFI1Ltkyy7%2FBildschirmfoto%202026-07-01%20um%2020.38.16.png?alt=media&amp;token=374e3c14-e6c7-40d9-aaf1-ac58d571e6a0" alt=""><figcaption></figcaption></figure>


# Konsolenbefehle (CLI)

Erweiterte Funktionen für die Shopware 6 Kommandozeile

### Media Deletion Service

#### Medien in einem Media-Folder löschen

Mit dem Befehl `bin/console norisk:foundation:media:delete-folder <folderId>` kannst du einen spezifischen Medien-Ordner in Shopware vollständig und dauerhaft entfernen.

Als Argument übergibst du die UUID des Ordners. In der Ausführung werden nicht nur der angegebene Ordner selbst, sondern auch sämtliche darin enthaltenen Dateien sowie alle Unterordner inklusive deren Inhalte rekursiv gelöscht.

Im Gegensatz zur Löschung über die Admin-UI funktioniert der Befehl auch dann zuverlässig, wenn der Ordner eine abweichende oder nicht standardkonforme UUID besitzt.

Vor der Ausführung wird der Name des Ordners ermittelt und eine ausdrückliche Sicherheitsabfrage gestellt, in der du noch einmal bestätigst, dass alle Inhalte unwiderruflich entfernt werden sollen. Wird die Abfrage abgelehnt oder kann der Ordner mit der angegebenen UUID nicht gefunden werden, bricht der Befehl ab, ohne Änderungen vorzunehmen.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2Fpmj2x0g55z1mtboS2Ltr%2FBildschirmfoto%202026-05-20%20um%2011.20.54.png?alt=media&amp;token=9e47dbc0-e093-48c4-85e0-21c20fc3b832" alt=""><figcaption></figcaption></figure>

#### Medien im Wurzelverzeichnis löschen

Mit dem Befehl `bin/console norisk:foundation:media:delete-root-files` entfernst du alle Mediendateien aus dem Media-Wurzelverzeichnis, die keinem Ordner zugeordnet sind und somit direkt im Root-Bereich der Medienverwaltung liegen.

Zu Beginn der Operation wird die Anzahl der betroffenen Dateien ermittelt und ausgegeben; wurden keine entsprechenden Medien ermittelt, endet der Befehl ohne weitere Aktion.

Anschließend folgt eine Sicherheitsabfrage mit der Gesamtzahl der gefundenen Medien, die du bestätigst, um alle Dateien dauerhaft zu entfernen. Am Ende der Löschvorgangs erhältst du die Anzahl der gelöschten Medien als Bestätigung.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FV5XNCEsZ5qGodbAiOI7Y%2FBildschirmfoto%202026-05-20%20um%2011.22.13.png?alt=media&amp;token=4cea82c9-32dd-4c6c-874c-edf7d91f721a" alt=""><figcaption></figcaption></figure>


# Admin-UI

Erweiterungen der Standard Shopware 6 Admin-UI

### Dark Mode

Zur Reduzierung der Belastung der Augen bei längeren Arbeitssitzungen sowie der generellen Blendwirkung des Displays, hat sich ein optionaler Dark Mode für User-Interfaces etabliert. Auch Themen wie Datenfokus und Energieeffizienz stehen beim Arbeiten im Dark Mode im Vordergrund.

Um das Shopware 6 Admin-UI zwischen dem regulären und dem Dark Mode umzustellen, findest du in der Sidebar beim Benutzerprofil einen entsprechenden Toggle.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FgqBwLftMk4zM4itUfwQ7%2FBildschirmfoto%202026-05-21%20um%2011.49.47.png?alt=media&amp;token=179c45a2-3e20-482c-a4d0-a52abc846742" alt="" width="375"><figcaption></figcaption></figure>

Im Dark Mode wird das Interface automatisch auf eine dunkle Farbpalette umgestellt:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FpVW0k640nxRl3Hg1pfN7%2FBildschirmfoto%202026-05-21%20um%2011.50.18.png?alt=media&amp;token=9a83b1d4-0318-434b-8b15-9bbd59e701eb" alt=""><figcaption></figcaption></figure>


# Entwickler-Ressourcen

Nützliche Funktionen für Shopware 6 Entwickler

### Conditonal Config Fields

Standardmäßig lassen sich Plugin-Einstellungen, die über eine `config.xml` oder `customConfig.xml` definiert sind, nicht nach Bedingungen steuern.

Beispiel: Eine Plugin-Einstellung ist abhängig von einer anderen, d.h. sie soll nur dann im Admin-UI angezeigt werden, wenn die übergeordnete Einstellung "true" ist.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FB3M6kSQ45TH6qDiZkvyc%2FCPT2605200856-974x436.gif?alt=media&amp;token=740cec8e-9bbd-4b80-8b3e-6912863293ed" alt=""><figcaption></figcaption></figure>

Die "Conditional Config Fields" in der norisk Foundation erweitern den Standard hier mit den dafür notwendigen Markern und Attributen.

#### 1. Opt-in Signal in config.xml eintragen

Um das "Conditional Config Fields"-System generell zu aktivieren, fügst du in **genau einem** `<card>`-Block den Signal-Marker `noriskToggleProvider` ein.

```xml
<card>
    <component name="norisk-toggle-provider">
        <name>noriskToggleProvider</name>
    </component>
    <!-- weitere Felder -->
</card>
```

#### 2. Abhängige Felder markieren

Über das Attribut `<noriskConditionalField>` knüpfst du nun Felder an Bedingungen, wie in diesem Beispiel verdeutlicht:

```xml
<!-- Einfach: nur sichtbar wenn "active" true ist -->
<input-field type="text">
    <name>apiKey</name>
    <noriskConditionalField>active</noriskConditionalField>
</input-field>

<!-- AND: beide müssen true sein -->
<noriskConditionalField>active+showDetails</noriskConditionalField>

<!-- OR: mindestens eines muss true sein -->
<noriskConditionalField>modeA;modeB</noriskConditionalField>

<!-- Kombiniert: AND hat Vorrang vor OR → (a AND b) OR c -->
<noriskConditionalField>active+showDetails;legacyMode</noriskConditionalField>
```

#### Operatoren

| Operator | Bedeutung | Priorität |
| -------- | --------- | --------- |
| `+`      | AND       | höher     |
| `;`      | OR        | niedriger |

#### Einschränkungen

* Kein Wertevergleich möglich, nur Truthy/Falsy (`!!value`)
* Keine Klammerung, komplexe Ausdrücke ggfs. über ein Zwischentoggle-Feld lösen
* Felder bleiben im DOM (`v-show`, nicht `v-if`), Werte werden auch bei ausgeblendeten Feldern gespeichert

### Config Section Headings

Zur Strukturierung und Gliederung umfangreicher Konfigurationsmasken, können Bereichsüberschriften innerhalb von Cards eine gute Wahl sein.

Mit den "Config Section Headings" der norisk Foundation teilst du Cards mit fett formatierten Abschnittsüberschriften und Trennlinien in visuell getrennte Abschnitte auf.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FYOnbbBNzaW71EZgbbGYS%2FBildschirmfoto%202026-07-01%20um%2019.59.20.png?alt=media&amp;token=01710b44-8055-42f4-9add-15083c39a628" alt=""><figcaption></figcaption></figure>

Füge dazu eine `norisk-config-heading`-Komponente an beliebiger Stelle innerhalb eines `-Blocks` ein. Alle nachfolgenden Felder gehören visuell zu diesem Abschnitt.

#### Hinweise

* Die erste Überschrift einer Card hat keine obere Trennlinie, jede folgende Überschrift erhält eine durchgehende Trennlinie darüber.
* Verwende \<heading> statt \<label>\
  sw-system-config entnimmt Labels bei benutzerdefinierten \<component>-Elementen und übergibt sie an den umgebenden Inherit-Wrapper; ein Label würde daher stets leer ankommen.
* Die Komponente ist rein darstellend und speichert keinen Konfigurationswert.

### Loading Spinner

{% hint style="info" icon="traffic-cone" %}
norisk Foundation v1.2.0
{% endhint %}

Die Komponente `norisk-loading-spinner` wrapped den SW-nativen mt-loader und gibt die Möglichkeit, einen optionalen Text unter dem animierten Loading-Indikator auszugeben.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2Fm5DJbgMACGmjbWLveo3n%2FBildschirmfoto%202026-07-03%20um%2015.17.59.png?alt=media&amp;token=51e917c8-84c9-4fe0-9e75-ad1977ff5d0f" alt=""><figcaption></figcaption></figure>

#### Verwendung

| Prop      | Typ     | Default | Beschreibung                                                                  |
| --------- | ------- | ------- | ----------------------------------------------------------------------------- |
| isLoading | Boolean | true    | false → Komponente wird nicht gerendert                                       |
| label     | String  | ''      | Text unterhalb des Spinners. Wird ignoriert wenn der Default-Slot befüllt ist |
| size      | String  | '48px'  | Größe des Spinners, z.B. '16px', '32px', '48px'                               |
| minHeight | String  | ''      | Min-Höhe des Containers, z.B. '320px'. Standard ist padding-basiert           |

| Slot    | Beschreibung                                                         |
| ------- | -------------------------------------------------------------------- |
| default | Inhalt unterhalb des Spinners. Fällt auf label-Prop zurück wenn leer |

#### Beispiele

Nur Spinner

```xml
<norisk-loading-spinner v-if="isLoading" />
```

Spinner mit Label

```xml
<norisk-loading-spinner v-if="isLoading" :label="$tc('my-plugin.loading')" />
```

Steuerung per Prop statt v-if

```xml
<norisk-loading-spinner :is-loading="isLoading" :label="$tc('my-plugin.loading')" />
```

Fixe Höhe (z.B. in einer Listing-Area)

```xml
<norisk-loading-spinner v-if="isLoading" min-height="320px" />
```

Custom Slot-Inhalt (z.B. mit Abbrechen-Button)

```xml
<norisk-loading-spinner v-if="isLoading">
    <p>{{ $tc('my-plugin.loading') }}</p>
    <mt-button @click="cancel">{{ $tc('global.default.cancel') }}</mt-button>
</norisk-loading-spinner>
```


# norisk Product Features

{% hint style="info" %}
Das norisk Product Features-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/WeIB8APPNUzQ9zXhwayO" %}
[Erste Schritte](/plugins/product-features/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/A2BkPrDaikhFA0Uusb8l" %}
[Anforderungen / Release Notes](/plugins/product-features/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk Product Features-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Product Features-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Product Features-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk Dynamic Pages

{% hint style="info" %}
Das norisk Dynamic Pages-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/D26lDPEOqUrDe08o0BPZ" %}
[Erste Schritte](/plugins/dynamic-pages/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/RMd3dHLO2RaVydr0meqN" %}
[Anforderungen / Release Notes](/plugins/dynamic-pages/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk Dynamic Pages-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Dynamic Pages-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Dynamic Pages-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk Manufacturers

norisk Manufacturers erweitert die Shopware Hersteller-Informationen und stellt konfigurierbare Übersichts- und Detailseiten für Hersteller und Marken zur Verfügung.

{% hint style="info" %}
Das norisk Manufacturers-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/ydMyokWyRKYbyhtkzNMm" %}
[Erste Schritte](/plugins/manufacturers/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/skU6HwOv8Dqz5P02XGtb" %}
[Anforderungen / Release Notes](/plugins/manufacturers/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk Manufacturers-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Manufacturers-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Manufacturers-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk Out of Stock

norisk Out of Stock beinhaltet konfigurierbare Verfügbarkeitsbenachrichtigungen mit optionalem DOI und FOMO-Funktionalitäten wie Visualisierung knapper Artikelbestände.

{% hint style="info" %}
Das norisk Out of Stock-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/rK6uan8LFutKWTt1Vwmg" %}
[Erste Schritte](/plugins/out-of-stock/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/sVKpqsHfddkT34Jx6jYK" %}
[Anforderungen / Release Notes](/plugins/out-of-stock/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk Out of Stock-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Out of Stock-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Out of Stock-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk Delivery Times

{% hint style="info" %}
Das norisk Delivery Times-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/9GvCAYLDMR57f0T1E1u1" %}
[Erste Schritte](/plugins/delivery-times/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/JzrKgmGZRnKRR7nYj3QK" %}
[Anforderungen / Release Notes](/plugins/delivery-times/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk Delivery Times-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Delivery Times-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Delivery Times-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk Exporter

{% hint style="info" %}
Das norisk Exporter-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/0U2YoWNsmsOXDbG4yGyg" %}
[Erste Schritte](/plugins/exporter/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/4xQdhdOAjHP3j43nui0i" %}
[Anforderungen / Release Notes](/plugins/exporter/release-notes)
{% endcontent-ref %}

### Features & Konfiguration

{% content-ref url="/pages/yVPMqiEUWGkhoKwIXdzt" %}
[Feed-Template-Builder](/plugins/exporter/feed-template-builder)
{% endcontent-ref %}

{% content-ref url="/pages/sb00922vEeiHfCjNM9qj" %}
[Export-Automatisierung](/plugins/exporter/export-automatisierung)
{% endcontent-ref %}


# Erste Schritte

Einrichtung des norisk Exporter-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Exporter-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Exporter-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# Feed-Template-Builder

Komplexe Produkt-Feeds schnell zusammenklicken

norisk Exporter erweitert die standardmäßige Erfassungsmaske von Feed-Templates zu einem komfortablen Template-Builder, in welchem du mit wenigen Klicks umfangreiche Produkt-Feeds anlegst.

### Feed anlegen

Um einen neuen Produkt-Feed mit dem Feed-Template-Builder bearbeiten zu können, wählst du bei der Erstellung des Feeds (Verkaufskanal vom Typ "Produktvergleich") eines der norisk Exporter Feed-Templates aus.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FZGZ6J4eP5Sbycpe6lKak%2FBildschirmfoto%202026-06-09%20um%2015.46.32.png?alt=media&amp;token=f927e6aa-7564-4100-aca0-c0a13b676694" alt=""><figcaption></figcaption></figure>

### Feed konfigurieren

Neben der standardmäßigen Feed-Einstellungen, steht dir eine zusätzliche Card "Erweiterte Konfiguration" mit den nachfolgend dargestellten Optionen zur Verfügung.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FHuRvEkdG2as0QskZfMHb%2FBildschirmfoto%202026-06-09%20um%2015.50.43.png?alt=media&amp;token=79c91b3a-3df6-4fa7-bdfa-143fd54c1f61" alt=""><figcaption></figcaption></figure>

**Hauptprodukte und Varianten exportieren**

Ergänzend zur Shopware Feed-Option "Varianten als eigene Produkte exportieren", kannst du über diese sowohl Hauptprodukte als auch Varianten im Produkt-Feed auszuspielen.

### Feed bearbeiten

Nach dem Speichern eines neuen Feeds bzw. nach dem Öffnen eines bestehenden Feeds mit norisk Exporter Feed-Template, findest du im Tab "Template" anstelle des reinen Template-Codes nun unseren Feed-Template-Builder.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FcBkJaGsnF3MEMSTAHgMU%2FBildschirmfoto%202026-06-09%20um%2015.57.43.png?alt=media&amp;token=2afe91ee-8406-45b9-9326-a7d23ee3561a" alt=""><figcaption></figcaption></figure>

#### **Toggle "Feed anzeigen/Template Builder"**

Im Interface kannst du jederzeit zwischen der Feed-Ansicht (Code) oder dem Template-Builder umschalten.

Mit dem Template-Builder verwaltete Produkt-Feeds lassen sich jedoch ausschließlich mit dem Builder und nicht direkt im Code bearbeiten.

Builder-Ansicht:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FoNwy8pJFBnEfPjVu0Cv4%2FBildschirmfoto%202026-06-09%20um%2016.08.33.png?alt=media&amp;token=552d3b1d-7cda-4eea-b639-2f78bb3472d7" alt=""><figcaption></figcaption></figure>

Feed-Ansicht:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FvuObd9FuLGL7yCjIiozI%2FBildschirmfoto%202026-06-09%20um%2016.09.12.png?alt=media&amp;token=59db7b32-206a-4d56-9613-a78c79496f8b" alt=""><figcaption></figcaption></figure>

#### **Feld hinzufügen**

Über einen Klick auf die Schaltfläche "Feld hinzufügen" wird ein leerer Eintrag in der darüberstehenden Feldliste erzeugt.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2F50CMZqkV9RS33SwXkLQ2%2FBildschirmfoto%202026-06-09%20um%2016.11.01.png?alt=media&amp;token=31a9a2b5-9ad6-4a86-9400-0aba5b182d4b" alt=""><figcaption></figcaption></figure>

**Header:**

In der Spalte "Header" legst du den Feldnamen fest, so wie er in deiner Feed-Datei (CSV, XML) verwendet werden soll.

**Typ:**

Für die Definition des Feldwerts ist es erforderlich, zuerst einen Feldtyp zu bestimmen. Verfügbare Feldtypen sind:

* Produktdaten
* Produktbild
* SEO-URL
* Produkteigenschaft
* Zusatzfeld
* Statischer Text
* Twig-Ausdruck

**Konfiguration:**

In der Spalte "Konfiguration" legst du den konkreten Feldwert bzw. dessen Ermittlung fest. Die Eingabemöglichkeiten sind abhängig vom gewählten Feldtyp (siehe Kap. [Feld-Typen](#feld-typen)).

#### **Felder organisieren**

**Reihenfolge ändern:**

Die Felder des Feeds lassen sich bei gedrückter Maustaste auf dem Icon links vor dem Namen des gewünschten Eintrags per Drag & Drop nach oben oder unten verschieben.

**Feld löschen:**

Während du dich mit dem Mauszeiger über einem Feldeintrag befindest (hover), wird am rechten Rand der Zeile ein Löschen-Icon eingeblendest, auf welches du zum Entfernen des entsprechenden Eintrags klickst.

{% hint style="warning" %}
Die Einstellungen im Template-Builder werden erst nach dem Speichern der Feed-Konfiguration über den blauen Speichern-Button in der Topbar übernommen.
{% endhint %}

#### **Feed testen**

Durch einen Klick auf den "Feed testen"-Button führst du einen Syntax-Check des Templates durch, der bspw. bei der Verwendung von komplexen Twig-Ausdrücken sinnvoll ist.

#### **Vorschau generieren**

Eine Vorschau der tatsächlichen Feed-Daten erhältst du durch einen Klick auf den "Vorschau generieren"-Button angezeigt:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FGpxdHICFVDo1wSH7t4bx%2FBildschirmfoto%202026-06-09%20um%2016.27.03.png?alt=media&amp;token=ccbe3597-75c8-493d-b3d1-bf229151f7b5" alt=""><figcaption></figcaption></figure>

### Feld-Typen

Folgende Feld-Typen stehen dir im norisk Exporter-Plugin aktuell zur Verfügung:

#### **Produktdaten**

| Konfiguration (Wert)       | Twig-Variable                                 | Bemerkung |
| -------------------------- | --------------------------------------------- | --------- |
| Aktiv                      | `product.active`                              |           |
| ID (UUID)                  | `product.id`                                  |           |
| Artikelnummer              | `product.productNumber`                       |           |
| Name                       | `product.translated.name`                     |           |
| Beschreibung               | `product.translated.description`              |           |
| EAN                        | `product.ean`                                 |           |
| Herstellernummer           | `product.manufacturerNumber`                  |           |
| Abverkauf                  | `product.isCloseout`                          |           |
| Topseller                  | `product.markAsTopseller`                     |           |
| Versandkostenfrei          | `product.shippingFree`                        |           |
| Erscheinungsdatum          | `product.releaseDate`                         |           |
| Bestand                    | `product.stock`                               |           |
| Verfügbarer Bestand        | `product.availableStock`                      |           |
| Hauptprodukt-ID            | `product.parentId`                            |           |
| Hauptprodukt-Artikelnummer | `product.parent.productNumber`                |           |
| Hersteller: Name           | `product.manufacturer.translated.name`        |           |
| Hersteller: Bild           | `product.manufacturer.media.url`              |           |
| Hersteller: Beschreibung   | `product.manufacturer.translated.description` |           |
| Hersteller: Link           | `product.manufacturer.link`                   |           |
| Kategorien (alle)          |                                               |           |
| Kategorie 1 .. 5           | (aus Breadcrumbs gesliced)                    |           |
| Steuergruppe               | `product.tax.name`                            |           |
| Steuersatz                 | `product.tax.taxRate`                         |           |
| Preis (brutto)             | `product.calculatedCheapestPrice.unitPrice`   |           |
| Listenpreis (brutto)       | `product.calculatedCheapestPrice.listPrice`   |           |
| Lieferzeit (min)           | `product.deliveryTime.min`                    |           |
| Lieferzeit (max)           | `product.deliveryTime.max`                    |           |
| Höhe                       | `product.height`                              |           |
| Länge                      | `product.length`                              |           |
| Breite                     | `product.width`                               |           |
| Gewicht                    | `product.weight`                              |           |

#### **Produktbild**

Als Produktbild kann aktuell lediglich das Cover-Bild des Produkts (`product.cover.media.url`) ausgewählt werden.

#### **SEO-URL**

| Konfiguration      | Twig-Variable                                         | Bemerkung              |
| ------------------ | ----------------------------------------------------- | ---------------------- |
| Produktdetailseite | `seoUrl('frontend.detail.page', PRODUKT)`             | URL zum Produkt        |
| Kategorieseite     | `seoUrl('frontend.navigation.page', ERSTE_KATEGORIE)` | URL zur Hauptkategorie |

#### **Produkteigenschaft**

Beim Feldtyp "Produkteigenschaft" lassen sich alle Eigenschaften (Properties) des Shops auswählen.

#### **Zusatzfeld**

Beim Feldtyp "Zusatzfeld" lassen sich alle Zusatzfelder (Custom Fields) im Produkt-Scope auswählen. Außerdem kannst du einen Standardwert festlegen, welcher im Feed ausgegeben wird, falls das Produkt keine Daten im entsprechenden Zusatzfeld hinterlegt hat.

#### **Statischer Text**

Den Feld-Typ "Statischer Text" verwendest du, wenn denselben, fixen Wert bei jeder Zeile deines Produkt-Feeds ausgeben möchtest.

#### **Twig-Ausdruck**

Der Feldtyp "Twig-Ausdruck" ermöglicht es dir, komplexe Feldberechnungen vorzunehmen und Entscheidungslogiken in deinem Feed-Template zu verwenden. Hier sind bspw. auch if-Blöcke verfügbar.

Außerdem kannst du Produktinformationen, die das Plugin nicht bereits im Typ "Produktdaten" anbietet, ganz einfach selbst im Feed implementieren.

### Feed-Migration

Das Plugin identifiziert Produkt-Feeds, die mit dem Feed-Template-Builder verwaltet werden an einem spezifischen Kommentar in der ersten Zeile deiner Template-Kopfzeile.

Bestehende Produkt-Feeds, die du manuell erstellt hast, lassen sich als Template-Builder-kompatibel kennzeichnen, indem du `{#- norisk exporter template -#}` an der beschriebenen Stelle einfügst und die Feed-Konfiguration speicherst.

Der Template Builder versucht dann, deine Feldeinträge zu erkennen. Nicht erkannte Felder werden als Einträge vom Typ "Twig-Ausdruck" angezeigt.

{% hint style="danger" %}
Starte die Migration unbedingt mit einem duplizierten Feed und nicht mit deinen Livedaten.
{% endhint %}


# Export-Automatisierung

Shopware-Exporte automatisch generieren und per Link herunterladen

norisk Exporter bietet dir die Möglichkeit, sämtliche Exporte aus dem Shopware Import/Export-Modul per Scheduler zu erzeugen und über einen öffentlichen Link herunterzuladen oder von 3rd-Party Tools verarbeiten zu lassen.

### Übersicht

Die Verwaltung der automatisierten Exporte erreichst du über das [norisk Cockpit](https://docs.norisk.group/plugins/konfiguration#norisk-cockpit).

Hier findest du einen Menüeintrag `Export-Automatisierung` in der Card `norisk System`, der dich zur Übersicht der Export-Automatisierungen leitet.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FUlLUDcZnzklRhuSjNpjU%2FBildschirmfoto%202026-06-09%20um%2017.54.11.png?alt=media&amp;token=9f1d0f86-3dad-4d7a-87f0-1eef9286f298" alt=""><figcaption></figcaption></figure>

### Automatisierung anlegen

Durch einen Klick auf den Button "Neuer geplanter Export" gelangst du zur Erfassungsmaske deines neuen, automatisierten Exports.

#### Allgemein

In der Card "Allgemein" konfigurierst du die grundlegenden Eigenschaften des Exports:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FQ5VEOoYJj5dXPhIMRWWs%2FBildschirmfoto%202026-06-09%20um%2018.00.49.png?alt=media&amp;token=475a4ead-3cd6-4ae0-babb-c29ee6f677b3" alt=""><figcaption></figcaption></figure>

**Name:**

Bezeichnung des Exports (Pflichtfeld).

**Exportprofil:**

Auswahl des zu automatisierenden Shopware-Exports (Pflichtfeld).

**Intervall:**

Häufigkeit der Export-Generierung.

**Aktiv:**

Toggle zur Aktivierung/Deaktivierung der Export-Automatisierung.

#### Download

Standardmäßig werden die automatisch generierten Exportdateien im Dateisystem auf dem Server abgelegt (es wird der Shopware Import/Export-Modul in seiner Standardfunktionalität verwendet).

Sollen die Exporte zusätzlich von extern heruntergeladen werden können, so kannst du das in der Card "Download-Freigabe" konfigurieren:

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2F921jJu2yXvnWXsAXzAI6%2FBildschirmfoto%202026-06-09%20um%2018.07.30.png?alt=media&amp;token=c62c2dba-44f2-4f0d-8fd2-7ac7fe227599" alt=""><figcaption></figcaption></figure>

**Download aktivieren:**

Toggle, um das Herunterladen von Export-Dateien zu ermöglichen.

**Zugriffsschlüssel:**

Sicherheitsparamter für den Downloadlink.

**Download-URL:**

Kompletter Link zur Exportdatei inkl. Zugriffsschlüssel.

### Automatisierung bearbeiten

Angelegte Exporte kannst du über das Kontextmenü in der Übersicht bearbeiten oder löschen.

<figure><img src="https://3312371281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcq9ZYdJ14QltXOPTNi4G%2Fuploads%2FODWNg6s3isBRwoiKCJOp%2FBildschirmfoto%202026-06-09%20um%2018.23.23.png?alt=media&amp;token=34265a23-dd94-40a7-b329-945bfdc03a9f" alt=""><figcaption></figcaption></figure>


# norisk B2B-Suite

norisk B2B-Suite erweitert die Shopware 6 Standard-Funktionalität mit verschiedenen spezifischen Lösungen, um B2B-Anforderungen individuell konfigurierbar zur Verfügung zu stellen.

{% hint style="info" %}
Das norisk B2B-Suite-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/mfC2nLRyW8M0zcHMPzz5" %}
[Erste Schritte](/plugins/b2b-suite/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/cbFm7fv9S8c33GjvqG2u" %}
[Anforderungen / Release Notes](/plugins/b2b-suite/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk B2B-Suite-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk B2B-Suite-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des B2B-Suite-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk i18n

norisk i18n beinhaltet einen umfangreichen Länder-Sprachen-Währungswechsler sowie verschiedene nützliche Werkzeuge für die Internationalisierung von Onlineshops.

{% hint style="info" %}
Das norisk i18n-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/K9HfO8lKD8RKSI0u8DJA" %}
[Erste Schritte](/plugins/i18n/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/GTJVCCVsP8qvIn9qIvuR" %}
[Anforderungen / Release Notes](/plugins/i18n/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk i18n-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk i18n-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des i18n-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk SEO

{% hint style="info" %}
Das norisk SEO-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/9GvCAYLDMR57f0T1E1u1" %}
[Erste Schritte](/plugins/delivery-times/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/JzrKgmGZRnKRR7nYj3QK" %}
[Anforderungen / Release Notes](/plugins/delivery-times/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk SEO-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk SEO-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des SEO-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk Shop the Look

{% hint style="info" %}
Das norisk Shop the Look-Plugin befindet sich aktuell in Entwicklung.
{% endhint %}

### Allgemeine Informationen

{% content-ref url="/pages/9GvCAYLDMR57f0T1E1u1" %}
[Erste Schritte](/plugins/delivery-times/erste-schritte)
{% endcontent-ref %}

{% content-ref url="/pages/JzrKgmGZRnKRR7nYj3QK" %}
[Anforderungen / Release Notes](/plugins/delivery-times/release-notes)
{% endcontent-ref %}

### Features & Konfiguration


# Erste Schritte

Einrichtung des norisk Shop the Look-Plugins

### Installation & Update

Die Anleitung zu Installation und Update von norisk Plugins findest du hier:

{% content-ref url="/pages/DJT67dMHg7xEHIRGl25Q" %}
[Installation & Update](/plugins/installation)
{% endcontent-ref %}

### Konfiguration

Die Anleitung zur Konfiguration von norisk Plugins findest du hier:

{% content-ref url="/pages/jCWu45a0jBoTlhCcX4lr" %}
[Konfiguration](/plugins/konfiguration)
{% endcontent-ref %}


# Anforderungen / Release Notes

Anforderungen und Changelog des norisk Shop the Look-Plugins

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Shop the Look-Plugins existieren folgende Abhängigkeiten zu anderen Plugins:

| Plugin            | Plugin-Version | Bemerkungen |
| ----------------- | -------------- | ----------- |
| norisk Foundation | 1.1.0          | -           |

#### Kompatibilitätsmatrix

| Plugin-Version | Release | Shopware | norisk Foundation |
| -------------- | ------- | -------- | ----------------- |
| 1.0.0          | WIP     | ?        | 1.1.0             |

### Release Notes

<details>

<summary>1.0.0 vom (WIP)</summary>

* Initiales Release im Shopware Plugin-Store

</details>


# norisk Base Theme

Page Desc

Introtext

{% content-ref url="/pages/zCtv6HoeyHJOeW1SFmVp" %}
[Broken mention](broken://pages/zCtv6HoeyHJOeW1SFmVp)
{% endcontent-ref %}


# Installation & Update

Anleitung und Hinweise zur Installation des norisk Base Themes für Shopware 6

### Installation

#### Shopware Extension Store

Sofern das Theme über den Shopware Plugin Store erworben wurde, findest du es unter `Erweiterungen > Meine Erweiterungen > Themes` gelistet und kannst die Installation per Mausklick durchführen.

Weiterführende Informationen zur Verwaltung von Erweiterungen in deinem Shop findest du im Shopware 6 Handbuch:

{% embed url="<https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen#meine-plugins>" %}

#### Manuelle Installation

Um das Theme manuell in deinen Shop hochzuladen und zu installieren, klickst du unter `Erweiterungen > Meine Erweiterungen` auf den Button `Erweiterung hochladen` und wählst die entsprechende Zip-Datei aus.

#### Composer-Installation

Das Theme kann auch per Composer aus dem Shopware Store eingebunden werden:

`composer require store.shopware.com/XYZ`

Für die Composer-Installation muss dein System dazu in der Lage sein, die Admin-Oberfläche zu "bauen". Dazu stellst du bitte sicher, dass die aktuelle NPM LTS Version (bspw. NodeJS 16 und NPM 8.x) installiert ist.

### Update

Die Möglichkeiten, das Theme auf eine neue Version zu aktualisieren, ergeben sich aus der gewählten Installationsmethode.

Bei Fragen, nimm gerne Kontakt mit dem norisk Support auf.

### Systemvoraussetzungen & Kompatibilität

#### Abhängigkeiten

Für die Installation und den Betrieb des Theme existieren keine Abhängigkeiten zu anderen Plugins.

#### Kompatibilitätsmatrix

| Plugin-Version | Shopware-Version | Bemerkungen |
| -------------- | ---------------- | ----------- |
| 1.0            | tbd.             | -           |
|                |                  |             |
|                |                  |             |


# Theme, Duplikate & Zuweisung


# Erweiterungen


# Theme & Tokens


# Erlebniswelten


# Startseite & Landingpages


# Kategorien


# Produkte


# Checkout


# Weitere Bereiche


# Medien & Allgemein


# Header


# Footer


# Content


# Listing (PLP)


# Detail (PDP)


# Pages


# Content


# Hero


# Content-Teaser


# Content-Slider


# Image-Teaser


# Text (erweitert)


# Icon-Text-Galerie


# Bild-Slider (erweitert)


# HTML + Twig


# Commerce


# Kategorie-Slider


# Produkt-Slider


# Produkt-Slider (PDP-X-Selling)


# Produkt-Slider (mit Teaser)


# Buy Box (erweitert)


# Galerie PDP (erweitert)


# Shop the Look (Produktliste)


# Shop the Look (Hotspots)


# Review-Slider


# Struktur


# Spalten

Das SWBT bringt für den Layout-Editor verschiedene CMS-Blöcke mit, welche dir die Strukturierung von Sektionen in Spalten ermöglichen.

Du findest die Spalten-Blöcke in der Kategorie "norisk Struktur (Spalten)".

<figure><img src="https://389517579-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnB0wyHzJKUlzESAmhSJC%2Fuploads%2FQLgCEZp6vCc9P57trjvj%2Fswbt_cms_spalten_index.gif?alt=media&amp;token=a16002a4-371e-4547-9d60-de9acce3ff88" alt=""><figcaption></figcaption></figure>

### Vordefinierte Blöcke

Folgende Spalten-Blöcke stehen dir zur Verfügung:

* 1-spaltig
  * Eine Spalte
  * Eine Spalte (ausbrechend)
* 2-spaltig
  * Zwei Spalten
  * Zwei Spalten (ausbrechend)
  * Zwei Spalten (links ausbrechend)
  * Zwei Spalten (rechts ausbrechend)
  * Zwei Spalten (5-7)
  * Zwei Spalten (7-5)
  * Zwei Spalten (4-8)
  * Zwei Spalten (8-4)
  * Zwei Spalten (3-9)
  * Zwei Spalten (9-3)
* 3-spaltig
  * Drei Spalten
  * Drei Spalten (2-2-8)
  * Drei Spalten (8-2-2)
  * Drei Spalten (8-2-2)
  * Drei Spalten (3-3-6)
  * Drei Spalten (3-6-3)
  * Drei Spalten (6-3-3)
* 3+ Spalten
  * Vier Spalten
  * Fünf Spalten
  * Sechs Spalten

{% hint style="info" %}
Zusätzliche und spezifischere Spaltenaufteilungen, bspw. zur Verwendung im Footer oder auf Landingpages, findest du hier:

* [Footer](/shopware-base-theme/cms/struktur/footer)
* [Grids + Spacer](/shopware-base-theme/cms/struktur/grids-spacer)
  {% endhint %}

### Weitere Einstellungen

Die Spalten kannst du über folgende Block-Einstellungen im Akkordeon-Tab "norisk Custom Config" noch detaillierter konfigurieren:

{% columns %}
{% column %}

<div align="left"><figure><img src="https://389517579-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnB0wyHzJKUlzESAmhSJC%2Fuploads%2FwDXacZagiiiN1gDojlCL%2Fimage.png?alt=media&amp;token=50b5c3ef-0b0c-4de3-98ec-3ff368874b0f" alt=""><figcaption></figcaption></figure></div>
{% endcolumn %}

{% column %}
**Gutter deaktivieren**

Die inneren Abstände zwischen den Spalten werden komplett entfernt.
{% endcolumn %}
{% endcolumns %}


# Zeilen


# Grids + Spacer

Das SWBT bringt verschiedene CMS-Blöcke für den Layout-Editor mit, welche dir zusätzliche Möglichkeiten für die Strukturierung von CMS-Pages geben.

Die findest die vordefinierten Grids und den Spacer-Block in der Kategorie "norisk Struktur (Grids)".

(IMAGE)

### Vordefinierte Grids

{% columns %}
{% column %}
Bild
{% endcolumn %}

{% column %}
Text
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
Bild
{% endcolumn %}

{% column %}
Text
{% endcolumn %}
{% endcolumns %}

### Spacer

Mit Hilfe des Spacer-Blocks kannst du die Abstände zwischen den CMS-Blöcken festlegen.

(IMAGE)

Unterstützte Abstandswerte sind:

* Manuelle (numerische) Werte in px oder rem für
  * mobile
  * Desktop
* Abstände aus dem Token-based Design System gem. Token-Name


# Footer


# Widgets


# Menü-Widget


# Sprachauswahl-Widget


# Coupon-Widget


# USP-Widget


# Newsletter-Teaser


# Weitere Elemente


# Willkommen bei der norisk GmbH

Hier finden Sie eine Übersicht über die von der norisk GmbH entwickelten OXID Module

{% content-ref url="/pages/-MbaiyT4kTsFkZj1MrRN" %}
[nrGoogleTagManager](/oxid/noriskmodules/nrgtm)
{% endcontent-ref %}

{% content-ref url="/pages/-MbahogeVYy9pftdp6d6" %}
[nrProductsUp](/oxid/noriskmodules/nrproductsup)
{% endcontent-ref %}


# nrGoogleTagManager

Das nrGoogleTagManager-Modul (nrGTM) liefert dem Shop-Betreiber eine Vielzahl von relevanten Daten über Benutzer-Interaktionen auf allen Seiten des OXID-Shops. Das Modul integriert diese Inhalte durch einen Tag-Manager-Container und die dataLayer-API auf der Zielseite. Es können pro Seitentyp verschiedene Arten **von Informationen** übergeben werden. Wie zum Beispiel:

* Artikelliste/Suchergebnisse: Block der ersten 5 SKUs (=Stock Keeping Units), die Anzahl ist konfigurierbar. Suchergebnisanzahl & Suchphrase
* Artikeldetail: Alle Artike-Informationen wie IDs, Preis, Hersteller, Pfad, Varianten-Bestand etc.
* AddToCart: Weitergabe der Artikel-Informationen bei Hinzufügen eines Artikels zum Warenkorb
* Warenkorb: Weitergabe aller (im Warenkorb befindlichen) Artikel-Informationen beim Aufruf des Warenkorbs
* Aktueller Warenkorb (Current Basket): Weitergabe aller (im Warenkorb befindlichen) Artikel-Informationen bei jedem Seitenaufruf
* Thankyou: Alle Informationen der gekauften Artikel inkl. aller Bestellungs-Informationen auf der Danke-Seite nach Bestell-Abschluss
* Generell: Mehrere Benutzerdaten (OXID des Shop-Benutzers, Newsletter-Status, Login-Status, E-Mail-Adresse und Neukunden-Status.)

Alle diese Informationen werden in die **DataLayer-API** (Schnittstelle) gepusht und können als **JavaScript oder Image-Tag-Variablen** weitergegeben werden. Diese gesammelten Benutzerdaten werden als Daten-Block für die Verwendung im Google Tag Manager zur Verfügung gestellt, so dass sie in verschiedenen Tags eingebunden werden können. Das Modul wird **initial einmal konfiguriert** und ist direkt danach nutzbar.

**Wichtiger Datenschutz-Hinweis**\
Bestimmte personenbezogene Benutzerdaten, die aus der Sicht der Datenschutzgrundverordnung (DSGVO) sensibel sind, sind standardmäßig vom dataLayer ausgeschlossen. Für Shops, die für die Weitergabe dieser Daten einen Opt-In vom Nutzer einholen, kann die Weitergabe dieser Daten jedoch manuell aktiviert werden. Hierunter fallen beispielsweise

* E-Mail-Adresse des eingeloggten Nutzers (gehashed/ungehashed)
* Geburtsdatum & Geschlecht des eingeloggten Nutzers
* Kundennummer des eingeloggten Nutzers


# User Guide

Hier erfährst Du, wie Du das nrGoogleTagManager konfigurieren kannst und welche Optionen sich daraus ergeben.


# Konfiguration im Backend

Die Konfiguration des Moduls erfolgt im Shop-Backend über norisk-Module → Google Tag Manager → Einstellungen:

![](https://731876186-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fmodule%2F-Mbanf0E3cbVUYJiSPGZ%2F-MbaoVaA92ybYtJ3etx6%2F0.png?generation=1623075200121100\&alt=media)\
![](https://731876186-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fmodule%2F-Mbanf0E3cbVUYJiSPGZ%2F-MbaoVaBY6-2vpLHGH4-%2F1.png?generation=1623075200138380\&alt=media)

Nach dem Klick auf "Einstellungen" öffnet sich das im folgenden Screenshot zu sehende Konfigurationsmenü, welches in die drei Tabs 1) Allgemein, 2) Detailkonfiguration und 3) Enhanced E-Commerce unterteilt ist.

<div align="left"><img src="https://731876186-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fmodule%2F-Mbanf0E3cbVUYJiSPGZ%2F-MbaoVaCzPCrfJb7zW7Y%2F2.png?generation=1623075200131458&amp;alt=media" alt=""></div>

###


# Tab Allgemein

Im oben Tab Allgemein existieren die folgenden Konfigurationsmöglichkeiten zur Steuerung des Google Tag Manager Containers und des dataLayers für den jeweiligen Bereich des Shops:

* Aktiv: Diese Checkbox anwählen, damit der Container und der dataLayer angezeigt wird (nur im Produktivmodus).
* Container-ID: Hinterlegen Sie hier Ihre Container-ID (im Format GTM-XXXXXX).
* Startseite: Aktivieren Sie diese Box, um das GoogleTag auf der Startseite des Shops zu integrieren.
* Artikeldetail: Aktivieren Sie diese Box, um GTM Container und dataLayer auf der Artikeldetailseite des Shops zu integrieren.
* Artikellisten: Aktivieren Sie diese Box, um GTM Container und dataLayer auf allen Artikellisten des Shops zu integrieren.
* Suchergebnis: Aktivieren Sie diese Box, um GTM Container und dataLayer auf Suchergebnis-Seiten zu integrieren.
* Warenkorb: Aktivieren Sie diese Box, um GTM Container und dataLayer auf der Warenkorb-Seite zu integrieren.
* Checkout: Aktivieren Sie diese Box, um GTM Container und dataLayer auf den User-, Payment-, Order- und Thankyou-Seiten (also den Seiten des Checkout-Prozesses) zu integrieren.

Alle anderen Seiten: Aktivieren Sie diese Box, um GTM Container und dataLayer auf allen restlichen Seiten des Shops zu integrieren.

Änderungen der Konfiguration speichern Sie auf allen Seiten mit einem Klick auf den Button unter den Einstellungen.

###


# Tab Detailkonfiguration

Im folgenden Screenshot sehen Sie den Tab Detailkonfiguration, hier existieren die folgenden Einstellungsmöglichkeiten:

<div align="left"><img src="https://731876186-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fmodule%2F-Mbanf0E3cbVUYJiSPGZ%2F-MbaoVaDtFb-LXtX0sN0%2F3.png?generation=1623075200123471&amp;alt=media" alt=""></div>

* User-Daten (=Benutzerdaten): Aktiviert den User-Datenblock im dataLayer. Übergeben werden die OXID des Benutzers, der Newsletter-Status, der Login-Status und der Neukunden-Status.
* **Erweiterte User-Daten:** Aktiviert die erweiterten User-(=Benutzer-)Daten (Kunden-Nummer, E-Mail-Adresse, E-Mail-Adresse als MD5-Hash, Geschlecht und Geburtstag). **Hinweis:** Die Übergabe dieser erweiterten Daten kann im Kontext der Datenschutz-Grundverordnung (DSGVO) ohne aktiven Opt-In des Shop-Nutzers problematisch sein. Sollten Sie sich der Folgen bewusst sein, können Sie diese Tags für erweitere User-Daten dennoch aktivieren. Konsultieren sie hierzu bitte Ihren Datenschutzbeauftragten.
* Basket (=Warenkorb)-Info: Aktiviert die Current-Basket-Info auf allen Seiten. Übergeben werden Produktname, OXID des Produkts, Brand, Quantity und Price, sowie weitere relevante Key-Value-Pairs.
* Varianten Bestand: Aktiviert die Stock-Info (Bestands-Information) für die angezeigte Variante im dataLayer.
* Suchartikelanzahl: Anzahl der Suchartikel im dataLayer (0 ist gleich Maximalanzahl).
* Zahlungsinfo: Aktiviert Informationen über die Zahlungsart im Datalyer .
* OrderID: Zeigt an, welche Identifizierung für die Bestellungen im dataLayer verwendet wird. Zur Auswahl per Dropdown-Menü stehen oxordernr oder oxid:

<div align="left"><img src="https://731876186-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fmodule%2F-Mbanf0E3cbVUYJiSPGZ%2F-MbaoVaEFgigY3epNErC%2F4.png?generation=1623075200132568&amp;alt=media" alt=""></div>

* Brand: Wählen Sie das OXID-Feld aus, das Sie im dataLayer für "Brand" (Marke) verwenden möchten. Zur Auswahl per Dropdown-Menü stehen oxvendor oder oxmanufacturer:

<div align="left"><img src="https://731876186-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fmodule%2F-Mbanf0E3cbVUYJiSPGZ%2F-MbaoVaFUkVkmICgVrjH%2F5.png?generation=1623075200178788&amp;alt=media" alt=""></div>

###




---

[Next Page](/llms-full.txt/1)