Diese App bietet die Möglichkeit QR Codes mithilfe vordefinierter Felder im Strict-Editor zu erstellen. Diese Felder werden über eine map in der entsprechenden Konfigurationstabelle den Attributen eines QR Codes zugewiesen, sodass dieser im Anschluss erstellt werden kann.
Hinweis für Print-Templates
Die verwendeten Print-Templates müssen der PDF-Version 1.7 zugeordnet werden.
Beispiel - Visitenkarte:
Hat man in einem Strict Template Felder definiert, die eine Person beschreiben (Name, Nachname, Telefon, E-Mail-Adresse etc.), so können QR-Codes erstellt werden, sofern man im Feld für den QR-Code ein entsprechende Format auswählt.
Richtet man sich im html5-Editor eine entsprechende Regel ein, wird dieser Code direkt im PDF platziert.
Einrichten des Features
- Anlegen eines neuen w2p-Feldes (Formular-Typ= Auswahlfeld)
- Anlegen einer Konfiguration(Konfiguration={siehe Code Block "QR Code Map"})
- Verknüpfen des Feldes mit dem gewünschten Template
source: W2pQrCode w2pTemplateFieldFeatureConfiguration: mailTo: map: mail: email options: fileFormat: eps trim: true widthMilliMeters: 100 widthPixels: 300 phone: map: phone: phone options: colorSpace: cmyk fileFormat: jpg marginWidthMilliMeters: 10 marginWidthPixels: 0 trim: true widthMilliMeters: 250 widthPixels: 300 url: map: url: url options: colorSpace: cmyk fileFormat: eps marginWidthMilliMeters: 5 marginWidthPixels: 0 trim: false widthMilliMeters: 100 widthPixels: 300 vCard: map: firstname: firstName lastname: lastName company: company phone: workphone mobile: mobile fax: fax url: url street: adressStreet city: addressCity zip: addressZipCode mail: mail role: role options: colorSpace: cmyk fileFormat: eps trim: true widthMilliMeters: 100 widthPixels: 300
Optional ist für die vCard eine andere Version wählbar (4.0). Diese Version unterstützt deutlich weniger Konfigurationsmöglichkeiten.:
vCard: version: 4 #Pflicht map: name: firstName fullName: lastName address: address nickName: nickName workPhone: workPhone homePhone: homePhone birthday: birthday anniversary: anniversary gender: gender categories: categories impp: impp photo: photo role: role organization: organization lang: language mail: mail url: url options: trim: 1 widthPixels: 300
Jedes first level dictionary (siehe: https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html) ist für ein QR Code Format zuständig.
In diesen dictionaries wird wiederum über keys und values gearbeitet.
Die Keys sind die Attribute eines QR Codes (WICHTIG: Schreibweise beachten, diese Keys dürfen nicht verändert werden).
Die Values repräsentieren die Identifikatoren der W2P-Felder, die in dem Strict-Template aktiv sind. Diese sind frei wählbar.
Optionen
Name | Werte | Beschreibung |
---|---|---|
colorSpace | rgb, cmyk | Definiert den Farbraum des QR-Codes. CMYK nur bei Dateiformat "svg" möglich. |
fileFormat | jpg, png, svg | Definiert das Dateiformat. |
marginWidthMilliMeters | Numerische, positive Werte | Breite des Randes für svg-Dateien. Werte in Millimeter. |
marginWidthPixels | Numerische, positive Werte | Breite des Randes für jpg- & png-Dateien. Werte in Pixel. |
trim | 1 oder 0 | Definiert, ob der Rand abgeschnitten werden soll, oder nicht. |
widthMilliMeters | Numerische, positive Werte | Breite des QR-Codes für svg-Dateien. Werte in Millimeter. |
widthPixels | Numerische, positive Werte | Breite des QR-Codes für jpg- & png-Dateien. Werte in Pixel. |
Nutzung
Nun da das Feature eingerichtet und konfiguriert wurde, kann es im Strict-Editor genutzt werden.
Dazu muss ein Artikel mit der entsprechenden Artikelvorlage im Shop geöffnet werden.
Zunächst wählt man ein Format für den QR Code aus. Diese Formate sind nicht konfigurierbar. Die Auswahl richtet sich nach den lokal vorhanden Formaten.
Pflichtfelder für diese Formate sind der obigen Map zu entnehmen. Ein QR Code des Formats "mailTo" wird ohne E-Mail-Adresse nicht generiert werden.
Nun füllt man die gewünschten/gemappted Felder aus. Der QR Code wird nun generiert und ggf. platziert.
Der QR Code wird im üblichen share-Verzeichnis der Session gespeichert.
Obacht: Gegenfalls muss die Seite neu geladen werden, damit der QR Code platziert bzw. aktualisiert wird.
Weitere Beispiele
URL | phone | mailTo |
---|---|---|