1. Was ist GrammiwebMailOpen? GrammiwebMailOpen ist ein nahezu universell einsetzbarer Formularmailer, der beliebige Informationen an vorgegebene Emailadressen weiterleitet. Mit GrammiwebMailOpen sind Sie in der Lage, Bestellungen, Rückmeldungen, ... Ihrer Besucher in die Form zu bringen, die Sie für die Weiterverarbeitung benötigen. Durch die strikte Umsetzung in der Scriptsprache PHP ist MailOpen innerhalb aller Webpräsenzen, die diese Vorgabe erfüllen, unkompliziert einsetzbar. MailOpen ist für den nichtkommerziellen Gebrauch frei verwendbar. Bei kommerzieller Nutzung bieten wir Ihnen MailOpen zu einem geringen Betrag an, der uns bei der Entwicklung von Programmerweiterungen sowie bei der Konstruktion neuer Produkte unterstützt. Nähere Informationen hierzu finden Sie auf der MailOpen-Homepage unter http://service.grammiweb.de/php_mailopen.shtml Natürlich sind auch Spenden oder Links zum Grammiweb willkommen :-) 2. Installation Systemvoraussetzungen: PHP Entpacken Sie die ZIP-Datei in ein Verzeichnis Ihrer Wahl. Alle Einstellungen nehmen Sie in der Datei "mailopen.php" vor, die sich im Unterverzeichnis /mailopen befindet. Folgende Angaben sind zur Verwendung des Scripts notwendig: Beim Entpacken wird ein neues Verzeichnis mit dem Titel "MailOpen" angelegt, in dem Sie folgende Dateien finden können: mailopen.php Das Script beispiel.html Ein Beispiel für ein Kontaktformular beispiel2.html Ein Beispiel für ein einfaches Bestellformular danke.html Die "Danke"-Seite, die nach dem Senden angezeigt wird readme.txt Eine kurze Beschreibung von MailOpen Die Steuerung des Scriptes basiert entweder auf Standardwerten, die in der Scriptdatei "mailopen.php" direkt angegeben werden, oder wird vom HTML-Formular "ferngesteuert". Um die Standardwerte zu ändern, öffnen Sie die Datei "mailopen.php" mit einem Editor, z. B. dem Texteditor Ihres Betriebssystems oder dem Quelltexteditor "Weaverslave". Die für die Einstellungen benötigten Werte befinden sich zwischen den Zeilen 22 und 49. Die Werte im Einzelnen: Zeile 22: $empfangAdresse = "ihre.adresse@domain.tld"; Ihre Emailadresse, also statt "ihre.adresse@domain.tld" z. B. "info@grammiweb.de". Bitte verwenden Sie hier nur eine einzelne Adresse, da diese auch als Absenderadresse für die Bestätigungsmail verwendet wird. Zeile 25: $empfangName = "Ihr Name"; Der Name, der als Absender für die Bestätigungsmail verwendet wird, also z. B. "Grammiweb.de" Zeile 30: #$empfangBCC = "blind1@domain.tld"; Soll die Nachricht an mehrere Empfänger versendet werden, "aktivieren" Sie diese Zeile durch Entfernen der Raute "#". Sie können hier kommagetrennte "BCC-Adressaten" eintragen, also z. B. "service@domain.tld,public@domain.tld" oder einfach nur "service@domain.tld" Zeile 33: $seiteDanke = "/danke.html"; Der Pfad und der Titel der Webseite, die nach dem Versand aufgerufen werden soll. Erfahrungsgemäß empfiehlt es sich, den kompletten absoluten Pfad zu verwenden, also z. B. "/intern/danke.html", wenn die Datei im Unterverzeichnis "intern" des Hauptverzeichnisses liegt, oder "/danke.html", wenn sie direkt im Hauptverzeichnis liegt Zeile 37: $doKopie = "j"; Wählen Sie hier "j", wenn der Absender eine Bestätigungsmail erhalten soll, oder "n" Zeile 41: $doInhalt = "j"; Wählen Sie hier "j", wenn das Script automatisch alle Formulareingaben auf Inhalt prüfen soll. Dies empfiehlt sich, wenn das Ausgangsformular Felder beinhaltet, die nicht unbedingt ausgefüllt werden müssen, die aber in der Mail nur dann aufgeführt werden sollen, wenn eine Eingabe darin erfolgte Zeile 45: $bodyDankEmail = "...."; Der Text der Email, die der Absender als Bestätigung erhält. Vorgegeben ist "Vielen Dank fuer Ihre Nachricht. Wir werden sie schnellstmoeglich bearbeiten.", gefolgt von einem kurzen Werbehinweis, dass diese Mail mit MailOpen versendet wurde. Wenn Sie diesen Hinweis entfernen, binden Sie bitte einen Link zum Grammiweb auf der Formularseite ein Zeile 48: $meldFehler = "..."; Wenn der Versand aufgrund eines Fehlers nicht erfolgt (z. B. weil ein Pflichtfeld nicht ausgefüllt wurde oder die Emailadresse nicht korrekt zu sein scheint), wird der Abbruchhinweis mit diesem Text, gefolgt von der Fehlerquelle, eingeleitet Zeile 49: $meldFehler2 = "..."; Mit diesem Text wird die Nachricht ausgegeben, dass die Fehlerquelle beseitigt werden soll Soweit die Einstellungen im Script. Nach dem Speichern können Sie sich des Formulars annehmen. Das Formular Im HTML-Formular können Sie die im Script angegebenen Standardwerte "überschreiben", wenn dies gewünscht wird. Dies ist z. B. notwendig sein, wenn die Werte im Script für alle Formulare einer Website gelten sollen, jedoch bei einem Formular ein anderer Wert verwendet werden soll. Die dazu benötigten Einstellungen sind im Beispielscript "beispiel.html" in den Zeilen 11 bis 17 aufgeführt. Da die Inhalte bereits oben erläutert wurden, hier nur eine kurze Übersicht mit der Bedeutung der Werte: MOPflichtfelder Die Pflichtfelder (dazu unten mehr) MODanke Die Dankeseite MOTo Die Emailadresse des Empfängers MOToName Der Name des Empfängers MOBCC "Kopienverteiler" MOKopie Soll eine Bestätigungsnachricht versendet werden? MOInhalt Sollen nur ausgefüllte Formularfelder angezeigt werden? Mit den Pflichtfeldern geben Sie die Felder vor, die ausgefüllt werden müssen. Dabei richten sich die Werte nach der Bezeichnung der Formularfelder, also z. B. "Email", wenn die Emailadresse des Absenders eingegeben werden muss. Mehrere Felder können Sie mit Leerzeichen getrennt vorgeben, also z. B. "Absender Email Nachricht". Werden keine Pflichtfelder vorgegeben, können Besucher auch komplett leere Nachrichten verschicken, also sollten Sie auf diese Limitierung nicht verzichten. Bei der Erstellung des Formulars gibt es verschiedene Punkte zu beachten: * Der Name des Absender wird immer im Formularfeld "Absender" eingegeben * Die Emailadresse des Absenders wird immer im Formularfeld "Email" eingegeben (hier erfolgt auch die Plausibilitätsprüfung, ob diese Adresse rein technisch existieren kann) * Der Betreff der Nachricht wird immer im Formularfeld "Betreff" eingegeben * Zum logischen Versand der Nachricht werden die Felder "Absender", "Email" und "Betreff" benötigt, da diese in der Mail selbst verwendet werden (damit sie z. B. einen Betreff hat) * Formularfelder, deren Bezeichnung mit "MO" beginnt, dienen der Steuerung des Scripts und werden nicht in der Nachricht angegeben. Wollen Sie also z. B. nicht, dass der "Abschicken"-Button in der Mail aufgeführt wird, geben Sie ihm die Bezeichnung "MOAbschicken" oder "MOSubmit" * Feldbezeichnungen beinhalten keine Sonderzeichen oder Leerzeichen. Verwenden Sie also lieber "ue" statt "ü" und trennen Sie logische Worte durch "_" statt durch " " * Die Reihenfolge der Formulareingaben in der Nachricht richtet sich nach der Reihenfolge der Felder im Formular selbst * Das Formular selbst kann auf allen Möglichkeiten aufbauen, die HTML bietet * In der ersten Zeile des Formulars muss die Adresse des Scripts auf Ihrem Server angegeben werden 3. Upload der Datei Legen Sie nun die Dateien auf Ihrem Webserver ab. Das war's schon. Sollten Sie weitere Fragen haben, finden Sie im Grammiweb unter http://service.grammiweb.de/kontakt.shtml ein dafür eingerichtetes Formular (übrigens auch mit MailOpen realisiert).