Platzhalterverzeichnis

- Kontaktformulare (Contact)

Kontaktformulare (Contact)

Layout / Inhaltsseiten

Das Layout aller Formulare wird global über das aktive Webdesign Template definiert. Dabei kann das Layout für Formulare, sowie für die verschiedenen Feldtypen (z.B. Textfeld und Datumsauswahl) individuell definiert werden.

Formularfeldtypen

Die nachfolgende Liste beschreibt alle verfügbaren Formularfeldtypen. Für eine Liste der verfügbaren Platzhalter zur individuellen Gestaltung der Anzeige der verschiedenen Formularfeldtypen siehe Abschnitt Formularfelder.

Feld Schlüssel Typ-spezifischer Block Template Zusätzliche spezifische Platzhalter
Textfeld text contact_form_field_text FieldText.html
Text label contact_form_field_label FieldLabel.html
  • [[CONTACT_FORM_FIELD_VALUE_RAW]] Enthält den Wert ohne "Escaping", d.h. es können HTML Elemente in den Text eingefügt und dargestellt werden
Kontrollkästchen checkbox contact_form_field_checkbox FieldCheckbox.html
  • [[CONTACT_FORM_FIELD_CHECKBOX_SELECTED]] Enthält den Wert checked="checked" sofern das Kontrollkästchen ausgewählt ist/wurde
Kontrollkästchen Gruppe checkboxGroup contact_form_field_checkboxGroup FieldCheckboxGroup.html
Land country contact_form_field_country FieldCountry.html
Datum date contact_form_field_date FieldDate.html
Datum & Zeit datetime contact_form_field_datetime FieldDatetime.html
Dateiupload (nur eine Datei) file contact_form_field_file FieldFile.html
  • [[CONTACT_UPLOADER_FOLDER_WIDGET]] Listet die angehängte Datei auf
  • [[CONTACT_UPLOADER_FOLDER_WIDGET_ID]] ID des Folder-Widgets
In der PDF- und Druck-Ansicht steht ausschliesslich dieser Platzhalter zur Verfügung. Alle anderen Platzhalter dieses Feldes sind in der PDF- und Druck-Ansicht nicht verfügbar.
Dateiupload (mehrere Dateien) multi_file contact_form_field_multi_file FieldMultiFile.html
  • [[CONTACT_UPLOADER_FOLDER_WIDGET]] Listet die angehängten Dateien auf
  • [[CONTACT_UPLOADER_FOLDER_WIDGET_ID]] ID des Folder-Widgets
In der PDF- und Druck-Ansicht steht ausschliesslich dieser Platzhalter zur Verfügung. Alle anderen Platzhalter dieses Feldes sind in der PDF- und Druck-Ansicht nicht verfügbar.
Fieldset fieldset contact_form_field_fieldset FieldFieldset.html
Verstecktes Feld hidden contact_form_field_hidden FieldHidden.html
Horizontale Linie horizontalLine contact_form_field_horizontalLine FieldHorizontalLine.html
Kennwort Feld password contact_form_field_password FieldPassword.html
Auswahlfelder radio contact_form_field_radio FieldRadio.html
Auswahlmenü select contact_form_field_select FieldSelect.html
Mehrzeiliges Textfeld textarea contact_form_field_textarea FieldTextarea.html
Empfängeradressen Auswahlliste recipient contact_form_field_recipient FieldRecipient.html
E-Mail access_email contact_form_field_access_email FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Geschlecht access_gender contact_form_field_access_gender FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_select -->
Anrede access_title contact_form_field_access_title FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_select -->
Vorname access_firstname contact_form_field_access_firstname FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Nachname access_lastname contact_form_field_access_lastname FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Firma access_company contact_form_field_access_company FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Adresse access_address contact_form_field_access_address FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Ort access_city contact_form_field_access_city FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
PLZ access_zip contact_form_field_access_zip FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Land access_country contact_form_field_access_country FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_select -->
Tel. Büro access_phone_office contact_form_field_access_phone_office FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Tel. Privat access_phone_private contact_form_field_access_phone_private FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Tel. Mobile access_phone_mobile contact_form_field_access_phone_mobile FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Fax access_phone_fax contact_form_field_access_phone_fax FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Geburtstag access_birthday contact_form_field_access_birthday FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
  • [[CONTACT_FORM_FIELD_ADDITIONAL_CLASS]] Enthält den Wert date
