3.2 Platzhalter und Parameter

Die Parameter werden wie die üblichen ConPresso-Parameter durch Semikolon (;) getrennt mit in den HTML-Kommentar geschrieben.

Beispiele:

<!-- Text: Name; title; author; needed=Bitte geben Sie einen Namen an; -->
für ein erforderliches Namesfeld, dessen Inhalt als Titel und Autor des Artikel dient

oder

<!-- Text: Email; authoremail; mailcheck=Bitte prüfen Sie die Mailadresse; needed;-->
für ein erforderliches E-Mail-Feld, dessen Inhalt geprüft und als Autoren-Email verwendet wird

oder

<!-- Text: Nachricht; type=textarea; cols=40; rows=5; needed=Bitte geben Sie eine Nachricht ein; -->
für ein großes erfoderliches Textfeld, das als "Nachricht" gespeichert wird

Neu seit 4.0a -> Neben dem einfach zu handhabenden Text-Platzhalter werden auch alle anderen Artikelinhalt-Platzhalter sinngemäß umgewandelt:

<!-- Text: Platzhaltername; --> und
<!-- HTML: Platzhaltername; -->
werden als normale Eingabefelder ausgegeben. Der Unterschied liegt in der Behandlung von HTML-Entities (Sonderzeichen wie <, > und & etc.)

<!-- Image: Platzhaltername; -->
erzeugt ein Upload-Feld. Die hochgeladene Datei wird darauf geprüft, ob es sich um ein Bild handelt, im System eingetragen und dann dem Artikel zugeordnet.

<!-- File: Platzhaltername; -->
erzeugt ein Upload-Feld. Die hochgeladene Datei wird darauf geprüft, ob es sich um eine Datei (kein Bild!) handelt, im System eingetragen und dann dem Artikel zugeordnet.

<!-- Url: Platzhaltername; -->
erzeut ein normales Textfeld, dessen Inhalt als URL gespeichert und dem Artikel zugeordnet wird. Für dieses Feld ist eine Prüfung mittels urlcheck möglich.

Hier nun eine Liste der Möglichen Parameter und ihrere Anwendung:

needed;
sorgt für die Prüfung auf Eingaben und Verweigert das Speichern, wenn keine Eingabe erfolgt.

needed=Fehlermeldung;
gibt statt des Standardfehlers einen belibigen Text aus

mailcheck=Meldung;
führt eine Prüfung der Syntax der Mailadresse durch und ggf. eine Fehlermeldung aus

title;
speichert die Eingabe als Artikeltitel. Bei mehreren title-Feldern werden deren Inhalte durch "/" getrennt.

author;
speichert diese Eingabe als Artikelautor

authoremail;
speichert diese Eingabe als Autoren-Email

disabled;
ausgegraute Formularfelder (sinnvoll in Verbindung mit Feldübergabe mittels URL)

datecheck;
die Eingabe wird auf Gültigkeit im gregorianschen Kalender geprüft (fehlende Angaben werden dabei ergänzt)

idx;
die ersten 6 Stellen der Eingabe werden als Artikelindex verwendet. Ist gleichzeitig datecheck angegeben, wird die Eingabe als Datum in der Form JJMMTT gespeichert.
ConPresso sortiert standardmäßig nach diesem Index, so daß sich Termine automatisch richtig einordnen oder z.B. Mitgliederlisten automatisch sortiert sind

Defaultmäßig werden die Felder als <input type="text"... erzeugt
Durch die Angabe von type= kann zwischen den verschiedenen Formularelementen gewählt werden

type=textarea;
erzeugt eine textarea

type=hidden;
erzeugt ein hidden-Feld

type=checkbox;
erzeugt eine Checkbox

type=radio;
erzeugt einen Radiobutton (wobei der immer ein paar gleichnamige Kumpels bekommen sollte)

type=select;
erzeugt ein Auswahl-Feld

type=fixed;
Darstellung als reiner Text mit angefügtem Hiddenfeld (sinnvoll in Verbindung mit Feldübergabe mittels URL)

type=datepicker;
erzeugt einen Datumswähler

diese Typen benötigen z.T. weitere Angaben in dieser Form:

size=Zahl;
erzeugt eine Size-Angabe in Textfeldern

checked;
erlaubt die Vorselektion bei Optionsfeldern (type=radio) 

cols=Zahl; und rows=Zahl;
machen dies analog für eine Textarea

value=Wert;
dient der Belegung von Checkboxen und Radiobuttons mit Werten

class=CSS-Klasse;
erlaubt die Angabe einer CSS-Klasse bei Text und Textarea

values=Text1,Text2,Text3,...
erzeugt die Werte für das Auswahlfeld (Trennung durch Kommata)