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.

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
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
IMGORIGWIDTH	Breite des Original-Bildes in Pixeln	add
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
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
THUMBWIDTH	Breite des Thumbnails innerhalb des TD-Blocks	add
IMGURL	URL für die Ansichts-Seite des Bilds

EXIF-Platzhalter

Siehe eigene Dokumentation der EXIF-Platzhalter.