Formular mit dem Formhandler einbinden
Um den Formhandler einzusetzen muss die Extension aus dem TER installiert werden. Anschließend muss es auf einer Seite eingebunden werden. Im TS der Seite genügt dann folgender Code:
plugin.Tx_Formhandler.settings {
debug = 0
templateFile = fileadmin/templates/kontakt.html
langFile = fileadmin/templates/kontakt.xml
formValuesPrefix = fh
additionalIncludePaths.1 = fileadmin/templates/
validators {
1 {
class = Tx_Formhandler_Validator_Default
config {
fieldConf {
homepage.errorCheck.1 = simpleantispam
text.errorCheck.1 = simpleantispam
name.errorCheck.1 = simpleantispam
NameS.errorCheck.1 = required
TextS.errorCheck.1 = required
}
}
}
}
finishers {
1 {
class = Tx_Formhandler_Finisher_Mail
}
24 {
class = Tx_Formhandler_Finisher_Redirect
}
}
singleErrorTemplate {
totalWrap = |
singleWrap = |
}
errorListTemplate {
totalWrap = <p class="error">Folgende Fehler sind aufgetreten</p><ul class="error">|</ul><br />
singleWrap = <li>|</li>
}
}
Im Beispiel sind die Felder NameS und TestS als Pflichtfelder definiert und müssen angegeben werden. Die Felder homepage, text und name sind mit dem ErrorCheck „simpleantispam“ definiert.
Einfacher SPAM Schutz
Der einfache SPAM Schutz basiert auf der Tatsache das Bots die Formulare meist komplett ausfüllen. Wir prüfen also einfach ob Felder die für den User nicht sichtbar sind ausgefüllt wurden. Wenn ja, kann davon ausgegangen werden das es sich um einen automatischen Eintrag handelt. Damit das ganze funktioniert müssen die Felder homepage, text und name im Formular verbaut werden aber dürfen nicht angezeigt werden.
Hier ein Muster Template:
fileadmin/templates/kontakt.html6
<!– ###TEMPLATE_FORM1### begin –>
###ERROR###
<form id="mailform" name="mailform" method="post" action="#" enctype="multipart/form-data" style="padding-left:20px;">
###HIDDEN_FIELDS###
<div class="form-row">
<div class="field-label">Name:</div>
<div class="field-widget"><input type="text" name="fh[NameS]" class="required" value="###value_NameS###" title="Bitte einen Namen angeben !" onblur="pkon(1)" /></div>
</div>
<div class="form-row">
<div class="field-label">eMail:</div>
<div class="field-widget"><input name="fh[EMail_Adresse]" class="required validate-email" value = "###value_EMail_Adresse###" title="Bitte E-Mail Addresse eingeben !" onblur="pkon(2)" /></div>
</div>
<div class="form-row">
<div class="field-label">Ort:</div>
<div class="field-widget"><input name="fh[Ort]" class="normal" value = "###value_Ort###" title="Bitte Wohnort eingeben !" onblur="pkon(3)" /></div>
</div>
<div class="form-row">
<div class="field-label">Straße:</div>
<div class="field-widget"><input name="fh[Strasse]" class="normal" value = "###value_Strasse###" title="Bitte die Straße eingeben !" onblur="pkon(3)" /></div>
</div>
<div class="form-row">
<div class="field-label">Telefon:</div>
<div class="field-widget"><input name="fh[Telefon]" class="normal" value = "###value_Telefon###" title="Bitte eine Telefonnummer eingeben !" onblur="pkon(3)" /></div>
</div>
<div class="form-row">
<div class="field-label">Frage:</div>
<div class="field-widget"><textarea name="fh[TextS]" class="required" cols="40" rows="10">###value_SText###</textarea></div>
</div>
<div style="position:absolute; left:-1000px; top:-1000px;">
<input type="text" name="fh[homepage]" value="" tabindex="50" class="formulartext"/>
<input type="text" name="fh[text]" value="" tabindex="50" class="formulartext"/>
<input type="text" name="fh[name]" value="" tabindex="50" class="formulartext"/>
</div>
<div style = "clear:both;"></div>
<br/>
<div style="margin:0px; padding:0px;">
<div style = "clear:both;"></div>
<br/>
<input type="submit" value="Anfrage senden" ###submit_nextStep### />
</div>
<br/>
</form>
<!– ###TEMPLATE_FORM1### end –>
Damit der errorChecvk „simpleantispam“ auch funktioniert muss das folgende Script geladen sein. Es funktioniert im Prinzip umgekehrt wie der required Error Check:
fileadmin/templates/Tx_Formhandler_ErrorCheck_Simpleantispam.php
<?php
class Tx_Formhandler_ErrorCheck_Simpleantispam extends Tx_Formhandler_AbstractErrorCheck
{
public function check() {
$checkFailed = “;
if (!empty($this->gp[$this->formFieldName]))
{
$checkFailed = $this->getCheckFailed();
}
return $checkFailed;
} // public function check()
} // class Tx_Formhandler_ErrorCheck_Simpleantispam extends Tx_Formhandler_AbstractErrorCheck
?>
Damit die Fehler noch korrekt angezeigt werden muss die Sprachdatei noch hinterlegt werden.
fileadmin/templates/kontakt.xml
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<T3locallang>
<meta type="array">
<description>Language labels for my form</description>
</meta>
<data type="array">
<languageKey index="default" type="array">
<label index="error_homepage_simpleantispam"></label>
<label index="error_text_simpleantispam"></label>
<label index="error_name_simpleantispam"></label>
<label index="error_NameS_required">Bitte einen Namen angeben</label>
<label index="error_TextS_required">Bitte einen Text angeben</label>
</languageKey>
</data>
</T3locallang>
Die Empfänger der Kunden- und Admin Mail lassen sich einfach im Flexform einstellen. Die Inhalte der Mail müssen dann im Template noch definiert werden:
fileadmin/templates/kontakt.html
<!– ###TEMPLATE_SUBMITTEDOK### begin
OPTIONAL – will be shown if form was submitted and all required fields were filled out
–>
<p>Vielen Dank für ihre Anfrage, wir werden sie so schnell wie möglich bearbeiten</p>
<!– ###TEMPLATE_SUBMITTEDOK### end –>
<!– ###TEMPLATE_EMAIL_USER_PLAIN### begin
OPTIONAL – this will be the email text that is sent to the user (plaintext!)
–>
Hallo ###value_NameS###,
Wir werden ihre Anfrage so schnell wie möglich bearbeiten
M.f.G.
<!– ###TEMPLATE_EMAIL_USER_PLAIN### end –>
<!– ###TEMPLATE_EMAIL_ADMIN_PLAIN### begin
OPTIONAL – this will be the email text that is sent to the admin (plaintext!)
(admin-email = the email you can specify in the mailformplus plugin)
–>
Hallo, ein Nutzer schrieb folgendes :
Name: ###value_NameS###
Email: ###value_EMail_Adresse###
Text:
###value_TextS###
<!– ###TEMPLATE_EMAIL_ADMIN_PLAIN### end –>