Typ PUBLIC
FirstSpirit bietet die Möglichkeit, eigene Module zu entwickeln und zu implementieren. Über den Typ PUBLIC können Schnittstellen ("HotSpots") vom Typ "Public" angesprochen werden (weitere Informationen zu diesem Komponenten-Typ sowie zur Modul-Entwicklung in FirstSpirit siehe FirstSpirit Entwicklerhandbuch für Komponenten).
Pflichtparameter
Pflichtparameter
Pflichtparameter
Parameter
Bei dem Tag CMS_INCLUDE_OPTIONS handelt es sich um einen Container, mit dem Konfigurationen festgelegt werden können, um Einträge in eine Eingabekomponente automatisch einzufügen.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
type* | Ja | 4.2 | IncludeType | Keiner |
type
Mit dem Pflichtparameter type wird der Typ der Werte- bzw. Inhaltsinkludierung angegeben.
Folgende Typen werden unterstützt:
- LANGUAGE: gibt die Projektsprachen aus
- TEMPLATESET: gibt die Ausgabekanäle des Projekts aus
- DATABASE: gibt den Inhalt von Datenquellen aus
- PUBLIC: gibt den Inhalt, der über eine öffentliche Schnittstelle zur Verfügung gestellt wird, aus
- Optionale Parameter
Optional können weitere optionale und Pflicht-Parameter bzw. -Tags verwendet werden (siehe unten).
Typ LANGUAGE
Mit dem Typ LANGUAGE ist es möglich, in einer mengenwertigen Eingabekomponente (z.B. CMS_INPUT_COMBOBOX) die im Projekt definierten Sprachen automatisch einzufügen.
- Pflichtparameter
Das Tag LANGUAGE benötigt keine weiteren Parameter. - Optionale Parameter
Optional zum Tag LANGUAGE können die Tags LABELS / LABEL verwendet werden (siehe unten).
Typ TEMPLATESET
Mit dem Typ TEMPLATESET ist es möglich, in einer mengenwertigen Eingabekomponente (z.B. CMS_INPUT_COMBOBOX) die im Projekt definierten Ausgabekanäle automatisch einzufügen.
- Pflichtparameter
Das Tag TEMPLATESET benötigt keine weiteren Parameter. - Optionale Parameter
Optional zum Tag TEMPLATESET können die Tags LABELS / LABEL verwendet werden (siehe unten).
Typ DATABASE
Mit dem Typ DATABASE ist es möglich, in einer mengenwertigen Eingabekomponente (z.B. CMS_INPUT_COMBOBOX) Datensätze aus einer Fremdtabelle automatisch einzufügen.
- Pflichtparameter
Die Datenquelle, aus der die Daten geholt werden sollen, muss mit dem Tag TABLE angegeben werden (siehe unten). - Optionale Parameter
Optional zum Tag DATABASE können die Tags KEY und LABELS / LABEL verwendet werden (siehe unten).
Typ PUBLIC
FirstSpirit bietet die Möglichkeit, eigene Module zu entwickeln und zu implementieren. Über den Typ PUBLIC können Schnittstellen ("HotSpots") vom Typ "Public" angesprochen werden (weitere Informationen zu diesem Komponenten-Typ sowie zur Modul-Entwicklung in FirstSpirit siehe FirstSpirit Entwicklerhandbuch für Komponenten).
- Pflichtparameter
Der Name der HotSpot-Klasse muss mit dem Tag NAME angegeben werden (siehe unten). - Optionale Parameter
Optional zum Tag PUBLIC können die Tags PARAMS / PARAM sowie LABELS / LABEL verwendet werden (siehe unten).
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
type* | Ja | 4.2 | IncludeType | Keiner |
LABELS
Zu jedem Typ kann über das Tag LABELS eine sprachabhängige Beschriftung der einzelnen Werte definiert werden.
Für jede Sprache muss dazu ein Tag LABEL angegeben werden.
ACHTUNG: Es muss mindestens eine Definition für die Rückfallbeschriftung ("*") erfolgen:
<LABELS>
<LABEL lang="*">...</LABEL>
</LABELS>
LABEL
Mit dem Tag LABEL kann für jede Sprache eine flexible, sprachabhängige Beschriftung der einzelnen Optionen definiert werden.
Um die Beschriftung für eine Sprache festzulegen, ist im Parameter lang die Abkürzung der Projektsprache anzugeben:
...
<LABEL lang="DE">...</LABEL>
<LABEL lang="EN">...</LABEL>
...
Rückfallwerte werden mit dem speziellen Sprachkürzel * ("für alle Sprachen") angegeben:
...
<LABEL lang="*">...</LABEL>
...
Bei dem Parameter lang handelt es sich um einen Pflichtparameter.
Der Beschriftungstext wird innerhalb eines öffnenden und schließenden <LABEL>-Tag angegeben (siehe Platzhalter TEXT).
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
lang* | Ja | 4.2 | String | Keiner |
lang
Mit dem Parameter lang wird das Sprachkürzel, das in den Servereigenschaften im Feld Abkürzung eingetragen ist (siehe FirstSpirit Handbuch für Administratoren, Kapitel "Sprach-Vorlagen"), angegeben, um festzulegen für welche Projektsprachen die Definitionen gelten sollen, z.B. DE für Deutsch, EN für Englisch, FR für Französisch usw. Folgende Zeichen können dabei beliebig oft angegeben werden: -, _, 0-9 und A-Z. Kleinbuchstaben werden nach dem Speichern der Vorlage automatisch in Großbuchstaben umgewandelt. Alternativ kann * für Rückfallwerte verwendet werden.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
lang* | Ja | 4.2 | String | Keiner |
TEXT
An dieser Stelle wird der Beschriftungstext der auszuwählenden Werte definiert.
Dazu steht das Systemobjekt #item zur Verfügung. Über dieses kann die Beschriftung dynamisch ausgegeben werden.
Beim Typ DATABASE repräsentiert #item dabei z. B. die anzuzeigende Datenbankzeile der über das Tag TABLE definierten Tabellenvorlage. Eine Spalte der Datenbankzeile kann durch einen Punkt getrennt für die Beschriftung verwendet werden, wie z. B. im Beispiel #item.Headline_EN.
Weiterhin werden über den Ausdrucksmechanismus sprachspezifische Endungen automatisch gesetzt, sollten sie vorhanden sein, d. h. folgende Definition ist möglich:
<CMS_INCLUDE_OPTIONS type="DATABASE">
<TABLE>Products.press_releases</TABLE>
<LABELS>
<LABEL lang="*">#item.Headline + ", " + #item.Subheadline</LABEL>
</LABELS>
</CMS_INCLUDE_OPTIONS>
Dabei wird abhängig von der zu generierenden Sprache zunächst für die einzelnen Attribute nach Attributen mit Spracherweiterung gesucht (z. B. #item.Headline_DE für die Sprache DE), und, falls diese nicht vorhanden ist, dann nach einem Attribut mit dem gegebenen Namen.
Es ist darauf zu achten, dass der Spaltenname korrekt angegeben wird und die Spalten auch tatsächlich in der angegebenen Tabelle vorhanden ist, da sonst keine Werte zur Auswahl angezeigt werden. Bei Verwendung von KEY muss darüber hinaus darauf geachtet werden, dass die über LABEL und #item definierte dynamische Beschriftung zu der über KEY definierten Spalte passt. Ist dies nicht der Fall, erhält der Redakteur bei der Auswahl einer Option eine entsprechende Fehlermeldung. |
NAME
Mit dem Tag PUBLIC wird der Klassenname der Funktionalität angegeben, aus der Inhalte in der verwendenden Eingabekomponente auswählbar gemacht werden sollen.
TEXT
An dieser Stelle wird der Klassenname der Funktionalität angegeben, und zwar innerhalb eines öffnenden und schließenden NAME-Tags:
<NAME>KLASSENNAME</NAME>
PARAMS
Über das Tag PARAMS können beim Ansprechen der Schnittstelle, über die Inhalte zur Verfügung gestellt werden sollen, verschiedene Parameter übergeben werden.
Für jeden Parameter muss dazu ein Tag PARAM angegeben werden.
PARAM
Über das Tag PARAM wird ein Parameter übergeben.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
name* | Ja | 3.0 | String | Keiner |
name
Über den Pflichtparameter name wird der Name der Klasse angegeben.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
name* | Ja | 3.0 | String | Keiner |
TEXT
An dieser Stelle wird der Wert angegeben.