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. 

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

1. Anlegen eines neuen w2p-Feldes (Formular-Typ= Auswahlfeld)
2. Anlegen einer Konfiguration(Konfiguration={siehe Code Block "QR Code Map"})
3. 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

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 Bedinungsteil 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