Visuelles Beispiel

 

 

 
 

Allgemein

Mit dem Mailformular-Modul wird über Templates die Möglichkeit der Dateneingabe bereitgestellt (Kontaktformular). Standardmäßig wird der erfasste Inhalt per Mail versandt, über kundenspezifische Anpassungen ist auch eine andere Weiterverarbeitung möglich. Es stehen hierzu zahlreiche Customization Points zur Verfügung. Durch die Einbindung eines Captcha-Moduls kann sichergestellt werden, dass die Eingabe von natürlichen Personen erfolgt (Anti-Spam).

 
 

Spezielle Einstellungen

Für das Formular-Modul können verschiedene Einstellungen getroffen und Templates ausgewählt werden.

  • Formular-Template: Wählen Sie hier das Formular-Template aus. Dieses enthält die Eingabe- und Dialogfelder sowie optional Validatoren.
  • 'Danke'-Modul: Wählen Sie das HTML-Modul aus, das nach erfolgreicher Dateneingabe angezeigt werden soll.
  • Einrückung: Geben Sie an, um wieviele Leerzeichen jede Zeile der versendeten E-Mail eingerückt werden soll (Standardwert: 25).
  • IP-Adresse des Versenders unterdrücken: Wählen Sie diese Option, wenn die standardmäßige Erfassung und Anzeige der IP-Adresse des Benutzers unterdrückt werden soll (z.B. aus Gründen des Datenschutzes).
  • Fehlermeldung: Geben Sie eine Fehlermeldung ein, die bei Fehlschlagen der Validierung ausgegeben werden soll.
  • E-Mail-Template: Wählen Sie das Template aus, das für die zu versendende E-Mail mit den eingegebenen Daten verwendet werden soll.
  • Bestätigungs-Template: Wählen Sie ein Template aus, wenn der Benutzer vor dem Versenden die Möglichkeit erhalten soll, die eingegebenen Daten nochmals zu prüfen und gegebenenfalls zu korrigieren.
  • Absender E-Mail: Geben Sie hier den gewünschten Absender der E-Mail ein.
  • Eingegebene E-Mail-Adresse als Absender nutzen: Wählen Sie diese Option, um die eingegebene E-Mail-Adresse als Absender zu nutzen.
  • Standard Betreff: Geben Sie hier den standardmäßig zu verwendenden Betreff ein.
  • Standard Empfänger: Geben Sie hier den standardmäßig zu verwendenden Empfänger ein.
  • CC-Empfänger: Hier können Sie optional einen weiteren Empfänger angeben, der eine Kopie der Mail erhält.
  • BCC-Empfänger: Hier können Sie optional einen weiteren Empfänger angeben, der eine Kopie der Mail erhält, ohne dass dies für die anderen Empfänger ersichtlich ist.
  • Betreff / Empfänger: Hier können Sie weitere Betreffzeilen und Empfänger angeben. Dadurch bekommt der Benutzer die Möglichkeit, im Formular in einer Dropdown-Liste zwischen mehreren Betreffs auszuwählen. Die E-Mail geht dann an den jeweiligen Empfänger.

Abb.: Spezielle Einstellungen des Formularmoduls

 

SMTP-Server:

Hier können Sie Ihren SMTP-Server eintragen: z.B. mail.gmx.net. 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.

SMTP-Authentifizierung:

E-Mail: Geben Sie hier die zu authentifizierende E-Mail-Adresse ein.

Password: Hier geben Sie das Password ein, mit dem Sie die o. g. E-Mail Adresse verifizieren.

Authentifizierungstyp:

  • Keine Authentifizierung: E-Mail Adresse und Password sind nicht notwendig.
  • Basic: Sie authentifizieren sich beim angegebenen SMTP-Server mit der eingetragenen E-Mail Adresse und dem Password.
  • NTLM: Sie senden E-Mails mit Ihrer Windows-Domäne, für diese müssen Sie keine E-Mail Adresse und kein Password angeben.

