Ein ConPresso-Platzhalter besteht grundsätzlich mindestens aus einem "Typ" und einem "Namen". Der Aufbau eines Platzhalters folgt dem Schema: <!-- Typ: Name -->

Platzhalter werden in ConPresso in Form eines HTML-Kommentars geschrieben. Dies hat den Vorteil, dass ein fehlerhafter Platzhalter-Tag als Kommentar im generierten Ausgabecode ausgegeben wird und damit im Frontend des Projekts für den Betrachter nicht direkt als Fehler sichtbar ist.

Alle Platzhalter liefern bei ihrer Ausgabe im Frontend per Default korrektes XHTML zurück.

ConPresso stellt verschiedene Typen von Platzhaltern bereit, die der Ein- und Ausgabe unterschiedlicher Inhaltsformen dienen. Hierzu gehören u.a. Platzhalter für Texte, Bilder oder Dateien.

ConPresso unterstützt in der Grundform die folgenden Platzhalter:

Weiterhin sind Platzhalter für die "Bedingte Ausgabe" von Inhalten vorhanden. Diese erlauben es, Teile des Artikeltemplates nur dann auszugeben bzw. abzuarbeiten, wenn der dazugehörige Platzhalter entweder leer oder mit Inhalt gefüllt ist:

Bei einigen der nachfolgend aufgezählten Platzhaltertypen wird in der Beschreibung das Stichwort "Entity-Umwandlung" benutzt. Dieses Stichwort bedeutet, dass vor der Ausgabe des jeweilgen Inhalts Sonderzeichen in ihre HTML-Entities umgewandelt werden (Bsp.: ">" wird zu "&gt;", usw.).

	Anmerkung
	Die oben genannten Platzhalter können z.B. durch Module erweitert werden. Sollte ein Modul neue Platzhalter oder zusätzliche Optionen für bestehende Platzhalter bereitstellen, entnehmen Sie die notwendigen Informationen bitte der Dokumentation des entsprechenden Moduls.

Der Name eines Platzhalters dient dazu, diesen eindeutig zu identifizieren. Er wird bei der Artikeleingabe als "Bezeichnung" neben den Eingabefeldern angezeigt. Der Name eines Platzhalters kann frei gewählt werden.

Zusätzlich können zu Platzhaltern weitere Optionen angegeben werden. Diese werden durch ";" getrennt hinter dem Namen angegeben.

Selbstverständlich können auch mehrere Optionen nacheinander angegeben werden. Die einzelnen Optionen werden durch ";" getrennt:

Optionen können in zwei Formen vorkommen:

Über die Optionen wird hauptsächlich die Verarbeitung der Platzhalter bei deren Ausgabe gesteuert. Andere Einstellungen, die die Eingabe eines Platzhalters betreffen, können wie unter „Platzhaltereigenschaften bearbeiten“ beschrieben bearbeitet werden.

Da die Verwendung von Optionen vom Typ eines Platzhalters abhängig ist, entnehmen Sie die genaue Beschreibung der jeweils möglichen Optionen bitte der Beschreibung der Platzhaltertypen.

Platzhalter vom Typ "Image" ermöglichen die Einbindung von Bildern in einen ConPresso-Artikel.

Wird in einem Artikeltemplate ein Platzhalter von Typ "Image" verwendet, so kann der redaktionell arbeitende Benutzer bei der Artikelerstellung bzw. -bearbeitung pro Bild-Platzhalter jeweils ein Bild auswählen. Dieses Bild muss zuvor hochgeladen und für die Rubrik verfügbar gemacht worden sein, wie in Abschnitt 1, "Dateien hochladen" beschrieben.

<img src="../_data/Dateiname" 
     alt="Alttext" 
     title="Beschreibung" 
     width="Breite" 
     height="Hoehe" />
    

Ohne Optionen: <!-- Image: ein Bild; -->
Dateiname:     <!-- Image: ein Bild; file -->
Alttext:       <!-- Image: ein Bild; alttext -->
Bildbreite:    <!-- Image: ein Bild; width -->
Bildhöhe:      <!-- Image: ein Bild; height -->
Beschreibung:  <!-- Image: ein Bild; description -->
    

Platzhalter vom Typ "File" ermöglichen die Einbindung von Dateien in einem ConPresso-Artikel.

