Visuelles Beispiel

 

 

 
 

Allgemein

Mit Hilfe des Moduls Mailformular ist es möglich, über einfache Templates eine Möglichkeit der Dateneingabe bereitzustellen, z.B. für ein Kontaktformular. Standardmäßig wird der erfasste Inhalt per Mail versandt. Über kundenspezifische Anpassungen ist auch eine andere Weiterverarbeitung möglich.

Formulare werden auch als Templates für zahlreiche Module verwendet. Bezeichnung im Sitemanager: Mailformular (deutsch)

Leistungsmerkmale

  • Beliebige HTML Elemente sind zur Formulargestaltung nutzbar.
  • Für die Eingaben stehen u.a. Textboxen, Checkboxen, Labels, Radio Button Lists, Drop Down Lists sowie Auswahllisten zur Verfügung.
  • Das Captcha-Modul kann sicherstellen, das die Eingabe von natürlichen Personen erfolgt (Anti-Spam).
  • Die Eingaben können validiert werden.
  • Vor der Übermittlung kann eine Anzeige der Daten erfolgen, z.B. zur Bestätigung / Einverständnis.
  • Formularinhalte werden als E-Mail an die angegebenen Empfänger versendet.
  • Formular kann auch in Kopie und/oder Blind-Kopie versendet werden.
  • Die E-Mail kann auch per Template angepasst werden.
  • Per Dropdownliste kann der Empfänger optional vom Benutzer ausgewählt werden ohne dass dadurch die E-Mail Adresse des Empfängers veröffentlicht wird.
  • Text kann über Sprachdateien lokalisiert werden.
  • Zahlreiche Customization Points zur kundenspezifischen Anpassung der Funktionalitä-ten im Projekt stehen zur Verfügung, z.B. können so die erfassten Daten zur weiteren Bearbeitung in eine XML-Datei oder Datenbank geschrieben werden.

Bestimmung

  • Eingabeformulare aller Art, z.B. Kontaktformular, Bestellformular usw.

Nutzen

  • Schnelle, kostengünstige und flexible Umsetzung von verschiedensten Formularen mit einem out-of-the-box Modul ohne Programmierung
  • Integration in die Geschäftsprozesse des Kunden möglich
 
 

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, ob die Inhalte eingerückt ausgegeben werden sollen.
  • 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 fehlgeschlagener 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 das Template aus, das für die Bestätigungsmail an den Benutzer verwendet werden soll.
  • 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-Mailadresse 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 Empfänger angeben, der eine Kopie der Mail erhält.
  • BCC-Empfänger: Hier können Sie optional einen Empfänger angeben, der eine Kopie der Mail erhält ohne dass dies für den Empfänger ersichtlich ist.
  • Betreff / Empfänger: Hier können Sie weitere Betreffzeilen und Empfänger angeben. Dieses Verfahren wird beispielsweise verwendet, um automatisch verschiedene Themen in einem Kontaktformular an verschiedene Adressen weiterzuleiten.

Abb.: Spezielle Einstellungen des Formularmoduls

 

SMTP-Authentifizierung:

Hier geben Sie Ihren SMTP-Server bekannt: z.B. mail.gmx.net

E-Mail: Geben Sie hier die E-Mail Adresse an, mit dem Benutzer, der diese E-Mail versendet.

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

Authentifizierungstyp: (hier gibt es 3 Möglichkeiten)

  • Keine Authentifizierung: E-Mail Adresse und Password sind nicht notwendig, aber der Authentifizierungstyp muss auf „none“ stehen.
  • Basic: Sie authentifizieren Ihren SMTP-Server mit Ihrer E-Mail Adresse und Ihrem Password.
  • 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.

 

Achtung: Wenn Sie die Felder E-Mail, Password und den Authentifizierungscode eingeben – aber nicht das Feld Port – dann wird automatisch der Port 25 benutzt.

 

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

Evtl. auftretende Fehler werden in der „Eventlog“ ausgegeben.
  

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

 
 

Template: Spezielle Einstellungen - Grundeinstellung - Mailformular-Template

<script runat="server">
   Sub Page_Load(Byval sender As Object,ByVal e as EventArgs)
       if context.items("lang") = 2 Then
           senden.Text = "send"
       else
           senden.Text = "senden"
       end if
   End Sub
</script>
<div class="form-horizontal">
<fieldset>
<!-- Error message if is not possible to send form -->
<div class="form-group">
  <label class="col-md-4 control-label" for="errormessage"></label> 
  <div class="col-md-8">[errormessage]</div>