Port: Hier geben Sie den Port an, der für die Authentifizierung am SMTP-Server notwendig ist. Standardmäßig wird Port 25 verwendet

 

 

Test E-Mail senden: Hier können Sie eine Test-Mail an den eingetragenen SMTP-Server mit den verschiedenen Authentifizierungs-Möglichkeiten versenden. Die von Ihnen angegebene E-Mail Adresse ist gleichzeitig Absender und Empfänger dieser Testnachricht.

Das Ergebnis des Tests wird in das contentXXL-Eventlog geschrieben.
  

Hinweis: Setzen Sie zur sicheren Übertragung vertraulicher Daten mit dem Formularmodul geeignete Verfahren ein, z.B. SSL.

 
 

Template: Spezielle Einstellungen - Grundeinstellung - Formular-Template

<div>[errormessage]<br />
  Topic:<br />
  [ddl:subject:class="contactfield"][/ddl]<br/>
  Firstname:<br />
  [tb:firstname:class="contactfield"]<br />
  Lastname:<br/>
  [tb:lastname:class="contactfield"]<br />
  E-mail:<br />
  [tb:email:mandatory=1 class="contactfield"]<br />
  [module:123]<br />
  [lbn:senden:text="Send form" CommandName="Update"]
</div>

In diesem Template wurde das E-Mail-Feld mit dem Parameter "mandatory=1" als Pflichtfeld deklariert. Die Dropdown-Liste mit der ID "subject" wird automatisch gefüllt mit den in den Moduleinstellungen eingepflegten Werten für Betreff/Empfänger. Ein Captcha-Modul wurde eingebunden.

Hinweis: Es ist möglich, eine Kopie der E-Mail als BCC an den Absender zu schicken. Hierzu muss eine Checkbox mit der ID „sendcopy“ ([cb:sendCopy]) nach der Textbox für die E-Mail-Adresse ([tb:email]) platziert werden.

 

Template: Formulareinstellungen - E-Mail-Template

Hier kann eine E-Mail getemplated werden, die im HTML-Format versendet wird. Es können alle die bereits im Formular-Template benutzten Platzhalter zusammen mit dem val-Kommando verwendet werden.
Beispiel: [tb:lastname] wird zu  [val:lastname].
 

Template: Formulareinstellungen - Bestätigungs-Template

<div>
  Topic:<br />
  [val:subject]<br/>
  Firstname:<br />
  [val:firstname]<br />
  Lastname:<br/>
  [val:lastname]<br />
  E-mail:<br />
  [val:email]<br />
  [lbn:senden:text="Send form" CommandName="send"] [lbn:cancel:text="Cancel" CommandName="cancel"]
</div

Mit der Auswahl eines Bestätigungstemplates wird dem Benutzer die eingegebenen Informationen vo dem Versenden nochmals angezeigt. Es können alle die bereits im Formular-Template benutzten Platzhalter zusammen mit dem val-Kommando verwendet werden. Die zum Absenden oder Abbrechen verwendeten Buttons müssen das Attribut CommandName=“send“ bzw. CommandName=“cancel“ tragen.

 

 

Platzhaltername

Typ

Beschreibung

[tb:id:parameters]

control

Erzeugt eine Textbox, die als Input- oder Textarea-Feld angezeigt wird. Wenn Sie ein mehrzeiliges Eingabefeld (Textarea) benötigen, müssen Sie den Parameter textmode=”multiline” angeben.

[cb:id:parameters]

control

Beispiel: [cb:gelesen:value="Ja"]. Wenn der Benutzer die Checkbox aktiviert, wird in der E-Mail "gelesen: Ja" übermittelt. Eine Vorbelegung der Checkboxen kann mit dem Parameter "checked="true" erzielt werden. 

[lb:id:parameters]

control

Es wird ein Label mit der angegebenen ID erzeugt.

[cbl:id:parameters][/cbl]

control

