Konfiguration einer Verweisvorlage

Die redaktionelle Pflege von Verweisen erfolgt über Eingabemasken, die vom Vorlagenentwickler projektspezifisch angepasst werden können. In den Eingabemasken werden standardmäßig alle Eingabefelder bzw. Auswahllisten angezeigt, die für den jeweiligen Verweistyp möglich sind (Beispiel: siehe interner Verweis).

Für die Konfiguration einer Verweisvorlage steht dem Vorlagenentwickler das Systemobjekt #link zur Verfügung. Auf dem Objekt können eine Vielzahl von Methoden aufgerufen werden. Welche Methoden zur Verfügung stehen, ist abhängig vom gewählten Verweistyp (weitere Informationen siehe Kapitel Ausgabe von Verweisen ).

<CMS_LINK_CONFIG>

Konfiguration einer Verweisvorlage

<CMS_PARAM>

Für die Konfiguration innerhalb der <CMS_PARAM>-Tags stehen eine Reihe von Attributen zur Verfügung:

Attribut: name

Über das "name"-Attribut wird festgelegt, welches Feld der Eingabemaske, konfiguriert werden soll. Jedes Eingabeelement kann über einen bestimmten Namen konfiguriert werden.
Soll beispielsweise das Eingabeelement für den Verweistext konfiguriert werden, so muss innerhalb des <CMS_PARAM>-Tags, das Attribut "name" mit dem Wert "text" übergeben werden:

<CMS_PARAM name="text"  ..../>

Welche Eingabeelemente in der Eingabemaske verfügbar sind, ist abhängig vom ausgewählten Verweistyp. Das heißt, für die Konfiguration der Instanzen der einzelnen Verweistypen, sind immer nur bestimmte "name"-Attribute verfügbar, die in den weiterführenden Kapiteln für jeden der drei Standard-Verweistypen erläutert werden:

• Attribute für interne Verweise: Liste aller "name"-Attribute für Verweise innerhalb des Projekts.
• Attribute für externe Verweise: Liste aller "name"-Attribute für Verweise außerhalb des Projekts.
• Attribute für content Verweise: Liste aller "name"-Attribute für Verweise auf einen Datensatz einer Datenquelle.

Attribut: label

Ist innerhalb des <CMS_PARAM>-Tags zusätzlich zum Attribut "name", das Attribut "label" angegeben, wird über den Parameter die sprachunabhängige Beschriftung des Eingabeelements in der Eingabemaske konfiguriert. Die Konfiguration:

<CMS_PARAM name="text" label="Verweistext:"/> 

ändert beispielsweise die Beschriftung der Eingabekomponente mit dem Namen "text", vom Default-Wert "Link-text" auf "Verweistext".

Attribut: value

Ist innerhalb des <CMS_PARAM>-Tags zusätzlich zum Attribut "name", das Attribut "value" angegeben, wird die Eingabekomponente mit dem angegebenen Wert vorbelegt.

Der angegebene Wert wird eventuell erst in Kombination mit dem Attribut "default" in der Komponente angezeigt (siehe Beschreibung des Attributs "default").

Sinnvoll ist eine Vorbelegung beispielsweise bei einer Auswahlliste. Die Liste kann vom Vorlagenentwickler mit einem oder mehreren möglichen Werten vorbelegt werden, wobei für jeden Wert ein eigenes <CMS_PARAM>-Tag in der Konfiguration angegeben werden muss. Beispielsweise zeigt die Konfiguration für die Auswahliste "target" zur Auswahl eines Zielframes:

<CMS_PARAM name="target" value="popup"/>
<CMS_PARAM name="target"  value="new"/>

die zwei Werte "popup" und "new" zur Auswahl an. Soll zusätzlich die Beschriftung der Werte geändert werden, ist das über die zusätzliche Angabe des Attributs "label" möglich:

    <CMS_PARAM name="target" label="Pop-Up-Fenster" value="popup"/>
    <CMS_PARAM name="target" label="Neues Fenster" value="new"/>

