Das printformer Template beinhaltet Container die mittels Feed befüllt werden (bspw. Produkte). Dabei wird (ein vordefiniertes oder automatisch ausgewähltes) Artikeltemplate inkl. Platzhalter (DataKeys) in den Container eingefügt. Die Zuordnung von Textbausteinen oder Bildern für die einzelnen Platzhalter erfolgt über eine Tabelle (CSV-Datei).

Feed-Mapping

Als erstes wird ein Feed-Mapping (Publish > Product-Feeds > Mapping) hinzugefügt.
Hier wird festgelegt wie die einzelnen Produkte später im Menü Produkte der Sidebar des Editors dargestellt werden.

Zunächst wird eine Name für den Feed vergeben.

Darstellung im Editor

Unter Zuweisung werden Keys hinzugefügt und dem gewünschten Value zugewiesen. Die Keys sind vordefiniert und bestimmen Bild und Text(e), die für die einzelnen Produkte in der Editor-Sidebar angezeigt werden sollen, s. Screenshot:
1 = title; 2 = subtitle; 3 = shortDescription; 4 = discountPrice; 5 = Price; 6 = image
Unter Value kann ein Text und/oder Platzhalter (der mit den Inhalten der CSV gefüllt wird) eingefügt werden. Die DataKeys für die Platzhalter müssen in folgender Schreibweise eingesetzt werden: ${pf-ca-DataKey}. (Beim Key images darf als Value lediglich den Name des Datakeys erhalten, ohne ${…})
Einem Key können auch mehrere Datakeys aus der CSV zugewiesen werden, diese werden dann kommasepariert angegeben.

Suchfelder

Zusätzlich können Suchoptionen hinzugefügt werden: diese erzeugen zusätzliche Suchfelder im Editor (Screenshot 7 und 8) in die kommaseparierte Begriffe zur Suche eingegeben werden können.
Der unter Spalte einzugegebene Name entspricht dem Spaltentitel in der CSV (Schreibweise muss exakt übereinstimmen).
Die Suchart unterscheidet zwischen Fuzzy und Exakt: Fuzzy ist eine Wildcardsuche nach dem Suchbegriff während Exakt nur nach dem genauen Begriff sucht (bspw. Suche nach Artikel-Nr.).
Wird hier nichts angegeben werden durch das Suchfeld im Editor nur die Keys title, subtitle und shortDescription nach exakten Übereinstimmungen durchsucht.

Feed einrichten

Um den Feed einzurichten (Publish > Product-Feeds > Übersicht > Feed hinzufügen) werden Name, Typ und ggf. die Mandanten eingegeben.

Allgemeine Konfiguration

Neben der Angabe des Trennzeichens (bspw. ; )und Überschrift-Offset (in welcher Zeile stehen die Überschriften; in der Regel immer die erste Zeile, die als 0 angegeben wird) kann über die Checkbox bestimmt werden ob HTML* interpretiert oder entfernt werden soll.

Über Feed replizieren kann gewählt werden ob der Feed beim Replizieren eines Drafts (bestehender Draft, der als Vorlage verwendet wird) ebenfalls kopiert werden soll oder nicht. Falls diese Checkbox aktiviert ist, werden eventuelle Aktualisierungen der ursprünglichen CSV-Datei (die zwischenzeitlich im Ordiginalfeed vorgenommen wurden) im neuen Projekt nicht berücksichtigt.

Zudem muss die in der CSV vergebene Bezeichnung der Identifier-Attribute angegeben werden (im unteren Beispiel Id)

Aus technischen gründen darf “id” nicht als Spaltentitel verwendet werden

Da die Werte in dieser Spalte zur jeweiligen Identifizierung verwendet werden müssen sie eindeutig und unique sein (bspw. Artikelnummer).

Zusätzlich besteht die Möglichkeit die Anzeige der Produkte (mit oder ohne Suchfilter) alphabetisch, nach Relevanz oder nach der Reihenfolge der CSV-Datei sortiert anzeigen zu lassen.

Typ lokal

Hier wird zunächst eine CSV-Datei hochgeladen, die alle Informationen (bspw. Identifier, Produktname und Dateiname und den Content) beinhaltet.

Beispiel-CSV tabellarisch dargestellt

Typ URL

