<we:form type="formmail"  />

Erzeugt ein HTML-Formular, welches verwendet wird, um die Daten der Formularfelder als E-Mail zu versenden.

Folgende Namen dürfen nicht für die HTML-Formular-Elemente benutzt werden:
remove, order, required, onsuccess, onerror, type, recipient, mimetype, subject, onmailerror, confirmmail, preconfirm, postconfirm, from.

Folgende Texte dürfen aus Sicherheitsgründen nicht am Anfang einer Zeile innerhalb der Mail auftauchen:
content-type: mime-version: Content-Transfer-Encoding: bcc: cc: to:

Folgender String darf im Mailtext nicht vorkommen:
multipart/mixed

ab Version 1.3.0.0
Endtag erforderlich nein
Pflichtattribute

Attribute

type Pflichtfeld: ja

Gibt den Typ-Form des we:form Tags an, hier "formmail".

ab Version 1.3.0.0
Typ string
mögliche Werte formmail
Standardwert -
id Pflichtfeld: nein

Besonderheit: Dieses Attribut steht nur zur Verfügung und wird im Tagwizzard nur angezeigt, wenn in den allgemeinen Einstellungen/Formmail der Eintrag "Formmail über webEdition-Dokument aufrufen" auf "ja" gesetzt ist.

Bei diesem Attribut gibst Du als Wert die id des Dokuments an, das als webEdition-Zwischenseite dienen soll. Möglich ist auch die Angabe von "self", wenn die Zwischenseite das absendende Dokument selber sein soll.

Die Zwischenseite kann z.B. dazu dienen eine Captcha-Überprüfung für das Mail-Formular durchzuführen.
Siehe auch:
<we:formmail>
<we:captcha>
<we:ifCaptcha>

ab Version 1.3.0.0
Typ string
Standardwert -
recipient Pflichtfeld: ja

Bei diesem Attribut gibst Du als Wert kommasepariert die E-Mail-Adressen an, an die die Daten der Formularfelder gesendet werden sollen. Die hier eingetragenen E-Mail-Adressen müssen zusätzlich innerhalb von webEdition über das Menü Bearbeiten -> Formmail-Empfänger eingetragen werden.

ab Version 1.3.0.0
Typ string
Standardwert -
name Pflichtfeld: nein

Hier wird ein Name des we-Tags angegeben.

ab Version 1.3.0.0
Typ string
Standardwert -
nameid Pflichtfeld: nein

Bestimmt die (HTML-)ID für das Formular. Diese ID kannst Du beispielsweise als ID Selector in einer CSS-Datei nutzen.

Dieses Attribut erlaubt es, für die Ausgabe des HTML-form Tags name und id gleichzeitig zu setzen, z.B. für nameid="XY" erfolgt die Ausgabe <form name="XY" id="XY" ….

ab Version 1.3.0.0
Typ string
Standardwert -
method Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die HTTP-Übertragungsmethode an, mit welcher die Formulardaten übertragen werden sollen.

ab Version 1.3.0.0
Typ string
mögliche Werte get, post
Standardwert -
target Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert das Ziel (Fenster- oder Framename) des Links an.

WertBedeutung
_top Link wird bei verschachtelten Framesets im obersten Frameset geöffnet.
_parent Link wird bei verschachtelten Framesets im Eltern-Frameset geöffnet.
_self Link wird im aktuellen Fenster/Frame geöffnet.
_blank Link wird in einem neuen Fenster geöffnet.
ab Version 1.5.0.0
Typ string
mögliche Werte _top, _parent, _self, _blank
Standardwert -
oncaptiaerror Pflichtfeld: nein
deprecated

Bei diesem Attribut gibst Du als Wert die Id jenes webEdition-Dokuments an, welches bei einem Fehler bei der Prüfung des Captcha aufgerufen werden soll.

ab Version 1.3.0.0
Typ number
Standardwert -
onsuccess Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die Id des webEdition-Dokuments an, welches nach dem erfolgreichen Versenden des Formulars aufgerufen werden soll.

ab Version 1.3.0.0
Typ string
Standardwert -
onerror Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die Id des webEdition-Dokuments an, welches bei einem Fehler (z.B. nicht alle notwendigen Felder ausgefüllt, die als Wert des Attributs "required" definiert wurden) aufgerufen werden soll.

Ab Version 9.2.3 wird dieses Dokument auch aufgerufen, wenn die (optional) mit einem Formular-Element "email" übergebene Absender-E-Mail-Adresse syntaktisch falsch ist: valide sind sowohl korrekte reine E-Mail-Adressen als auch Adressen im Format "[Vorname] Name <adresse>").

ab Version 1.3.0.0
Typ number
Standardwert -
onmailerror Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die Id des webEdition-Dokuments an, welches bei einer syntaktisch falschen Absender-E-Mail-Adresse aufgerufen werden soll. Das Formular-Element für die Absender-E-Mail-Adresse muss den Namen "email" haben.

Ab Version 9.2.3 wird das Attribut neu und ausschließlich dazu verwendet, um die Id des webEdition-Dokuments anzugeben, welches bei Problemen mit dem E-Mail-Versand aufgerufen wird. Dies ist dann der Fall, wenn die Verbindung zum Mailserver scheitert oder der Server die Mail nicht versenden kann (ob jedoch eine erfolgreich versandte Mail beim Empfänger zustellbar ist kann nicht geprüft werden). Ebenfalls aufgerufen wird dieses webEdition-Dokument bei Problemen mit dem Zufügen etwaiger Anhänge.

