www.stefanheymann.de

Stefan Heymann

Home | Fotografie · Hasselblad · Galerie | Ruler · XML · HomePump · HomeGallery

HomeGallery

Allgemein·Download·Doku·Historie·Links·Banner·Donateware

Platzhalter

In den Templates können Platzhalter für verschiedene Inhalte gesetzt werden. Ein Platzhalter ist links und rechts durch je zwei Raute-Zeichen eingeschlossen. Beispiel: ##IMAGE##

Manche Platzhalter besitzen noch Attribute (analog zu HTML/XML). Hier können weitere Angaben gemacht werden. 
Beispiel: ##IMGWIDTH add="8"##

Platzhalter, die eine URL zurückgeben werden stets ohne umschließende Anführungszeichen ersetzt.

Das Attribut "add" addiert zu dem Wert, der normalerweise eingesetzt würde noch eine Zahl (die auch negativ sein kann).
Beispiel: Wenn ein Bild 600 Pixel breit ist, dann wird ##IMGWIDTH add="8"## durch 608 ersetzt.

Das Attribut "mul" multipliziert den Wert, der normalerweise eingesetzt würde mit der angegebenen Zahl. Diese muss mit einem Punkt (.) als Dezimaltrenner angegeben werden. Nach der Multiplikation wird ein ggf. per "add"-Attribut angegebener Wert hinzuaddiert.
Beispiel: Wenn ein Bild 600 Pixel breit ist, dann wird ##IMGWIDTH mul="0.66" add="8"## durch 404 (600*0,66+8) ersetzt. 

Allgemeine Platzhalter

Diese Platzhalter können an jeder Stelle eingesetzt werden.

Platzhalter Bedeutung Attribute
CALLINGPAGE Die aufrufende Seite (entspricht dem Inhalt des Feldes "Aufrufende Seite" im Programm). Damit kann auf die Startseite oder eine Galerie-Übersicht zurück verlinkt werden, ohne dass die URL dazu fest im Template stehen muss.
CREATIONDATE Datum der Erzeugung der Galerie-HTML-Seiten. Das Datum hat defaultmäßig das Format DD.MM.YYYY. Ein anderes Format kann über den Parameter "format" angegeben werden, z. B. ##CREATIONDATE format="YYYY-MM-DD, HH:NN:SS" ## format
GALLERYDESCRIPTION Die Beschreibung der Galerie. Gut geeignet als Bildüberschrift auf der Übersichts-Seite. Muss bei den Kopfdaten der Galerie eingegeben werden.
GALLERYNAME Der Name der Galerie. Gut geeignet für TITLE-Tags oder Überschriften. Muss bei den Kopfdaten der Galerie eingegeben werden.
HGVERSION Name und aktuelle Versionsnummer von HomeGallery
IMAGEBORDER Breite in Pixeln des Randes um die Bilder
IMGCOUNT Anzahl Bilder
JPEGQUALITY Eingestellte JPEG-Quality in ganzen %
THUMBS Die Thumbnail-Tabelle der Übersichts-Seite

Platzhalter für ein Bild

Diese Platzhalter können auf der Bild-Seite und innerhalb der Thumbnail-Zelle verwendet werden.

Zu den Platzhaltern, die ihre Daten aus den EXIF-Metadaten beziehen gibt es eine eigene Dokumentation.

Platzhalter Bedeutung Attribute
BACK URL für den Sprung um ein Bild zurück
BACKLINK Ein kompletter Link zum vorherigen Bild. Folgende Attribute werden unterstützt:
  • pre: Text vor dem Link (wird unverändert ausgegeben, kann also auch HTML-Auszeichnungen enthalten)
  • text: Inhalt des Links (wird unverändert ausgegeben)
  • post: Text nach dem Link (wird unverändert ausgegeben)
  • none: Der Text, der ausgegeben werden soll, wenn es kein vorheriges Bild gibt (wird unverändert ausgegeben)
  • alle anderen Attribute (wie z. B. "target") werden direkt in den Start-Tag eingetragen.

Beispiel: 

##BACKLINK pre=" | " text="Zurück" none="--" target="_blank"##
pre, text, post, none, A-Attribute
CAPTION Caption-Feld des aktuellen Bildes
DATE Bild-Datierung
DESCRIPTION Bild-Beschreibung
EXIF-... Einbinden von EXIF-Feldern. Weitere Informationen dazu tagid, format, index, default
FIRST URL für den Sprung zum ersten Bild der Galerie
FIRSTLINK Link zum ersten Bild. Weiteres siehe BACKLINK. pre, text, post, none, A-Attribute
IMAGE Das Bild für die Ansichts-Seite. Dieser Platzhalter wird durch das komplette
<img>-Tag ersetzt. ALT-Text ist der Inhalt des ALT-Feldes. 

Das <img>-Tag kann alternativ auch mit anderen Platzhaltern zusammengebaut werden. Beispiel:

<img src="##IMGSRC##" alt="##IMGALT##" title="##IMGALT##"
     width="##IMGWIDTH##" height="##IMGHEIGHT##"
     border="##IMAGEBORDER##">
