floppy-isdn4linux Version 3.6.2 - Fli4l

srv/www/admin/OpenVPN.cgi
/srv/www/css/OpenVPN.css
/srv/www/lang/OpenVPN.de
8. Entwickler-Dokumentation
Sowohl das Benutzen von Sprachdateien als auch von CSS-Dateien ist optional. Immer Eingebunden
werden css/main.css und lang/main.xx wobei ’xx’ der gewählten Sprache entspricht.
Der Funktion show_html_header können aber neben dem Titel noch weitere Parameter
übergeben werden. Ein Aufruf mit allen möglichen Parametern könnte so aussehen:
show_html_header "Titel der Seite" "refresh=$time;url=$url;cssfile=$cssfile;showmenu=no
Alle zusätzlichen Parameter müssen, wie im Beispiel gezeigt, mit Anführungszeichen umschlossen
und durch ein Semikolon getrennt werden. Eine Überprüfung der Syntax erfolgt
NICHT! Es ist also notwendig sehr genau auf die Parameterübergabe zu achten.
Hier eine kurze Übersicht über die Funktion der Parameter:
• refresh=$time: Zeit in Sekunden in der die Seite vom Browser neu geladen werden soll.
• url=$url: Die URL die bei einem Refresh neu geladen wird.
• cssfile=$file: Name einer CSS-Datei, wenn diese vom Namen des CGIs abeicht.
• showmenu=no: Damit kann die Anzeige des Menüs und des Headers unterdrückt werden.
Sonstige Richtlinien zum Inhalt:
• Fasst euch kurz :-)
• Schreibt sauberes HTML (SelfHTML ist da ein guter Ansatzpunkt)
• Verzichtet auf hochmodernen Schnick-Schnack (JavaScript ist OK, wenn es nicht stört,
sondern den Benutzer unterstützt, das ganze muß auch ohne JavaScript funktionieren)
Die show_tab_header Funktion
Damit der Inhalt eurer mithilfe des CGI erzeugten Webseite auch hübsch geordnet aussieht
könnt ihr die cgi-helper Funktion show_tab_header nutzen. Sie erzeugt dann anklickbare
’Tabs’, so dass ihr eure Seite in mehrere Bereiche unterteilen könnt, oder einfach nur eine
Titelzeile (ein Tab).
Der show_tab_header Funktion werden Parameter immer in Paaren übergeben entgegen.
Der erste Wert entspricht dem Titel eines Tabs, der 2. dem Link. Wird als Link die Zeichenkette
’no’ übergeben, wird lediglich der Titel ausgegeben und der Tab ist nicht anklickbar (und blau).
Im folgenen Beispiel wir ein ’Fenster’ mit dem Titel ’Ein tolles Fenster’ erzeugt. Im Fenster
steht ’foo bar’:
show_tab_header "Ein tolles Fenster" "no"
echo "foo"
echo "bar"
show_tab_footer
334