Kurzanleitung zu PDF-Templates
##############################

Grundsätzlich folgt der Aufbau der PDF-Templates dem Prinzip von DTP-Programmen wie
Freehand oder QuarkXpress:
Es wird ein Textfeld angelegt und positioniert und mit Inhalt gefüllt.
Das Textfeld wird in den PDF-Templates durch den Tag 
<CELL X="int[mm|px]" Y="int[mm|px]">
</CELL>
definiert.
Für die Position werden die Parameter X und Y übergeben. Als Werte für
X (Abstand von links) und Y (Abstand von oben) können die Maßeinheiten
px (Pixel) oder mm (Millimeter) angegeben werden. Ohne Maßeinheit wird
Millimeter verwendet.
X und Y bezeichnen die linke obere Ecke des Textfeldes.

Als optionaler Paramter können in <CELL> verwendet werden:
FONT-FAMILY für die Schriftart (helvetica, courier, times)
FONT-SIZE für die Schriftgröße (ganzzahliger Wert)
Damit werden Schrift-Definitionen innerhalb der Zelle definiert.
Hat eine Zelle keine Angaben zur Schrift, werden automatisch
die vorhergehenden übernommen.
Standardschrift ist Helvetica (=Arial)

Beispiel:
<CELL X="157.5" Y="95.5" FONT-FAMILY="times" FONT-SIZE="11">
Rechung
</CELL>
Diese Definition ergibt eine Zelle, die 157,5mm von links und
95,5mm von oben beginnt. Der Text 'Rechnung' wird in Times 11pt
dargestellt.

Innerhalb der Textfelder oder Zellen können die HTML-Tags verwendet
werden:
<b></b> oder <strong></strong> - Fettdruck
<i></i> oder <em></em> - kursive Schrift
<u></u>     - unterstriechener Text
<sup></sup> - hochgestellter Text
<a></a>     - Links
<p></p>     - Absatz
<br>        - Zeilenumbruch 
<hr>        - horizontale Linie

Mit kleinen Abwandlungen sind die folgenden HTML-Tags auch erlaubt:
- Bilder:
  <img src="dateiname" width=int[mm|px] [height=int[mm|px]] [X="int[mm|px]"] [Y="int[mm|px]"]>
  Dateiname und Bildbreite sind obligatorische Angaben. Mit den Maßeinheiten
  ist es bei den Bildern wie bei der Position der Textzellen.
  Die Bildhöhe height ist wie X und Y für die Position eine optionaler Wert. 
  Beispiel: <img src="pdftemplate/kansok.jpg" X="135" Y="0" width="64">
- Schriftdefintion wie in HTML:
  <font face="helvetica|courier|times" [size="int"]></font>
  Eine der drei Schriftarten muß angegeben werden. Die Schriftgröße ist optional; als
  Angabe wird ein Wert in Punkt erwartet.
- Tabellen
  <table [border="0|1"]> - definiert den Anfang einer Tabelle. 
                           Optional mit Rahmen: border="1"
  <tr> - Beginn einer Tabellenzeile (table row)
  <td width="int[mm|px]" [height="int[mm|px]"] [align="LEFT|CENTER|RIGHT"] [valign="TOP|MIDDLE|BOTTOM"]>
       - Beginn einer Tabellenzelle (table data)
       Wie bei allen Maßen werden werden auch hier wieder absolute Werte in Pixel
       bzw. Millimeter erwartet. Wird die horizontale Ausrichtung align nicht angegeben, 
       wird der Inhalt linksbündig dargestellt. Die vertikale Ausrichtung des Textes
       ist ohne Angabe oben (top).
  
Neben den Formatoptionen stehen eine Reihe von Variablen zur Verfügung,
die aus Shopweezle's Datenbank mit Inhalt gefüllt werden:
Benutzerdaten:
##user_comp##  - Firma
##user_salut## - Anrede
##user_first## - Vorname
##user_name##  - Nachname
##user_street##- Straße
##user_hnr##   - Hausnummer
##user_zip##   - Postleitzahl
##user_city##  - Stadt
##ctry_short## - Abkürzung für Land
##user_ctry##  - Land
##user_email## - Email-Adresse

Die Auswahl der Liefer-Adresse erfolgt am Anfang des Templates mit:
<PARAM ADDRESS="deliver"></PARAM>
Wird nichts angegeben oder ist die Checkbox 'Lieferadresse' beim Kunden nicht aktiviert,
wird die Rechnungsadresse verwendet.

Rechnungsdaten:
##nummer##     - Rechnungsnummer
##orderdate##  - Datum der Bestellung
##billdate##   - Datum der Rechnungsstellung; wird automatisch gesetzt, wenn 
                 gedruckt wird oder die Bestellung auf 'erledigt' gestellt wird.
##sentdate##   - Versanddatum; wird automatisch gesetzt, wenn Versandinfo-Email 
                 verschickt wird.
##remdate##    - Datum der Erinnerungs-Email; wird automatisch gesetzt, wenn 
                 Erinnerungs-Email verschickt wird.
##today##      - aktuelles Datum
##time##       - aktuelle Uhrzeit

##total##      - Gesamtsumme mit Anzeige der Mehrwertsteuer

##memo##       - Zusatztext

##paymprice##   - Preis Zahlungsweise
##paymethod##   - Name Zahlungsweise
##paymdetails## - Details zur Zahlungsweise

##shipmprice##  - Versandkosten
##shipmethod##  - Versandart
##shipmdetails##- Details zum Versand

Die Auflistung der einzelnen Postionen wird mit dem Tag <LOOP></LOOP>
definiert. Innerhalb dieses LOOP-Bereichs stehen die folgenden Variablen
zur Verfügung:
##quantity##   - Menge/Stückzahl
##itemnumber## - Artikel-Nummer
##itemname##   - Artikel-Bezeichung inkl. eventuell Angaben zu EIgenschaften
##price##      - Einzelpreis
##sumprice##   - Gesamtpreis

Beispiel:
<CELL X="25" Y="105" FONT-FAMILY="courier" FONT-SIZE="10">
<table border=1>
<tr>
<td height="10" width="15" align="CENTER"><b>Anzahl</b></td>
<td height="10" width="105" align="CENTER"><b>Artikel</b></td>
<td height="10" width="25" align="CENTER"><b>Preis</b></td>
<td height="10" width="25" align="CENTER"><b>Summe</b></td>
</tr>
<LOOP>
<tr>
<td height="8" width="15" align="CENTER">##quantity##</td>
<td height="8" width="105">##itemnumber## ##itemname##</td>
<td height="8" width="25" align="RIGHT">##price##</td>
<td height="8" width="25" align="RIGHT">##sumprice##</td>
</tr>
</LOOP>
</table>
</CELL>