Das Paket enthält: vionlink-formmailer.php formular.htm meldung_template.htm danke_template.htm src/font.tff src/bg.png src/capmaker.

Transkript

1 Das Paket enthält: vionlink-formmailer.php formular.htm meldung_template.htm danke_template.htm src/font.tff src/bg.png src/capmaker.php eine Nutzungslizenz Lizenz- und Nutzungsbestimmungen.pdf dieses Handbuch Schnelleinstieg Quick Installation 1. Öffnen Sie die Datei vionlink-formmailer.php. Im oberen Teil des Scripts werden die Einstellungen vorgenommen. Hier sind nähere Erläuterungen vorhanden. Tragen Sie die adresse ein, an die das Formular versendet wird. Speichern Sie die Datei ab. 2. Öffnen Sie entweder die bereits fertige und beiliegende Formularwebseite formular.htm oder Ihre eigene Formularwebseite. Wenn Sie eine eigene Formularseite nutzen, tragen Sie im <form>-tag den Namen und Pfad der Scriptdatei ein und ändern gegebenenfalls die Methode auf post. <form action="vionlink-formmailer.php" method="post"> 3. laden Sie den Ordnerinhalt auf Ihren Webspace. 4. Wenn Se die mitgelieferte Formularwebseite nutzen, verlinken Sie diese auf Ihren anderen Webseiten.

2 Schritt für Schritt- Anleitung Die Grundeinstellung (einsetzten der adresse) Öffnen Sie die Datei vionlink-formmailer.php. Im oberen Teil des Scripts werden die Einstellungen vorgenommen. Ein Kommentar leitet die Option ein, die vorgenommen werden kann. Es folgen jeweils Variablen mit entsprechenden Variablenwerten. An welche adresse sollen die Formulardaten gesendet werden? $sendmailto = 'ihrname@provider.xy'; In der Variablen $sendmailto ist festgehalten, an welche adresse das Formular gesendet werden soll. In einfachen Anführungstrichen ist eine Beispiel- adresse, die Sie gegen Ihre adresse austauschen. Die Grundeinstellung ist nun vorgenommen. Die weiteren Optionen werden später besprochen. Aufbau und Design des Formulars Das Formular kann um unzählge Formularfelder (und -arten) erweitert werden. Umgekehrt kann auch nur ein einziges Formularfeld abgefragt werden. Im Fehlerfall, wenn der Benutzer z.b. kein Pflichtfeld gefüllt hat, wird das Template meldung_template.htm verwendet. Es handelt sich hierbei um eine reine HTML-Datei, die vom Script eingelesen und mit der oder den Fehlermeldung(en) ausgestatt wird. Dazu enthält das Template einen Platzhalter, der nicht entfernt werden darf. Den HTML-Code können Sie nach Ihren Wünschen anpassen.