Hier wird die gewünschte URL (Link zur CSV bspw. https://example.com/mein-feed.csv) eingegeben sowie Angaben zum Automatischen Import.(Polling = Abholen der Datei im angegeben Intervall, Angabe in Sekunden. Im Bsp. würde der printformer alle alle 3600 Sekunden die neue Datei ziehen / wird Daten löschen vor Import aktiviert werden vor dem import der CSV alle Produktinformationen aus dem Feedcon gelöscht)

Wird diese Konfiguration verwendet ist zu beachten, dass die URL erreichbar und mehrfach abrufbar sein muss.

Typ FTP/SFTP

Der Typ FTP/SFTP funktioniert nach dem gleichen Prinzip wie URL. Eingabe der Dateinamens (der CSV) sowie Angaben zum Automatischen Import und den FTP/SFTP-Einstellungen (Konfiguration für den FTP-Server).

Im Mapping wird das vorher erstellte FeedMapping zugewiesen und unter Medien die Checkbox aktiviert, sowie der gewünschte Anbieter ausgewählt.

Beim Speichern werden die Daten an den Feedcon geschickt. Unter Log können die Antworten vom Feedcon eingesehen werden. (success bedeutet der Feed wurde erfolgreich angelegt, ansonsten erscheint eine Fehlermeldung)

Allgemeine Einstellungen

Weitere Einstellungsmöglichkeiten zum Product-Feed gibt es unter den allgemeinen Settings > Seitenplanung.

Template

Damit die Daten aus dem Feed im Editor sichtbar sind, wird in der Template-Konfiguration unter Content die Checkbox catalog aktiviert werden:

Zum Testen wird beim Öffnen des Templates aus dem Editor die Checkbox Seitenplanung erzeugen aktiviert:

Optional kann ein/e Project-ID, -Code oder -Name eingegeben werden.
Unter Feed muss der vorher angelegte Feed ausgewählt werden.

Feed-Datei herunterladen bzw. austauschen

Über das Feed-Menü kann mit dem Button Datei herunterladen im jeweiligen Feed, die CSV-Datei heruntergeladen werden.

Es wird immer nur die zuletzt ins Backend hochgeladene Datei gezogen (werden über den Editor Anpassungen in den Feed übertragen, sind diese nur in der Feed-Datei der Datenbank, nicht im Adminbereich, enthalten)

Nach Überarbeitung der CSV-Datei kann diese in der Konfiguration neu hochgeladen und der Feed gespeichert werden.

Damit der alte Feed nicht nur erweitert, sondern ggf. gelöschte Datensätze im System ebenfalls gelöscht werden muss Daten löschen vor Import aktiviert werden.

In bestehenden Drafts werden Artikel die bereits platziert wurden nicht aktualisiert (nur die Datensätze die noch nicht verwendet wurden werden durch die neue Feed-Datei angepasst).

Produkte über Suche filtern und automatisch platzieren

Über das Feature Seite automatisch befüllen (das über die allgemeinen Einstellung > Seitenplanung aktiviert werden kann) müssen Produkte nicht einzeln in die Container gezogen werden.

Sobald dieses Feature aktiviert ist erscheint in Editor der Button Auswahl platzieren. Über die Suche können die gewünschten Produkte gefiltert werden, hilfreich ist es dabei entsprechende Suchfelder über das Feed-Mapping vorab zu erstellen. Bspw. ein Suchfeld für die Spalte Artikelname (der CSV-Datei). Im Editor können dann alle gewünschten Artikel (Bestätigung mit Enter) eingegeben werden und über durch Klick auf den Button Auswahl platzieren werden sie automatisch in die zur Verfügung stehenden Container platziert.

* Folgende Tags, Attributes und Values können vom printformer interpretiert werden:

supported tags
h1 - h5
p
br
b
strong
i
em
u
s
strike
del
ul
ol
li
super
sub

### supported css attributes and values

#### on any supported tag
    - font-family
        - postscript or family name of an available font
    - font-weight
        - bold
    - font-style
        - italic
    - text-decoration
        - underline
        - line-through
    - text-transform
        - uppercase
    - font-size
        - values in px/pt (px get converted)
    - text-align
        - left
        - center
        - right
    - color
        - hex notation: \#ffffff
        - rgb notation: rgb(x, x, x)
        - cmyk notation cmyk(x, x, x, x)
        - color names [available color names](https://www.w3schools.com/colors/colors_names.asp)
#### only on ul / ol
    - list-style-type
        - lower-alpha
        - circle
        - square
        - or any single ascii char (unicode characters will follow soon)

### supported attributes
#### html
    - ..
#### data
    - data-leading
        - values in px/pt (px get converted)
    - data-overprint-stroke
        - true / false
    - data-overprint-fill
        - true / false
CODE