Website access_website contact_form_field_access_website FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Beruf access_profession contact_form_field_access_profession FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Interessen access_interests contact_form_field_access_interests FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Signatur access_signature contact_form_field_access_signature FieldSpecial.html
Block: <!-- BEGIN/END contact_form_field_special_input -->
Layout
Formular

Das standard Layout eines Formulars ist über die Template-Datei Form.html definiert. Optional dazu kann für ein ausgewähltes Formular ein komplett individuelles Layout definiert werden, indem eine Anwendungsvorlage nach dem Schema <FORM-ID>.html (unter core_modules/Contact/Tempalte/Frontend/) im gewünschten Webdesign Template angelegt wird.

Zur Individualisierung stehen die nachfolgenden Platzhalter und Template-Blöcke zur Verfügung.

Statusmeldung
Einleitungstext

<!-- BEGIN formText -->
  • [[CONTACT_FORM_TEXT]]
<!-- END formText -->

Formular

<!-- BEGIN contact_form -->
Oberflächentexte
  • [[TXT_CONTACT_SUBMIT]]
  • [[TXT_CONTACT_RESET]]
  • [[TXT_NEW_ENTRY_ERORR]]
Meta-Informationen
  • [[CONTACT_FORM_CUSTOM_STYLE_ID]] Ist leer oder falls die Option "Eigenen Stil verwenden" gesetzt ist den Wert _<FORM-ID>'
  • [[CONTACT_FORM_NAME]]
  • [[CONTACT_JAVASCRIPT]] JavaScript-Code unter anderem für die Eingabevalidierung und das Datei-Upload-Handling
  • [[CONTACT_UNIQUE_ID]] Eindeutige ID für das Datei-Upload-Handling. Muss als HTML-hidden übermittelt werden. Beispiel:
    <input type="hidden" name="unique_id" value="[[CONTACT_UNIQUE_ID]]" />
  • [[CONTACT_FORM_ACTION]] URL für die HTML-form-action Eigenschaft
Sonstiges
  • [[HIDE_EMPTY_FIELDS]] Wird dieser funktionale Platzhalter innerhalb des Blocks <!-- BEGIN/END contact_form --> platziert, so werden nur jene Formular-Felder ausgegeben, welche einen vorausgefüllten Wert (via GET, POST oder Benutzerkonto-Daten) gesetzt haben.
Auflistung der Felder

Jedes Formularfeld wird standardmässig gemäss definiertem Template (siehe Formularfelder) ausgegeben. Alternativ kann das Layout für jedes Formularfeld individualisiert werden. Siehe dazu weiter unten bei Definition individuelles Feld-Layout.

<!-- BEGIN contact_form_field_list -->
  • [[CONTACT_FORM_FIELD]]
<!-- END contact_form_field_list -->

CAPTCHA

<!-- BEGIN contact_form_captcha -->
  • [[TXT_CONTACT_CAPTCHA]]
  • [[CONTACT_CAPTCHA_CODE]]
<!-- END contact_form_captcha -->

Definition individuelles Feld-Layout

Das Layout eines spezifischen Formularfeldtypes kann optional pro Formular individualisiert werden:

<!-- BEGIN contact_form_field_<FIELD-TYPE> -->

Siehe Platzhalter bei Formularfelder

<!-- END contact_form_field_<FIELD-TYPE> -->

Weiters kann das Layout eines einzelnen Formularfeldes individualisiert werden:

<!-- BEGIN contact_form_field_<FIELD-ID> -->

Siehe Platzhalter bei Formularfelder

<!-- END contact_form_field_<FIELD-ID> -->

<!-- END contact_form -->

Individueller CSS Style

<!-- BEGIN contact_form_css_link -->
  • [[CONTACT_FORM_CSS_HREF]]
<!-- END contact_form_css_link -->

Formularfelder

