Version: GSB 7Formulare

Die Standardlösung enthält Formulare z.B. für die Expertensuche, das Kontaktformular, die Newsletter-An-/Abmeldung und zum Empfehlen einer Seite. Weitere Formulare können vom Site Manager angelegt werden.

Bestandteile von Formularen

Um Formulare zusammenstellen zu können, werden einerseits die Feldbezeichner (Labels) und andererseits die Formularfelder benötigt. Diese, für alle Formulare gleich geltenden Bestandteile, werden im ersten Schritt beschrieben. Anschließend folgt eine Beschreibung der spezifischen Zusammenstellung der bereits vorhandenen Formulare.

standardlsg/_config/ResourceBundleEntries/Labels

In diesem Verzeichnis finden Sie alle Labels (Feldbezeichner), die den in den Formularen verwendeten Feldern Namen geben. Die Dokumente sind internationalisiert, sodass es keine redundanten Dokumente für einzelne Sprachversionen geben muss.

Diese Dokumente sind vom Typ „Konfiguration-Resource-Label“ (ConfigResLabel). Sie sind alle nach demselben Schema aufgebaut:

• Das Feld „Beschreibung“ kann eine Beschreibung enthalten, die nur intern verwendet wird, z.B. die Erklärung, wofür das Label verwendet wird.
• Im Feld „Wert“ wird eine Tabelle angelegt, die für jede Sprache, für den der Webauftritt konfiguriert ist, eine Spalte enthält:

en	de
[engl. Label-Name]	[dt. Label-Name]

Legen Sie für jedes Label, das Sie benötigen, ein eigenes Dokument in diesem Verzeichnis an. Vergeben Sie möglichst sprechende Namen.

Bei der Expertensuche haben Sie beispielsweise die Option, nach bestimmten Dokumenttypen zu suchen. Hierzu benötigen Sie einerseits eine Dokumentkategorie und ein entsprechendes Label, welches genau denselben Dokumentnamen trägt, damit es in der Expertensuche angezogen werden kann.

standardlsg/_config/ResourceBundleEntries/Templates

In diesem Ordner befinden sich die Dokumente, die für den Mailversand benötigt werden. In diesen Dokumenten wird definiert, welche Formulareinträge in welcher Reihenfolge und mit welchen Kommentaren in den E-Mails positioniert werden. Auch dieses Dokument ist, analog zu den Labels, internationalisiert.

standardlsg/SiteGlobals/Forms

Dieser Ordner und die dort liegenden Unterordner beinhalten vielfältige Elemente, die zur Erstellung von HTML-Formularen verwendet werden bzw. die Formularkonfiguration selbst.

standardlsg/SiteGlobals/Forms/Kontakt

In diesem Ordner befindet sich das Kontakt-Formular, das dem Besucher der Website zur Kontaktaufnahme zur Verfügung gestellt wird. Außerdem ist hier der Kontakt-Formular-Integrator abgelegt, in dem im Feld „Beschreibung“ der einleitende Text zum Formular erfasst wird.

standardlsg/SiteGlobals/Forms/Newsletter

In diesem Ordner befinden sich die Newsletter-Formulare, über die der Besucher der Website den Newsletter bestellen bzw. abbestellen kann. Außerdem ist hier jeweils ein Formular-Integrator für das Bestellen- bzw. Abbestellen-Formular abgelegt, in dem im Feld „Beschreibung“ der einleitende Text zum Formular erfasst wird.

standardlsg/SiteGlobals/Forms/SeiteEmpfehlen

In diesem Ordner befindet sich das Seite-Empfehlen-Formular, das dem Besucher der Website zum Empfehlen der Seiten zur Verfügung gestellt wird. Außerdem ist hier ein Standardartikel abgelegt, der das erfolgreiche Versenden der Seite bestätigt.

standardlsg/SiteGlobals/Forms/Suche

In diesem Ordner befindet sich das Formular für die Volltextsuche, über die der Besucher der Website nach einzelnen Worten oder Wortgruppen suchen kann. Außerdem liegt in diesem Ordner das Formular für die Expertensuche. Hierüber kann der Besucher die Suche nach einem Suchtext um die folgenden Suchoptionen erweitern: „Letzte Änderung nach“, „Letzte Änderung vor“, „Schwerpunktthema“ und „Dokumenttyp“. Zusätzlich liegt in diesem Verzeichnis noch jeweils ein Formular-Integrator für die Volltext- und Expertensuche, in dem im Feld „Beschreibung“ der einleitende Text zum jeweiligen Formular erfasst wird.

