seitenbezogene #global-Aufrufe
Die Anforderungen an eine Website sind sehr vielfältig. So sind einige Websites mehrsprachig, andere einsprachig. Einige haben mehrere Inhaltsbereiche – andere nur einen einzelnen.
Für die Darstellung und Verlinkung komplexer Websites mit mehrsprachigen Seiten und mehreren Inhaltsbereichen sind seitenbezogene Informationen und Mechanismen nötig.
In FirstSpirit kann über das Systemobjekt #global auf seitenbezogene Informationen (umfasst u.a. Seiten, Absätze, Seitenreferenzen, Inhaltsbereiche usw.) zugegriffen werden.
In der nachfolgenden Tabelle sind die wichtigsten seitenbezogene Aufrufe aufgeführt:
Aufruf | Bedeutung | Rückgabedatentyp |
---|---|---|
#global.gca("BEZEICHNER") | Fügt den Inhalt einer globalen Seite aus Globale Inhalte ein. | |
#global.id | Liefert die ID des aktuellen gerenderten Knotens (z. B. Seite, Absatz usw.) zurück. | |
#global.docgroup | Ermittelt, ob der aktuelle Knoten eine Dokumentengruppe ist oder nicht. | Boolean |
#global.node | Liefert eine Seitenreferenz oder eine Dokumentengruppe zurück. | Abhängig vom Knoten: |
#global.node.changeDate | Liefert das Änderungsdatum der Seitenreferenz zurück. | |
#global.node.depth | Liefert die Tiefe der Seitenreferenz relativ zum Wurzelknoten der Struktur-Verwaltung zurück. Die Zählung beginnt mit 0 für den Wurzelknoten. | |
#global.node.editor | Liefert den letzten Bearbeiter der Seitenreferenz zurück. | |
#global.node.editor.abbreviation | Liefert die Abkürzung des letzten Bearbeiters der Seitenreferenz zurück. | String |
#global.node.editor.eMail | Liefert die E-Mail-Adresse des letzten Bearbeiters der Seitenreferenz zurück. | String |
#global.node.editor.phoneNumber | Liefert die Telefonnummer des letzten Bearbeiters der Seitenreferenz zurück. | String |
#global.node.editor.realname | Liefert den Namen des letzten Bearbeiters der Seitenreferenz zurück. | String |
#global.node.id | Liefert die ID der Seitenreferenz zurück. | |
#global.node.keywords | Liefert eine Liste aller Schlüsselwörter zur Seitenreferenz zurück. Diese Liste ergibt sich aus der Vereinigungsmenge aller Schlüsselwörter, die in der Struktur-Verwaltung entlang der Baumstruktur definiert wurden (beginnend von der aktuellen Seitenreferenz bis zur Wurzel). | |
#global.page | Liefert die Seite aus der Inhalte-Verwaltung zurück. | |
#global.page.body("BEZEICHNER") | Liefert einen Inhaltsbereich zurück. | |
#global.page.changeDate | Liefert das Änderungsdatum der Seite zurück. | |
#global.page.depth | Liefert die Tiefe der Seiten, relativ zum Wurzelknoten der Seiten-Verwaltung zurück. Die Zählung beginnt mit 0 für den Wurzelknoten. | |
#global.page.editor | Liefert den letzten Bearbeiter der Seite zurück. | |
#global.page.editor.abbreviation | Liefert die Abkürzung des letzten Bearbeiters der Seite zurück. | String |
#global.page.editor.eMail | Liefert die E-Mail-Adresse des letzten Bearbeiters der Seite zurück. | String |
#global.page.editor.phoneNumber | Liefert die Telefonnummer des letzten Bearbeiters der Seiten zurück | String |
#global.page.editor.realname | Liefert den Namen des letzten Bearbeiters der Seiten zurück. | String |
#global.page.id | Liefert die ID der Seite zurück. | |
#global.page.isTranslated | Ermittelt, ob für die Seite in der aktuellen Sprache das Attribut Seite für diese Sprache vollständig übersetzt gesetzt ist. | Boolean |
#global.page.isTranslated("BEZEICHNER") | Ermittelt, ob für die Seite in der angegebenen Sprache das Attribut Seite für diese Sprache vollständig übersetzt gesetzt ist. Als Bezeichner ist die Abkürzung der Sprache (z. B. EN) anzugeben. | Boolean |
#global.ref | Liefert ähnlich wie #global.node die aktuelle Seitenreferenz oder eine Seitengruppe zurück. | Abhängig vom Knoten: |
#global.section | Liefert den Absatz in einer Absatzvorlage zurück. Handelt es sich bei dem aktuellen Objekt nicht um einen Absatz, wird null zurückgeliefert. | |
#global.section.changeDate | Liefert das Änderungsdatum des Absatzes zurück. | |
#global.section.depth | Liefert die Tiefe des Absatzes, relativ zum Wurzelknoten der Seiten-Verwaltung zurück. Die Zählung beginnt mit 0 für den Wurzelknoten. | |
#global.section.editor | Liefert den letzten Bearbeiter der Seiten zurück. | |
#global.section.editor.abbreviation | Liefert die Abkürzung des letzten Bearbeiters des Absatzes zurück. | String |
#global.section.editor.eMail | Liefert die E-Mail-Adresse des letzten Bearbeiters des Absatzes zurück. | String |
#global.section.editor.phoneNumber | Liefert die Telefonnummer des letzten Bearbeiters des Absatzes zurück. | String |
#global.section.editor.realname | Liefert den Namen des letzten Bearbeiters des Absatzes zurück. | String |
#global.section.id | Liefert die ID des Absatzes zurück. | |
#global.section.name | Liefert den Namen des Absatzes zurück. Kann verwendet werden, um manuelle Verweise zu automatisch erzeugten Ankern zu erstellen. | String |
Beispiele
Nachfolgend werden einige Beispiele zur Verwendung der Anweisung innerhalb von Vorlagen gezeigt. Die Beispiele sollen die konkrete Auswirkung der Anweisung verdeutlichen und eine Hilfe für den Vorlagenentwickler bei der Erstellung eigener Vorlagen sein.
Für die Verwendung innerhalb eines Projekts, müssen die hier gezeigten Beispiele angepasst werden! Beispielsweise müssen Variablennamen auf die spezifischen Variablennamen des Projekts geändert werden, in dem die Anweisung verwendet werden soll. |
1. Beispiel: Ausgabe des letzten Bearbeiters
Letzte Änderung am $CMS_VALUE(#global.page.changeDate.format("dd.MM.yyyy"))$ von $CMS_VALUE(#global.page.editor.realname)$
Das Beispiel gibt die letzte Änderung der Seite formatiert und den Namen des Bearbeiters aus.
Ausgabe:
Letzte Änderung am 27.06.2007 von Mustermann
2. Beispiel: Sprachwechsel
<a href="$CMS_REF(#global.ref, lang:"EN")$">Seite in Englisch</a>
Mithilfe der $CMS_REF(...)$-Anweisung wird die URL des aktuellen Knotens in einer anderen Sprache ermittelt.
Ausgabe:
<a href="/preview/671041/show/site/EN/current/671044/681046">Seite in Englisch</a>
3. Beispiel: Wechsel des Präsentationskanals
<a href="$CMS_REF(#global.ref, templateSet:"print")$">Druckversion</a>
Mit Hilfe der $CMS_REF(...)$-Anweisung wird die URL des aktuellen Knotens in einem anderen Präsentationskanal ermittelt.
Ausgabe:
<a href="/preview/671041/show/site/DE/current/671086/681046">Druckversion</a>