Jedes Formularfeld verfügt analog dem Formular (Form.html) über ein standard Layout, welches in einer Template-Datei definiert ist. Die Namen der entsprechenden Template-Dateien sind in der Liste Formularfeldtypen in der Spalte Template aufgeführt. Zur Individualisierung stehen die folgenden Platzhalter und Template-Blöcke zur Verfügung.

Allgemein
Pflichtfeld
Generisch Typ-spezifisch Feld-spezifisch
<!-- BEGIN contact_form_field_required -->
  • [[CONTACT_FORM_FIELD_REQUIRED]]
<!-- END contact_form_field_required -->
<!-- BEGIN contact_form_field_required_<FIELD-TYPE> -->
  • [[CONTACT_FORM_FIELD_REQUIRED]]
<!-- END contact_form_field_required_<FIELD-TYPE> -->
<!-- BEGIN contact_form_field_required_<FIELD-ID> -->
  • [[CONTACT_FORM_FIELD_REQUIRED]]
<!-- END contact_form_field_required_<FIELD-ID> -->
Auswahloptionen

Nur verfügbar bei: Kontrollkästchen Gruppe / Auswahlfelder / Auswahlmenü / Empfängeradressen Auswahlliste / Geschlecht / Anrede / Land

Generisch Typ-spezifisch Feld-spezifisch
<!-- BEGIN contact_form_field_options -->
  • [[CONTACT_FORM_FIELD_VALUE]]
  • [[CONTACT_FORM_FIELD_VALUE_KEY]] Ausgewählter Wert (leer wenn keine, resp. die Option "Bitte wählen" gewählt wurde)
  • [[CONTACT_FORM_FIELD_GROUP_LABEL]] Bezeichnung des Formularfeldes
  • [[CONTACT_FORM_FIELD_OPTION_KEY]] Index der Option
  • [[CONTACT_FORM_FIELD_OPTION_FIELD_ID]] ID des Formularfeldes
  • [[CONTACT_FORM_FIELD_SELECTED]] selected="selected" / checked="checked"
<!-- END contact_form_field_options -->
<!-- BEGIN contact_form_field_options_<FIELD-TYPE> -->
  • [[CONTACT_FORM_FIELD_VALUE]]
  • [[CONTACT_FORM_FIELD_VALUE_KEY]] Ausgewählter Wert (leer wenn keine, resp. die Option "Bitte wählen" gewählt wurde)
  • [[CONTACT_FORM_FIELD_GROUP_LABEL]] Bezeichnung des Formularfeldes
  • [[CONTACT_FORM_FIELD_OPTION_KEY]] Index der Option
  • [[CONTACT_FORM_FIELD_OPTION_FIELD_ID]] ID des Formularfeldes
  • [[CONTACT_FORM_FIELD_SELECTED]] selected="selected" / checked="checked"
<!-- END contact_form_field_options_<FIELD-TYPE> -->
<!-- BEGIN contact_form_field_options_<FIELD-ID> -->
  • [[CONTACT_FORM_FIELD_VALUE]]
  • [[CONTACT_FORM_FIELD_VALUE_KEY]] Ausgewählter Wert (leer wenn keine, resp. die Option "Bitte wählen" gewählt wurde)
  • [[CONTACT_FORM_FIELD_GROUP_LABEL]] Bezeichnung des Formularfeldes
  • [[CONTACT_FORM_FIELD_OPTION_KEY]] Index der Option
  • [[CONTACT_FORM_FIELD_OPTION_FIELD_ID]] ID des Formularfeldes
  • [[CONTACT_FORM_FIELD_SELECTED]] selected="selected" / checked="checked"
<!-- END contact_form_field_options_<FIELD-ID> -->
Legacy Deprecated

Diese Platzhalter stehen lediglich zum Zweck der Rückwärtskompatibilität für Templates älter als Version 5 zur Verfügung. Vom Einsatz wird dringend abgeraten, da diese einerseits nicht mehr offiziell unterstützt werden und andererseits, dass diese zukünftig ohne Ankündigung nicht mehr zur Verfügung stehen.

HTML E-Mail-Benachrichtigung
Kontaktdaten

Die übermittelten Kontaktdaten können in der HTML E-Mail-Benachrichtigung mit dem folgenden Template Block ausgegeben werden:

<!-- BEGIN form_field -->