standardlsg/SiteGlobals/Forms/_components In diesem Ordner befinden sich, aufgeteilt in entsprechende Unterordner, die Einzelelemente (z.B. Buttons) der für den Webauftritt konfigurierten Formulare.

Legen Sie für alle Elemente, die Sie benötigen, entsprechende Dokumente in den jeweiligen Ordnern an und vergeben Sie jeweils sprechende Namen. Sollte Ihnen ein Verzeichnis fehlen, ggf. weil Sie einen neuen Dokumenttyp aufnehmen, so legen Sie zu den benötigten Dokumenten auch noch ein neues Verzeichnis mit dem Namen an, der die Funktion der Elemente beschreibt (z.B. „Radiobutton“).

Die in den folgenden Abschnitten eingefügten Tabellen enthalten die Beschreibungen der einzelnen Elemente, sodass Sie durch Veränderungen der Einträge die Formulare entsprechend konfigurieren können.

Action

Im Verzeichnis SiteGlobals/Forms/_components/Actions liegen Dokumente, mit denen eine Aktion aufgerufen wird, z.B. das Versenden eines Kontaktformulars.

Es handelt sich hier um Dokumente vom Typ „HTML-Formular Action.“

Die folgende Tabelle zeigt, welche Bedeutung die einzelnen Elemente haben und welche Eingabeoptionen zur Verfügung stehen.

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
Java-Klasse (className)	Der vollqualifizierte Name der Java-Klasse, welche die tatsächliche Aktion ausführt
Parameter (parameters)	Action-spezifische Parameter als Key/Value-Paare
Klassifizierte Parameter (cl2Parameters)	Action-spezifische Parameter, die als ClassifiedLinks übergeben werden

Buttons

Im Ordner SiteGlobals/Forms/_components/Buttons werden alle Dokumente gespeichert, die für Buttons verwendet werden.

Es handelt sich hier um Dokumente vom Typ „HTML-Formular Generischer Button“.

Die folgende Tabelle zeigt, welche Bedeutung die einzelnen Felder haben und welche Eingabeoptionen zur Verfügung stehen.

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
ID (idName)	ID des Elements
Label (displayNameKey)	Der ResourceBundleEntry, der die internationalisierten Namen des Auswahlelementes enthält
Bild (image)	Kapselt das <image>-Tag des Button-Elementes
Typ (typeAttribut)	Legt den Typ des Button-Elements fest (z.B. Submit-Button, Reset-Button, Einfacher Button)
Access-Key ('accessKey')	Access-Key des Dokuments

Radiobuttons

Im Ordner SiteGlobals/Forms/_components/Radiobuttons werden alle Dokumente gespeichert, die für Radiobuttons und deren Optionen verwendet werden.

Es handelt sich hier um Dokumente vom Typ „HTML-Formular Statische Radiobutton Gruppe“.

Die folgende Tabelle zeigt, welche Bedeutung die einzelnen Felder haben und welche Eingabeoptionen zur Verfügung stehen.

HFSRadiobuttonGrp

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
ID (idName)	ID des Elements
Label (displayNameKey)	Der ResourceBundleEntry, der die internationalisierten Namen des Auswahlelementes enthält
Radiobuttons (radiobuttons)	Einzelne HFOption-Dokumente in denen die darzustellenden Auswahlmöglichkeiten hinterlegt werden.
Pflichtfeld (mandatory)	Kann Werte true oder falseannehmen, zeigt an, inwiefern das Formularfeld ein Pflichtfeld ist. Für ein Mapping der Int-Properties auf die technischen Werte siehe JavaDoc der Klasse DoctypesConstants
Validatoren (validators)	Liste von HFValidator-Dokumenten, die den eingegebenen Wert überprüfen

HFRadiobutton

Zur Konfiguration eines Radiobuttons soll zukünftig der Dokumenttyp HFOption verwendet werden.

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
ID (idName)	ID des Elements
Label (displayNameKey)	Der ResourceBundleEntry, der die internationalisierten Namen des Auswahlelementes enthält
Radiobuttons (radiobuttons)	Einzelne HFOption-Dokumente in denen die darzustellenden Auswahlmöglichkeiten hinterlegt werden.
Selektiertes Attribut (selectedAttribute)	Kann Werte true oder false annehmen, zeigt an, ob ein Radiobutton per Default ausgewählt ist.

