VLVZ-Modul: Verwendung
Grundlegendes
Die Funktionalität des Moduls wird über die Funktion zeigeLehrveranstaltungen bereitgestellt, welcher beim Aufruf ein assoziatives Array mit verschiedenen Anzeigeparametern übergeben wird.
Die Funktion liefert einen UTF8-kodierten HTML-String zurück, welcher an beliebiger Stelle in die eigene Seite eingebettet werden kann.
Einbinden des Moduls
Das Modul wird im Quelltext der Webseite eingebunden. Dies geschieht über folgenden PHP-Code:
<?php require_once('tu/inc/lehrveranstaltung.php'); ?>Funktionsbeschreibung - zeigeLehrveranstaltungen()
Beschreibung
Diese Funktion gibt eine Tabelle mit den Lehrveranstaltungen aus, welche ALLEN Suchkriterien entsprechen. Dabei wird standardmäßig das aktuell gültige Semester aufgerufen, bei Angabe eines Semesters werden ggf. die Daten aus dem Archiv des Vorlesungsverzeichnisses angezeigt. Die Funktion gibt dabei einen HTML-formatierten String zurück, welcher UTF-8 kodiert ist.
Diese Funktion verwendet direkt die API des Vorlesungsverzeichnisses.
Aufruf
zeigeLehrveranstaltungen($param_array);
Parameter
$param_array - Ein assoziativer Array mit folgenden Parametern, alle Angaben sind optional:| Parameter | Beschreibung |
|---|---|
| 'name' (String) |
Eine Liste von Strings, die in Veranstaltungsname oder -nummer auftauchen sollen. Die Strings werden normalerweise UND-verknüpft, es sei denn das Schlüsselwort 'OR' wird verwendet. (Groß- und Kleinschreibung wird hierbei nicht beachtet). |
| 'dozent' (String) |
Eine Liste von Strings, die im Dozentennamen auftauchen soll (Groß- und Kleinschreibung wird hierbei nicht beachtet). |
| 'fakult' (String) |
Kurzname der Fakultät, welche die Veranstaltung durchführt:
|
| 'semester' (String) |
Semester in der Kurzform (z.B. "ss19" oder "ws1819") zur Abfrage von
Lehrveranstaltungen aus vergangenen Semestern.
(Standard: ohne Angabe, Verwendung des aktuellen Semesters) Für die Archivanzeige entfallen die folgenden Parameter: 'enable_meinplan', 'disable_js', 'sort',
'detail_in_table', 'use_vlvz_style' |
| 'enable_meinplan' (Boolean) |
Ist dieser Parameter auf 'TRUE' gesetzt, so haben Studierende die Möglichkeit, Veranstaltungen aus der Liste auszuwählen und zu ihrem persönlichen Stundenplan hinzuzufügen. Standardmäßig ist diese Option deaktiviert (FALSE). |
| 'disable_js' (Boolean) |
Ist dieser Parameter auf 'TRUE' gesetzt, so wird die Verwendung von Javascript deaktiviert. Bitte beachten Sie, dass Sie in diesem Fall diverse Effekte nicht funktionieren. Standardmäßig ist die Option deaktiviert (FALSE), Javascript ist somit aktiv. |
| 'sort' (Integer) |
Gibt an, wie die Ergebnisse sortiert werden sollen
|
| 'not_found_text' (String) |
Gibt den Text an, der bei erfolgloser Suche angezeigt wird, dabei ist es möglich HTML-Formatierungen zu verwenden (Standard: "Keine Lehrveranstaltung gefunden." - Wärend Umstellung des VLVZ ist der Text immer "Das Vorlesungsverzeichnis wird momentan überarbeitet. (Freischaltung <Datum>)") |
| 'detail_in_table' (Boolean) |
Ist dieser Parameter auf 'TRUE' gesetzt, so werden die Details direkt in der Tabelle angezeigt, der Detail-Link entfällt dadurch. Standardmäßig ist die Option deaktiviert (FALSE). |
| 'use_vlvz_style' (Boolean) |
Ist dieser Parameter auf 'TRUE' gesetzt, so werden die gleichen
CSS-Klassen wie im zentralen VLVZ verwendet.
Achtung: Zusätzlich muss im Seitenkopf das Stylesheet aus dem VLVZ eingebunden werden.
(Pfad zur CSS-Datei: /verwaltung/vlvz/app/static/css/style.css )Standardmäßig ist die Option deaktiviert (FALSE). |
| 'joined_time_room' (Boolean) |
Ist dieser Parameter auf 'TRUE' gesetzt, so werden Zeit und Raum zusammen in einer Tabellenzelle dargestellt. Standardmäßig ist die Option deaktiviert (FALSE). |