version 1.0
© Martin Auer 2004
Sie können Kopien für den
persönlichen Gebrauch anfertigen
aber es ist nicht gestattet, das Script in irgend
einer Form
weiterzuverbreiten.
Entpacken Sie die ZIP-Datei in ein beliebiges Verzeichnis. Das Verzeichnis wird die folgenden Dateien enthalten:
cushymailform.php
_vorlage.cm
_vorlage.css
_template.cm
_template.css
Zusätzlich wird es ein Unterverzeichnis namens sec enthalten. In diesem Unterverzeichnis werden sich die folgenden Dateien befinden:
cushymailform_admin.php
.htaccess
Die Datei .htaccess enthält keine Daten. Sie ist nur ein Platzhalter und sollte durch Ihre eigene ersetzt werden. Diese Anordnung hat den Zweck, Ihnen zu ermöglichen, das Eingabeformular mit einem Passwort zu schützen. Wenn Sie nicht wissen, wie Sie ein Verzeichnis mittels .htaccess schützen, finden Sie hier alles Nötige: http://de.selfhtml.org/diverses/htaccess.htm#verzeichnisschutz.
Laden Sie die gesamte Anordnung zur Ihrer Website hoch. Das Eingabeformular und das Mailformular können nur korrekt zusammenarbeiten, wenn sich das Eingabeformular ein Verzeichnis unter dem Mailformular befindet. Ändern Sie die Berechtigungen für das Verzeichnis, in dem sich cushymailform.php befindet, auf 777, damit das Script Dateien in das Verzeichnis schreiben kann.
Im Eingabeformular (cushymailform_admin.php) definieren Sie eine Kennung (ID), z.B. sekretariat, und die zugehörigen Einstellungen.
Auf Ihren Webseiten erstellen Links
zum Mailformular nach dem folgenden Muster:
<a href = "../pfad/zu/cushymailform.php?id=sekretariat">Kontakt</a>.
So können Sie zum Beispiel je nach der Seite, von der der/die UserIn kommt, unterschiedliche Betreffs definieren, oder Sie können damit Kontaktlisten für eine Reihe von Abteilungen erstellen, sie können das Mailformular verschiedene Sprachen sprechen lassen, sein Aussehen an den Stil der jeweiligen Seite anpassen usw.
Im Eingabeformular sehen Sie links eine Liste der vorhandenen Sätze von Einstellungen. Am Anfang sollten zwei vorhanden sein: _vorlage und _template. Wie der Name sagt, sind es Vorlagen, die Sie benutzen können, eine für Deutsch und eine für Englisch. Wenn das Script auch nur in zwei Sprachen existiert, so können Sie das Mailformular an sich jede Sprache sprechen lassen.
Wenn Sie auf einen der Links auf der linken Seite klicken, werden die zugehörigen Einstellungen in das Formular geladen.
Der erste Punkt ist die Kennung (ID), die Sie in dem Link (oder vielmehr im query-string zum Link) verwenden. Wenn Sie die Kennung sekretariat erzeugen, werden die Einstellungen in der Datei sekretariat.cm gespeichert und die neue Kennung wird in der Liste links erscheinen. Wenn Sie sekretariat als Vorlage für einen neuen Satz von Einstellungen verwenden wollen, laden Sie den Satz in das Formular, ändern Sie die Kennung und was Sie sonst noch ändern wollen und drücken Sie den Speichern-Knopf. Wenn Sie löschen anhaken, werden die zugehörigen Einstellungen gelöscht und die Kennung verschwindet aus der Liste.
Der nächste Punkt ist das Stylesheet, das Sie für diese Erscheinungsform des Mailformulars nutzen wollen. Sie können den URL eingeben oder - wenn das Stylesheet sich in derselben Website befindet - den Pfad. Geben Sie nicht den Pfad vom Eingabeformular aus, sondern den vom Mailformular aus ein, denn das Mailformular sucht dann nach dem Stylesheet. Sie können natürlich auch _vorlage.css beibehalten.
Das Mailformular enthält vier Klassen (class), die Sie vielleicht Ihrem Stylesheet hinzufügen möchten: .cusyhmail_layout_table ist die äußere Tabelle, die dazu dient, den Navigations-Balken und das Mailformular zu positionieren. .cushymail_layout_cell ist die Klasse für die zugehörigen <td> Zellen. .cusyhmail_table ist die innere Tabelle <table>, die das Mailformular enthält, .cushymail_cell ist die Klasse für die zugehörigen Zellen <td>
Da Ihre Site PHP benutzt, haben Sie möglicherweise auch einen Navigationsbalken der die hauptsächlichen Links Ihrer Site enthält. Sie können URL oder Pfad eingeben (Pfad wie oben vom Verzeichnis des Mailformulars aus), und können wählen, ob der Balken links oder oben erscheinen soll.
Titel ist eine Zeile, die über dem Formular erscheint und auch in der Titelleiste des Browser-Fensters.
Empfänger-Email: Die Email-Adresse, an die die Nachricht gehen soll. Diese Adresse wird im Mailformular nicht sichtbar.
Empfänger-Name: Tragen Sie in der zweiten Spalte die Bezeichnung ein, die im Mailformular erscheinen soll, z.B. An:, Nachricht an:, Abteilung:. Tragen Sie den Namen in der dritten Spalte ein. Der Name wird in einem Eingabefeld erscheinen, das schreibgeschützt ist, kann also vom User nicht geändert werden.
Absender-Name: Tragen Sie in der zweiten Spalte eine passende Bezeichnung ein: z.B. Absender-Name:, Ihr Name:. Klarerweise können und brauchen Sie in der dritten Spalte nichts einzutragen.
Absender-Email: Tragen Sie in der zweiten Spalte eine Bezeichnung ein, in der dritten Spalte nichts.
Betreff: Tragen Sie in der zweiten Spalte eine Bezeichnung ein, z.B. Thema:, Betreff:, Subject:. In der dritten Spalten können Sie einen voreingestellten Betreff eintragen. In der vierten Spalte können Sie einen Schreibschutz hinzufügen. Wenn Sie den anklicken, kann die Userin den Betreff nicht ändern und nichts hinzufügen.
Kopie?: Tragen Sie in der zweiten Spalte eine Frage ein, ob der User eine Kopie seiner Nachricht an seine Email-Adresse zugeschickt haben möchte.
Nachricht: Tragen Sie in der zweiten Spalte eine Bezeichnung ein. In der dritten Spalten können Sie eine voreingestellte Nachricht festlegen. In der vierten Spalte können Sie die Nachricht als schreibgeschützt definieren. Tun Sie das nur, wenn Sie einen guten Grund dafür haben. Wenn Sie Ihre UserInnen verprellen wollen, lassen Sie die Spalte leer und fügen Schreibschutz hinzu.
Danke-Meldung: Erscheint, nachdem der User seine Meldung abgeschickt hat.
Autoresponder Absender: Tragen Sie den Absender-Namen ein, der in der automatischen Antwort bzw. in der Nachrichtenkopie für den User erscheinen soll. Wenn Sie keinen Namen eintragen, wird der Empfänger-Namen (Punkt 6) verwendet.
Autoresponder Email: Tragen Sie die Email-Adresse ein, die als Absender der automatischen Antwort bzw. in der Nachrichtenkopie für die Userin erscheinen soll. Bedenken Sie, dass manche Mail-Filter Mails nicht weiterleiten, wenn als Absender eine nicht-existente Email-Adresse angegeben ist. Wenn Sie nichts eintragen, wird die Empfänger-Adresse (Punkt 5) benutzt.
Autoresponder Nachricht: Tragen Sie die Nachricht ein, die als automatische Antwort geschickt werden soll. Wenn Sie nichts eintragen, wird keine automatische Antwort geschickt.
Durchschlag: Tragen Sie eine Email-Adresse ein, wenn ein Durchschlag der Nachricht an einen zweiten Empfänger geschickt werden soll. Wenn Sie nichts eintragen, wird kein Durchschlag geschickt.
Die letzten Punkte sind Fehlermeldungen, die erscheinen, wenn das Mailformular nicht korrekt ausgefüllt wird. Sie können Sie dem Stil Ihrer Website anpassen bzw. in andere Sprachen übertragen.