5. Template-Platzhalter

Es muss differenziert werden zwischen den Platzhaltern für ConPresso-Templates (die als HTML-Kommentare ausgebildet werden) und den Platzhaltern für die moduleigenen Templates.

Diese sind bewußt in einem eigenständigen Format erstellt worden, damit Verwechslungen ausgeschlossen sind.

5.1 ConPresso-Templates

Um die durch das Modul bereitgestellten Elemente in ConPresso-Seiten anzuzeigen, müssen in den Artikel-Templates Platzhalter eingesetzt werden. Zur Zeit stehen folgende Platzhalter zur Verfügung:

<!-- SLIDESHOW: Table; -->
zeigt die Dia-Übersicht

<!-- SLIDESHOW: InPage; -->
zeigt eine javascript-basierte Diashow in der Seite

<!-- SLIDESHOW: Show; -->
zeigt einen Link zum Aufruf des Albums (Detailseite)

<!-- SLIDESHOW: Random; -->
zeigt ein Zufallsbild, das gleichzeigt Link zur Detailseite ist

<!-- SLIDESHOW: Picture1; --> bis <!-- SLIDESHOW: PictureX; --> (X=Anzahl der Bilder des Albums)
gibt nur den Dateinamen eines zufällig ausgewählten Bildes aus

Sollte es kein Bilderalbum für den Artikel geben, dann werden die Platzhalter nicht genutzt und aus dem Seitenquelltext entfernt.

5.2 Modul-HTML-Templates

Das Modul bietet in den Einstellungen die Möglichkeit die Ausgabe über Templates zu steuern. Hierbei wird zwischen den Templates für Dias, Miniatur, Seitennummerierung, Seitennaviagtion,Anzeige (Pop-Up) und Bildübersicht unterschieden, die mit verschiedenen Platzhaltern versehen werden können.

Bei den Platzhaltern des Moduls ist auf eine exakte Schreibweise zu achten, also keine Zeilenumbrüche innerhalb des Platzhalters und die Leerschritte beachten! Bitte beachten Sie auch, daß die Platzhalter nur im jeweiligen Template funktionieren!

Bildübersicht-Vorlage
ist die Darstellung der Miniaturen inkl. Seitennavigation und bietet folgende Platzhalter:

### ALBUM_DESCRIPTION ###
ist die Album-Beschreibung, die bei der Erstellung angegeben werden kann.

### SLIDE_TABLE ###
ist die eigentliche Bildübersicht.

### ALBUM_NAVIGATION ###
ist die Navigationsleiste. Ob diese erscheint lässt sich in den Einstellungen festlegen.

### ALBUM_ANCHOR ###
ist der Name des Albums in url-codierter Form und kann daher z.B. als Name für eine Sprungmarke benutzt werden, also z.B. <a name="### ALBUM_ANCHOR ###"></a>

Dia-Vorlage
ist die Vorlage, die für die Darstellung eines einzelnen Bildes innerhalb einer tabellarischen Bildübersicht verwendet wird und bietet folgende Platzhalter:

### SLIDE_SIZE ###
sind die Außenmaße eines Dias (Bild inkl. Diarahmen)

### SLIDE_PADDING ###
ist der Abstand zwischen den Diarahmen

### ALBUM_DIR ###
ist das Modulverzeichnis (z.B. mod_gallery)

### INNER_SLIDE_SIZE ###
ist die Größe, auf die die Miniatur-Bilder verkleinert wurden (ohne Diarahmen)

### ALBUM_PIC ###
ist der Dateiname des Originalbildes. Für die Miniatur ist ein "t" davorzusetzen, für das Diashowbild ein "h".

### ALBUM_PIC_WIDTH ### und ### ALBUM_PIC_HEIGHT ###
sind die Abmessungen des Diashow-Bildes und kann z.B. für die Definition eines Pop-Ups genutzt werden.

### ALBUM_PIC_ORG_WIDTH ### und ### ALBUM_PIC_ORG_HEIGHT ###
sind die Abmessungen des Original-Bildes und kann z.B. für den alt-Text oder eine Bildunterschrift genutzt werden.

### ALBUM_PIC_USER ###
ist der User, der das Bild eingestellt hat.

### ALBUM_PIC_TIMESTAMP ###
ist der in der Datenbank gespeicherte Zeitstemple des Bildes im Format JJJJ-MM-TT hh:mm:ss

