Univention Support Database

Problem:

Wie können selbsdefinierte Links auf der Serverstartseite erstellt werden?

Lösung:

Um eine selbstdefinierte Verlinkung auf der Startseite eines UCS Servers anzuzeigen, die beispielsweise auf Dokumentation zu einem Softwarepaket oder die Webseite zum Zugriff auf den Dienst oder die Konfiguration verweist, wie es unter anderem beim Univention Directory Manager der Fall ist, muss ein Paket erstellt oder ein bestehendes Paket erweitert werden. Es müssen in diesem Paket zwei Univention Config Registry Templates existieren, die in die Startseite integriert werden.

Dazu wird wie folgt vorgegangen:

Im Source-Paket werden die Verzeichnisse

• conffiles/var/www/ucs-overview/de.html.d/
• conffiles/var/www/ucs-overview/en.html.d/

erstellt, jeweils ein Verzeichnis für die deutsche bzw. die englische Startseite.

In diesen Verzeichnissen wird jeweils eine Datei mit dem Namen <Nr.Name>.html erstellt (z.B. 77beispiel.html). Die Nummern welche dort gewählt werden können, sind alle die, welche unter /etc/univention/templates/files/var/www/ucs-overview/de.html.d/ noch nicht zu finden sind. Über diese Nummern wird auch die Reihenfolge der Linkdarstellung auf der Startseite gesteuert. Der Name sollte die Dateien funktional bezeichnen. Der Inhalt der Dateien muss die Definition einer Tabellenzeile in HTML enthalten. Beispiele gibt es auf einem UCS System unterhalb von /etc/univention/templates/files/var/www/ucs-overview/de.html.d/.

Als Vorlage kann auch der folgende Link auf die Univention Homepage dienen:

Um die neuen Templatedateien im Source-Paket dem System bekannt zu machen, müssen noch folgende Dateien im Paket erstellt bzw. angepasst werden:

• debian/<Binär-Paketname>.univention-config-registry

Der Inhalt der Datei sollte folgendermaßen aussehen:

In der debian/rules Datei muss in der install-Target folgender Aufruf stehen:

Damit dieser Aufruf funktioniert muss das Paket univention-config-dev installiert sein. Daher sollte es auch in die Build-Dependencies mit aufgenommen werden.

Um eine eigene Grafik vor dem Link anzuzeigen muss das Paket um das Verzeichnis "icon/" ergänzt werden.

In diesem Verzeichnis kann die gewünschte Grafik abgelegt werden. Es empfiehlt sich dabei eine .png Datei mir den Abmessungen 32x32 pixel zu verwenden. In der debian/rules Datei des Pakets muss nun noch eine Regel erstellt werden, durch welche die Datei bei der Installation in das richtige Verzeichnis kopiert wird:

Die Graphik kann nun wie im obigen Beispiel referenziert werden:

Eine Einführung in die Erstellung von Softwarepaketen ist im folgenden SDB-Artikel zu finden: http://sdb.univention.de/1006