[ ] Die IBPS MIni Module - Recom Modul
Die Dateien werden einfach entsprechend den Verzeichnissen entpackt. Es entsteht ein Verzeichnis '_recom' und ein Unterverzeichnis '_templates'.
2. Konfiguration
Folgende Ausdrücke müssen in der Datei ibps_recom.php angepasst werden:
| $http_server | Hier wird die Domain oder die IP-Adresse des Servers eingetragen. | |
| $dirRecom | Dies ist der Pfad zum Recom Modul, relativ vom Root-Verzeichnis. | |
| $defaultMail | Default Absende-E-Mail-Adresse des Skriptes, falls keine im Formular angegeben wurde. | |
| $defaultURL | Default URL, falls keine URL von Formular übergeben wurde. Diese wird dann als empfohlener Link in die Nachricht eingefügt. | |
| $defaultMailTpl | Default E-Mail-Template, falls keines im Formular angegeben wurde. | |
| $defaultSuccessTpl | Default-Template für die HTML-Seite, welchen bei erfolgreicher Versendung angezeigt werden soll. |
Die drei Variablen $defaultMail, $defaultURL, $defaultMailTpl und $defaultSuccessTpl können durch Werte aus dem Formular geändert werden. Weitere Angaben dazu im Punkt 3.
3. Integration in die Website
In der HTML-Seite, welche empfohlen werden soll, müssen folgende Einträge eingefügt werden:
a) eine Javascript-Funktion zum Aufruf des Skriptes
function RecomPage() {
scriptName = "/_recom/ibps_recom.php?url=" + window.location.href;
window.open(scriptName, "RecomPage", "width=450,height=550");
}
b) der Aufruf des JS-Skriptes
<A HREF="javascript:RecomPage();">Seite empfehlen</A>
Folgende Tags können noch zum Eingabeformular in der Datei ibps_recom.php hinzugefügt werden:
<INPUT TYPE="hidden" NAME="url" VALUE="yourURL">
Dieser Tag übergibt die URL. Die Bestimmung kann mit Javascript, PHP oder sonstigen Funktionen geschehen. Der Tag ist optional.
<INPUT TYPE="hidden" NAME="mailTemplate" VALUE="_templates/yourMailTemplate.tpl">
Mit diesem Tag kann das E-Mail-Template angegeben werden. Der Tag ist optional.
<INPUT TYPE="hidden" NAME="successTemplate" VALUE="_templates/yourSuccessTemplate.htm">
Mit diesem Tag kann die Datei vorgegeben werden, welche nach erfolgreicher Versendung angezeigt werden soll. Der Tag ist optional.
<INPUT TYPE="text" NAME="sender_name" VALUE="senderMailAdress">
Dieser Tag übergibt die E-Mail-Adresse des Absenders. Es kann sowohl ein Hidden-Tag, als auch andere Formular-Tags verwendet werden. Die verwendete E-Mail-Adresse wird im Skript auf Gültigkeit überprüft. Der Tag ist optional.
Wer sich mit HTML und PHP ein wenig auskennt, kann das Eingabeformular leicht an das eigene Layout anpassen.
4. Templates
Es können mehrere Mail-Templates eingesetzt werden. Diese müssen dann im Formular mit dem entsprechenden Tag (s.o.) angegeben werden. Da die Empfehlung als Text-Mail versendet wird, kann im Template kein HTML eingesetzt werden. Um Angaben aus dem Formular in das Mail-Template zu integrieren, stehen folgende Platzhalter zur Verfügung:
| <%sender_email%> | E-Mail Adresse des Absenders. | |
| <%sender_name%> | Name des Absenders. | |
| <%recipient_email%> | E-Mail Adresse des Empfängers. | |
| <%recipient_name%> | Name des Empfängers. | |
| <%url%> | URL des empfohlenen Dokumentes. | |
| <%message%> | Nachricht des Absenders. |
Das Mail-Template ist frei gestaltbar. Achten Sie jedoch auf die Anzahl der Zeichen pro Zeile. Mehr als 60 Zeichen pro Zeile sind nicht empfehlenswert, da sonst in einigen E-Mail-Clients die Zeilen umgebrochen werden und damit das Mail-Design zerstört wird.
5. Fehler/ Verbesserungen
Sollten Fehler bei Benutzung dieses Skriptes auftreten, bitte uns diese sofort melden (info@ibps-friedrichs.de). Wir werden versuchen diesen Fehler so schnell wie möglich zu beseitigen. Bei Verbesserungen am Skript, bitten wir darum, uns diese mitzuteilen, damit wir diese für alle anderen Nutzer des Skriptes verfügbar machen können.
6. Nutzung
Das Skript kann frei genutzt bzw. modifiziert werden. Der Copyright-Hinweis muß aber erhalten bleiben. IBPS Friedrichs übernimmt keinerlei Haftung von Schäden, die durch Verwendung dieses Skriptes oder Teilen des Codes entstehen. Der Verkauf des Source-Codes dieses Skriptes ohne schriftliche Einwilligung von IBPS Friedrichs ist nicht erlaubt.
Bitte teilen Sie uns mit, auf welcher Website Sie dieses Skript einsetzen. Wir werden auf unserer Seite einen entsprechenden Link auf Ihre Seite setzen.