### ALBUM_PIC_DATE ###
ist der in der Datenbank gespeicherte Zeitstemple des Bildes in dem Format, das in den ConPresso-Systemeinstellungen eingestellt wurde.

### ALBUM_FROM ###
ist der Name des Albums, zu dem das Bild gehört.

### ALBUM_SPEED ###
ist die eingestellte Geschwindigkeit der automatischen Wiedergabe.

### POP_UP_WIDTH ###
ist die eingestellte Breite des Pop-Up-Fensters.

### POP_UP_HEIGHT ###
ist die eingestellte Höhe des Pop-Up-Fensters.

### ALBUM_THUMB ###
ist der Dateiname des Miniaturbildes (also Original-Dateiname inkl. davorgestelltem "t")

### ALBUM_BESCHREIBUNG ###
ist die ggf. eingegebene Beschreibung des Bildes, die z.B. als "alt"- und "title" Tag benutzt werden kann.

Miniatur-Vorlage
ist die Vorlage, die für die Darstellung eines einzelnen Bildes innerhalb einer NICHT-tabellarischen Bildübersicht verwendet wird und bietet folgende Platzhalter (die mit denen der Dia-Vorlage identisch sind, es fehlen nur die Dia-typischen Platzhalter):

### ALBUM_DIR ###
ist das Modulverzeichnis (z.B. mod_gallery)

### INNER_SLIDE_SIZE ###
ist die Größe, auf die die Miniatur-Bilder verkleinert wurden (ohne Diarahmen)

### ALBUM_PIC ###
ist der Dateiname des Originalbildes. Für die Miniatur ist ein "t" davorzusetzen, für das Diashowbild ein "h".

### ALBUM_PIC_WIDTH ### und ### ALBUM_PIC_HEIGHT ###
sind die Abmessungen des Diashow-Bildes und kann z.B. für die Definition eines Pop-Ups genutzt werden.

### ALBUM_PIC_ORG_WIDTH ### und ### ALBUM_PIC_ORG_HEIGHT ###
sind die Abmessungen des Original-Bildes und kann z.B. für den alt-Text oder eine Bildunterschrift genutzt werden.

### ALBUM_PIC_USER ###
ist der User, der das Bild eingestellt hat.

### ALBUM_PIC_TIMESTAMP ###
ist der in der Datenbank gespeicherte Zeitstemple des Bildes im Format JJJJ-MM-TT hh:mm:ss

### ALBUM_PIC_DATE ###
ist der in der Datenbank gespeicherte Zeitstemple des Bildes in dem Format, das in den ConPresso-Systemeinstellungen eingestellt wurde.

### ALBUM_FROM ###
ist der Name des Albums, zu dem das Bild gehört.

### ALBUM_SPEED ###
ist die eingestellte Geschwindigkeit der automatischen Wiedergabe.

### POP_UP_WIDTH ###
ist die eingestellte Breite des Pop-Up-Fensters.

### POP_UP_HEIGHT ###
ist die eingestellte Höhe des Pop-Up-Fensters.

### ALBUM_THUMB ###
ist der Dateiname des Miniaturbildes (also Original-Dateiname inkl. davorgestelltem "t")

### ALBUM_BESCHREIBUNG ###
ist die ggf. eingegebene Beschreibung des Bildes, die z.B. als "alt"- und "title" Tag benutzt werden kann.

Seiten-Nummerierung
ist die Vorlage für die Darstellung einer einzelnen Seitennummer und bietet folgende Platzhalter:

### PAGE_LINK ###
ist die URL auf die entsprechende Seite des Bilderalbums.

### PAGE ###
ist die angezeigte Seitennummer.

Seiten-Navigation
ist die Vorlage für die Darstellung der gesamten Seitennavigation und bietet folgende Platzhalter:

### PAGE_REWIND ###
ist der Link (Text und URL) zur vorherigen Albumseite.

### PAGINATION ###
ist die gesamte Navigation mittels Seitennummern.

### PAGE_FORWARD ###
ist der Link (Text und URL) zur nächsten Albumseite.

Anzeige-Vorlage
isz die HTML-Vorlage für das Pop-Up-Fenster. Achten sie hierbei darauf, daß es sich um eine komplette HTML-Seite handelt! Es stehen folgende Platzhalter zur Verfügung:

