Dokumentation contentXXL CMS Version 5.3

Visuelles Beispiel

simplymailform

 

 
 

Allgemein

Dieses Modul ist eine Ergänzung zum templatebasierten Mailformular und ermöglicht Redakteuren, mit Hilfe eines Formulargenerators auf einfache Weise Formulare zu erstellen.

Leistungsumfang

  • Erstellen von einfachen Mailformularen ohne Templates durch den Redakteur
  • Einbinden eines Captcha-Moduls
  • Speichern der Daten abgesendeter Formulare in der Datenbank
  • Versenden der Formulardaten als E-Mail

 

 

 
 

Spezielle Einstellungen

 

Grundeinstellungen

  • Dankemeldung: Dieser Text wird nach erfolgreichem Abschicken des Formulars angezeigt.
  • Bezeichnung des Absendebuttons: Wird im Template der Platzhalter [SendButton] verwendet, kann hier der Text festgelegt werden.
  • Captcha aktivieren: Durch Aktivieren dieses Feldes wird ein Captcha erzeugt (sofern vom Template unterstützt).
  • Formulardaten in Datenbank speichern: Bei Aktivierung dieses Feldes werden die Daten der abgesendeter Formulare in der Datenbank gespeichert und können unter dem Reiter "Objekte" abgerufen werden.
  • Formulardaten als E-Mail verschicken: Wird dieses Feld aktiviert, werden die Daten der abgesendeten Formulare als E-Mail an die konfigurierten Adressen weitergeleitet.

SMTP-Server (nur sichtbar, wenn der E-Mail-Versand aktiviert wurde)

  • Absender E-Mail: Geben Sie hier den gewünschten Absender der E-Mail ein.
  • Empfänger E-Mail: Geben Sie hier ein, an welche E-Mail Adressen (bei mehreren Empfängern mit ";" getrennt)  die Daten gesendet werden sollen.
  • Betreff: Geben Sie hier die Betreffzeile ein.
  • SMTP Server: Hier können Sie Ihren SMTP-Server eintragen. Dies ist nur dann erforderlich, wenn ein anderer Mailserver verwendet werden soll als in der web.config unter dem Key "mailserver" spezifiziert ist oder kein solcher Eintrag in der web.config existiert.

SMPT-Server-Anmeldung (nur sichtbar, wenn der E-Mail-Versand aktiviert wurde)

  • E-Mail: Geben Sie hier die zu authentifizierende E-Mail-Adresse ein.
  • Passwort: Hier geben Sie das Password ein, mit dem Sie die o. g. E-Mail Adresse verifizieren.
  • Art der Anmeldung: Wählen Sie hier die Art der Anmeldung am SMTP-Server aus.
  • Port: Geben Sie hier den für die Anmeldung am SMTP-Server benötigten Port aus. Standardmäßig wird Port 25 verwendet.

Templates

  • Kopfbereich: wählen Sie hier ein Template für die Kopfzeile aus.
  • Listenansicht: Wählen Sie ein Template für die Ansicht der Formularelemente aus.
  • Listenansicht alt..: Wählen Sie ein Template für eine alternierende Ansicht der Formularelemente aus.
  • Fußbereich: Wählen sie ein Template für die Fußzeile aus.
 
 

Generator

Mit dieser Oberfläche können Sie sich Ihr Formular zusammenstellen.

In der linken Liste sehen Sie alle Felder, die dem Formular bereits hinzugefügt wurden.

Wählen Sie in dieser Liste einen Eintrag aus, so werden die zugehörigen Daten im Fenster rechts angezeigt und können editiert werden.

Rechtes Fenster:

