FirstSpirit Online Documentation - Editing link templates

Start page / Tutorials / First project / Link templates / Input components

Input components of a link template

At a minimum, a link template must have an input component each for the link target and the link text. The FS_REFERENCE input component should be used for the link target and the CMS_INPUT_TEXT input component should be used for the link text.

In order to define these input components, the source code is added within the <CMS_MODULE> tags. The source code and associated explanations for

are described in the following sections.

The entire content for the "Form" tab is summarized again at the end of the page.

Link target input component

<FS_REFERENCE name="lt_pageref" hFill="yes" imagePreview="no" sections="no" useLanguages="no">
 <FILTER>
 <ALLOW type="pageref"/>
 <ALLOW type="pagereffolder"/>
 </FILTER>
 <LANGINFOS>
 <LANGINFO lang="*" label="Target"/>
 <LANGINFO lang="DE" label="Ziel"/>
 </LANGINFOS>
 <PROJECTS>
 <LOCAL name=".">
 <SOURCES>
 <FOLDER name="root" store="sitestore"/>
 </SOURCES>
 </LOCAL>
 </PROJECTS>
 </FS_REFERENCE>

Clicking on the Save icon in the client bar shows the appearance of the input component immediately in the integrated preview.

Description of the FS_REFERENCE input component


FS_REFERENCE	Calls the input component for reference selection
name="lt_pageref"	Unique name of the input component. This name can be used later to access the content stored in the component.
hFill="yes"	An input component is displayed in the full display width.
imagePreview="no"	No image preview of the selected image is to be displayed in the input component.
sections="no"	After selecting a page reference, selection of a target section is suppressed.
useLanguages="no"	A value is saved for all languages.
<FILTER>	Using the element type information, it is possible to control the view and functionality of the selection dialog.
<ALLOW type="pageref"/> <ALLOW type="pagereffolder"/>	The ALLOW tag is used to define element types that are permitted to be selected from the selection dialog. If the tag is specified for a type, it will no longer be possible to select any of the others. pageref = page references (Site Store) pagereffolder = menu levels (Site Store)
LANGINFO lang="*" LANGINFO lang="DE"	Specifies the language information for * = all languages not explicitly defined DE = the DE language
label="Target"	Input component label for the specified language.
<PROJECTS>	This defines from which projects (local and/or remote) references may be selected.
<LOCAL name=".">	If the PROJECTS tag is entered, the local project needs to be defined. The parameter name is used to input the name of the local project. This is usually done using a . (dot)
<SOURCES>	The selection or display is limited to specific folders (incl. subfolders). This is a positive list, which means that only the specified folders are allowed.
<FOLDER name="root" store="sitestore"/>	A folder to be included is specified. The entire store of the entire Site Store is allowed.

Input component for the link text

<CMS_INPUT_TEXT name="lt_text" hFill="yes" useLanguages="yes">
    <LANGINFOS>
      <LANGINFO lang="*" label="Link text"/>
      <LANGINFO lang="DE" label="Verweistext"/>
    </LANGINFOS>
  </CMS_INPUT_TEXT>

Clicking on the Save icon in the tool bar shows the appearance of the input component immediately in the integrated preview.

Information about the CMS_INPUT_TEXT input component


CMS_INPUT_TEXT	Calls the input component for single line text input
name="lt_text"	Unique name of the input component. This name can be used later to access the content stored in the component.
hFill="yes"	An input component is displayed in the full display width.
useLanguages="yes"	Different values are stored for the different languages.
LANGINFO lang="*" LANGINFO lang="DE"	Specifies the language information for * = all languages not explicitly defined DE = the DE language
label="Link text"	Input component label for the specified language.

Entire form area of the link template text link (internal)

<CMS_MODULE>

  <FS_REFERENCE name="lt_pageref" hFill="yes" imagePreview="no" sections="no" useLanguages="no">
    <FILTER>
      <ALLOW type="pageref"/>
      <ALLOW type="pagereffolder"/>
      <ALLOW type="documentgroup"/>
    </FILTER>
    <LANGINFOS>
      <LANGINFO lang="*" label="Target"/>
      <LANGINFO lang="DE" label="Ziel"/>
    </LANGINFOS>
    <PROJECTS>
      <LOCAL name=".">
        <SOURCES>
          <FOLDER name="root" store="sitestore"/>
        </SOURCES>
      </LOCAL>
    </PROJECTS>
  </FS_REFERENCE>

  <CMS_INPUT_TEXT name="lt_text" hFill="yes" useLanguages="no">
    <LANGINFOS>
      <LANGINFO lang="*" label="Link text"/>
      <LANGINFO lang="DE" label="Verweistext"/>
    </LANGINFOS>
  </CMS_INPUT_TEXT>

</CMS_MODULE>

Print version | Page start