Die folgenden Platzhalter sollten nur im Abschnitt "Artikelseite" des Artikeltemplates verwendet werden, da sie Formularelemente zum Eintragen in das Gästebuch bereitstellen.
Die Platzhalter dieses Typs stellen Formularfelder bereit, mit deren Hilfe Texte ins Gästebuch eingetragen werden können, ähnlich den Formularfeldern beim Erstellen eines Artikels im ConPresso-Backend.
Zur Ausgabe dieser Daten muss es Platzhalter mit gleichem Namen, aber vom Typ "text" in den Abschnitten "Rubrikseite" und "Javascript/PHP" des Artikeltemplates geben. Denn der Platzhalter "<!-- text: beliebigerName; -->" gibt den Text aus, der über den Platzhalter "<!-- gb_text: beliebigerName; -->" eingegeben wurde.
Einige der Metadaten eines Artikels (Artikel-Titel, Name und E-Mail des Autors) können über Platzhalter von diesem Typ mit Inhalt gefüllt werden.
Demnach gibt es die speziellen Platzhalter "<!-- gb_text: title; -->", "<!-- gb_text: author; -->" und "<!-- gb_text: email; -->", deren Daten über Platzhalter vom Typ "Value" ausgegeben werden. Nähere Informationen dazu können Sie im Abschnitt 3.1.1, "Value-Platzhalter" nachlesen.
type |
Mithilfe dieser Option wählt man zwischen folgenden Formularelementen: "Eingabefeld (input)", "Eingabebereich (texarea)", "Checkbox", "Radio-Button" und "Auswahlliste". Standardmäßig werden "Eingabefelder (input)" oder "Eingabebereiche (texarea)" verwendet, je nachdem, ob in den Platzhaltereinstellungen des gleichnamigen Platzhalters vom Typ "text" die Option "Kurztext" gewählt wurde oder nicht. Folgende Typen sind möglich: |
||||||||||||||||||||||||||||||||||||||||||||||||||
needed |
Markiert ein Formularfeld als Pflichtfeld. |
||||||||||||||||||||||||||||||||||||||||||||||||||
mailcheck |
Überprüft die gesendete E-Mail auf Korrektheit. |
||||||||||||||||||||||||||||||||||||||||||||||||||
badwords |
Schaltet für dieses Felde die Überprüfung nach Badwords ein, die in den Moduleinstellungen eingetragen wurden. |
||||||||||||||||||||||||||||||||||||||||||||||||||
size |
Bestimmt die Anzeigebreite des Elements bei "type=text;" oder es bestimmt die Anzeigehöhe der Liste bei "type=select;". |
||||||||||||||||||||||||||||||||||||||||||||||||||
maxlength |
Bestimmt die maximale Anzahl erlaubter Zeichen im Element bei "type=text;". |
||||||||||||||||||||||||||||||||||||||||||||||||||
cols |
Bestimmt die Anzahl Zeichen pro Zeile bei "type=textarea;". |
||||||||||||||||||||||||||||||||||||||||||||||||||
rows |
Bestimmt die Anzahl sichtbarer Zeilen bei "type=textarea;". |
||||||||||||||||||||||||||||||||||||||||||||||||||
tabindex |
Bestimmt die Tabulator-Reihenfolge für Formularelemente durch Angabe einer Zahl. |
||||||||||||||||||||||||||||||||||||||||||||||||||
accesskey |
Bestimmt ein einzelnes Zeichen als Hotkey für das Element. |
||||||||||||||||||||||||||||||||||||||||||||||||||
class |
Ordnet dem Formular-Element eine Stylesheet-Klasse zu. |
||||||||||||||||||||||||||||||||||||||||||||||||||
value |
Absendewert des Formularfeldes bei Verwendung der Option "type=radio;" und "type=checkbox;". |
||||||||||||||||||||||||||||||||||||||||||||||||||
label |
Text der anklickbaren Beschriftung ("label"-Element) bei Verwendung der Option "type=radio;" und "type=checkbox;". |
||||||||||||||||||||||||||||||||||||||||||||||||||
values |
Legt die verschiedenen Absendewerte der Auswahlliste bei Verwendung der Option "type=select;" fest. |
||||||||||||||||||||||||||||||||||||||||||||||||||
abbc |
Dies ermöglicht die Eingabe von BB-Code, der aus Tags mit eckigen Klammern besteht, ähnlich den HMTL-Tags. Ist diese Option gesetzt, so wird als Typ automatisch "type=textarea;" verwendet, egal ob und wie diese Option gesetzt ist. Im Modulverzeichnis liegt eine CSS-Datei, welche den zu HTML-Code umgewandelten BB-Code entsprechend hervorhebt, sie hat den Namen "mod_guestbook.css(.dist)" und wird standardmäßig in der Datei "_local_header.php(.dist)" aufgerufen. Dieser Aufruf sollte gegebenenfalls in den "global_header.php(.dist)" geschreiben werden, damit er im "HTML-<head>" steht. Dieser BB-Code heißt hier im Modul "abbc"-Code, das kommt von "AdvancedBBCode", da die Umwandlungsfunktionen dieses Codes unter diesem Namen veröffentlicht wurden. Eine Vorschau der Möglichkeiten dieses "abbc"-Codes finden Sie auf der AdvancedBBCode-Demoseite. Standardmäßig wird eine Menüleiste über dem Eingabebereich (textarea) ausgegeben, welche Links zur Verfügung stellt, um die verschiedenen BB-Code-Tags in das "textarea"-Feld einzufügen. Diese BB-Code-Tags werden mit Hilfe von Javascript eingefügt. Die folgenden Werte müssen dabei durch "Komma (,)" getrennt werden, damit in dieser Reihenfolge eine Menüleiste zusammengestellt wird.
|
Beispiel 3.25. Gb_text-Platzhalter
Input oder Textarea-Feld, je nach Platzhaltereinstellungen: <!-- gb_text: beliebiger_Name; --><br /> Typ Text (input), Pflichtfeld, nach Badwords suchen: <!-- gb_text: beliebiger_Name; type=text; needed=Tragen Sie in dieses Feld etwas ein; badwords; --><br /> Typ Text (input) mit angegegebener Größe, maximaler Länge und CSS-Klasse: <!-- gb_text: beliebiger_Name; type=text; size=20; maxlength=25; class=eingabefeld; --><br /> Typ Text (input) mit Tabindex und Accesskey: <!-- gb_text: beliebiger_Name; type=text; tabindex=2; accesskey=a; --><br /> Typ Text (input), spezielles Feld "Autor", als Pflichtfeld: <!-- gb_text: author; needed=Geben Sie Ihren Namen an!; --><br /> Typ Text (input), spezielles Feld "E-Mail", als Pflichtfeld mit E-Mail-Kontrolle: <!-- gb_text: email; needed=Wie ist Ihre E-Mail?; mailcheck=Überprüfen Sie Ihre E-Mail!; --><br /> Typ Text (input), spezielles Feld "Artikeltitel" bzw. "Betreff", als Pflichtfeld: <!-- gb_text: title; needed=Tragen Sie ein Betreff ein!; --><br /> Typ Textarea, mit einigen Optionen, z.B. Badwords unabhängig von Groß- und Kleinschreibung: <!-- gb_text: beliebiger_Name; type=textarea; needed; cols=50; rows=10; badwords=kleingroß; --><br /> Typ Radio-Button mit 3 Auswahlmöglichkeiten: <!-- gb_text: beliebiger_Name; type=radio; value=Wert1; label=Hiermit wählen Sie Wert 1; needed=Eine Möglichkeit müssen Sie schon auswählen; --><br /> <!-- gb_text: beliebiger_Name; type=radio; value=Wert2; label=Hiermit wählen Sie Wert 2; --><br /> <!-- gb_text: beliebiger_Name; type=radio; value=Wert3; label=Hiermit wählen Sie Wert 3; --><br /> Typ Radio-Button mit Frage nach Häufigkeit des Besuchs auf dieser Seite: <!-- gb_text: Besuch; type=radio; needed=Bitte wählen Sie bei "Besuch", wie oft Sie schon auf unserer Seite waren!; value=zum ersten Mal; label=Ich bin zum ersten mal hier zu Besuch.; --><br /> <!-- gb_text: Besuch; type=radio; needed; value=war schonmal da; label=Ich war schonmal auf dieser Seite.; --><br /> <!-- gb_text: Besuch; type=radio; needed; value=regelmäßig; label=Ich bin regelmäßig auf dieser Seite.;--> Typ Checkbox, mit beispielhafter Frage: <!-- gb_text: beliebiger_Name; type=checkbox; needed=Ist Ihre Anfrage ernst gemeint?; value=Ernsthaft-Ja; label=Hiermit versichere ich, dass dies eine ernsthafte Anfrage (und kein Spam) ist!; --><br /> Typ Auswahlliste, 2 Werte gleichzeitig zeigen: <!-- gb_text: beliebiger_Name; type=select; size=2; class=pizzaliste; values=Pizza Napoli,Pizza Funghi,PizzaMare,Pizza Calzone,Pizza con tutti; --><br /> Eingabebereich mit BB-Code und impliziter Typangabe (fehlend, nur durch Option "abbc" festgelegt), als Pflichtfeld, Standard Menüleiste: <!-- gb_text: Nachricht; needed=Sie müssen noch einen Nachricht eintragen; abbc; --><br /> Eingabebereich mit BB-Code und expliziter Typangabe, keine Menüleiste, als Pflichtfeld: <!-- gb_text: Nachricht; type=textarea; needed=Haben Sie uns nicht mitzuteilen?; abbc=none; --><br /> Eingabebereich mit BB-Code und individueller Menüleiste, als Pflichtfeld: <!-- gb_text: Nachricht; needed; abbc="Einfache Schriftformatierung:",b,u,i,s,o,m,sup,sub,<br>, "Hyperlinks & Listen: ",url,mail,img,list,listp,<br>, "Andere: ",br,line,#,quote,code,<br>, "Weitere Formatierungen einblenden:",smilies,color,size,<br>,font,mark; --><br />
Die Platzhalter dieses Typs stellen Formularfelder bereit, mit deren Hilfe URL's ins Gästebuch eingetragen werden können.
Zur Ausgabe dieser Daten muss es Platzhalter mit gleichem Namen vom Typ "url" in den Abschnitten "Rubrikseite" und "Javascript/PHP" des Artikeltemplates geben. Denn ein Platzhalter "<!-- url: beliebigerName; -->" gibt den Link aus, der über den Platzhalter "<!-- gb_url: beliebigerName; -->" eingegeben wurde.
Dieser Platzhalter funktioniert ähnlich wie "gb_text", es werden aber nur einzeilige Eingabefelder (input) ausgegeben.
Der "Verweistext" kann nicht gesondert eingetragen werden, statt dessen wird "http://" von den URL's abgeschnitten und als "Verweistext" verwendet.
Beispiel 3.26. Gb_url-Platzhalter
URL ohne Optionen: <!-- gb_url: beliebiger_Name; --><br /> URL als Pflichtfeld, nach Badwords suchen: <!-- gb_url: Homepage; needed=Tragen Sie Ihre Homepage ein!; badwords; --><br /> URL mit angegegebener Größe, maximaler Länge und CSS-Klasse: <!-- gb_url: beliebiger_Name; size=20; maxlength=25; class=eingabefeld; --><br /> URL mit Tabindex und Accesskey: <!-- gb_url: beliebiger_Name; tabindex=3; accesskey=a; --><br />
Diese Platzhalter geben bestimmte Links, Formular-Buttons bzw. ein Captcha aus.
Sie können meistens in Verbindung mit "ifSet" und "ifNotSet" verwendet werden.
Weitere Informationen und zwei Beispiele dazu stehen im Abschnitt 3, "Bedingte Platzhalter (ifSet/ifNotSet)".
Weitere Platzhalter vom Typ "guestbook" finden Sie im Abschnitt 3.1.3, "Guestbook-Platzhalter"
Es gibt die folgenden Value-Platzhalter:
"submit" |
Gibt einen Formular-Button zum Absenden eines Eintrags aus. Es gibt für diesen und den nächsten Platzhalter die folgenden Ausgabeoptionen: |
||||||||
"reset" |
Gibt einen Formular-Button zum Zurücksetzen des Formulars aus. Es sind die gleichen Ausgabe-Optionen, wie bei dem bereits beschriebenen "submit"-Platzhalter verfügbar. |
||||||||
"captcha" |
Dieser Platzhalter hat den Zweck, möglichst viele Spam-Einträge vom Gästebuch fernzuhalten. Es gibt die folgenden Ausgabeoptionen: Beispiel 3.29. Captcha-Platzhalter Ohne Optionen: <!-- guestbook: captcha; --><br /> Typ "image" mit "message": <!-- guestbook: captcha; type=image; message=Die eingegebene Zahl und die im Bild sind nicht gleich!; --><br /> Typ "calc" mit "class" und "message": <!-- guestbook: captcha; type=calc; class=klein; message=Sie haben sich verrechnet!; --><br /> Typ "calc" mit "noimage", "input" und "message": <!-- guestbook: captcha; type=calc; noimage; message=Verrechnet ??;--><br /> Ergebniss hier eintragen: <!-- guestbook: captcha; input;--><br /> Typ "radio" mit "label1" und "label2": <!-- guestbook: captcha; type=radio; label1=Andere Option wählen!; label2=Diese Option wählen!; --><br /> Typ "radio" mit "jscript": <!-- guestbook: captcha; type=radio; jscript; --><br /> |
||||||||
"link2gb" |
Gibt einen Link zu den Einträgen des Gästebuchs (index.php) aus. D.h. sollte dieser Platzhalter im Abschnitt "Artikelseite" des Artikeltemplates stehen. Es gibt fast die gleichen Ausgabeoptionen, wie bei den ConPresso-Platzhaltern vom Typ "url", mit der Ausnahme, dass kein Target ausgegeben wird, da dies über das Formular nicht eingegeben werden kann. Die gleichen Ausgabeoptionen sind auch bei den folgenden Platzhaltern verfügbar: "link2comment", "link2quote", "link2edit", "link2enter" und "fastedit".
Beispiel 3.30. Link2gb-Platzhalter Ohne Optionen: <!-- guestbook: link2gb; --> Nur Starttag: <!-- guestbook: link2gb; starttag; -->Anderer Text</a> URL: <!-- guestbook: link2gb; url; --> Verweistext: <!-- guestbook: link2gb; text; --> Nur das Target: <!-- guestbook: link2gb; target; --> Ohne HTML-Code: <!-- URL: eine URL; strip_tags --> |