Selectboxen

Sofern Sie in einem Formular Selectboxen einsetzen möchten, müssen Sie diese als einzelne Dokumente anlegen und im Verzeichnis SiteGlobals/Forms/_components/Selectboxen speichern.

Es handelt sich hier um Dokumente vom Typ „HTML-Formular Dynamische Select Box“

Die folgende Tabelle zeigt, welche Bedeutung die einzelnen Felder haben und welche Eingabeoptionen zur Verfügung stehen.

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
ID (idName)	ID des Elements
Label (displayNameKey)	Der ResourceBundleEntry, der die internationalisierten Namen des Auswahlelementes enthält
Formular-Füll-Klasse (formFillerClass)	Der vollqualifizierte Name der Java-Klasse, zur Befüllung der Selectbox, z.B. aus einer Datenbank
Eigenschaften für die Formular-Füll-Klasse (formFillerProps)	Java-Klassen-spezifische Parameter als Key/Value-Paare
Formular-Füll-Parameter (cl2formFillerProps)	Java-Klassen -spezifische Parameter, die als ClassifiedLinks übergeben werden
Auswahlmöglichkeiten (choicesDirectory)	Einzelnes ConfigString-Dokument, das den Pfad zu einem Ordner angibt, in dem die letztendlich darzustellenden Auswahlmöglichkeiten liegen.
Pflichtfeld (mandatory)	Kann Werte true oder falseannehmen, zeigt an, inwiefern das Formularfeld ein Pflichtfeld ist. Für ein Mapping der Int-Properties auf die technischen Werte siehe JavaDoc der Klasse DoctypesConstants
Sortierung (sortOrder)	Angabe des Sortierkriteriums bzgl. des Titels der gefundenen Dokumente. Es stehen folgende Sortierkriterien zur Auswahl: „Keine Sortierung“, „aufsteigend“ oder „absteigend“
Validatoren (validators)	Liste von HFValidator-Dokumenten, die den eingegebenen Wert überprüfen
Mehrfachauswahl (multipleAttribute)	Kann Werte true oder false annehmen, zeigt an, ob die gleichzeitige Auswahl mehrere Elemente zulässig ist
Größe (sizeAttribute)	Analog zum HTML-Attribut size einer gewöhnlichen HTML-Selectbox (vgl. HFSSelectBox); Kann ganzzahlige Werte annehmen, die dann die Anzahl der simultan dargestellten Auswahlmöglichkeiten angeben.
Erstes Element (firstChoices)	Diejenigen Auswahlmöglichkeiten, die vor den dynamisch eingelesenen Möglichkeiten dargestellt werden sollen
Letztes Element (lastChoices)	Diejenigen Auswahlmöglichkeiten, die nach den dynamisch eingelesenen Möglichkeiten dargestellt werden sollen

Textfelder

Im Verzeichnis SiteGlobals/Forms/_components/Textfelder liegen Dokumente, mit denen Textfelder dargestellt werden.

Es gibt zwei Arten von Textfeldern: Texteditoren und Eingabefelder. Sie benötigen diese Felder immer dann, wenn der Benutzer Texteingaben machen soll. Ein Texteditor kommt immer dann zum Einsatz, wenn ein mehrzeiliges Textfeld zur Eingabe benötigt wird (HFTextInputArea). Alle anderen Felder werden mit Dokumenten vom Typ „HFTextInputField“ erzeugt.

Die folgenden Tabellen zeigen, welche Bedeutung die einzelnen Felder haben und welche Eingabeoptionen zur Verfügung stehen.

