Libraries

Autotable

Mittels Autotable kann man einfach Tabellen aus einem Array erstellen.
Instanziert wird Autotable via new lib_autotable($resources). Als Ressourcen können entweder die eigenen übergeben werden oder neue per system::get_resources() abgeholt werden.

Es gibt 3 Methoden:

• set_content($name,$table[,$hide,$last,$per_site,$highlight_first]): Hiermit wird ein Array an die Bibliothek übergeben. Die Parameter sind $name: der Name der Tabelle, mit dem man seine Tabelle hinterher auch wiederfindet, $table: der Inhalt, optional $hide: Der Grad der Anzeige; wird $hide auf 0 gesetzt, wird sowohl Rahmen, als auch Titelleiste angezeigt. Bei $hide=1 wird nur ein Rahmen, bei $hide=2 nur der Inhalt angezeigt. $last: der Offset, mit dem die Tabelle begonnen werden soll. (idR. 0). $per_site, wieviele Einträge der Tabelle auf eine Seite gebracht werden sollen, Default ist 50. $hightlight_first: Falls die Tabelle sowohl einen x-Header, als auch einen y-Header braucht, wird - sofern dieser Parameter auf 1 gesetzt wird - die erste Spalte farbig hervorgehoben.
• get_xml($name) Liefert den XML-Code der Tabelle.
• get_ajax_xml($name) Für Systeminterne Anwendungen, liefert die Tabelle ohne Ajax-Teil.

Ein Array muss wie folgt aufgebaut sein:
$array [ 'Zeilen-Bezeichnung' ] [ 'Spalten-Bezeichnung' ] = 'Zelleninhalt';

Besondere Felder:

• _control: in diesem Feld können eigene Kontroll-Elemente untergebracht werden, die am Fußende angezeigt werden.
• _warning: Wird dieses Feld auf 1 gesetzt, wird entsprechende Zeile Rot eingefärbt.

simple_form

Mit simple-form ist es möglich, Formulare zu erstellen und zu verwalten. Es gibt die folgenden Funktionen:

• create_ressource(name,title=""): Als Parameter werden eine Bezeichnung (name) des Formulars übergeben, womit man das Formular evtl. wiederfinden kann, und optional ein Titel, der das ganze zieren wird.
• add_input(formular, name, Typ, Parameter1, Parameter2, Beschreibung[, Wert, erforderlich]): Hiermit lässt sich ein neues Feld zu einem bestehenden (mit create_ressource) erzeugten) Formular hinzufügen. Anzugeben ist der Name des Formulars und der Name des Feldes. Als Typ sind die Werte textline, textarea und select möglich. Ist als Typ textline gewählt, ist als Parameter1 normal oder password möglich. Als Parameter2 kann man nun entweder einen leeren String oder einen regulären Ausdruck angeben, beim Absenden würde der Inhalt nur bei einem Matching freigegeben.
  Ist als Typ textarea gewählt, kann man bei Parameter1 wählen zwischen small und great (small z.b. nutzbar in Auflistungen der Hobbys in Profilen oder Foreneinträgen, great ist idR. seitenfüllend). Parameter2 ist in diesem Falle wiederum entweder ein Leerstring oder ein regulärer Ausdruck.
  Sollte man als Typ select gewählt haben, so ist in Parameter1 die Auswahl zwischen single und multiple möglich, in Parameter2 zwischen check und list. single in Kombination mit check erzeugt Radiobuttons, in Kombination mit list eine Select-Box. multiple erzeugt zusammen mit check eine checkbox-Liste und zusammen mit list eine Select-Box mit Mehrfachauswahl. Werte lassen sich zu typ=select mittels add_option hinzufügen. in "Beschreibung" ist der Name des Feldes anzugeben, der angezeigt wird, in "Wert" ein evtl. vorhandener Wert. Ist "erforderlich" auf 1 gesetzt, so muss das Feld ausgefüllt werden, damit das Formular abgeschickt werden kann. Ist als Typ textline mit password gewählt, so kann man in "Wert" den Namen eines anderen Passwort-Feldes angeben und ein Formular kann nur bei Übereinstimmung beider Felder abgeschickt werden. Es reicht, im 2. Feld den Namen des ersten Feldes anzugeben. (keine doppelte Verkettung nötig).
• add_option(Formular,Feld,Name,Wert,Text,ausgewählt) Fügt zu einem Select-Typ eine Option hinzu.
• delete_ressource(Formular) löscht ein Formular
• is_ressource(Formular) prüft, ob ein Formular existiert
• is_send(Formular) prüft, ob ein Formualr bereits abgesendet wurde.
• restore_send(Formular) setzt das "Abgesendet"-Flag zurück
• get_xml(Formular[, special]) liefert den XML-Code eines Formulares. Ist special auf login gesetzt, so wird ein spezielles Formular ohne Zwischenspeicherung erzeugt. (Wäre bei Passwörtern ein wenig krank... ;-) )
• reset_values(Formular) setzt die vom Benutzer eingetragenen Werte zurück.
• mit get_content(Formular,name) kann man die vom Benutzer eingetragenen Werte abrufen. Sinnvollerweise sollte man davor überprüfen, ob das Formular überhaupt abgeschickt wurde :)