$CMS_INCLUDE(...)$
Verwendung von $CMS_INCLUDE(...)$
Mit der Anweisung $CMS_INCLUDE(...)$ können Inhalte einer Datei aus der Medien-Verwaltung in eine Vorlage eingefügt werden.
Beim Einfügen kann festgelegt werden, mit welcher Kodierung ("Encoding") der Inhalt eingefügt und ob der FIRSTspirit-Ausdrücke ausgewertet werden soll.
Syntax von $CMS_INCLUDE(...)$
Der Grundaufbau von $CMS_INCLUDE(...)$ sieht wie folgt aus:
$CMS_INCLUDE(
BEZEICHNER,
parse:BOOLESCHER_WERT,
encoding:ENCODING
)$
Innerhalb einer $CMS_INCLUDE(...)$-Anweisung können mehrere Parameter kommasepariert übergeben werden, z.B.:
$CMS_INCLUDE(media:"css", parse:true)$
BEZEICHNER
Innerhalb von $CMS_INCLUDE(...)$ wird mit dem Bezeichner der Referenzname eines Objektes innerhalb von FIRSTspirit angegeben.
Der Bezeichner besteht bei manueller Angabe der Objektes aus zwei Teilen:
- Objekttyp
- Referenzname des Objektes
Der Objekttyp richtet sich nach der Art eines Objektes. Für die $CMS_INCLUDE(...)$-Anweisung sind folgende Objekttypen gültig:
- Datei oder Bild aus der Medien-Verwaltung: media
- Datei aus der Medien-Verwaltung: file
Wenn eine Datei aus der Medien-Verwaltung mit dem Referenznamen "suedsee" eingebunden werden soll, so ist folgendender Bezeichner für $CMS_INCLUDE(...)$ anzugeben:
file:"suedsee"
Alternativ kann ein Variablenname angegeben werden.
parse
Mit dem Attribut parse kann festgelegt werden, ob beim Einfügen des Inhalts der Datei - unabhängig von der Einstellung "Datei parsen" einer Datei - FIRSTspirit-Ausdrücke ersetzt werden sollen (Wert: true) oder nicht (Wert: false).
Wird der Parameter parse nicht angegeben, so wird die Einstellung "Datei parsen" der Datei in der Medien-Verwaltung verwendet.
encoding
Mit dem Attribut encoding wird festgelegt, mit welcher Kodierung der Inhalt der Datei - unabhängig von der Kodierung der Datei in der Medien-Verwaltung - ausgegeben werden soll.
Wird der Parameter encoding nicht angegeben, so wird die Kodierungseinstellung der Datei in der Medien-Verwaltung verwendet.
Für die Angabe der Kodierung sind alle für Java verfügbaren Kodierungen zulässig (vgl. Java-API-Dokumentation).
Beispiele zu $CMS_INCLUDE(...)$
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: (Geparste Ausgabe)
Codebeispiel:
$-- Inhalt der Datei "css" in der Medien-Verwaltung --$
<pre>
Beispiel für eine geparste/ungeparste, inkludierte Datei:
Der Wert der Variable "output" ist: $CMS_VALUE(output)$.
</pre>
$-- Vorlageninhalt --$
$CMS_SET(output,"Dies ist eine Ausgabe")$$CMS_INCLUDE(media:"css",parse:true)$
Beschreibung:
Im oben angegebenen Codebeispiel wird der Inhalt der Datei "css" aus der Medien-Verwaltung geparst ausgegeben bzw. in einer Vorlage eingefügt.
Ausgabe:
<pre>
Beispiel für eine geparste/ungeparste, inkludierte Datei:
Der Wert der Variable "output" ist: Dies ist eine Ausgabe.
</pre>
2. Beispiel: (Ungeparste Ausgabe)
Codebeispiel:
$-- Inhalt der Datei "css" in der Medien-Verwaltung --$
<pre>
Beispiel für eine geparste/ungeparste, inkludierte Datei:
Der Wert der Variable "output" ist: $CMS_VALUE(output)$.
</pre>
$-- Vorlageninhalt --$
$CMS_SET(output,"Dies ist eine Ausgabe")$$CMS_INCLUDE(media:"css",parse:false)$
Beschreibung:
Im oben angegebenen Codebeispiel wird der Inhalt der Datei "css" aus der Medien-Verwaltung ungeparst ausgegeben bzw. in einer Vorlage eingefügt.
Ausgabe:
<pre>
Beispiel für eine geparste/ungeparste, inkludierte Datei:
Der Wert der Variable "output" ist: $CMS_VALUE(output)$.
</pre>