Startseite / Vorlagen (Grundlagen) / Aufbau von Vorlagen / Verweisvorlagen / Beispiele / Externe Verweise

Beispiel: Formular für externe Verweise

Externe Verweise verweisen auf Objekte außerhalb des FirstSpirit-Projekts, z. B. auf Seiten anderer Internetauftritte.

Im Folgenden wird beispielhaft ein Formular und die Syntax für eine entsprechende Ausgabe für einen Verweis, der auf die Startseite der Unternehmens-Website www.e-Spirit.com führt, vorgestellt.

Darstellung (SiteArchitect)

Erläuterung

	Verwendung	Eingabekomponente im folgenden Code-Beispiel
1.	Eingabe des Verweisziels in einem gültigen Format (z. B. http://www.e-spirit.com) (Pflichtfeld, siehe Einleitung)	lt_reference
2.	Eingabe eines Verweistextes (Pflichtfeld, siehe Einleitung)	lt_text
3.	Eingabe eines optionalen Kommentars, der als Tooltip zum Verweis angezeigt werden kann.	lt_comment
4.	Auswahl eines Zielfensters (Soll das Verweisziel im selben Fenster, in einem neuen Fenster oder in einem projektspezifisch definierten Fenster geöffnet werden?). Standardmäßig werden Verweisziele im selben Fenster geöffnet, Verweise zu externen Web-Angeboten sollten idealerweise in einem neuen Fenster geöffnet werden.	lt_target

Formular

<CMS_MODULE>
 
   <CMS_INPUT_TEXT name="lt_reference" hFill="yes" singleLine="no" useLanguages="no">
     <LANGINFOS>
       <LANGINFO lang="*" label="Target URL"/>
       <LANGINFO lang="DE" label="Zieladresse"/>
     </LANGINFOS>
   </CMS_INPUT_TEXT>
 
   <CMS_INPUT_TEXT name="lt_text" hFill="yes" singleLine="no" useLanguages="no">
     <LANGINFOS>
       <LANGINFO lang="*" label="Link text"/>
       <LANGINFO lang="DE" label="Verweistext"/>
     </LANGINFOS>
   </CMS_INPUT_TEXT>
 
   <CMS_INPUT_TEXT name="lt_comment" hFill="yes" singleLine="no" useLanguages="no">
     <LANGINFOS>
       <LANGINFO lang="*" label="Comment"/>
       <LANGINFO lang="DE" label="Kommentar"/>
     </LANGINFOS>
   </CMS_INPUT_TEXT>
 
   <CMS_INPUT_COMBOBOX name="lt_target" hFill="yes" singleLine="no" useLanguages="no">
     <ENTRIES>
       <ENTRY value="_blank">
         <LANGINFOS>
           <LANGINFO lang="*" label="in new window"/>
           <LANGINFO lang="DE" label="in neuem Fenster"/>
         </LANGINFOS>
       </ENTRY>
       <ENTRY value="_self">
         <LANGINFOS>
           <LANGINFO lang="*" label="in current window"/>
           <LANGINFO lang="DE" label="im aktuellen Fenster"/>
         </LANGINFOS>
       </ENTRY>
     </ENTRIES>
     <LANGINFOS>
       <LANGINFO lang="*" label="Target window"/>
       <LANGINFO lang="DE" label="Zielfenster"/>
    </LANGINFOS>
   </CMS_INPUT_COMBOBOX>

 </CMS_MODULE>

Ausgabe

Im Folgenden werden nur minimale Code-Beispiele vorgestellt, die für eine Verwendung im produktiven Projekt entsprechend angepasst werden müssen. So wurde beispielsweise auf eine Nicht-Leer-Prüfung (z. B. $CMS_IF(!lt_reference.isEmpty)$ verzichtet. Ohne diese kann es im Produktiv-Projekt aber zu Generierungsfehlern kommen.

Verweise werden in HTML generell mit folgender Syntax ausgegeben:

<a href="[Verweisziel]">[Verweistext]</a>

Für das Verweisziel wird in der HTML-Ausgabe über die Verweisvorlage der Wert von lt_reference verwendet, für den Verweistext der Wert von lt_text:

<a href="$CMS_VALUE(lt_reference)$">$CMS_VALUE(lt_text)$</a>

Ob das vom Redakteur eingegebene Verweisziel ein gültiges Format hat, kann mithilfe der Dynamischen Formulare geprüft werden.

Kommentare aus dem Feld lt_comment können über das HTML-Attribut title als Tooltip zum Verweis ausgegeben werden.

Schließlich kann noch das über lt_target vom Redakteur gewählte Zielfenster des Verweises ausgelesen und berücksichtigt werden: Dazu wird die Methode getKey angewendet (siehe dazu Datentyp Option). Der ermittelte Wert wird für das HTML-Attribut target verwendet. Dieses Attribut erwartet als Wert z. B. _blank (zum Öffnen des Verweises in einem neuen Fenster) oder _self (zum Öffnen des Verweises im selben Fenster). Diese Werte werden vom Redakteur über die betreffende Combobox im Formular ausgewählt.

Final könnte eine einfache beispielhafte Ausgabe des Verweises folgendermaßen aussehen:

<a href="$CMS_VALUE(lt_reference)$"
   
    title="$CMS_VALUE(lt_comment)$"
    target="$CMS_VALUE(lt_target.getKey())$"
>
$CMS_VALUE(lt_text)$
</a>

Schema

Druckversion | Seitenanfang