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, Rckmeldungen, ... Ihrer Besucher in die Form
zu bringen, die Sie fr die Weiterverarbeitung bentigen.

Durch die strikte Umsetzung in der Scriptsprache PHP ist MailOpen
innerhalb aller Webprsenzen, die diese Vorgabe erfllen,
unkompliziert einsetzbar.

MailOpen ist fr 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 untersttzt. Nhere Informationen
hierzu finden Sie auf der MailOpen-Homepage unter
http://service.grammiweb.de/php_mailopen.shtml

Natrlich 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 knnen:

mailopen.php    	Das Script 
beispiel.html 		Ein Beispiel fr ein Kontaktformular 
beispiel2.html 		Ein Beispiel fr 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 fr die Einstellungen 
bentigten 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 fr die Besttigungsmail 
verwendet wird.

Zeile 25: $empfangName = "Ihr Name";
Der Name, der als Absender fr die Besttigungsmail verwendet wird, 
also z. B. "Grammiweb.de"

Zeile 30: #$empfangBCC = "blind1@domain.tld";
Soll die Nachricht an mehrere Empfnger versendet werden, 
"aktivieren" Sie diese Zeile durch Entfernen der Raute "#". Sie 
knnen 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";
Whlen Sie hier "j", wenn der Absender eine Besttigungsmail erhalten 
soll, oder "n"

Zeile 41: $doInhalt = "j";
Whlen Sie hier "j", wenn das Script automatisch alle Formulareingaben 
auf Inhalt prfen soll. Dies empfiehlt sich, wenn das Ausgangsformular 
Felder beinhaltet, die nicht unbedingt ausgefllt werden mssen, die 
aber in der Mail nur dann aufgefhrt werden sollen, wenn eine Eingabe 
darin erfolgte

Zeile 45: $bodyDankEmail = "....";
Der Text der Email, die der Absender als Besttigung erhlt. 
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 ausgefllt 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 knnen Sie 
sich des Formulars annehmen.


Das Formular

Im HTML-Formular knnen Sie die im Script angegebenen Standardwerte 
"berschreiben", wenn dies gewnscht wird. Dies ist z. B. notwendig 
sein, wenn die Werte im Script fr alle Formulare einer Website gelten 
sollen, jedoch bei einem Formular ein anderer Wert verwendet werden 
soll.

Die dazu bentigten Einstellungen sind im Beispielscript 
"beispiel.html" in den Zeilen 11 bis 17 aufgefhrt. Da die Inhalte 
bereits oben erlutert wurden, hier nur eine kurze bersicht mit 
der Bedeutung der Werte:

MOPflichtfelder    	Die Pflichtfelder (dazu unten mehr) 
MODanke 		Die Dankeseite 
MOTo 			Die Emailadresse des Empfngers 
MOToName 		Der Name des Empfngers 
MOBCC 			"Kopienverteiler" 
MOKopie 		Soll eine Besttigungsnachricht versendet 
			werden? 
MOInhalt 		Sollen nur ausgefllte Formularfelder 
			angezeigt werden? 

Mit den Pflichtfeldern geben Sie die Felder vor, die ausgefllt 
werden mssen. Dabei richten sich die Werte nach der Bezeichnung der 
Formularfelder, also z. B. "Email", wenn die Emailadresse des 
Absenders eingegeben werden muss. Mehrere Felder knnen Sie mit 
Leerzeichen getrennt vorgeben, also z. B. "Absender Email Nachricht".

Werden keine Pflichtfelder vorgegeben, knnen 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 Plausibilittsprfung, 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" bentigt, 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 aufgefhrt 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 Mglichkeiten 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 dafr eingerichtetes Formular (brigens auch mit MailOpen
realisiert).