Hinweis: Dieser Block wird für jedes ausgefühlte Formularfeld je einmal ausgegeben.

  • [[FIELD_LABEL]] Bezeichnung des Formularwertes
  • [[FIELD_VALUE]] Der übermittelte Wert des Formularwertes
  • [[INCLUDE_EMPTY]] Ist dieser Platzhalter vorhanden, so wird der Block <!-- BEGIN/END form_field --> für jedes Formularfeld ausgegeben - nicht nur für die Ausgefüllten.

Achtung: Der folgende Platzhalter erlaubt es einem Angreifer unsicheren Code einzuschleusen. Der Platzhalter sollte deshalb nur in Kombination mit einer Escape-Funktion verwendet werden. Bsp. func_s([[FIELD_VALUE_RAW]])

  • [[FIELD_VALUE_RAW]] Die übermittelten Rohdaten des Formularwertes
<!-- END form_field -->

Beispiel:

<table>
    <tbody>
        <!-- BEGIN form_field -->
        <tr>
            <td>[[FIELD_LABEL]]</td>
            <td>[[FIELD_VALUE]]</td>
        </tr>
        <!-- END form_field -->
    </tbody>
</table>

Alernativ kann jeder Formularwert individuell gestaltet werden. Dazu kann das folgende Konstrukt verwendet werden:

<!-- BEGIN field_<FIELD-ID> -->

Hinweis: Dieser Block wird nur angezeigt, sofern das Feld mit der ID <FIELD_ID> bei der Formulareinsendung ausgefühlt wurde.

  • [[FIELD_<FIELD_ID>_LABEL]] Bezeichnung des mittels <FIELD_ID> bestimmten Formularwertes
  • [[FIELD_<FIELD_ID>_VALUE]] Der übermittelte Wert des mittels <FIELD_ID> bestimmten Formularwertes
  • [[INCLUDE_EMPTY]] Ist dieser Platzhalter vorhanden, so wird der Block <!-- BEGIN/END field_<FIELD-ID> --> immer angezeigt - nicht nur wenn das dazugehörige Formularfeld ausgefüllt wurde.

Achtung: Der folgende Platzhalter erlaubt es einem Angreifer unsicheren Code einzuschleusen. Der Platzhalter sollte deshalb nur in Kombination mit einer Escape-Funktion verwendet werden. Bsp. func_s([[FIELD_<FIELD_ID>_VALUE_RAW]])

  • [[FIELD_<FIELD_ID>_VALUE_RAW]] Die übermittelten Rohdaten des Formularwertes
<!-- END field_<FIELD-ID> -->

Beispiel:

<table>
    <tbody>
        <!-- BEGIN field_1 -->
        <tr>
            <td>[[FIELD_1_LABEL]]</td>
            <td>[[FIELD_1_VALUE]]</td>
        </tr>
        <!-- END field_1 -->
        <!-- BEGIN field_2 -->
        [[INCLUDE_EMPTY]]
        <tr>
            <td>[[FIELD_2_LABEL]]</td>
            <td>[[FIELD_2_VALUE]]</td>
        </tr>
        <!-- END field_2 -->
    </tbody>
</table>
Meta-Informationen
[[CONTACT_EMAIL]]

HTML-Codierte Ausgabe der E-Mail Adresse aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_COMPANY]]

HTML-Codierte Ausgabe der Firma aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_ADDRESS]]

HTML-Codierte Ausgabe der Adresse aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_ZIP]]

HTML-Codierte Ausgabe der PLZ aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_PLACE]]

HTML-Codierte Ausgabe des Orts aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_COUNTRY]]

HTML-Codierte Ausgabe des Landes aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_PHONE]]

HTML-Codierte Ausgabe des Telefons aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_FAX]]

HTML-Codierte Ausgabe des Faxes aus Grundeinstellungen/Kontaktinformationen

[[CONTACT_NAME]]

HTML-Codierte Ausgabe des Name des Administrators aus Grundeinstellungen/Kontaktinformationen

<!-- BEGIN contact_form_field_special_input -->
<!-- END contact_form_field_special_input -->
<!-- BEGIN contact_form_field_special_select -->
<!-- END contact_form_field_special_select -->