Wird in einem Artikeltemplate ein Platzhalter von Typ "File" verwendet, so kann der redaktionell arbeitende Benutzer bei der Artikelerstellung bzw. -bearbeitung pro Datei-Platzhalter jeweils eine Datei auswählen. Diese Datei muss zuvor hochgeladen und für die Rubrik verfügbar gemacht worden sein, wie in Abschnitt 1, "Dateien hochladen" beschrieben.

<a href="../_data/Dateiname">Beschreibung [Dateigröße]</a>
    

Die Dateigröße wird "human readable" - also "menschenlesbar" ausgegeben (z.B. 128Kb).

Ohne Optionen:                 <!-- File: eine Datei --> 
Dateiname:                     <!-- File: eine Datei; file --> 
Dateigröße I (human readable): <!-- File: eine Datei; hrsize --> 
Dateigröße II (Bytes):         <!-- File: eine Datei; size  -->
Beschreibung:                  <!-- File: eine Datei; description -->
    

Platzhalter vom Typ "Text" ermöglichen die Eingabe einfacher, wenig formatierter Texte in einen ConPresso-Artikel.

Sie erzeugen bei der Artikeleingabe einfache Textfelder, so genannte Textareas. Erstellt oder bearbeitet ein redaktionell arbeitender Benutzer den Inhalt eines solchen Textfelds in einem Artikel, so steht ihm dabei nicht der ConPresso-WYSIWYG-Eitor zur Verfügung, der umfangreiche Formatierungen erlauben würde. Platzhalter vom Typ "Text" eignen sich daher besonders dazu, redaktionell arbeitenden Benutzern keine Möglichkeiten zu HTML-Formatierungen (z.B. fett, unterstreichen oder die Verwendung von Farben und Tabellen) zu geben. Damit ist durch die Verwendung einfacher Text-Platzhalter eine striktere Einhaltung der vorgegebenen Formatierungen und des Designs der Seite gewährleistet, als dies bei der Verwendung von Platzhaltern des Typs "HTML" der Fall wäre.

Text
    

HTML-Sonderzeichen werden bei der Ausgabe in Entities umgewandelt.

Ohne Optionen:             <!-- Text: ein Text -->
HTML-Tags entfernt:        <!-- Text: ein Text; strip_tags -->
Zeilenumbrüche als <br />: <!-- Text: ein Text; nl2br -->
Kombiniert:                <!-- Text: ein Text; striptags; nl2br -->
    

Platzhalter vom Typ "HTML" ermöglichen die Eingabe HTML-formatierter Texte in einen ConPresso-Artikel, sofern der verwendete Browser dafür ausgelegt ist.

HTML-Platzhalter erlauben bei der Artikelerstellung oder -bearbeitung die Benutzung des ConPresso-WYSIWYG-Editors, mit dem Inhalte wie mit einem Textverarbeitungprogramm bearbeitet werden können. Redaktionell arbeitende Benutzer haben über den WYSIWYG-Editor weitreichende Möglichkeiten Formatierungen in Texten vorzunehmen. So können beispielsweise Bilder, Tabellen oder Links in den Text eingebunden werden und die Textformatierung (fett, unterstrichen, Textfarbe, etc.) nach Belieben gewählt werden.

Über das Umschalten in den HTML-Modus kann bei der Artikelerstellung der HTML-Code auch direkt editiert werden.

Text mit <b>HTML-Code</b>
    

Ohne Optionen:      <!-- HTML: HTML -->
HTML-Tags entfernt: <!-- HTML: HTML; strip_tags -->
HTML-Entities:      <!-- HTML: HTML; htmlspecialchars -->
Kombiniert:         <!-- HTML: HTML; strip_tags; htmlspecialchars -->
    

Platzhalter vom Typ "URL" ermöglichen die Einbindung von Links in einen ConPresso-Artikel.

<a href="Linkziel" evtl. Target>Verweistext</a>
    

Im Verweistext werden HTML-Sonderzeichen durch Entities ersetzt.

Ohne Optionen:  <!-- URL: eine URL --> 
Nur Starttag:   <!-- URL: eine URL; starttag -->Anderer Text</a> 
URL:            <!-- URL: eine URL; url --> 
Verweistext:    <!-- URL: eine URL; text --> 
Nur das Target: <!-- URL: eine URL; target --> 
Ohne HTML-Code: <!-- URL: eine URL; strip_tags --> 

Sonderfälle (mit obigen Beispielen kombinierbar):

Zurück-Link:      <!-- URL: eine Zurueck-URL; back --> 
Zur Artikelseite: <!-- URL: eine Weiter-URL; more --> 
Zur Artikelseite (kombiniert mit starttag): 
                  <!-- URL: eine Weiter-URL; more; starttag -->anderer Text</a>
    

