RUB »  Rechenzentrum » Internetdienste » CMS Imperia » Dokumentation » Dokumentation

Mitteilungsübersicht erstellen

Sie haben das Template für Ihre Meldungen erstellt und möchten jetzt eine Übersichtsseite erstellen.
Dazu erstellen Sie einfach eine normale neue Seite, mit dem Template für Ihre Seite. Dort fügen Sie das Überschrift Modul ein. Beachten Sie aber, dass Sie bei dem Modul ohne Zeilenumbruch/manuelles BR einstellen.
In das Feld der Texteingabe müssen Sie nun einen IMPERIA Abschnitt einfügen:
<IMPERIA>
</IMPERIA>

In diesen Abschnitt können Sie verschiedene Befehle einfügen.
Um eine einfache Linkliste zu erzeugen brauchen Sie folgende Befehle:

CLEARLIST ❶
FILEMASK = ".*\.htm[lsx]?$" ❷
READDIR = "/path/to/documents" ❸
FOREACH FOUND { ❹
<a href="<!--YY-directory-->/<!--YY-filename-->"><!--YY-title--></a><br />
}

❶ Eventuell vorhandene Trefferliste und Trefferlimit aus einem vorhergehenden SiteActive-Block
löschen.
❷ Regulärer Ausdruck, auf den die Dateinamen der Dokumente passen müssen, damit sie als Treffer
gelten.
❸ Verzeichnis bestimmen, in dem rekursiv nach Treffern gesucht werden soll.
❹ Dies ist die Ausgabe-Routine. Der in den geschweiften Klammern angegebene HTML-Code wird
für jeden Treffer in die HTML-Seite eingefügt. Dabei werden die YY-Variablen durch die entsprechenden
Werte aus den Treffer-Dokumenten ersetzt.

Mit Hilfe von <!--YY-Meta-Variable--> kann innerhalb einer FOREACH-FOUND-Schleife auf jede Meta-Variable eines gefundenen Dokuments zugegriffen werden.

Weitere Beispiele finden Sie im Programmierhandbuch von Imperia unter Punkt 5.4

Bitte beachten Sie, dass "intelligente Listen" (z.B. alternierende) die Verwendung von Perl erfordern.
Dazu fügen Sie den Block
<IMPERIA lang="perl">
</IMPERIA>
ein.
Näheres dazu finden Sie ebenfalls im Programmierhandbuch.

Bitte beachten Sie außerdem, dass eine Meldung aus dem Template generiert wird, deshalb wird in der Fußzeile der späteren Meldung das Datum der Templatedatei angezeigt. Das passiert, da die Templatedatei das Datum an dem sie erstellt wurde besitzt. Eine Meldungsdatei besitzt aber das Datum an dem die Meldung erschienen ist.
Um nun das Datum in der Fußzeile zu ändern begeben Sie sich in das Codeinclude Menü. Klicken Sie dazu auf der Imperia-Startseite im linken Menü auf den Unterpunkt Codeinclude-Dateien im Reiter Struktur. Hier bearbeiten Sie die Datei fusszeile.htms

Suchen Sie nach der Zeile
<!--Xdate:default-->

Diese Zeile bindet das Datum des Dokuments statisch ein. Dies wollen Sie aber nicht.

Bauen Sie also eine Abfrage ein, ob die Seite mit SiteActive erstellt wurde oder nicht.

#IF ("<!--XX-siteactive-->" EQ "1")

Für den abgefragten Fall, dass die Seite mit SiteActive erstellt wurde, fügen Sie die unten stehende Zeile ein. Diese liest aus den erstellten Meldungen die Datumsangaben. Sie können auch die Uhrzeit mit angeben. Dies empfiehlt sich aber erst ab eine Änderung, welche häufiger als einmal täglich stattfindet.

<!--ZZ-day-->.<!--ZZ-mon-->.<!--ZZ-fullyear-->

Kurzer Exkurs: Mit Hilfe von ZZ-Variablen kann auf Datum und Uhrzeit des Laufs des SiteActives zugegriffen werden. D.h. auf das Datum wann die einzelnen Meldungen aus der Templatedatei erstellt wurden.

Für den abgefragten Fall, dass die Seite nicht mit SiteActive erstellt wurde, fügen Sie einfach die Zeile
<!--Xdate:default-->
ein bzw. bauen die oben genannte Abfrage sowie den anderen Fall um die Zeile herum.
Beachten Sie bitte die Fallunterscheidung mit #ENDIF abzuschließen.

Beachten Sie bitte weiterhin, dass die Variable siteactive nicht standardmäßig existiert. Daher müssen Sie diese erstellen. Dazu benötigen Sie allerdings die Rolle des superusers. Sollten Sie die Rolle besitzen können Sie die Variable erstellen. Sollten Sie die Rolle nicht besitzen wenden Sie sich bitte an Ihren Administrator.
Um die Variable nun zu erstellen, wählen Sie als Ansicht ihres Schreibtisches entweder Compact oder Detail.
Anschließend klicken Sie auf "Ansicht" in der Zeile Ihrer Datei, welche die Übersicht der Meldungen erstellt. Sie befinden sich nun im Meta-Viewer der Datei.
Scrollen Sie ganz nach unten und schreiben Sie in das Eingabefeld hinter <Feld hinzufügen> Ihren gewünschten Variablennamen. In diesem Fall "siteactive". Klicken Sie anschließend auf <Feld hinzufügen>. Das Feld wurde nun hinzugefügt und kann mit einem Wert belegt werden. Schreiben Sie dazu einfach den Wert in das Eingabefeld ihrer neu erzeugten Variable und klicken Sie anschließend ganz unten auf Speichern.

Diese Fallunterscheidung zwischen dynamischen und statischen Inhalt (hier Datum) brauchen Sie auch, wenn Ihre Seite mehrsprachig aufgebaut ist. Dann benötigen Sie sowohl eine Fallunterscheidung für die Sprache als auch für jede Sprache einen einzelnen Systemdienst.

Anbei finden Sie zwei Code-Beispiele.
Eines für die Sprachumschaltung und eines für die Datumsangabe.

Sprachumschaltung   (942.0)

Datumsangabe   (456.0)