HFTextInputArea

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
ID (idName)	ID des Elements
Label (displayNameKey)	Der ResourceBundleEntry, der die internationalisierten Namen des Auswahlelementes enthält
Formular-Füll-Klasse (formFillerClass)	Der vollqualifizierte Name der Java-Klasse, zur Befüllung der Selectbox, z.B. aus einer Datenbank
Eigenschaften für die Formular-Füll-Klasse (formFillerProps)	Java-Klassen-spezifische Parameter als Key/Value-Paare
Formular-Füll-Parameter (cl2formFillerProps)	Java-Klassen -spezifische Parameter, die als ClassifiedLinks übergeben werden
Pflichtfeld (mandatory)	Kann Werte true oder falseannehmen, zeigt an, inwiefern das Formularfeld ein Pflichtfeld ist. Für ein Mapping der Int-Properties auf die technischen Werte siehe JavaDoc der Klasse DoctypesConstants
Validatoren (validators)	Liste von HFValidator-Dokumenten, die den eingegebenen Wert überprüfen
Nur lesbar (readOnlyAttribute)	Kann Werte true oder false annehmen, zeigt an, ob das Textfeld geändert werden darf
Standardwert (defaultValue)	Der Default-Wert, der beim erstmaligen Aufruf des Formulars angezeigt werden soll
Spalten (columnsAttribute)	Kapselt das Attribut columns des HTML-TextArea-Tags
Zeilen (rowsAttribute)	Kapselt das Attribut rows des HTML-TextArea-Tags

HFTextInputField

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
ID (idName)	ID des Elements
Label (displayNameKey)	Der ResourceBundleEntry, der die internationalisierten Namen des Auswahlelementes enthält
Formular-Füll-Klasse (formFillerClass)	Der vollqualifizierte Name der Java-Klasse, zur Befüllung der Selectbox, z.B. aus einer Datenbank
Eigenschaften für die Formular-Füll-Klasse (formFillerProps)	Java-Klassen-spezifische Parameter als Key/Value-Paare
Formular-Füll-Parameter (cl2formFillerProps)	Java-Klassen -spezifische Parameter, die als ClassifiedLinks übergeben werden
Pflichtfeld (mandatory)	Kann Werte true oder falseannehmen, zeigt an, inwiefern das Formularfeld ein Pflichtfeld ist. Für ein Mapping der Int-Properties auf die technischen Werte siehe JavaDoc der Klasse DoctypesConstants
Validatoren (validators)	Liste von HFValidator-Dokumenten, die den eingegebenen Wert überprüfen
Nur lesbar (readOnlyAttribute)	Kann Werte true oder false annehmen, zeigt an, ob das Textfeld geändert werden darf
Standardwert (defaultValue)	Der Default-Wert, der beim erstmaligen Aufruf des Formulars angezeigt werden soll
Größe (sizeAttribute)	Kapselt das Attribut size des HTML-Input Tags vom Typ text oder password
Typ (typeAttribute)	Kapselt das Attribut typedes HTML-Input Tags. Mögliche Werte sind text, hidden oder password.Bei Typ password wird der eingegebene Text nicht im Klartext sondern durch (*) dargestellt. Für ein Mapping der Int-Properties auf die technischen Werte siehe JavaDoc der Klasse DoctypesConstants
Maximale Länge (maxLengthAttribute)	Kapselt das Attribut maxlength des HTML-Input Tags vom Typ text oder password
HTML5-Attribute	Kann spezielle HTML5-Konfiguration aufnehmen

Validator

Im Verzeichnis SiteGlobals/Forms/_components/Validatoren liegen Dokumente, mit denen eingegebene Inhalte überprüft werden können.

Validatoren werden benötigt, wenn eingegebene Inhalte validiert werden müssen. Dazu legen Sie ein Dokument vom Typ „HFItemValidator“ an. Dieses fungiert als Wrapper für die Java-Klasse (Struts-Framework), welche die Validierung eines Formularfeldes vornimmt.

Es gibt es zwei unterschiedliche Validatoren: für z.B. E-Mails oder für die Datumseingabe.

Die folgende Tabelle benennt detailliert die einzelnen Eingabefelder, die zur Eingabe von Validatoren zur Verfügung stehen. Zudem werden in den Beschreibungen Konfigurationsmöglichkeiten aufgezeigt.

Attribut	Beschreibung
Interne Beschreibung (description)	Interne Beschreibung der Interaction-Elemente, in denen der Site-Admin z.B. Hinweise zur Benutzung für Redakteure hinterlegen kann.
Java-Klasse (className)	Der vollqualifizierte Name der Java-Klasse, welche die tatsächliche Aktion ausführt
Parameter (parameters)	Action-spezifische Parameter als Key/Value-Paare
Klassifizierte Parameter (cl2Parameters)	Action-spezifische Parameter, die als ClassifiedLinks übergeben werden

