CMS_GROUP

CMS_GROUP - Rahmen

CMS_GROUP - Register

Parameter

Die Komponente CMS_GROUP verfügt über drei optionale Parameter:

• name: technischer Bezeichner einer Gruppierung, z. B. für die Benutzung in einem BeanShell-Skript
• scrollable: definiert, ob eine Gruppierung Scrollleisten hat oder nicht
• tab: Darstellung von Eingabekomponenten als Reiter

Übersicht

height

Mit dem Parameter height wird die Anzeigehöhe der Gruppierung in Pixeln festgelegt.

Als Wert erwartet der Parameter eine Ganzzahl, die größer als 200 ist. Wird der Parameter nicht angegeben, orientiert sich die Höhe an den enthaltenen Eingabekomponenten.

Sind mehrere Register definiert (Parameter tabs), richtet sich die Höhe nach den auf dem betreffenden Register enthaltenen Eingabekomponenten.

Übersicht

name

Mit dem optionalen Parameter name kann einer Gruppierung ein Bezeichner zugewiesen werden.

Mit diesem Bezeichner ist der programmiertechnischer Zugriff auf eine Gruppierung, z. B. in einem BeanShell-Skript, oder im Rahmen von Regeln / dynamischen Formularen die Einblendung eines Hinweistextes (siehe Seite <MESSAGE/>: Korrekturhinweise einblenden) möglich.

Anders als Bezeichner von Eingabekomponenten (ebenfalls Parameter name), muss der Bezeichner für CMS_GROUP innerhalb eines Formulars nicht eindeutig sein.

Übersicht

scrollable

Mit dem optionalen Parameter scrollable kann man festlegen, ob eine Gruppierung zur Darstellung von Scrollleisten fähig sein soll oder nicht.

Übersicht

tabs

Mit dem optionalen Parameter tabs können in einer Gruppierung Eingabekomponenten als Reiter dargestellt werden.

Die Orientierung der Reiter kann vorgegeben werden.

Für die Ausrichtung der Reiter im SiteArchitect kann links, rechts, aber auch oben und unten gewählt werden.

Wird der Parameter nicht angegeben, so werden keine Reiter angezeigt.

Hinweis: Im ContentCreator können Reiter nur oben dargestellt werden.

Übersicht

LANGINFOS

Über das Tag LANGINFOS können für jede Eingabekomponente sprachabhängige Angaben definiert werden, z. B. wie die Eingabekomponente in den unterschiedlichen Projektsprachen betitelt sein soll (Parameter label), welcher Tooltip angezeigt werden soll (Parameter description) usw. Aus Gründen der Übersichtlichkeit werden dabei Definitionen, die in mehreren Sprachen identisch sind, zusammengefasst. So wird z. B. aus

 <LANGINFOS> 
 <LANGINFO lang="*" label="Date" format="dd.MM.yy"/>
 <LANGINFO lang="DE" label="Date" format="dd.MM.yy"/>
 <LANGINFO lang="EN" label="Date" format="MM/dd/yy"/>
</LANGINFOS>

beim Speichern

 <LANGINFOS> 
 <LANGINFO lang="*" label="Date" format="dd.MM.yy"/>
 <LANGINFO lang="EN" label="Date" format="MM/dd/yy"/>
</LANGINFOS>

Die Definition für den Rückfallwert (*) bleibt dabei immer erhalten, von Definitionen für Sprachen mit gleichen Werten bleibt immer die oberste erhalten.

Ab FirstSpirit-Version 4.2R4 kann der Rückfallwert weggelassen werden. Dann wird beim Speichern automatisch die zuerst definierte Sprache als Rückfallwert verwendet, z. B. wird aus

<LANGINFOS>
 <LANGINFO lang="EN" label="Date"/>
 <LANGINFO lang="DE" label="Datum"/> 
</LANGINFOS>

beim Speichern

 <LANGINFOS> 
 <LANGINFO lang="*" label="Date"/>
 <LANGINFO lang="DE" label="Datum"/> 
</LANGINFOS>

LANGINFO

Mit dem Tag LANGINFO werden Werte oder Attribute für eine Sprache oder aber für die Verwendung als Rückfallwerte angegeben.

Um Werte bzw. Attribute für eine Sprache anzugeben ist im Parameter lang die Abkürzung der Projektsprache anzugeben:

...
<LANGINFO lang="DE".../>
...

Rückfallwerte werden mit dem speziellen Sprachkürzel * ("für alle Sprachen") angegeben:

...
<LANGINFO lang="*".../>
...

Bei dem Parameter lang handelt es sich um einen Pflichtparameter.

Übersicht

lang

Mit dem Parameter lang wird das Sprachkürzel, das in den Servereigenschaften im Feld Abkürzung eingetragen ist (siehe Sprach-Vorlagen (→Dokumentation für Administratoren)), 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.

Übersicht

description

Über den Parameter description kann eine Beschreibung angegeben werden, wie die Eingabekomponente vom Redakteur verwendet und befüllt werden soll. Der hier definierte Text wird als Tooltip bei Mouse-Over an der betreffenden Eingabekomponente eingeblendet.

Der Text soll dem Redakteur als Hilfestellung dienen und so kurz wie möglich, verständlich und relevant sein. Er sollte zum Label (Parameter label) passen bzw. dieses geeignet ergänzen.
Achten Sie darauf, dabei Terminologie zu verwenden, die der Redakteur kennt und erwartet.

Beispiel:

...description="Bitte geben Sie hier den Text für die Überschrift ein (H1)."...

Tipp: Wenn Sie wissen möchten, wie Sie Redakteure beim Befüllen von Eingabekomponenten noch besser unterstützen und anleiten können, schauen Sie sich das Kapitel zu Regeln sowie weitere Parameter und Funktionen von Formularen an.

Übersicht

label

Mithilfe des Parameters label definieren Sie das Label (die Beschriftung) der Eingabekomponente.

Wählen Sie ein möglichst kurzes und aussagekräftiges Label.
In Verbindung mit einer relevanten Beschreibung (Parameter description) können Sie den Redakteur darin unterstützen, die Eingabekomponente korrekt und erfolgreich zu verwenden.

Beispiel:

... label="Überschrift (H1)" ...

Übersicht

GroupScrollMode	Anzeigeeinstellung für Scrollleisten FIXED Keine Scrollleisten verwenden VERTICAL Vertikale Scrollleisten verwenden HORIZONTAL Horizontale Scrollleisten verwenden BOTH Horizontale und vertikale Scrollleisten verwenden
PositiveInteger	Positive Ganzzahl
Designator	Eindeutiger Bezeichner variabler Länge; muss mit einem Buchstaben oder Unterstrich beginnen und darf nur die Zeichen "A-Z", "a-z", "0-9" und "_" enthalten, z.B. "fr_st_varName"
TabMode	Orientierungsmodus der Reiter NONE Keine Anzeige von Reitern TOP Reiter oben anzeigen LEFT Reiter links anzeigen BOTTOM Reiter unten anzeigen RIGHT Reiter rechts anzeigen
String	Eine beliebige Zeichenkette
LanguageAbbreviation	Sprachkürzel, z.B. DE, EN, FR oder * für Rückfallwerte

Beispiel

Ein Beispiel für die Formularkomponente CMS_GROUP:

<CMS_GROUP tabs="TOP">
  <LANGINFOS>
    <LANGINFO lang="*" label="TEXT_FALLBACK"/>
    <LANGINFO lang="DE" label="TEXT_DE"/>
    <LANGINFO lang="EN" label="TEXT_EN"/>
  </LANGINFOS>
  ...
</CMS_GROUP>