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.

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

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.

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:

Feed-Ansicht:

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

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).
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.
Die Einstellungen im Template-Builder werden erst nach dem Speichern der Feed-Konfiguration über den blauen Speichern-Button in der Topbar übernommen.
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:

Feld-Typen
Folgende Feld-Typen stehen dir im norisk Exporter-Plugin aktuell zur Verfügung:
Produktdaten
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
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.
Starte die Migration unbedingt mit einem duplizierten Feed und nicht mit deinen Livedaten.
Last updated
