"Form" tab
Input components
Editorial content is entered in the FirstSpirit editing environment using input components such as a text form field or an image selection component. FirstSpirit supports a range of input components for various types of editorial content. The input components are used to make entering content for editors as convenient as possible.
The page template, section template, table template, etc. determine which input components are made available to an editor on a page, in a section, or in a dataset, etc. The required input components are incorporated in the template's “Form” tab by the template developer.
All input components must be defined within the <CMS_MODULE> tags. On each page, in each section, in each dataset, etc. an editor can fill the defined input components with content based on the corresponding template. The form area of a template is therefore like a type of framework that can be filled with individual content for any individual page or any section in the Page Store or for any dataset in the Data Store or Page Store.
The form area of a template contains a simple XML. DTD validation is carried out when saving GUI.XML. If incorrect formatting is identified during this process, the file cannot be saved. Other errors are simply displayed.
Since a page template is only used to hold the static content of a page, only those inputs are defined that:
- are needed only once on each page, such as a page title.
- are always to look the same way on all pages (such as navigation elements and image elements).
Other input components, such as those for entering text or images, are defined in the section templates.
All input components can be used as often as required.
This section of the documentation contains a list of all input components that are supported by FirstSpirit. The technical tag identifiers are used. An explanatory identifier is however displayed for each input component via a tooltip.
Under “Contents” and for each input component, you will obtain a brief overview of possible parameters that are directly linked, as well as a detailed explanation of the parameter in question. Mandatory parameters are displayed here by an asterisk (*).
One or more examples of the syntax of a valid configuration for the respective input component type are listed at the end of the page. The “for example” link takes you directly to them. These examples show how the corresponding input component is used and as many parameters as can reasonably be combined with them are illustrated. When using the Online Help system in SiteArchitect (“Help / Index” menu) or F1, the example that is linked via the “for example” link can be moved directly to the template using drag-and-drop and edited further there.
“to the methods:” takes you to documentation for the data type of the respective input component type. Whereas the documentation under “Forms” primarily lists the options for configuring the associated input component for use by the editor (“backend”), the data type documentation is relevant with respect to outputting the values entered by the editor (“frontend”).
Following an example figure of the input component and a general description, an exact explanation of the individual parameters of the input component is provided as well as the structure in which the tags and parameters are to be used.
It is also possible to determine which tags and parameters are available for an input component as the template is being created. To do this, simply use the “Form” tab and the code completion functionality.
Structure of the form area
The form area in the documentation is divided into four sections:
- Input components: All input components are listed here. Input components start with CMS_INPUT_ or FS_ and end with the input component type (e.g., NUMBER).
- Data elements: Are used to fill input components with data (e.g., from the Data Store). Data elements start with CMS_INCLUDE_ and end with the data element type (currently only OPTIONS).
- Design elements: Are used to comment on and group input components. Design elements start with CMS_ and end with the design element type (e.g., LABEL).
- Default values: Input components in FirstSpirit can be prepopulated with values, if necessary. These can be applied or modified by the editor. If no value is assigned by the editor, the default value can also be used in the preview and on the generated page (“fallback value”).