Register "Formular"
Eingabekomponenten der FirstSpirit Redaktionsumgebung
Redaktionelle Inhalte werden in der FirstSpirit Redaktionsumgebung über Eingabekomponenten, beispielsweise ein Texteingabefeld oder eine Bildauswahlkomponente eingepflegt. FirstSpirit unterstützt dabei eine Vielzahl von Eingabekomponenten für unterschiedliche Arten redaktioneller Inhalte. Die Eingabekomponenten dienen dazu, das Einpflegen der Inhalte für Redakteure so komfortabel wie möglich zu gestalten.
Welche Eingabekomponeten einem Redakteur auf einer Seite oder auf einem Absatz zur Verfügung gestellt werden, ist abhängig von der Seiten- bzw. Absatzvorlage. Die gewünschten Eingabekomponenten werden vom Vorlagenentwickler im Registerbereich "Formular" der Vorlage eingebunden.
Alle Eingabekomponenten müssen innerhalb der CMS_MODULE Tags definiert werden. Ein Redakteur kann auf jeder Seite oder auf jedem Absatz basierend auf der entsprechende Vorlage die definierten Eingabekomponenten mit Inhalt füllen. Der Formularbereich einer Vorlage ist also als eine Art Gerüst zu verstehen, das für jede einzelne Seite oder jeden Absatz in der Inhalte-Verwaltung mit individuellen Inhalten gefüllt werden kann.
Im Formularbereich einer Vorlage steht reines XML. Beim Abspeichern der GUI.XML wird eine DTD-Validierung durchgeführt. Wird dabei eine Verletzung der Wohlgeformtheit festgestellt, lässt sich die Datei nicht speichern. Auf sonstige Fehler wird nur hingewiesen.
Da eine Seitenvorlage nur dazu dient, die statischen Inhalte einer Seite aufzunehmen, werden hier nur die Eingabekomponenten definiert, die:
- nur einmal auf jeder Seite benötigt werden, wie beispielsweise ein Seitentitel
- die auf allen Seiten immer gleich aussehen sollen, wie Navigationselemente und Bildelemente
Andere Eingabekomponenten, beispielsweise zur Text- oder Bildeingabe, werden in den Absatzvorlagen definiert.
Alle Eingabekomponenten können beliebig oft verwendet werden.
In diesem Abschnitt der Dokumentation finden Sie eine Aufstellung aller Eingabekomponenten, die von FirstSpirit unterstützt werden. Dabei werden die technischen Tag-Bezeichnungen verwendet. Per Tooltip wird jedoch zu jeder Eingabekomponente eine erläuternde Bezeichnung eingeblendet.
Zu jeder Eingabekomponente erhalten Sie eine Kurzübersicht über mögliche Parameter, die direkt mit einer ausführlichen Erklärung des jeweiligen Parameters verlinkt ist. Pflichtparameter werden durch ein Sternchen (*) angezeigt. Am Ende der jeweiligen Übersichtsseite wird Ihnen der Link zu einem Beispiel angeboten. In diesen Beispielen wird der Einsatz der entsprechenden Eingabekomponente exemplarisch dargestellt, wobei möglichst viele, sinnvoll kombinierbare Parameter aufgenommen wurden.
Des Weiteren können Sie sich auf der entsprechenden Detailseite eine genaue Erklärung der einzelnen Parameter anzeigen lassen.
Zu Beginn jeder Detailseite ist weiterhin eine schematische Darstellung der üblichen Verwendungsweise der entsprechenden Eingabekomponente aufgelistet.
Gliederung Formularbereich
Der Formularbereich in der Dokumentation ist in drei Teile untergliedert:
- Eingabekomponenten: Hier sind alle Eingabekomponenten aufgeführt. Eingabekomponenten beginnen mit CMS_INPUT_ und enden mit dem Eingabekomponententyp (z. B. NUMBER).
- Datenelemente: Dienen dazu Eingabekomponenten mit Daten (z. B. aus der Datenquellen-Verwaltung) befüllen. Datenelemente beginnen mit CMS_INCLUDE_ und enden mit dem Typ des Datenelementes (z. B. CONTENT).
- Gestaltungselemente: Dienen zur Kommentierung und Gruppierung von Eingabekomponenten. Gestaltungselemente beginnen mit CMS_ und enden mit dem Typ des Gestaltungselementes (z. B. LABEL).