Suchformular

Die Suche setzt sich aus zahlreichen Dokumenten zusammen, die miteinander in Bezug gesetzt werden. Da es sich hierbei sowohl um funktionale Dokumente als auch um redaktionelle Dokumente handelt, spiegelt sich dies in den Speicherorten wieder.

Sie benötigen für die Suche selbst und die Suchergebnisseite Dokumente vom Typ „Navigationsknoten“, „Navigationsziel“, „HTML-Formulare“, „HTML-Formular Integratoren“ sowie "Generische JSP", "Dynamische Dokumentliste", "Konfiguration-String" und "Konfiguration-Richtext 1.0" für die Solr-Konfiguration.

In der Standardlösung enthält das Suchformular nur ein Eingabefeld für den Suchbegriff sowie einen Senden-Button. Zudem wird jedoch eine Möglichkeit zur Sortierung nach "Titel" (Feld "Titel") und "Datum" (Feld "Erscheinungsdatum"), jeweils auf- und absteigend sowie eine Einschränkung der Suchergebnisse nach "Schwerpunktthema" (Feld "Kategorie") und "Dokumenttyp" angeboten. Die Ausgabe der Feldbeschreibungen und Filter erfolgt über einzelne Labeldokumente, die unterhalb von "/standardlsg/_config/ResourceBundleEntries/Labels" editiert werden können.

standardlsg/SiteGlobals/Forms/Suche

In diesem Ordner befinden sich Dokumente, mit denen das Suchformular zusammengestellt wird:

Die folgende Tabelle gibt einen Überblick darüber, welche Dokumente benötigt werden und welche Funktion diese Dokumente haben.

Name	Dokumenttyp	Funktion
Expertensuche_Integrator	HTML-FormularIntegrator	Mit diesem Dokument werden die Überschrift (z.B. Expertensuche) und ein optionaler Einleitungstext erfasst. Das eigentliche Formular wird hier verlinkt.
Expertensuche_Formular	HTML-Formular	Mit diesem Dokumenttyp konfigurieren Sie die einzelnen Bestandteile der Suche. (Wichtig: Bei Veränderungen in diesem Dokument müssen Sie auch das inkludierte Layout-Dokument verändern.)
Servicesuche_Integrator	HTML-FormularIntegrator	Mit diesem Dokument werden die Überschrift (z.B. Servicesuche) und ein optionaler Einleitungstext erfasst. Das eigentliche Formular wird hier verlinkt.
Servicesuche_Formular	HTML-Formular	Mit diesem Dokument wird das einfache Suchfeld erfasst, das im Servicebereich verlinkt ist.
Expertensuche_Autosuggest_Formular	HTML-Formular	Mit diesem Dokument wird die Vorschlagsuche konfiguriert
Servicesuche_Autosuggest_Formular	HTML-Formular	Mit diesem Dokument wird die Vorschlagsuche konfiguriert
Autosuggest_Liste	HTML-Baustein	Mit diesem Dokument wird die Ausgabe der Vorschlagsuche konfiguriert

Weitere benötigte Dokumente

In diesem Kapitel werden alle weiteren benötigten Dokumente beschrieben, teilweise wurden diese bereits in der oben stehenden Tabelle erwähnt.

Besonders wichtig ist das Dokument, mit welchem das Layout der Suche beschrieben wird. Dieses befindet sich in "standardlsg/SiteGlobals/Layout/ContentRegion/Formulare" und heißt "Layout_Expertensuche" bzw. "Layout_Servicesuche". In diesen Dokumenten ist eine HTML-Struktur eingebunden, die das Layout der Suche beschreibt. Hier wird für jedes Feld, das angezeigt werden soll, eine Zelle für Label und HTML-Element (z.B. Textfeld) benötigt. Diese werden mit dem „Formularelemente/Layout“ Standard ausgegeben. Für die Buttons und versteckte Felder ist die letzte Zeile vorbehalten. Das „Formularelemente/Layout“ ist hier ebenfalls Standard. Wenn aus der bestehenden Suche ein Feld gelöscht wird, so muss im Layout-Dokument (verlinkt im Formular über das Feld „Layout“) ebenfalls die betreffende Zeile entfernt werden. Analog dazu funktioniert das Hinzufügen von Dokumenten.

