Feldname | Beschreibung |
|---|
sitestoreref
| Das Feld "sitestoreref" ist eine Eingabekomponente für die Auswahl einer Referenz aus der Struktur-Verwaltung des Projekts. Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden, beispielsweise indem eine bestimmte Referenzen vorselektiert angezeigt wird:
<CMS_PARAM name="sitestoreref" value="pageref:xyz" default="1"/>
Wird bei der Konfiguration das optionale Attribut value="showmediastore" angegeben:
<CMS_PARAM name="sitestoreref" value="showmediastore"/>
wird dem Redakteur, neben der Baumansicht der Struktur-Verwaltung, zusätzlich noch die Baumansicht der Medien-Verwaltung angezeigt.
Wird bei der Konfiguration das optionale Attribut value="hidesitestore" angegeben:
<CMS_PARAM name="sitestoreref" value="hidesitestore"/>
wird die lokale Struktur-Verwaltung des Projekts ausgeblendet. Die Struktur-Verwaltungen von eventuell vorhandenen Remote-Projekten
sind dagegen sichtbar. (Dazu muss allerdings das Attribut remote angegeben werden.)
Die ausgewählte Referenz muss im Quelltext der Verweisvorlage mittels $CMS_REF(#link.sitestoreref)$ aufgelöst werden. |
section
| Das Feld "section" ist eine Eingabekomponente für die Auswahl eines Absatzes. Dabei werden standardmäßig alle Absätze der Seite angezeigt, deren Seitenreferenz vom Redakteur in der Eingabekomponente "sitestoreref" selektiert wurde.
Über die Konfiguration kann das Standardverhalten der Eingabekomponente verändert werden, beispielsweise indem ein bestimmter Absatz der Seite vorselektiert angezeigt wird:
<CMS_PARAM name="section" value="Text/Bild" default="1"/>
Ist in der Eingabemaske ein Absatz selektiert, können außerdem noch "section_anchor" und "section_id" verwendet werden. |
section_anchor | "section_anchor" hat nur dann einen Wert, wenn ein Absatz in der Auswahlliste "section" selektiert wurde
Über den Wert von "section_anchor" kann eine HTML-Sprungmarke (Anker) auf den Absatz zusammengesetzt werden. Solche Anker benötigt ein Vorlagenentwickler, um in umfangreichen Seiteninhalten Sprungmarken innerhalb der Seite zu setzen, beispielsweise für ein Inhaltsverzeichnis oder um am Ende einer Seite, zum ersten Absatz zurück zu springen.
Die Ausgabe muss im Quelltext der Verweisvorlage mittels $CMS_VALUE(#link.section_anchor)$ erfolgen.
Achtung: Es ist notwendig, für die Absatzvorlage des Zielabsatzes (im Vorlagenbereich) das Attribut "<a>-Tag" zu aktivieren! Bei einer Vorschau, Generierung oder einer Veröffentlichung wird das "<a>-Tag" automatisch erzeugt.
Absätze werden beim Anlegen und Umbenennen auf Seitenebene mit einem eindeutigen Referenznamen versehen. Die automatisch von FIRSTspirit erzeugten Anker sind somit eindeutig innerhalb der generierten Seite, z.B.
<a id="section_1" name="section_1"></a>
Die Verwendung von #link.section_anchor führt also zur Rückgabe eines eindeutigen Verweisziels: #section_1 |
section_id | "section_id" hat nur dann einen Wert, wenn ein Absatz in der Auswahlliste "section" selektiert wurde
Über den Wert von "section_id" kann auf die ID des selektierte Absatzes zugegriffen werden.
Beispiel:
$CMS_REF(#link.sitestoreref)$
$CMS_IF(!#link.section_id.isEmpty)$
#$CMS_VALUE(#link.section_id)$
$CMS_END_IF$
Die ID ist im Unterschied zu den Absatznamen (wie beispielsweise in "section_anchor" verwendet) projektweit eindeutig. Über "section_id" ist damit eine zuverlässige, eindeutige Referenzierung eines Absatzes möglich.
Achtung: Es ist notwendig, für die Absatzvorlage des Zielabsatzes (im Vorlagenbereich) das Attribut "<a>-Tag" zu aktivieren! Bei einer Vorschau, Generierung oder einer Veröffentlichung wird das "<a>-Tag" automatisch erzeugt. |
text | Das Feld "text" ist eine Eingabekomponente für die Eingabe eines Verweistexts. In das Feld kann ein beliebiger Text eingegeben werden, der verlinkt werden soll. Über die Konfiguration kann das Standardverhalten der Eingabekomponente verändert werden.
Beispiel:
<CMS_PARAM name="text" label="Verweistext"/> |
comment | Das Feld "comment" ist eine Eingabekomponente für die Eingabe eines Kommentars. Der Redakteur kann in das Eingabefeld einen beliebigen Kommentartext eingeben, der beispielsweise als "tooltip" angezeigt werden kann. Über die Konfiguration kann das Standardverhalten der Eingabekomponente verändert werden.
Beispiel:
<CMS_PARAM name="comment" value="Bitte hier klicken!"/>
|
linktemplate | Das Feld "linktemplate" ist eine Auswahlliste für die Auswahl einer Verweisvorlage. Standardmäßig enthält die Auswahlliste alle Verweisvorlagen der aktuellen Instanz des Verweisvorlagentyps. (Begriffserklärung: siehe Verweisvorlagen
)
Der Redakteur kann aus der Liste die Verweisvorlage auswählen, die zur Erstellung des Verweises verwendet werden soll.
Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden.
Über die Definition mehrerer Parameter, kann die Auswahlliste vom Vorlagenentwickler, beispielsweise mit einer beliebigen Anzahl an gültigen Verweisvorlagennamen vorbelegt werden. Für das Attribut value ist der eindeutige Bezeichner anzugeben.
<CMS_PARAM name="linktemplate" value="myInternalLink.standardLink1"/>
<CMS_PARAM name="linktemplate" value="myInternalLink.standardLink2" default="1" />
<CMS_PARAM name="linktemplate" value="myInternalLink.standardLink3"/>
Die Elemente werden in der Liste, in der vom Vorlagenentwickler konfigurierten Reihenfolge dargestellt. |
mediaref | Das Feld "mediaref" ist eine Eingabekomponente für die Auswahl eines Medienobjekts aus der Medien-Verwaltung des Projekts, das verlinkt werden soll. Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden.
Beispiel:
<CMS_PARAM name="mediaref" value="media:abc" default="1"/>
Die ausgewählte Referenz muss im Quelltext der Verweisvorlage mittels $CMS_REF(#link.mediaref)$ aufgelöst werden.
|
target | Das Feld "target" ist eine Eingabekomponente für die Auswahl eines Zielframes für den Verweis, beispielsweise im aktuellen Fenster oder in einem Popup-Fenster. Der Verweis wird im selektierten Zielframe geöffnet.
Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden, beispielsweise kann die Liste vom Vorlagenentwickler mehrfach vorbelegt werden:
<CMS_PARAM name="target" value="_top"/>
<CMS_PARAM name="target" value="_self" default="1"/>
<CMS_PARAM name="target" value="_blank"/>
Über das Attribut "value" können die gängigen HTML-Frame-Bezeichner aber auch projektspezifisch definierte Frames zur Auswahl gestellt werden. |
language | Das Feld "language" ist eine Eingabekomponente für die Auswahl einer Sprache für den Verweis. Standardmäßig werden in der Auswahlliste alle Sprachen des Projekts angezeigt.
Über die Konfiguration der Eingabekomponente kann das Standardverhalten der Eingabekomponente verändert werden, beispielsweise kann der Vorlagenentwickler eine Sprache vorselektieren:
<CMS_PARAM name="language" value="DE" default="1"/>
|
remote | Das Feld "remote" definiert, welches Remote-Projekt für die Auswahl einer Referenz aus der Struktur-Verwaltung zur Verfügung steht. Für das Attribut value ist der symbolische Name des Remoteprojektes anzugeben:
<CMS_PARAM name="remote" value="symbNameRemoteproject"/>
Alternativ kann mit dem Schlüsselbegriff category der Bezeichner der Remote-Kategorie angegeben werden:
<CMS_PARAM name="remote" value="category:categoryName"/>
Wird bei der Konfiguration für das Feld "sitestoreref" das optionale Attribut value="showremotesitestore" angegeben:
<CMS_PARAM name="sitestoreref" value="showremotesitestore"/>
wird dem Redakteur, neben der Struktur-Verwaltung des internen Projektes, zusätzlich noch die Struktur-Verwaltung des Remote-Projektes angezeigt.
Wird bei der Konfiguration für das Feld "sitestoreref" das optionale Attribut value="showremotemediastore" angegeben:
<CMS_PARAM name="sitestoreref" value="showremotemediastore"/>
wird dem Redakteur, neben der Struktur-Verwaltung des internen Projektes, zusätzlich noch die Medien-Verwaltung des Remote-Projektes angezeigt. |
remotemedia | Das Feld "remotemedia" definiert, welches Remote-Projekt für die Auswahl eines Medienobjektes aus der Medien-Verwaltung zur Verfügung steht. Für das Attribut value ist der symbolische Name des Remoteprojektes anzugeben:
<CMS_PARAM name="remotemedia" value="symbNameRemoteproject"/>
Alternativ kann mit dem Schlüsselbegriff category der Bezeichner der Remote-Kategorie angegeben werden:
<CMS_PARAM name="remotemedia" value="category:categoryName"/>
Wird bei der Konfiguration für das Feld "mediaref" das optionale Attribut value="showremotemediastore" angegeben:
<CMS_PARAM name="mediaref" value="showremotemediastore"/>
wird dem Redakteur, neben der Medien-Verwaltung des internen Projektes, zusätzlich noch die Medien-Verwaltung des Remote-Projektes angezeigt.
Wird bei der Konfiguration für das Feld "mediaref" das optionale Attribut value="remoteonly" angegeben:
<CMS_PARAM name="mediaref" value="remoteonly"/>
wird dem Redakteur ausschließlich die Medien-Verwaltung des Remote-Projektes angezeigt. |
| |
|
)