3 Falls keine eigene Dankeseite verwendet werden soll, sonder der editierbare Danketext, funktioniert das ähnlich. Genutzt wird das Template danke_template.htm Auch hier ist ein Platzhalter, der nicht entfernt werden sollte. Der HTML-Code ist editierbar. Zeichensatz Im <head> Bereich jeder HTML-Seite sind 2 mögliche Zeichensatz-Varianten zu finden. Eine davon ist jeweils mit Kommentar-Zeichen  auskommentiert. <meta http-equiv="content-type" content="text/html; charset=iso "> <meta http-equiv="content-type" content="text/html; charset=utf-8"> In der Datei vionlink-formmailer.php unter den Optionen finden Sie die Variable $charset. Nutzen Sie dort den zum Meta-Tag passenden Zeichensatz. Eine der beiden Varianten ist auskommentiert, mit einer Raute vor der Variablen. Badwords (Wörter-Sperrliste) In den Optionen befindet sich ein Array $badwordsarray mit Wörtern. Sollte eines der dort aufgezählten Wörter in einem Formularfeld auftauchen, wird eine Fehlermeldung erzeugt. Neue Wörter können hinzugefügt werden. Dazu schreiben Sie direkt hinter =array( das auszuschließende Wort in einfachen Anführungszeichen gefolgt von einem Komma. Captcha - Sicherheitscode-Abfrage um die Sicherheitsabfrage zu verwenden, muss unter den Optionen die Variable $use_captcha auf 1 gestellt werden. Gleichzeitig muss in der Formularwebseite der folgende Abschnitt zu finden sein: <tr><td>sicherheitscode</td><td valign="top"> <iframe class="scode" src="src/capmaker.php" scrolling="no" frameborder="0"></iframe><input name="cap" type="text" class="cap"><br style="clear:left;" ></td></tr> Nur mit korrekter Eingabe des Sicherheitstextes kann das Formular erfolgreich abgesendet werden.

4 Wenn Sie das Captcha nicht verwenden möchten, entfernen Sie den o.g. Abschnitt bzw. fügen ihn nicht in Ihre Formularwebseite ein. Stellen Sie den Wert von $use_captcha auf 0 Die Captchatechnik setzt voraus, das beim Ihrem Webspaceprovider die GD Bibliothek vom Script verwendet werden kann, was bei den meisten Providern der Fall ist. Bei manchen Hoster wird ein absoluter Pfad zur Verlinkung der Schriftart verlangt. Die Grundeinstellungen im Script und das Template sind nun angepasst. Upload Laden Sie nun die Dateien und den Ordner auf Ihren Webspace hoch. Wenn Sie die Datei formular.htm aufrufen, erscheint Ihr Formular. Es ist bereit, die Daten von Besuchern aufzunehmen und an Sie zu versenden. weitere Optionen Eine Kopie des Formularinhaltes an eine andere adresse? Die hier beschriebene Variable kann mehrere Variablenwerte annehmen. Es handelt sich um ein Array. Die Werte werden in einfache Anführungszeichen gesetzt, jeder Variablenwert ist durch ein Komma vom Anderen getrennt. $sendmailcopy = array('einekopie@provider.xy','nochnekopie@provider.xy');

5 In der Variablen $sendmailcopy sind adressen enthalten, an die das Formular zusätzlich gesendet werden soll. Wird diese Funktion der zusätzlichen adressen nicht benötigt, kann die Variable ausser Kraft gesetzt werden. Dazu setzt man ein Rautensymbol(#) vor die Variable: #$sendmailcopy = array('einekopie@provider.xy','nochnekopie@provider.xy'); Nun ist die Variable auskommentiert und wird nicht berücksichtigt. Dabei spielt es keine Rolle, ob Werte darin eingetragen sind oder nicht. Formular-Pflichtfelder ein Pflichtfeld im Formular ist ein Feld, in dem eine Eingabe erfolgen muss. Wird keine Eingabe durch den Benutzer vorgenommen, wird eine Meldung ausgegeben, welche auf das Ausfüllen des Pflichtfelds hinweist. Im Folgenden sind 3 Formularfelder (Vorname, und Mitteilung) als Pflichtfeld definiert. Um ein Feld zu einem Pflichtfelder zu machen, muss der Name des Formularfeldes in die u.a. Variable eingefügt werden. Achten Sie auf Groß- und Kleinschreibung! Als Pflichtfelder können nur input und textarea-formularfelder verwendet werden, keine Checkboxen, Radiobuttons und Selectlisten. Um keine Pflichfelder zu verwenden setzen Sie vor die u.a. Zeile ein Rautensymbol(#). $needed = array('vorname', ' ', 'Mitteilung');

6 Textausgaben hier sind einige Meldungen, die während oder nach dem Ausfüllen des Formulars auftauchen. Nach erfolgreichem Absenden des Formulars $vielendank =' Vielen Dank fuer Ihre Mitteilung! '; Wenn das Captcha verwendet wird, und der Sicherheitstext falsch war $codenichtkorrekt =' Sicherheitstext ist nicht korrekt!<br> '; Beim Synthaxcheck auf eine gültige adresse $f_synthax_ =' keine gültige adresse!<br> '; Beim Synthaxcheck auf eine gültige Telefonnummer $f_synthax_tel=' keine gültige Telefonnummer!<br> '; Beim Schutz vor Header Injection, wenn kritische Zeichen auftauchen $f_ehi_check=' Ihre Eingabe enthält kritische Zeichen!<br> '; Eine Kopie der an den Formularabsender(Besucher)? das setzt voraus, das im Formular ein Feld für die adresse des Formular- Benutzers ist. Das Formularfeld sieht so aus: <input type="text" name="formularfeldname"> Um das Feld zuordnen zu können, muss ein eindeutiger Name vergeben werden. In diesem Fall muss der Formularfeldname ' ' lauten. <input type="text" name=" "> In den Optionen kann nun für die Variable $copy2user ein Wert vergeben werden. 1 bedeutet das eine Kopie an die adresse aus dem Formularfeld gesendet wird. 0 bedeutet: keine Kopie wird gesendet.

7 Möchten Sie, dass der Besucher entscheidet, ob er eine Kopie möchte? Dann geben Sie der Variablen $copy2user_ckbox den Wert 1. Es ist aber auch noch ein besonderes Formularfeld notwendig: <input type="checkbox" name="wannacopy"> Die Checkbox trägt den Formularfeldnamen 'wannacopy'. Hakt der Besucher die Checkbox an, kann die Kopie versendet werden. Natürlich muss auch hier ein Formularfeld für die adresse des Benutzers bereitstehen. Der Formularfeldname muss " " lauten. Wenn Sie die Checkbox-Variante verwenden ( $copy2user_ckbox ='1'; ) wird die Variante über $copy2user außer Kraft gesetzt. Denn der Besucher entscheidet nun selbst, ob er eine Kopie möchte oder nicht. Reply Funktion ("Antworten"-Funktion Ihres programms) Sofern eine adresse vom Besucher im Formular hinterlassen wird (wieder das Formularfeld das den Formularfeld-Namen " " trägt), kann diese adresse als Absenderadresse der generierten erscheinen. In Ihrem Mailprogramm liest dann die Funktion "Antworten" die adresse aus, so das eine direkte Antwort möglich ist. Wurde keine adresse hinterlassen oder ist die Variable auf den Wert 0 gesetzt, wird Ihre eigene adresse verwendet. $use_reply = '1'; Welchen Betreff sollen die s erhalten? $mail_subject = 'Kontaktformular';

8 Welchen Betreff soll die Kopie an den Benutzer des Formulars haben? Das wird natürlich nur berücksichtigt, wenn ein das Versenden einer Kopie eingestellt wurde. $mail_copysubject = 'Kopie Ihrer Nachricht'; Formular-Synthax-Prüfung: adresse die Eingabe einer adresse kann auf korrekte Synthax geprüft werden. Dazu muss der Formularfeldname in die folgende Variable eingetragen werden. Um die Prüfung zu deaktivieren, setzen Sie vor die u.a. Zeile ein Rautensymbol(#). $check_ml_synthax = array(' '); Formular-Synthax-Prüfung: Telefonnummer Um die Eingabe einer formal gültigen Telefonnummer zu überprüfen,tragen Sie den entsprechenden Formularfeldnamen in die folgende Variable ein. Um die Prüfung zu deaktivieren, setzen Sie vor die u.a. Zeile ein Rautensymbol(#). $check_tel_synthax = array('telefon'); Formularinhalt als Textdatei speichern wenn Sie die Option nutzen möchten, waehlen Sie bitte bei use_depot die 1. Erstellen Sie einen Ordner (bsp. log) im selben Verzeichnis, indem sich die Scriptdatei vionlink-formmailer.php befindet. Der Ordner benötigt Schreibrechte. Vergeben Sie daher mit Ihrem FTP-Programm die CHMOD-Rechte (755 bzw. 766 oder 777). Erhöhen Sie die CHMOD Rechte schrittweise und senden Sie Testmails und prüfen Sie, ob die Mail gepseichert wurde. Beachten Sie das manchmal neue Dateien als vertsteckte erzeugt werden, aktualisieren Sie entsprechend die Anzeige in Ihrem FTP PRogramm.

9 Den Ordnernamen geben Sie in der Variablen depot_foldername an. Beachten Sie, den endenen Slash(/), der auf jeden Fall enthalten sein muss. Um die Option nicht zu verwenden wählen Sie als use-depot 0. $use_depot = '1'; $depot_foldername = 'log/'; eigene "Danke"-Webseite Sie können den Besucher nach erfolgreichem Ausfüllen des Formulars auf eine eigens dafür angelegte und gestaltete Webseite leiten. Wenn Sie eine solche Danke-Webseite nutzen möchten, setzten Sie die Variable $thx_use auf den Wert 1 und geben Sie bitte den absoluten Pfad zur Seite in der Variablen $dankeseite an. Bsp. Wenn Sie keine eigene Seite haben, wird eine Dankesmeldung nach dem Absenden des Formulars angezeigt. Setzen Sie die Variable $thx_use auf den Wert 0. Ob eine Seite angegeben ist oder nicht spielt keine Rolle. $thx_use = '0'; $dankeseite = ' Der Header Injection Schutz ist immer aktiviert. Das Script prüft die Formulareingaben auf kritische Zeichen und gibt eine Fehlermeldung aus, sobald solche entdeckt wurden.

10 Probleme beim Mailversand? wenn keine versendet wird: - kann die Ursache bei Ihrem Provider liegen. Manche Provider (so z.b. HostEurope) fordern aus Spamschutzgründen einen Zusatz im PHP-Mailbefehl. Ändern Sie die Mailbefehle im Script entsprechend ab. - kann die Ursache an der adresse liegen Nutzen Sie dann keine adresse eines Fre -Providers, sondern eine adresse aus dem Webspacepaket Ihre Providers. Viel Spaß mit dem vionlink formmailer!