1. Größe und Einzug (Size und Margin)

Der QR Code benötigt einen ihn umgebenden Einzug bzw. eine leere, unbedruckte weiße Fläche. Dieser Einzug an jeder Seite des Symbols muß mindestens vier QR Code Pixels groß sein.

Wenn die Bildgröße manuell festgelegt wird, kann es (je nach Inhalt) passieren, daß das kodierte Bild "pixelverschwommen" (die Pixel sind nicht mehr quadratisch) und damit schwer für manche Lesegeräte zu erkennen ist. Dies geschieht oft bei kleinen Bildgrößen (weniger als 100 Pixel). Für den "Best Read Mode" wird das Größenfeld dazu verwendet, einen Vergrößerungsfaktor (0-9) für eine optimale Bildgröße zu definieren: 0=keine Vergrößerung, 1=100%, 2=200%, bis zu 9=900% Vergrößerung.

2. Verwendung des Shortcodes

Im Artikeleditor benutze

[qrcodetag/] und ein QR Code mit Link zur aktuellen URL wird erzeugt
[qrcodetag]Inhalt[/qrcodetag] um einen QR Code mit Inhalt zu generieren.

Die Standardwerte können durch Übergabe von Parametern ersetzt werden, z.B.
[qrcodetag size="150" link="true"]Inhalt[/qrcodetag] erzeugt einen 150x150 Pixel großen QR Code und verlinkt zum Inhalt.

Für die Tooltip-Funktion verwende diesen Code

[qrcodetag tooltip="QR Code Inhalt"]ein Link oder nur Text[/qrcodetag]

wobei QR Code Inhalt der QR Code Bildinhalt und ein Link oder nur Text der sichtbare Text ist - beachte den Unterschied zur vorherigen Benutzung!

Warnung! WordPress Fehler!

Verwende auf keinen Fall "self closing" QR Code Tags (erstes Beispiel) mit QR Code Tags mit Inhalt (zweites Beispiel) innerhalb eines Artikels! Dies ist ein Fehler im WordPress-Parser (v2.8) - die QR Code Generierung kann fehlerhaft sein!

Verwende auf keinen Fall leere Shortcodes [qrcodetag][/qrcodetag] - auch dies ist ein WordPress Fehler. Verwende stattdessen [qrcodetag]_[/qrcodetag] (einzelner Unterstrich als Inhalt)!

3. PHP Function Verwendung

Um einen QR Code in einem Template oder einem PHP aktivierten Artikel zu generieren, benutze das globale $qrcodetag Object:

global $qrcodetag;
echo $qrcodetag->getQrCodeUrl($content, $size, $encoding, $ecc, $margin, $version);

Für ein 100 x 100px QR Code im Seitentemplate füge folgenden PHP code ein:

<img src="<?php 
  global $qrcodetag; 
  echo $qrcodetag->getQrCodeUrl('Mein Inhalt',100,'UTF-8','L',4,0); 
?>">

4. Widget Verwendung

Ziehe das QR Code Widget einfach in die Sidebar (Desgin | Widgets) und passe die Einstellungen entsprechend an.

5. Bekannte Probleme

- Self closing tag Problem (siehe Shortcode-Warnung)
- Gemischte Tags (siehe Shortcode-Warnung)
- Leeres Tag Problem (siehe Shortcode-Warnung)
- Falsche Margin Größe (nur bei Benutzung der Google API)

6. Useful Links

Denso Wave Incorporated - Alles über den QR Code (erfunden 1994 von der japanischen Firma Denso-Wave)
ZXing Decoder Online - Decodiere QR Codes online
ZXing Library - Google QR Code image processing library für Java
Google Chart API - Googles QR Code API, wird von diesem Plugin verwendet
QR Code Lib - PHP & Perl QR Code Library von Y. Swetake, wird von diesem Plugin verwendet

7. Übersetzungen

Übersetzungen für dieses Plugin sind willkommen! Lade Poedit herunter und schicke die Übersetzungsdateien (*.po & *.mo, sowie diese HTML-Hilfe) an mich. Danke!

8. Bekanntmachung

Dieses Wordpress QR Code Tag Plugin basiert teilweise auf Super Cool QRCode Widget von Matias S.


WordPress plugin pluginName.' v'.$this->pluginVersion ?> by Dennis D. Spreen