Dieses Plugin 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 kann anhand "input_qr_code" automatisch ein QR Code erstellt werden.

Richtet man sich im html5-Editor eine entsprechende Regel ein, wird dieser Code auch direkt im PDF platziert.

Hier ein Beispiel anhand des vCard-Formats:

Einrichten des Features

1. Anlegen eines neuen w2p-Feldes (Formular-Typ=Feature,  Feature=basic_widget/input_qr_code.field)
2. Anlegen einer Konfiguration(Konfiguration={siehe Code Block "QR Code Map"})
3. Verknüpfen des Feldes mit dem gewünschten Template

feature: input/qrCode.field
w2pTemplateFieldFeatureConfiguration:
  mailTo:
    map:
      mail: email
    options:
      fileFormat: eps
      trim: true
      width: 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

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