> For the complete documentation index, see [llms.txt](https://docs.norisk.group/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norisk.group/plugins/exporter/feed-template-builder.md).

# Feed-Template-Builder

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="/files/JywNFn9dUaPoNPueIk6u" 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="/files/5BJLC6cCLPZb35bwD6mG" 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="/files/bagBewXXTcpPTcUnKdlP" 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="/files/XMRCOujijZdRFBmHWupB" alt=""><figcaption></figcaption></figure>

Feed-Ansicht:

<figure><img src="/files/TaMhk7jQgM6hl7wEFkCs" 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="/files/5pQyyGSkSVrsZrSA78Wo" 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="/files/qZVI6E1QsjuB27zLrQ8n" 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 %}