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

QR Code Map

{
	"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.:

Mapping for vCard - 4.0

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

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.

Konfiguration im Template

Um den QR-Code in einem Print-Template nutzen zu können, sollte ein Bild als Platzhalter platziert und für dieses Bild eine Regel erstellt werden.

Laden Sie ein Bild hoch oder wählen Sie ein Bild aus der Galerie aus und platzieren Sie es im Template.
Klicken Sie auf das Bild-Element und öffnen Sie die Elementeigenschaften in der Toolbar.
Klicken Sie bei Eingabe im Tab Daten auf das >_ Icon.
Legen Sie eine neue Variable an, indem Sie auf den Button "neue Variable" klicken.
Wähen Sie für die Variable das Feld der QR-Codes aus.
Erstellen Sie eine neue Bedingung, indem Sie auf den Button "neue Bedingung" klicken.
Löschen Sie den Bedienungsteil der Bedingung.
Tragen Sie "[1]" in den "dann"-Textblock ein und speichern Sie die Bedingung.

Der QR-Code ist nun auskonfiguriert.

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

URL	phone	mailTo

brandbox – Eine Plattform, unendliche Möglichkeiten

QR-Code Generator