- 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>
Name|Beschreibung
<c>$_db</c>|Name der zuletzt genutzten Datenbank
<c>$_id</c>|ID des Datensatzes
<c>$htx</c>|aufgerufene Seite (über die URL, "..baseportal.pl?htx=$htx")
<c>$_loop</c>|fortlaufende Nummer der geholten Datensätze
<c>$_range</c>|Ausgabebereich Start
<c>$_range_length</c>|Ausgabebereich Anzahl
<c>$_amount</c>|Anzahl Datensätze die beim letzten Abruf tatsächlich geholt wurden.
<c>$_amount_query</c>|Anzahl Datensätze die beim letzten Abruf ohne "range" geholt worden wären.
<c>$_amount_all</c>|Anzahl Datensätze die in der zuletzt genutzten Datenbank insgesamt enthalten sind
</tab>

<h2>Parameter und Abfragewerte:</h2>

<tab>
Name|Beschreibung
<c>%_cgi</c>|Werte die über CGI (GET oder POST) mit "=" übergeben wurden(z.B. Farbe=Rot)
<c>%_get</c>|Werte die über CGI, in Tags oder über eine Datenbank-Abfrage gesetzt wurden (z.B. Farbe=Rot)
<c>%_sel</c>|Abfragewerte (z.B. Name==a)
<c>%_put</c>|Zu schreibende Werte (z.B. Name:=Hans)
<c>%_put_last</c>|Tatsächlich geschriebene Werte
<c>$_put_id</c>|ID des zuletzt geschriebenen Datensatzes
<c>%_raw</c>|Ungefilterte Ausgabe von Feldern (z.B. bei Datum, Link oder Email) - man erhält den tatsächlichen Inhalt des Feldes
<c>%_loop</c>|Enthält den aktuellen Datensatz bei <c><loop></c> oder <c>get; get_next();</c>
<c>%_cookies</c>|Die vom Browser übermittelten "Cookies"
</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>
Name|Beschreibung
<c>$uid</c>|Name des Nutzers (über die URL)
<c>$upw</c>|Passwort des Nutzers (über die URL, wird bei der Anmeldung übermittelt)
<c>$sid</c>|Session-Id des Nutzers (über die URL)
<c>$_user</c>|Name des angemeldeten Nutzers. Definiert leer, wenn Anmeldung fehlgeschlagen
<c>%_user</c>|Feldinhalte der Nutzer-Datenbank des angemeldeten Nutzers
<c>$_session</c>|Session-Id des Nutzers
<c>%_session</c>|Hash zum Weiterreichen von (internen) Session-Variablen
</tab>

<h2>Ausgabe und Fehlerbehandlung</h2>

<tab>
Name|Beschreibung
<c>$_out</c>|Enthält den bisher ausgegebenen Text.
<c>$_outx</c>|Enthält die bisher ausgegebenen Statusmeldungen.
<c>$_error</c>|Fehlername des letzten Fehlers
<c>%_error</c>|enthält (sofern vorhanden) alle verfügbaren Informationen über den letzten Fehler:<br><c>name</c> => nochmals den Fehlernamen des letzten Fehlers<br><c>text</c> => Ausführliche Fehlerbeschreibung des letzten Fehlers in der ausgewählten Sprache<br><c>line</c> => Zeilennummer des Scripts, bei der der Fehler aufgetreten ist<br><c>htx</c> => Name des Templates, in dem der Fehler aufgetreten ist<br><c>from</c> => Funktion in der der Fehler aufgetreten ist
<c>$_error_mode</c>|<i>ungesetzt/leer</i> = Fehler an der Stelle des Auftretens ausgeben<br><c>top</c> = gesammelt zu Beginn<br><c>bottom</c> = gesammelt am Ende<br><c>no</c> = keine Fehler ausgeben
<c>@_error</c>|Array von <c>%_error</c>-Hashes: Alle gesammelten (noch nicht ausgegebenen) Fehler<br>also <c>$_error[0]{name}</c> wäre der Name des ersten noch nicht ausgegebenen Fehlers
<c>$_error_handler</c>|Übergebene Routine wird im Fehlerfall ausgeführt
</tab>

<h2>XML / Tag-Datenbanken</h2>

<tab>
Name|Beschreibung
<c>$_</c>|Enthält im "Ende"-Code den Inhalt des eingeschlossenen Bereichs
<c>%_</c>|Die Parameter des Tags aufgeschlüsselt nach Name=Wert
<c>$_tag</c>|Name des Tags (Nur bei Name=* sinnvoll)
<c>@_parents</c>|Die umschliessenden Tags
<c>$_query</c>|Die Parameter des Tags als kompletter Text
<c>$_begintag</c>|Wenn gesetzt, befindet sich der Code beim Anfangstag
<c>$_empty</c>|Wenn gesetzt, wurde das Tag als markiert (<c><tag /></c>)
</tab>

<h2>Umgebungsvariablen</h2>

<tab>
Name|Beschreibung
<c>$_REMOTE_ADDR</c>|IP des Nutzers
<c>$_REMOTE_PORT</c>|Port über den die Seite aufgerufen wurde
<c>$_HTTP_USER_AGENT</c>|Browser der zum Abruf genutzt wurde
<c>$_HTTP_REFERER</c>|URL der Seite, die davor aufgerufen wurde
</tab>

<h2>Volltextsuche</h2>

<tab>
Name|Beschreibung
<c>$_fullsearch</c>|Suchbegriffe
<c>$_fullsearch_range</c>|Starteintrag für die Volltextsuche
<c>$_fullsearch_range_length</c>|Anzahl der zu durchsuchenden Einträge
<c>$_fullsearch_match</c>|Anzahl der zu findenden Treffer
<c>$_fullsearch_match_pos</c>|Eine Position nach dem zuletzt gefundenen Treffer
<c>$_fullsearch_amount</c>|Anzahl der bei der Volltextsuche gefundenen Treffer
<c>$_fullsearch_regex</c>|Muster um im Text die Suchtexte zu markieren
</tab>

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

Ohne Änderungen zurück zur Seite

Neue Seite erstellen