IMGALT Der in das ALT-Feld eingegebene Text
IMGALTTEXT Der in das ALT-Feld eingegebene Text bzw. der Caption-Text, wenn ersterer leer ist
IMGID ID-Nummer des Bildes. Diese ID-Nummer kann beliebig vergeben werden (z.B. Bildnummer im eigenen Archivierungs-System) und auch in mehreren Galerien auftauchen. Im Gegensatz dazu steht die IMGGUID, die Galerie übergreifend eindeutig ist.
IMGGUID Galerie übergreifend eindeutige ID. Diese wird von Windows als GUID erzeugt (Globally Unique Identifier). Die Erzeugung erfolgt auf Benutzer-Anforderung (Button "Erzeugen") oder wenn die GUID über den ##IMGGUID##-Platzhalter abgerufen wird. Kann beispielsweise für Web-Applikationen verwendet werden.
Beispiel: {4966BEBF-F886-41F0-ABB0-1166107FA990}
IMGHEIGHT Höhe des Ziel-Bildes in Pixeln add, mul
IMGINDEX Lfd. Nr. des Bilds, beginnend bei 1 add
IMGJPEGQUALITY Die für das Bild gültiger JPEG-Kompressions-Qualität in ganzen %. Dieser Wert steht auf 100 für Bilder, bei denen das JPEG lediglich kopiert wird
IMGORIGHEIGHT Höhe des Original-Bildes in Pixeln add, mul
IMGORIGWIDTH Breite des Original-Bildes in Pixeln add, mul
IMGSIZE Dateigröße des Bildes (mit einer Nachkommastelle und automatisch gewählter Einheit Byte/KB/MB/GB/TB). Kann auf der Bilderseite oder in der Thumbnail-Zelle verwendet werden.
IMGSRC URL für die Bild-Datei
IMGWIDTH Breite des Ziel-Bildes in Pixeln add, mul
LAST URL für den Sprung zum letzten Bild der Galerie
LASTLINK Link für den Sprung zum letzten Bild der Galerie. Weiteres siehe BACKLINK. pre, text, post, none, A-Attribute
NEXT URL für den Sprung um ein Bild vorwärts
NEXTLINK Link für den Sprung um ein Bild vorwärts. Weiteres siehe BACKLINK. pre, text, post, none, A-Attribute
NEXTTHUMB IMG-Tag für das Thumbnail für das nächste Bild
NEXTTHUMBURL URL für das Thumbnail für das nächste Bild (damit kann das IMG-Tag selbst zusammengebaut werden)
ORIGPATH Pfad des Original-Files
ORIGFILE Dateiname des Original-Files mit Extension
ORIGFILEONLY Dateiname des Original-Files ohne Extension
ORIGIMGSIZE Dateigröße des Original-Bildes. Über das Attribut "decsep" kann der Dezimal-Trenner angegeben werden, z.B. ##ORIGIMGSIZE decsep="."## decsep
OVERVIEW URL für den Sprung zur Übersicht. Sind mehrere Übersichts-Seiten angelegt, zeigt die URL auf die zum Bild gehörende Übersichts-Seite.
PREVTHUMB IMG-Tag für das Thumbnail für das vorherige Bild
PREVTHUMBURL URL für das Thumbnail für das vorherige Bild (damit kann das IMG-Tag selbst zusammengebaut werden)
TECHNICALS Technische Daten zum Bild

Platzhalter für Übersichts-Seiten

Mit diesen Platzhaltern kann die Navigation über mehrere Übersichts-Seiten hinweg aufgebaut werden.

Platzhalter Bedeutung Attribute
PAGECOUNT Anzahl Seiten
PAGEINDEX Nummer der aktuellen Seite. Die erste Seite hat die Nummer 1 add
PAGENEXT URL der nächsten Seite. Von der letzten Seite aus geht's wieder zur ersten.
PAGENEXTLINK Link zur nächsten Seite. Weiteres siehe BACKLINK pre, text, post, none, A-Attribute
PAGEPREV URL der vorigen Seite. Von der ersten Seite aus geht's zur letzten.
PAGEPREVLINK Link zur vorigen Seite. Weiteres siehe BACKLINK pre, text, post, none, A-Attribute
PAGEFIRST URL der ersten Seite
PAGEFIRSTLINK Link zur ersten Seite. Weiteres siehe BACKLINK. pre, text, post, none, A-Attribute
PAGELAST URL der letzten Seite
PAGELASTLINK Link zur letzten Seite. Weiteres siehe BACKLINK. pre, text, post, none, A-Attribute
PAGEFIRSTIMGINDEX Lfd. Nr. des ersten Bilds auf der Seite add
PAGELASTIMGINDEX Lfd. Nr. des letzten Bilds auf der Seite add

Platzhalter für die Thumbnail-Zellen

Innerhalb des TD-Codes für eine Zelle der Thumbnail-Tabelle oder innerhalb des Templates für eine Bild-Seite können folgende Platzhalter verwendet werden:

Platzhalter Bedeutung Attribute
THUMBURL URL des Thumbnails innerhalb des TD-Blocks
THUMBBORDER Dicke des Rahmens für das Thumbnail
THUMBHEIGHT Höhe des Thumbnails innerhalb des TD-Blocks add, mul
THUMBWIDTH Breite des Thumbnails innerhalb des TD-Blocks add, mul
IMGURL URL für die Ansichts-Seite des Bilds

EXIF-Platzhalter

Siehe eigene Dokumentation der EXIF-Platzhalter.