- baseportal Dokumentation

Titel:

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.

<h2>Variablen über die URL weitergeben</h2>

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

<h2>Variablen über Tag-Parameter weitergeben</h2>

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

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

...zu folgender Ausgabe:

<codeparse>
<div style="text-align:center;font-weight:bold">Einleitung</div>
</codeparse>

Eine Reihe von Werten werden von baseportal in Spezialvariablen bereitgehalten. Sie beginnen (fast) immer mit einem Unterstrich <c>_</c>. Obwohl es möglich ist, sollten Sie also auf eigene Variablen, die mit einem Unterstrich beginnen, verzichten.

<h2>Datenbank-Abruf:</h2>

<tab>
Variable|Bedeutung
$_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
</tab>

<h2>Parameter und Abfragewerte:</h2>

<tab>
Variable|Bedeutung
%_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)
%_put_last|Tatsächlich geschriebene Werte
$_put_id|ID des zuletzt geschriebenen Datensatzes
%_raw|Ungefilterte Ausgabe von Feldern (z.B. bei Datum, Link oder Email) - man erhält den tatsächlichen Inhalt des Feldes
%_loop|Enthält den aktuellen Datensatz bei <c><loop></c> oder <c>get; get_next();</c>
%_|Enthält die Werte der Parameter eines per XML selbst-definierten Tags
</tab>

Durch <c>%_cgi</c> und <c>%_get</c> 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: <c>$_get{"Mein Name"}; $_cgi{"12345"};</c>

<h2>Rechteverwaltung</h2>

<tab>
Variable|Bedeutung
$uid|Name des Nutzers (über die URL)
$upw|Passwort des Nutzers (über die URL, wird bei der Anmeldung übermittelt)
$sid|Session-Id des Nutzers (über die URL)
$_user|Name des angemeldeten Nutzers. Definiert leer, wenn Anmeldung fehlgeschlagen
%_user|Feldinhalte der Nutzer-Datenbank des angemeldeten Nutzers
$_session|Session-Id des Nutzers
%_session|Hash zum Weiterreichen von (internen) Session-Variablen
</tab>

<h2>Umgebungsvariablen</h2>

Name: Passwort: Stichworte: Version: 1 2 3 Angebot:

Ohne Änderungen zurück zur Seite

Neue Seite erstellen