In diesem Fenster können Sie die Eigenschaften der einzelnen Elemente des Formulars festlegen:

  • Feldname: Hier müssen Sie einen eindeutigen Namen festlegen, der intern verwendet wird (unter dieser ID werden gegebenenfalls die Werte in der Datenbank gespeichert).
  • Feldbeschreibung: Geben Sie hier eine Benennung ein, aus der die Bedeutung des Elements hervorgeht (Beispiel: Vorname).
  • Art des Elements: Wählen Sie hier die Art des Formularelements aus welches Sie verwenden möchten:
    • Text: Eingabefeld
    • Password: Eingabefeld mit verdeckter Anzeige der eingegebenen Zeichenfolge
    • Mail: Eingabefeld für Mailadressen. Die Gültigkeit der eingegebenen Adresse wird beim Absenden des Formulars validiert.
    • Checkbox: Klickfeld
    • Radio: Optionsfeld (Radiobutton)
    • Dropdownlist: Auswahlliste
  • Pflichtfeld: Wenn Sie dieses Klickfeld aktivieren, wird beim Absenden des Formulars überprüft, ob das Formularelement ausgefüllt wurde. Gegebenenfalls erscheint eine Fehlermeldung (s.u.).
  • Fehlermeldung: Geben Sie hier eine Meldung ein, die bei ungültiger Eingabe angezeigt werden soll (s.o.).
  • Standartwert: Geben Sie hier die Vorbelegung des Elements an, falls gewünscht.
  • CSS-Styles: Hier können Sie Inline-Styles zur optischen Anpassung des Elements definieren.
  • CSS-Klasse: Hier können Sie eine CSS-Klasse definieren, die dem Element als Attribut zugewiesen wird.
  • Gruppe: Handelt es sich bei dem ausgewählten Element um einen Radiobutton, können Sie hier eine Gruppe definieren (dieses Eingabefeld wird nur bei Radiobuttons angezeigt).
  • Listenwerte: Geben Sie hier die Werte ein, die in der Dropdownliste des Formulars erscheinen sollen (nur bei Auswahl „Dropdownlist" werden diese zusätzlichen Eingabefelder angezeigt).

Ist das Formularelement fertig bearbeitet, kann es mit dem Button "Pfeil links" in der Liste der vorhandenen Elemente abgelegt werden. Sind mehrere Elemente vorhanden, kann mit den entsprechenden Buttons (Pfeil oben bzw. unten) sortiert werden.
Ein neues Element wird mit dem +-Button hinzugefügt. Aus dem Formular enfernen lassen sich vorhandene Elemente mit dem x-Button.

Hinweis: Bitte vergessen Sie nicht, die Moduleinstellungen zu speichern. Ansonsten gehen diese Änderungen verloren.

 

Objekte

Unter diesem Reiter werden alle erfolgreich abgesendeten Formulare aufgelistet, falls das Speichern in Datenbank aktiviert wurde.
Durch einen Klick auf einen Eintrag können Sie sich diesen nochmals als Formular anzeigen lassen. Einzelne Einträge löschen Sie mit einem Klick auf das rote Entfernen-Symbol.

 

 

Templating & Platzhalter

Zwar werden in diesem Modul die Formulare nicht über Templates generiert, sondern von Redakteuren erstellt, Templates werden aber benötigt für die Einbindung des Captcha-Moduls, der Positionierung der Formular-Elemente und des Absende-Buttons.

 

Template Listenansicht

<div class="form-group">
  <label>[label]</label>
    [Control] [ErrorMessage]
</div>

 

Platzhalter Listenansicht

Platzhaltername

Typ

Platzhalterbeschreibung

[Control]

control

Formularelement wie Textbox, Checkbox, Radiobutton etc. aus dem Generator.

[ErrorMessage] string Die im Generator konfigurierte Fehlermeldung bei unzulässigen Eingaben (z.B. Pflichtfeld vergessen). 
[Label] string Benennung des Formularelements aus derm Generator (Feldbeschreibung).

 

Template Fußbereich

[CaptchaText]<br/>
[CaptchaImage]<br/>
[CaptchaErrorMessage]<br/>
[SendButton]<br/>

 

Platzhalter Fußbereich

Platzhaltername

Typ

Platzhalterbeschreibung

[CaptchaErrorMessage]

string

Fehlermeldung, wenn Captcha-Bild und eingegebene Zeichenfolge nicht übereinstimmt.

[CaptchaImage] control Erstellt das Bild mit dem Captcha-Code. Das gerenderte Control trägt das Attribut class="captcha-image" und kann über diese CSS-Klasse individuell gestaltet werden.
[CaptchaText] control Eingabefeld für die Zeichenfolge. Das gerenderte Control trägt das Attribut class="captcha-text" und kann über diese CSS-Klasse individuell gestaltet werden.
[SendButton] control Button zum Absenden des Formulars mit der im Modul konfigurierten "Bezeichnung des Absendebuttons". Das gerenderte Control trägt das Attribut class="captcha-sendbutton" und kann über diese CSS-Klasse individuell gestaltet werden.

Statt des Platzhalters [SendButton] zum Absenden des Formulars kann jeder Button-Platzhalter (bn, lbn, ibn, bnupdate) mit der id="send" und dem Attribut CommandName="Update" verwendet werden. Beispiel: [lbn:send:text="senden" commandname="update"]