### ALBUM_TITLE ###
ist der Name des angezeigten Albums.

### ALBUM_CSS ###
bindet _cfg/style.css oder _cfg/style.css.dist ein.

### ALBUM_TRANSITION_IN ###
bindet das Meta-Tag für Page-Enter ein, daß den Seitenübergang initiiert.

### ALBUM_TRANSITION_OUT ###
bindet das Meta-Tag für Page-Exit ein, daß den Seitenübergang für das Verlassen definiert.

### ALBUM_DESCRIPTION ###
ist der Beschreibungstext des gesamten Albums.

### ALBUM_BESCHREIBUNG ###
ist die Bildbeschreibung, die ggf. eingegeben wurde. (diese wird mit zwei Zeilenschaltungen (kein <br>) versehen, damit sie als "alt"- und "titel"-Tag benutzt werden kann)

### ALBUM_PIC_NUMBER ### und ### ALBUM_PICS_TOTAL ###
geben die Nummer des aktuellen Bildes sowie die Gesamtzahl aus. Damit lässt sich eine Anzeige der Form "Bild n von m" erzeugen.

### ALBUM_JAVASTRING ###
ist ein sich ändernder Code, der das jeweils nächst Bild aufruft. Dieser wird im Head-Bereich eingebunden, um das automatische Ablaufen der Diashow zu erreichen.

### ALBUM_JS_PRELOAD ###
ist ein Javascript-Code, der am Ende des Templates eingesetzt wird, damit das nächste Bild vorausgeladen wird, nachdem die Anzeige fertiggestellt wurde.

### ALBUM_SPEED ###
ist die eingestellte Geschwindikeit mit 1000 multiplziert, also eine Angabe in Millisekunden.

### ALBUM_WIDTH ###
ist die eingestellte maximale Breite des Diashow-Bildes.

### ALBUM_HEIGHT ###
ist die eingestellte maximale Höhe des Diashow-Bildes.

### ALBUM_PIC ###
ist das anzuzeigende Bild inkl. Link und "alt"-Text

### ALBUM_PIC_NAME ###
ist der Dateiname des angezeigten Bildes.

### ALBUM_PIC_WIDTH ### und ### ALBUM_PIC_HEIGHT ###
sind die Abmessungen des Diashow-Bildes und kann z.B. für die Definition eines Pop-Ups genutzt werden.

### ALBUM_PIC_ORG_WIDTH ### und ### ALBUM_PIC_ORG_HEIGHT ###
sind die Abmessungen des Original-Bildes und kann z.B. für den alt-Text oder eine Bildunterschrift genutzt werden.

### ALBUM_PIC_USER ###
ist der User, der das Bild eingestellt hat.

### ALBUM_PIC_TIMESTAMP ###
ist der in der Datenbank gespeicherte Zeitstemple des Bildes im Format JJJJ-MM-TT hh:mm:ss

### ALBUM_PIC_DATE ###
ist der in der Datenbank gespeicherte Zeitstemple des Bildes in dem Format, das in den ConPresso-Systemeinstellungen eingestellt wurde.

### ALBUM_SHOW_ORIG ###
ist der unter "Originalbild-Link" eingegebene Text.

### ALBUM_ORIG_SIZE ###
ist eine "human-readable" Angabe zur Größe des Originalbildes.

### ALBUM_SHOW_STOP ###
ist der unter "Pause" angegebende Text (wird beim letzten Bild nicht ausgegeben)

### ALBUM_SHOW_WAIT ###
ist der unter "Warte-Hinweis" angegebende Text (wird beim letzten Bild nicht ausgegeben)

### ALBUM_HREF_NEXT ###
ist die URL zum nächsten Bild (wird beim letzten Bild nicht ausgegeben). Beim letzten Bild wird die URL zum Neustart ausgegeben.

### ALBUM_SHOW_NEXT ###
ist der unter "Nächstes Bild" angegebende Text (wird beim letzten Bild nicht ausgegeben). Beim letzten Bild wird der unter "Wiederholen-Hinweis" eingegebene Text angezeigt.

### ALBUM_NEXT_PIC ###
ist der Dateiname des nächsten Bildes und kann in eigenen Codes eingesetzt werden.