baseportal Dokumentation

Variablen sind "Platzhalter" für Werte und werden wie in vielen Programmiersprachen eingesetzt. Einfache Variablen beginnen mit dem $-Zeichen und müssen mit einem Buchstaben beginnen, gefolgt von weiteren Buchstaben, Zahlen oder Unterstrichen (Beispiele: $Text, $Mein_Name, $urx_123). Inhalte von Variablen können beliebig lang sein und aus Zahlen, Texten oder beliebigen anderen Zeichen bestehen.

Die über eine URL oder in einem baseportal-Tag angegebenen Parameter werden automatisch als Variablen zur Verfügung gestellt.

Beispiele:

<perl><br> out "Zähler: ",$cnt++,"<p>";<br> out '<a href="/cgi-bin/baseportal.pl?htx=/zaehler&cnt=',$cnt,'">Weiter';<br> </perl>

Dieses Code-Stück fungiert als Zähler. Jeder Klick auf "Weiter" erhöht die Zahl um 1. Dies geschieht durch die Variable $cnt, deren Wert durch den Parameter in der URL weitergegeben wird und im Template zur Verfügung steht.

Pfiffig ist der Einsatz von Variablen, um HTML-Bausteine individuell anzupassen:

<font face=arial,helvetica color=red><h2 align=center>$Text</h2></font>

Die Variable $Text wird nun mit dem aktuellen Wert ersetzt. Angenommen obige Zeile wird im Template titel gespeichert, so führt der Einbau in eine andere Seite durch...

<include src=titel Text=Einleitung>

...zu folgender Ausgabe:

Einleitung

Spezialvariablen

Eine Reihe von Werten werden von baseportal in Spezialvariablen bereitgehalten. Sie beginnen immer mit einem Unterstrich "_". Obwohl es möglich ist, sollten Sie also auf eigene Variablen, die mit einem Unterstricht beginnen, verzichten.

Datenbank-Abruf:

$_db
Name der zuletzt genutzten Datenbank

$_id
ID des Datensatzes

$htx
zuletzt aufgerufenes Template "baseportal.pl?htx=$htx"

$_loop
fortlaufende Nummer der geholten Datensätze

$_range
Ausgabebereich Start

$_range_length
Ausgabebereich Anzahl

$_amount
Anzahl Datensätze die beim letzten Abruf tatsächlich geholt wurden.

$_amount_query
Anzahl Datensätze die beim letzten Abruf ohne "range" geholt worden wären.

$_amount_all
Anzahl Datensätze die in der zuletzt genutzten Datenbank insgesamt enthalten sind.

Parameter und Abfragewerte:

%_cgi
Werte die über CGI (GET oder POST) mit "=" übergeben wurden
(z.B. Farbe=Rot)

%_get
Werte die über CGI, in Tags oder über eine Datenbank-Abfrage gesetzt wurden
(z.B. Farbe=Rot)

%_sel
Abfragewerte (z.B. Name==a)

%_put
zu schreibende Werte (z.B. Name:=Hans)

Durch die "Hashes" %_cgi und %_get können auch Parameter abgefragt werden, die nicht über Variablen zugänglich sind, weil sie für Variablennamen unzulässige Zeichen enthalten (z.B: Leerzeichen, Sonderzeichen usw.) oder weil Sie durch eigene Variablen überschrieben wurden. Beispiele: $_get{"Mein Name"}; $_cgi{"12345"};