</div>
<!-- Select Basic -->

 

Sie können für die E-Mail auch ein HTML-Modul verwenden, in dem Sie alle ID´s zur Verfügung haben, die Sie in Ihrer Maske angegeben haben, indem Sie den [val:] Platzhalter verwenden.

Zum Beispiel wenn sie [tb:meinenachricht] verwendet haben können sie im mailtemplate [val:meinenachricht] benutzen.
Sie können außerdem ein captcha Modul verwenden, um den Missbrauch des Formulars durch Bots zu verhindern. Sie können das Captcha-Modul einfach über [module:#captchamodulid#] einbinden.
  
Falls das Mailformular nicht abgeschickt wird, könnte der Fehler beim SMTP-Server liegen, oder es ist ein Fehler in Ihrem Sourcecode aufgetreten. Falls Sie den Eintrag < add key"showexception" value="true" /> in Ihrer web.config eingetragen haben, sehen Sie am Ende des Seitenquelltextes die aufgetretenen Fehler. Häufige Fehler sind falsche SMTP Einträge in der web.config oder falsch konfigurierte SMTP-Server.

Sie können ein Bestätigungstemplate auswählen, um die vom Benutzer eingegebenen Informationen nochmals anzeigen zu lassen. Sie können Linkbuttons verwenden, um die E-Mail abzuschicken oder den ganzen Vorgang abbrechen, indem Sie CommandName=“send“ bzw. CommandName=“cancel“.

Sie können auch eine Kopie an den Absender zurückschicken indem Sie eine Checkbox mit der ID „sendcopy“ nach der Textbox für die E-Mail-Adresse mit der ID „email“ integrieren. Das Formular wird dann den Absender als BCC setzen.

 

Platzhalter

Element

Type

Beschreibung

[tb:id:parameters]

string

Das Textbox Element wird als input oder textarea angezeigt. Wenn Sie eine textarea benötigen müssen Sie bei den parameter textmode=”multiline” angeben.

[cb:id:parameters]

string

Sie können Checkboxen wie folgt verwenden [cb:read_conditions:value="Yes"]. Wenn diese Checkbox aktiviert ist gibt Sie „Yes” zurück.

[lb:id:parameters]

string

Mit diesem Label können sie z. B. Fehlermeldungen ausgeben [lb:errormessage:style="color:red;"]

[cbl:id:parameters][/cbl]

string

Die CheckBoxList kann verwendet werden um eine Gruppe von checkboxen anzuzeigen . Sie müssen jede einzelene Box definieren indem sie [li:text:value] verwenden. 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]

string

Genau wie bei der CheckBoxList können Sie die RadioButtonList verwenden.
Auch hier können Sie die Anorndnung über den Parameter RepeatDirection="Vertical" oder RepeatDirection="Horizontal" bestimmen.

[ddl:id:parameters][/ddl]

string

Die DropDownList arbeit auch so wie die anderen beiden Listen. Sie müssen [li:text:value] Elemente für die selection verwenden. DropDownLists eignen sich dazu größere Listen darzustellen.

[li:text:value]

string

Das ListItem kann nicht alleine verwendet werden. Sie können es in kombination mit Checkboxlisten, Radiobuttonlisten, Dropdownlisten. Der Text wird auf der Website angezeigt der value wird über die E-Mail weitergegeben

[liloc:localizationkey:value]

string

Wenn Sie eine mehrsprachige Seite mit Übersetzung durch language-Dateien betreiben, können Sie diesen Platzhalter verwenden um den Übersetztentext für den localizationkey auszugeben. Ansonsten hat es die selbe Funktionalität wie das normale listitem.

[ful:id:parameters]

string

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

[lbn:id:parameters]

string

Der  send button. Muss den Parameter CommandName="update" enthalten

[hidden:id:value]

string

Das hidden Feld kann für interne Informationen verwendet werden. Wenn Sie bei den Parametern \n angeben wird ein Zeilenumbruch durchgeführt Sie können dies nutzen um z. B. Überschriften in die E-Mail zu integrieren die ein Anwender nicht sehen soll:
[hidden:hid1:\nPersonal Informations\n]

[errormessage]

string

Wird benutzt, um Fehlermeldungen auszugeben die in den Speziellen Einstellungen hinterlegt ist.

 

Anmerkung:
Es sind zusätzliche Informationen über die context.items verfügbar. Wenn der Empfänger über einen Parameter in der Url übergeben wird lesen Sie bitte folgenden Artikel:

http://partner.contentxxl.com/desktopdefault.aspx/tabid-30/30_read-2269/