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)