Zu dieser Webseite gehört auch ein in Jlog eingebundenes Kontaktformular, welches des Öfteren auch nachgefragt worden ist. Hiermit möchte ich dem nun nachkommen ud dieses Stück Code der Öffentlichkeit zur Verfügung stellen:
- Voraussetzungen zum Betrieb
- Funktionsweise
- Konfiguration
- Zusammenspiel mit Jlog
- Download/Quellcode
- Beschreibung der sendMail-Schnittstelle
- Lizenz
- Bugs, Kontakt
Hinweis zur neuesten Version (5. April 2008)
Voraussetzungen zum Betrieb
- Jlog 1.1.0 oder höher
- PHP ab Version 4.3
- funktionierende
mail()-Funktion oder MySQL-Datenbank - QuizSession-Bibliothek
- In der hier verwendeten Fassung:
- Content Negotiation (
Option +MultiViews)
- Content Negotiation (
Funktionsweise
Das Kontaktformular ist bewusst einfach gehalten, bietet allerdings über die Funktion sendMail(), die dem Skript zur Verfügung gestellt werden muss, eine flexible Schnittstelle zum Senden oder Speichern von Emails. Mit Hilfe der QuizSession-Bibliothek verfügt es darüber hinaus über einen simplen aber wirkunsvollen Spamschutz.
Zur Installation reicht es aus, die Datei kontakt.php irgendwo in der Document-Root abzulegen und die Include-Pfade anzupassen.
Konfiguration
Neben der Wahl eines Moduls zum Versenden von Emails und dem Anpassen des Pfades hierzu müssen im Skript noch folgende Dinge für den jeweiligen Zweck angepasst werden:
- Standard-Absender-Adresse falls der Absender keine Emailadresse angibt (Konstante MAIL_DEFAULT_FROM).
- Emfängeradresse (Konstante MAIL_TO).
- Titel (Variable $c['meta']['title'])
- Optionale Überschrift (z.B.
$c['main'] =)'<h2>Kontakt mit ...</h2>';
Zusammenspiel mit Jlog
TODO, siehe Jlog als CMS
Download/Quellcode
Zum Kontaktformular gehören folgenden Dateien:
- kontakt.php zum Herunterladen
- Hauptdatei des Kontaktformulars.
- mail.php zum Herunterladen
- Beispiel-Wrapper der Funktion
sendMail()fürmail().
Beschreibung der sendMail-Schnittstelle
bool sendMail($fromName, $fromAddr, $toAddr, $subj, $text);Parameter
- $fromName
- Name des Absenders
- $fromAddr
- Emailadresse des Absenders; Standardwert: MAIL_DEFAULT_FROM
- $toAddr
- Emailadresse des Empfängers, entspricht bei kontakt.php dem Wert MAIL_TO
- $subj
- Betreff der Nachricht
- $text
- Text der Email
Rückgabewerte
Gibt im Erfolgsfall TRUE, ansonsten FALSE zurück.
Lizenz
Copyright © 2007 - 2008 Robert Bienert, alle Rechte vorbehalten
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Bugs, Kontakt
Es kann nicht ausgeschlossen werden, dass die Pinnwand Bugs enthält. Momentan existiert kein Bugtracker, allerdings können Fehler oder Anregungen jederzeit per Email (Adresse im Impressum) gemeldet werden.