{html_image} ist eine eigene Funktion die ein HTML Tag für ein Bild erzeugt. Die Höhe und Breite der Ausgabe wird automatisch aus der Bilddatei berechnet wenn die Werte nicht übergeben werden.
| Attribut Name | Typ | Erforderlich | Standardwert | Beschreibung |
|---|---|---|---|---|
| file | string | Ja | n/a | Name/Pfad zum Bild |
| height | string | Nein | Normale Höhe des Bildes | Höhe des Bildes |
| width | string | Nein | Normale Breite des Bildes | Breite des Bildes |
| basedir | string | Nein | DOCUMENT_ROOT | Basisverzeichnis für relative Pfadangaben |
| alt | string | Nein | "" | Alternative Beschreibung des Bildes |
| href | string | Nein | n/a | Link für das Bild |
| path_prefix | string | Nein | n/a | Präfix für den Pfad zum Bild |
basedir ist der Basispfad der für die Verlinkung verwendet werden soll. Wenn kein Wert übergeben wird, wird die Umgebungsvariable DOCUMENT_ROOT verwendet. Wenn Sicherheit eingeschaltet ist, muss das Bild in einem sicheren Verzeichnis liegen.
href ist das href Attribut für das
Image-Tag. Wenn dieser Wert übergeben wird, wird um das Bild ein
<a href="LINKVALUE"><a> Tag erzeugt.
path_prefix ist ein optionaler Präfix der dem
Bildpfad vorangestellt wird. Die ist nützlich wenn zum Beispiel für
den Bildpfad ein anderer Servername verwendet werden soll.
Alle weiteren Parameter werden als Name/Wert Paare (Attribute) im <img>-Tag ausgegeben.
Technische Bemerkung
{html_image} greift auf das Dateisystem zu um Höhe und Breite zu errechnen. Wenn Sie caching nicht verwenden sollten Sie normalerweise auf diese Funktion aus performance Gründen verzichten.
Example 8.8. html_image
Wobei index.tpl wie folgt aussieht:
-----------------------------------
{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}
Mögliche Ausgabe:
<img src="pumpkin.jpg" alt="" width="44" height="68" /> <img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" /> <img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" />