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:
<!-- ifSet: mod_gallery; --> / <!-- ifNotSet: mod_gallery; -->
bei Vorhandensein eines Albums für den Artikel wird dieser Wert belegt und lässt sich für bedingte Ausgaben heranziehen, um z.B. nur dann einen Rahmen zu zeichnen.
<!-- 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; -->
ist der Dateiname eines Zufallsbildes, das zur Gestaltung des Artikels verwendet werden kann
<!-- SLIDESHOW: Picturen; --> (n ist eine ganze Zahl in aufsteigender Reihenfolge)
ist der Dateiname eines Zufallsbildes, das zur Gestaltung des Artikels verwendet werden kann, wobei bereits verwendete Bilder nicht erneut ausgegeben werden. Damit lässt sich z.B. eine (ständig wechselnde) Bildreihe ausgeben
Sollte es kein Bilderalbum für den Artikel geben, dann werden die Platzhalter nicht genutzt und aus dem Seitenquelltext entfernt.
*** Neu in ConPresso 4.1.x ***
Durch die neuen Seitentemplates in ConPresso ab 4.1.x ergeben sich neue Ausgabemöglichkeiten.
Durch die Angabe von <!-- Function: ModGallery; --> wird an der gewünschten Stelle im Seitentemplate eine kleine Galerie mit Zufallsbildern aus allen zugänglichen Alben ausgegeben.
Hierfür sind noch ein paar Parameter erforderlich:
Duch die Angabe von number=n wird die Anzahl der Bilder bestimmt.
Durch die Angabe von link=(album|image) wird entweder bei Klick auf die Bilder auf das Album oder das Eizelbild verlinkt. Default ist image.
Durch die Angabe von format=(protrait|landscape) kann die Orientierung der Bilder auf hoch- oder querformatige Bilder eingeschränkt werden. Default ist eine Einschränkung, also hoch- und querformatige Bilder gemischt.
Beispiel:
<!-- Function: ModGallery; number=5; link=image; format=landscape; -->
erzeugt einen schmalen Streifen von 5 querformatigen Bildern, die auf das jeweilige Galeriebild verlinken.
Für 4.0.x-Installationen kann die Funktion in der Form
<?php echo ModGallery($num,$format=false,$link=false); ?>
benutzt werden.
Für die Formatierung sollte auf einen DIV-Container und verschachtelte CSS-Anweisungen zurückgegriffen werden.
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.
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_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_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.
### PAGE_TEXT ###
ist der für "Seiten" eingegebene Begriff.
### 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 eingegebene "Fenster-Titel".
### ALBUM_CSS ###
bindet _cfg/style.css oder _cfg/style.css.dist ein.
### ALBUM_TRANSITION_IN ### / ### ALBUM_TRANSITION_OUT ###
bindet ein vollständiges Meta-Tag für Page-Enter / Page-Exit ein, das den Seitenübergang initiiert.
### ALBUM_DESCRIPTION ###
ist die Albumbeschreibung, die ggf. eingegeben wurde.
### 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_JAVASTRING ###
ist ein sich ändernder Code, der das jeweils nächst Bild aufruft (Achtung: Im Template selbst ist dazu noch weiterer Code erforderlich! Dies ist nur der sich ändernde Teil!)
### 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_NUMBER ###
ist der laufende Nummer des angezeigten Bildes.
### ALBUM_PIC_TOTAL ###
ist die Gesamtzahl der Bilder des ALbums.
### 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 wird für für ein Vorausladen des nächsten Bildes benötigt. (Achtung: Im Template selbst ist dazu noch weiterer Code erforderlich! Dies ist nur der sich ändernde Teil!)
### ALBUM_HREF_PREV ###
ist die URL zum vorherigen Bild (wird beim ersten Bild auf dieses Bild selbst gelenkt).
### ALBUM_SHOW_PREV ###
ist der unter "Vorheriges Bild" angegebende Text (wird beim ersten Bild durch den "Hinweis kein vorh.Bild" ersetzt).
### ALBUM_PREV_PIC ###
ist der Dateiname des vorherigen Bildes.