Die CheckBoxList kann verwendet werden um eine Gruppe von Checkboxen anzuzeigen . Sie müssen jede zur Liste gehörige CheckBox mit einem ListItem-Eintrag [li:text:value] (s.u.) definieren. Beispiel: [cbl:you_like_the_taste_of:][li:Chocolate:1][li:Vanilla:2][li:Lemon:3][/cbl]
Sie können die Anordnung mit dem Parameter  RepeatDirection="Vertical" oder RepeatDirection="Horizontal" anpassen.

[rbl:id:parameters][/rbl]

control

Die RadioButtonList kann analog zur CheckBoxList verwendet werden.
Auch hier können Sie die Anordnung über den Parameter RepeatDirection="Vertical" oder RepeatDirection="Horizontal" bestimmen.

[ddl:id:parameters][/ddl]

control

Die DropDownList arbeit analog zu den beiden anderen Listen. Sie müssen [li:text:value]-Elemente für jeden Listeneintrag verwenden. DropDownLists eignen sich gut dazu, größere Listen darzustellen.

[li:text:value]

control

Das ListItem kann nicht alleine verwendet werden,  sondern nur in Kombination mit Checkboxlisten, Radiobuttonlisten oder Dropdownlisten. Der Text wird auf der Website angezeigt, der jeweilige Wert wird in der E-Mail übermittelt.

[liloc:localizationkey:value]

control

Dieser Platzhalter ist sinnvoll, wenn Sie eine mehrsprachige Seite unter Verwendung von Lokalisierung betreiben. Sie können so die Übersetzung für den jeweiligen Lokalisierungs-Schlüssel ausgeben. Ansonsten hat er die selbe Funktionalität wie normale ListItems.

[ful:id:parameters]

control

Der FileUpLoad kann dazu verwendet werden um Dateien an die E-Mail anzuhängen.

[lbn:id:parameters]

control

Erzeugt einen LinkButton zum Absenden des Formulars. Alternativ können ImageButton [ibn:...], und Button[bu:...] verwendet werden. Alle diesen Buttons müssen den Parameter CommandName="update" enthalten. Bei Verwendung eines UpdateButtons [bnupdate:...] entfällt dieser Parameter.

[hidden:id:value]

control

Das HiddenField kann zur Übermittlung interner Informationen verwendet werden. Wenn der Text ein \n enthält, wird in der E-Mail an dieser Stelle ein Zeilenumbruch ausgeführt.
Beispiel:
[hidden:hid1:\nPersönliche  Informationen\n]

[errormessage]

string

Wird benutzt, um die in den "Speziellen Einstellungen" hinterlegte Fehlermeldung auszugeben, wenn nicht alle Pflichtfelder ausgefüllt wurden.

 

Anmerkung:
Alle diese Platzhalter generieren entsprechende ASP.NET-WebControls und akzeptieren die einschlägigen Parameter. Sie können grundsätzlich in den Templates aller formularbasierten Module verwendet werden.


Wenn der Empfänger über einen Parameter in der Url übergeben wird, sind bestimmte Informationen des zugehörigen-Kontaktes über context.items verfügbar:

Platzhaltername

Typ

Beschreibung

[ci:recipient]

string

contact.b_email (an diese Adresse wird das Formular gesandt).

[ci:recipientfirstname] string contact.firstname
[ci:recipientlastname] string contact.lastname
[ci:recipienttitle] string contact.title
[ci:recipientname] string contact.title + " " + contact.firstname + " " + contact.lastname
[ci:recipientsalutation] string contact.salutation
[ci:company] string contact.company
[ci:department] string contact.department
[ci:memo] string contact.memo
[ci:b_room] string contact.b_room
[ci:b_street] string contact.b_street
[ci:b_zipcode] string contact.b_zipcode
[ci:b_city] string contact.b_city
[ci:b_country] string contact.b_country

Hinweis: In einem Template des Kontakt-Moduls kann das Mailformular wie folgt verlinkt werden:
<a href="desktopdefault.aspx/tabid-.../mailcontact-[val:itemid]/">