Für die Sortierung und Filterung sind die Dokumente unterhalb von "standardlsg/SiteGlobals/Functions/Solr/Suche" bzw. im Speziellen unter

• /standardlsg/SiteGlobals/Functions/Solr/Suche/Ergebnisdarstellung/Expertensuche/Solr_Facettierung
• /standardlsg/SiteGlobals/Functions/Solr/Suche/Ergebnisdarstellung/Expertensuche/Solr_Sortierung

abgelegt. Diese Dokumente sind über die Slotbelegung "supplement" im Navigationsziel der Suche mit Ansicht "Standard" zu verlinken.

Kontakt

Das Kontaktformular setzt sich aus zahlreichen Dokumenten zusammen, die miteinander in Bezug gesetzt werden. Da es sich hierbei sowohl um funktionale Dokumente als auch um redaktionelle Dokumente handelt, spiegelt sich dies in den Speicherorten wieder.

Sie benötigen für das Formular selbst und die Bestätigungsseite jeweils ein Dokument vom Typ „Navigationsknoten“ und eines vom Typ „Navigationsziel“ sowie „HTML-Formulare“ und „HTML-Formular Integratoren“.

Folgende Felder sind im Kontaktformular vorhanden:

• Vor- und Zuname
• Telefon
• Email
• Ihre Nachricht
• Senden (Button)

Diese Labels können Sie selbstständig jederzeit in den entsprechenden Dokumenten ändern.

Die Kontaktformulare werden im Ordner standardlsg/SiteGlobals/Forms/Kontakt abgelegt.

Weitere benötigte Dokumente

Beim Kontaktformular gibt es, anders als bei der Suche, noch die Besonderheit, dass es eine Bestätigungsseite gibt, sodass im Verzeichnis standardlsg/DE/Service/Kontakt folgende Dokumente vorhanden sein müssen:

Zusätzlich ist das Dokument wichtig, mit dem das Layout des Kontaktes beschrieben wird. Dieses befindet sich in standardlsg/SiteGlobals/Layout/ContentRegion/Formulare und heißt Layout_Kontaktformular. In diesen Dokumenten ist eine HTML-Struktur eingebunden, die das Layout des Kontaktformulars beschreibt. Hier wird für jedes Feld, das angezeigt werden soll, eine Zelle für Label und HTML-Element (z.B. Textfeld) benötigt. Diese werden mit dem „Formularelemente/Layout“ Standard ausgegeben. Ausnahme ist das Feld „Nachricht“, hierfür wird eine Zeile mit „Formularelemente/Layout“ Label sowie eine mit „Formularelemente/Layout“ Field benötigt. Für die Buttons und versteckte Felder ist die letzte Zeile vorbehalten. Das „Formularelemente/Layout“ ist hier ebenfalls Standard.

