Zum Inhalt

Einführung

In diesem Kapitel lernen Sie, wie man mit imperia aus der Rubrikenstruktur Menüs, Breadcrumbnavigationen und Site-Maps generiert, die Sie in Ihr imperia Webprojekt einfügen können.

Funktionsprinzip#

Die imperia Navigationsgenerierung ist ein Werkzeug für imperia-Webentwickler, um die – in imperia angelegte – Rubrikenstruktur für die Gestaltung von Menüs und anderen Navigationsstrukturen zu nutzen.

Alle Menüs und Navigationsstrukturen werden in der Konfigurationsdatei der Navigationsgenerierung definiert, die im Konfigurationsverzeichnis unter site/config/navigation_generator.conf erstellt wird.

Das Ergebnis der imperia Navigationsgenerierung ist eine statische Datei oder mehrere statische Dateien. Die Dateien enthalten eine Navigationsstruktur, die in einer Auszeichnungssprache – in der Regel HTML oder JSON – beschrieben sind. Als Webentwickler können Sie diese Dateien Ihrem Webprojekt zur Verfügung stellen oder direkt als Code-Schnipsel inkludieren.

Schließlich muss noch definiert werden, unter welchen Umständen die Navigationsgenerierung angestoßen wird. Das kann entweder manuell aus der Benutzeroberfläche oder automatisiert erfolgen.

Um ein Menü oder eine andere Navigationsstruktur mittels der imperia Navigationsgeneration zu erstellen, müssen Sie in der Datei site/config/navigation_generator.conf anlegen bzw. die Vorlage navigation_generator.conf.sample aus demselben Verzeichnis umbennenen und berarbeiten.

In dieser Datei definieren Sie einerseits den Ablageort und das Namensschema für die generierten Dateienen und andererseits werden die Templates für die einzelenen Menüs direkt in diese Datei geschrieben.

Im Unterkapitel Konfiguration lernen Sie, wie welche Möglichkeiten Ihnen die Navigationsgenerierung bietet und wie Sie die Konfiguration bearbeiten und ein Menü-Template schreiben.

Um die Navigationsdateien aus der Konfigurationsdatei zu erzeugen, gibt es die manuellen und die automatische Methode.

In der manuellen Methode legen Sie für die Erzeugung bzw. Aktualisierung der Navigationsdateien einen eigenen Menüpunkt im Hauptmenü von imperia an. Über diesen Menüpunkt wird Menüerzeugung mit den jeweiligen Parametern aufgerufen. Lernen Sie im Unterkapitel Menü erzeugen, wie Sie diesen Menüpunkt anlegen.

In der automatischen Methode erfolgt die Aktualisierung des Menüs durch einen definierten Systemdienst.

In der Entwicklung der Menü-Templates ist es außerdem hilfreich, die Navigationsdateien über das Adminskript site_navigation_generator.plzu generieren, dass sich im Verzeichnis site/bin befindet.

In einem klassischen imperia Webprojekt werden die Navigationsdateien entweder vom Webserver als Server-Side-Includes eingebunden oder über ein imperia Inplace-SiteActive im Template.

Generell ist die Methode von imperia jedoch nicht vorgegeben. Jenachdem welches Framework Sie für Ihr Webprojekt benutzen, kommen andere Methoden und Formate infrage.

Lernen Sie im Kapitel Menü einbinden, wie Sie Ihre Menüdateien als Server-Side-Includes einbinden.