Value-Platzhalter werden von ConPresso zu jedem Artikel automatisch bereitgestellt. Sie unterscheiden sich hinsichtlich ihres Aufbaus nicht von anderen Platzhaltern, doch statt des sonst frei wählbaren Platzhalternamens sind bei Value-Platzhaltern definierte Werte anzugeben (Beispiel: <!-- Value: Author -->).

Value-Platzhalter können nur zur Ausgabe von Informationen, z.B. von Metadaten wie Titel, Autor, etc. benutzt werden. Eine direkte Eingabe von Inhalten bei der Artikelerstellung ist im Falle dieser Platzhalter also nicht möglich.

Auch Value-Platzhalter können mit Unterstützung des „Template-Editor“ in den Formatierungscode des Artikeltemplates eingefügt werden.

ConPresso kennt die folgenden Value-Platzhalter:

Titel
    

Titel:                  <!-- Value: title -->
Titel (ohne HTML-Tags): <!-- Value: title; strip_tags -->
    

%lt;a href="mailto:Autor-eMail">Autor-Name</a>
    

Autor:     <!-- Value: author --><br /> 
Autorname: <!-- Value: author; name --><br /> 
Autormail: <!-- Value: author; email --><br /> 
Initialen: <!-- Value: author; initials --><br />
    

<a href="mailto:Autor-eMail">Zuletzt bearbeitet von</a>
    

Zuletzt bearbeitet von: <!-- Value: editor --><br /> 
Name:                   <!-- Value: editor; name --><br /> 
Mail:                   <!-- Value: editor; email --><br /> 
Initialen:              <!-- Value: editor; initials --><br />
    

01.01.2006 11:30
    

Publikationsdatum:               <!-- Value: pub_date --><br /> 
Publikationsdatum:               <!-- Value: pub_date; timestamp --> (Unix-Timestamp)<br /> 
Publikationsdatum - Swatch-Time: <!-- Value: pub_date; format=B --> <br /> 
    

02.02.2007 14:15
    

Verfallsdatum:               <!-- Value: exp_date --><br /> 
Verfallsdatum:               <!-- Value: exp_date; timestamp --> (Unix-Timestamp)<br /> 
Verfallsdatum - Swatch-Time: <!-- Value: exp_date; format=B --> <br /> 
    

1
    

Artikelnummer: <!-- Value: articlenr --><br />
    

1
    

Templatemummer: <!-- Value: template --><br />
    

1
    

Artikelindex: <!-- Value: articleidx --><br />
    

<a href="../rubrikverzeichnis/index.php?rubric=rubrikname">Rubriktitel</a>
    

Die Rubrik des Artikels: <!-- VALUE: rubric; -->
Die ID der Rubrik des Artikels: <!-- VALUE: rubric; id; -->
Das Verzeichnis der Rubrik des Artikels: <!-- VALUE: rubric; directory; -->
Der Name der Rubrik des Artikels: <!-- VALUE: rubric; name; -->
Der Titel der Rubrik des Artikels: <!-- VALUE: rubric; title-->
    

Um Inhalte abhängig davon auszugeben, ob ein bestimmter Platzhalter in einem Artikel Daten enthält oder nicht, stehen in ConPresso die beiden folgenden Tag-Paare zur Verfügung.

"Name" steht hierbei für den Namen des Platzhalters, auf den sich der ifSet- bzw. der ifNotSet-Platzhalter bezieht.

<!-- ifSet: ein Text -->Oben wurde ein Text ausgegeben!<br /><!-- /ifSet -->
    

<!-- ifSet: Artikeltext  --><!-- URL: Weiter-Link; more --><!-- /ifSet -->
    

Diese Platzhalter arbeiten unabhängig davon, ob sie auf der Rubrik-Ausgabeseite oder der Artikel-Ausgabeseite Verwendung finden. Es ist also beispielsweise möglich (und auch sinnvoll!), das Erscheinen eines Weiter-Links auf der Rubrik-Ausgabeseite davon abhängig zu machen, ob ein bestimmter Inhalt (z.B. Text) auf der Artikel-Ausgabeseite angezeigt wird.

	Achtung
	Platzhalter für bedingte Ausgaben dürfen nicht geschachtelt werden.

Das bei der ConPresso-Installation angelegte Artikeltemplate "Platzhalter Demo" enthält alle Verwendungsmöglichkeiten von ConPresso-Platzhaltern.