ab Version 1.3.0.0
Typ number
Standardwert -
onrecipienterror Pflichtfeld: nein
deprecated

Bei diesem Attribut gibst Du als Wert die Id eines webEdition-Dokuments an, das angezeigt werden soll.

ab Version 1.3.0.0
Typ number
Standardwert -
from Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die E-Mail-Adresse an, welche als Absender bei der zu sendenden E-Mail eingetragen werden soll, wenn das Formular-Element "email" nicht existiert.

ab Version 1.3.0.0
Typ string
Standardwert -
subject Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert den Text an, welcher in der Betreff-Zeile der zu sendenden E-Mail stehen soll.

ab Version 1.3.0.0
Typ string
Standardwert -
charset Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die zu benutzende Kodierung der zu versendenden E-Mail an. Eine Standard-Kodierung ist iso-8859-1. In webEdition Version 6 ist die Standard-Kodierung utf-8.

ab Version 3.1.0.0
Typ string
Standardwert -
order Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert kommasepariert die Formular-Element-Namen in der Reihenfolge an, in der sie in der zu sendenden E-Mail angezeigt werden sollen. Wird dieses Attribut nicht gesetzt, dann wird die Reihenfolge der Formular-Elemente aus dem HTML-Quellcode übernommen.

ab Version 1.3.0.0
Typ string
Standardwert -
required Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert kommasepariert die Formular-Element-Namen an, die Pflichtfelder sein sollen. Wurde eines der angegebenen Formular-Elemente nicht ausgefüllt, wird eine webEdition-eigene Fehlermeldung angezeigt (wenn das Attribut "onerror" leer oder nicht gesetzt ist) oder die webEdition-Seite aufgerufen, die als Wert des Attributs "onerror" angegeben ist.

ab Version 1.3.0.0
Typ string
Standardwert -
remove Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert kommasepariert die Feldnamen an, welche nicht mit der E-Mail versendet werden sollen.

ab Version 3.0.0.0
Typ string
Standardwert -
mimetype Pflichtfeld: nein

Wenn Du als Wert dieses Attributs "text/html" angibst, dann wird die E-Mail im HTML-Format verschickt. In diesem Fall kann die Vorlage beliebig gestaltet werden. Wenn Du als Wert dieses Attributs "text/plain" angibst oder das Attribut nicht setzt, dann wird das webEdition-Dokument als Text-Mail verschickt. In diesem Fall ist darauf zu achten, dass die Vorlage des webEdition-Dokuments keine HTML-Tags ausser <br> enthalten darf. Das Tag <br> wird in einen Zeilenumbruch übersetzt.

ab Version 1.3.0.0
Typ string
mögliche Werte text/plain, text/html
Standardwert -
confirmmail Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert "true" an, wenn eine Bestätigungsmail gesendet werden soll.

ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
forcefrom Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert "true" an, wenn die unter "from" eingetragene als Absenderadresse in der Mail angegeben werden soll. Bei "false", oder wenn das Attribut nicht gesetzt ist, wird die vom Nutzer in das Feld "email" eingetragene Adresse angegeben, falls ein Feld mit diesem Namen (name="email") im Formular vorhanden ist. Erlaubte Werte: true, false

ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
preconfirm Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert den Namen eines we:Formular-Elements an, dessen Inhalt als Einleitungstext (vor den Daten des Formulars) der E-Mail erscheinen soll.

ab Version 1.3.0.0
Typ string
Standardwert -
postconfirm Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert den Namen eines we:Formular-Elements an, dessen Inhalt als Ausleitungstext (nach den Daten des Formulars) der E-Mail erscheinen soll.

ab Version 1.3.0.0
Typ string
Standardwert -
params Pflichtfeld: nein
Hier können Link-Parameter angegeben werden, um sie an eine Folgeseite zu übergeben.
ab Version 1.3.0.0
Typ string
Standardwert -
pass_* Pflichtfeld: nein

Für das * - also nach dem "_" (Unterstrich) - kann ein beliebiger Wert (HTML-Attribut) vergeben werden. Dieses wird dann so an die Ausgabe weritergegeben.

Zum Beispiel kann man dadurch einem Formular eine ID verpasst werden. Denn das Attribut "id" kann ja nicht verwendet werden, da dieses schon ein webEdition-Attribut ist. In einem solchen Fall kann man "pass_id" verwenden.

Dieses Attribut gibt es übrigens bei allen Tags die eine Ausgabe produzieren.

ab Version 3.2.0.0
Typ string
Standardwert -

Syntax

<we:form type="formmail" id="" recipient="" name="" nameid="" method="get|post" target="_top|_parent|_self|_blank" onsuccess="" onerror="" onmailerror="" from="" subject="" charset="" order="" required="" remove="" mimetype="text/plain|text/html" confirmmail="true|false" forcefrom="true|false" preconfirm="" postconfirm="" params="" pass_*=""/>						

Siehe auch

Hilf mit!

Hast Du eine Ergänzung für die Tag-Referenz, dann werde bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder einfach formlos per E-Mail an websites@webedition.org.

Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.

powered by webEdition CMS