Wenn Sie nun aus dem bestehenden Kontaktformular ein Feld löschen möchten (z.B. „Telefon“), so muss im Layout-Dokument (verlinkt im Formular über das Feld „Layout“) die betreffende Zeile (z.B. für das Element „Telefon“ die Zeile $slots.get(“phone“) gelöscht werden und im Dokument „Kontakt_Formular“ die zugehörigen Linklisten mit dem Eintrag „Kontakt_Telefon“ gelöscht werden. Analog dazu funktioniert das Hinzufügen von Dokumenten.

Hinweis: Beachten Sie, dass neue Felder eventuell auch in der zugehörigen E-Mail ausgegeben werden sollen, sodass diese entsprechend im in der Aktion verlinkten Mail-Template standardlsg/_config/ResourceBundleEntries/

Templates/Kontakt_Template mit $ID-DES-ELEMENTS einzubinden sind.

Hinweis: Informationen zur Absicherung von GSB-Formularen gegen missbräuchliche Nutzung finden sich auf der Seite Absicherung von HTML-Formularen

Newsletter-Anmeldung

Die Standardlösung bietet die Möglichkeit, Newsletter zu versenden. Für diesen Versand können sich Besucher auf der Website Anmelden bzw. Abmelden.

Hierfür stehen zwei HTML-Formulare im Verzeichnis standardlsg/SiteGlobals/Forms/Newsletter zur Verfügung.

Die HTML-Formulare setzen sich aus zahlreichen Dokumenten zusammen, die miteinander in Bezug gesetzt werden. Da es sich hierbei sowohl um funktionale Dokumente als auch um redaktionelle Dokumente handelt, spiegelt sich dies in den Speicherorten wieder.

Sie benötigen für die Formulare selbst jeweils ein Dokument vom Typ „Navigationsknoten“ und eins vom Typ „Navigationsziel“ sowie „HTML-Formulare“ und „HTML-Formular Integratoren“.

Newsletter-Anmeldung

Folgende Felder sind in der Newsletter-Anmeldung vorhanden:

• E-Mail
• Format
• Bestellen (Button)

Newsletter-Abmeldung

Folgende Felder sind in der Newsletter-Abmeldung vorhanden:

• E-Mail
• Abbestellen (Button)

Diese Labels können Sie selbstständig jederzeit in den entsprechenden Dokumenten ändern.

Die Formulare werden im Ordner standardlsg/SiteGlobals/Forms/Newsletter abgelegt.

Weitere benötigte Dokumente

Beim Newsletter gibt es noch die Besonderheit der Bestätigungsseite. Es gibt entsprechende Bestätigungsseiten die im standardlsg/DE/Service/Newsletter vorhanden sein müssen:

Zusätzlich ist das Dokument wichtig, mit dem das Layout der Newsletter-Formulare beschrieben wird. Diese befinden sich in standardlsg/SiteGlobals/Layout/ContentRegion/Formulare und heißen Layout_NewsletterAbbestellen und Layout_NewsletterBestellen. In diesen Dokumenten ist eine HTML-Struktur eingebunden, die das Layout der Newsletter-Formulare beschreibt. Hier wird für jedes Feld, das angezeigt werden soll, eine Zelle für Label und HTML-Element (z.B. Textfeld) benötigt. Diese werden mit dem „Formularelemente/Layout“ Standard ausgegeben. Für die Buttons und versteckte Felder ist die letzte Zeile vorbehalten. Das „Formularelemente/Layout“ ist hier ebenfalls Standard.

Wenn Sie nun aus den bestehenden Newsletter-Formularen ein Feld löschen möchten, so müssen Sie im Layout-Dokument die entspreche Zeile und in den HTML-Formularen die zugehörige Linkliste löschen. Analog dazu funktioniert das Hinzufügen von neuen Elementen in die Newsletter-Formulare.

Seite empfehlen

Die Standardlösung stellt die Funktion bereit, Seiten zu empfehlen und den entsprechenden Link mit einem Begleittext per E-Mail zu versenden. Zur Aufnahme der Daten wird ein HTML-Formular genutzt, das die eingegebenen Daten über die Standardfunktion „Mailversand“ (Ordner standardlsg/SiteGlobals/Functions/SeiteEmpfehlen) versendet.

Das HTML-Formular der Seitenempfehlung beinhaltet die folgenden Felder und Buttons:

• Empfänger
• Absender
• Betreff
• Kommentar
• Senden (Button)

Die folgende Tabelle gibt einen Überblick darüber, welche Dokumente in das HTML-Formular eingebunden werden und welche Funktion diese Dokumente haben. Die Dokumente liegen alle in Unterordnern von standardlsg/SiteGlobals/Forms/SeiteEmpfehlen.

Name	Dokumenttyp	Funktion
SeiteEmpfehlen_Formular	HTML-Formular	HTML-Formular
SeiteEmpfehlen	Standardartikel	Enthält die Bestätigungsmeldung für den erfolgreichen Versand der Empfehlung

Der erfolgreiche Versand der Seitenempfehlung wird durch eine separate Meldung auf der Webseite bestätigt.

Hinweis: Beachten Sie, dass neue Felder eventuell auch in der zugehörigen E-Mail ausgegeben werden sollen, sodass diese entsprechend im in der Aktion verlinkten Mail-Template standardlsg/_config/ResourceBundleEntries/Templates/SeiteEmpfehlen_Template mit $ID-DES-ELEMENTSeinzubinden sind.

Sicherheits-Hinweis

Weitere Hinweise zum Schutz von GSB-Formularen finden sich auf der Seite Absicherung von HTML-Formularen.

Warenkorb

In der Standardlösung ist auch ein Warenkorb integriert, der im Konzept GSB7/Warenkorb detailliert beschrieben ist.