Verwendung von Verweisvorlagen
Verweisvorlagen können in FirstSpirit nicht wie Seiten-, Absatz- oder Tabellenvorlagen direkt vom Redakteur verwendet werden, sondern werden in einigen FirstSpirit-Eingabekomponenten zur Verfügung gestellt, die wiederum in Seiten-, Absatz- oder Tabellenvorlagen zum Einsatz kommen.
Dabei gibt es spezielle Eingabekomponenten, die dem Redakteur hauptsächlich zur Pflege von Verweisen dienen:
- FS_LIST, Typ INLINE mit source=„LINKTEMPLATES“ und
- CMS_INPUT_LINK
aber auch Komponenten, in denen Verweise zusätzlich zu anderen redaktionellen Inhalten (Texten, Bildern usw.) gepflegt werden:
Standardmäßig werden in diesen Eingabekomponenten dem Redakteur alle im Projekt vorhandenen Verweisvorlagen zur Auswahl angeboten. Um die Auswahl einzuschränken, bieten die Eingabekomponenten entsprechende Tags, z. B.
- LINKEDITORS / LINKEDITOR
für CMS_INPUT_LINK, CMS_INPUT_DOM, CMS_INPUT_DOMTABLE und CMS_INPUT_IMAGEMAP - TEMPLATE / uid
für FS_LIST
Beispiel für die Eingabekomponente CMS_INPUT_DOM:
<CMS_INPUT_DOM ...>
...
<LINKEDITORS>
<LINKEDITOR name="internerVerweis"/>
<LINKEDITOR name="externerVerweis"/>
</LINKEDITORS>
...
</CMS_INPUT_DOM>
Beispiel für die Eingabekomponente FS_LIST:
<FS_LIST ...>
<DATASOURCE type="inline" ...>
...
<TEMPLATES source="linktemplates">
<TEMPLATE uid="internerVerweis"/>
<TEMPLATE uid="externerVerweis"/>
</TEMPLATES>
</DATASOURCE>
...
</FS_LIST>
Sprachabhängigkeit
Eingabekomponenten in einer Verweisvorlage können immer nur sprachunabhängig definiert werden (Parameter useLanguages="no"). Sollen für Verweise sprachabhängige Inhalte erfasst werden, muss die verwendende (äußere) Eingabekomponente (also z. B. CMS_INPUT_DOM oder FS_LIST) als sprachabhängig definiert sein (useLanguages="yes"). Im Falle von FS_LIST, Typ INLINE, ist dies die Standardkonfiguration.
Beispiel für eine Liste mit mehrsprachigen Verweisen
<FS_LIST name="st_fslist_languagedependent" height="200" rows="3">
<DATASOURCE type="inline" useLanguages="yes">
<LABELS>
<LABEL lang="*">#item.lt_text</LABEL>
</LABELS>
<ACTIONS>
<ACTION name="EDIT"/>
<ACTION name="ADD"/>
<ACTION name="UP"/>
<ACTION name="DOWN"/>
<ACTION name="REMOVE"/>
</ACTIONS>
<COLUMNS>
<COLUMN show="no">#identifier</COLUMN>
</COLUMNS>
<LAYOUT>
<ADD component="toolbar" constraint="top"/>
<ADD component="overview" constraint="bottom"/>
<ADD component="simpleview" constraint="hide"/>
</LAYOUT>
<TEMPLATES source="linktemplates"/>
</DATASOURCE>
<LANGINFOS>
<LANGINFO lang="DE" label="Verweisliste sprachabhängig"/>
<LANGINFO lang="*" label="Link list language dependent"/>
</LANGINFOS>
</FS_LIST>
In dieser Konfiguration können die Verweise in den verschiedenen Projektsprachen unterschiedliche Angaben (z. B. Verweisziele, Verweistexte) beinhalten. Darüber hinaus können die Listen in den unterschiedlichen Sprachen eine unterschiedliche Anzahl an Verweisen aufweisen.
Zu mehrsprachigen Verweisen in der Eingabekomponente FS_LIST siehe auch Seite FS_LIST, Typ INLINE, Parameter useLanguages.
Beispiel für eine Liste mit einsprachigen Verweisen
<FS_LIST name="st_fslist_languageindependent" height="200" rows="3">
<DATASOURCE type="inline" useLanguages="no">
<LABELS>
<LABEL lang="*">#item.lt_text</LABEL>
</LABELS>
<ACTIONS>
<ACTION name="EDIT"/>
<ACTION name="ADD"/>
<ACTION name="UP"/>
<ACTION name="DOWN"/>
<ACTION name="REMOVE"/>
</ACTIONS>
<COLUMNS>
<COLUMN show="no">#identifier</COLUMN>
</COLUMNS>
<LAYOUT>
<ADD component="toolbar" constraint="top"/>
<ADD component="overview" constraint="bottom"/>
<ADD component="simpleview" constraint="hide"/>
</LAYOUT>
<TEMPLATES source="linktemplates"/>
</DATASOURCE>
<LANGINFOS>
<LANGINFO lang="DE" label="Verweisliste sprachunabhängig"/>
<LANGINFO lang="*" label="Link list language independent"/>
</LANGINFOS>
</FS_LIST>
In dieser Konfiguration haben alle Verweise der Liste in allen Projektsprachen dieselben Angaben (z. B. Verweisziel, Verweistext) und die Anzahl der Verweise der Listen sind in allen Projektsprachen identisch.