Attribut: hidden

Ist innerhalb des <CMS_PARAM>-Tags zusätzlich zum Attribut "name", das Attribut "hidden" angegeben, wird das entsprechende Eingabefeld für den Redakteur "versteckt". Das Feld wird in der Eingabemaske nicht mehr angezeigt und kann durch den Redakteur nicht bearbeitet werden.

Wird nicht zuvor mittels "value" und "default" ein Wert für das Feld vorbelegt, so bleibt es leer (null).

Sinnvoll ist die Angabe immer dann, wenn der Vorlagenentwickler eine Änderung der Werte durch den Redakteur unterbinden möchte. Beispielsweise wird über die folgende Konfiguration, die Eingabekomponente "mediaref" zur Auswahl eines Elements aus der Medien-Verwaltung nicht mehr angezeigt:

<CMS_PARAM name="mediaref" hidden="1"/> 

Attribut: default

Ist innerhalb des <CMS_PARAM>-Tags zusätzlich zu den Attributen "name" und "value", das Attribut "default" angegeben, wird der unter "value" angegebenen Wert, vorselektiert in der Komponente angezeigt. Das Attribut kann die Werte "0" (keine Vorauswahl) oder "1" (Vorauswahl) erhalten und kann sowohl für einfache Texteingabefelder (z.B. "text") als auch für Auswahllisten (z.B. "target") angegeben werden. Wenn Texteingabefelder mit einem Wert vorbelegt werden sollen, so muss in der Konfiguration zusätzlich zur Angabe von "value" das Attribut "default" mit dem Wert "1" angegeben werden. Bei allen anderen Eingabefeldern (z.B. "target") wird für jeden konfigurierten Parameter ein Eintrag in der Auswahlliste erzeugt:

<CMS_PARAM name="target" label="Pop-Up-Fenster" value="popup"/>
<CMS_PARAM name="target" label="Neues Fenster" value="new"/>

Wird default="1" nicht angegeben, bleibt das Eingabefeld leer, kann aber durch Selektion eines Eintrags gefüllt werden.

Über die Konfiguration:

<CMS_PARAM name="target" label="Pop-Up-Fenster" value="popup"/>
<CMS_PARAM name="target" label="Neues Fenster" value="new" default="1"/>

wird der Wert "Neues Fenster" in der Auswahlliste vorselektiert angezeigt. Das Feld muss vom Redakteur nur dann bearbeitet werden, wenn ein anderer als der Defaultwert ausgewählt werden soll.

Konfigurationsmöglichkeiten

Wie die einzelnen Attribute sinnvoll kombiniert werden können, ist abhängig von der Art der Eingabekomponente. Die Eingabemasken für die unterschiedlichen Verweistypen kennen drei Gruppen von Eingabeelementen:

• einfache Textfelder (z.B. "text", "comment")
• Auswahllisten (z.B. "target", "language")
• Felder zur Auswahl einer Referenz (z.B. sitestoreref, ref, mediaref)

Attributauswahl für Textfelder:

<CMS_PARAM name="text" label="neue Beschriftung"/>

<CMS_PARAM name="text" hidden="1"/>

<CMS_PARAM name="text" value="mein Verweis" default="1"/>

Attributauswahl für Auswahllisten:

<CMS_PARAM name="target" hidden="1"/>

<CMS_PARAM name="target" label="Pop-Up-Fenster" value="popup"/>
<CMS_PARAM name="target" label="Neues Fenster" value="new" default="1"/>

Attributauswahl für Eingabeelemente zur Referenzauswahl:

<CMS_PARAM name="sitestoreref" label="neue Beschriftung"/>

<CMS_PARAM name="sitestoreref" hidden="1"/>

<CMS_PARAM name="sitestoreref" value="showmediastore"/>

<CMS_PARAM name="sitestoreref" value="pageref:eineSeitenreferenz" default="1"/>