[ ]  Das IBPS E-C@rd Modul - Anleitung

1. Installation
Die Dateien werden einfach entsprechend den Verzeichnissen entpackt. Es entsteht ein Verzeichnis '_ecards' und zwei Unterverzeichnisse, '_ecard_images', '_templates'.

2. Konfiguration
Beim diesem E-Card Modul muß nur ein Ausdruck im einem Skript angepasst werden:

• Datei ecard_preview.php
  Hier muß nur der der Pfad zur Fehler-Seite angepasst werden. Diese muß nicht zwingend im Verzeichnis '_templates' liegen
   

3. Integration in die Website

• E-Card Motive
  Alle E-Card Motive, egal ob kleine Vorschau oder die Version zum Versenden, werdem im Verzeichnis '_ecard_images' abgelegt. Das Skript referenziert nur auf dieses Verzeichnis.
  
  
• Übersichtsseite der E-Card Motive (hier die Datei ecards.php)
  Diese Datei kann beliebig gestaltet werden, da die Motive nur durch folgenden Link an die Eingabemaske übergeben werden:
        
  <A HREF="ecard_form.php?pic=name_of_pic.jpg"><IMG SRC="_ecard_images/name_of_small_pic.gif"></A>
       
  Welche Bildgrößen Sie verwenden wollen, bleibt Ihnen überlassen.
  
  
• E-Card Formular (hier die Datei ecard_form.php)
  In dieser Datei können Sie die maximale Textlänge für den Text auf der E-Card, sowie die Fehlertexte definieren. Wer mit HTML/ PHP vertraut ist, kann auch dieses Formular vollständig verändern. Wichtig sind folgende Einstellungen:
  
  

  $max_length		Länge des Textes auf der E-Card (Default 255)
  $msgTextError1		Fehlertext bei technischen Fehlern (z.B. Versendefehler)
  $msgTextError2		Fehlertext bei Eingabefehlern
  $ecard_PLAIN_data		Mailtext für nicht HTML-fähige E-Mail Clients

  
  Sollte der Name der Templates für die E-Cards verändert werden, so muß der folgende Input-Tag angepasst werden. Der Ablageort der Templates ist das Verzeichnis '_templates'.
   
  <INPUT TYPE="hidden" NAME="ecard[template_name]" VALUE="templateName.tpl">
  
  'templateName.tpl' bezeichnet hier den Dateinamen des Templates. Der Name ist beliebig wählbar.

4. Templates
Die Gestaltung der Templates ist völlig frei. Doch sollten Sie bei der Gestaltung der Templates auf folgende Punkte zu achten:

• Die Dateigrößen der E-Card Motive. Sie diese sehr groß, dann erhöht sich die Übertragungszeit der E-Cards um ein Vielfaches.
• Sollten Sie zusätzlich Grafiken im Template einbinden, müssen diese relativ vom Root-Verzeichnis aus referenziert sein, da sie sonst nicht gefunden werden. Verwenden Sie nicht zu viele Grafiken (s.o.).

Es stehen folgende Platzhalter zur Verfügung, um Daten aus dem Formular in das Template einzutragen:

<%ecard_sender_email%>		E-Mail Adresse des Absenders
<%ecard_sender_name%>		Name des Absender
<%ecard_reciepient_email%>		E-Mail Adresse des Empfängers
<%ecard_reciepient_name%>		Name des Empfängers
<%ecard_image_name%>		Filename der Grusskarte (wird in einen Image-Tag im SRC-Attribut eingesetzt)
<%ecard_message%>		Nachricht der E-Card

5. Fehler/ Verbesserungen
Sollten Fehler bei Benutzung dieses Skriptes auftreten, bitte uns diese sofort melden (info@ibps-friedrichs.de). Wir werden versuchen diese Fehler so schnell wie möglich zu beseitigen. Bei Verbesserungen am Skript, bitten wir darum uns diese ebenfalls 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.

7. Hinweis
Das Modul verwendet die HTML Mime mail class von Richard Heyes als Basis zum Versenden der HTML-Mails. Diese Klasse hat sich als ausgesprochen flexibel für diesen Zweck erwiesen. Weitere Infos zu dieser Klasse finde Sie unter http://www.phpguru.org/.

8. Versionshinweise

• V 1.01
  • Mailtext für nicht HTML-fähige Clients jetzt in der Datei ecard_form.php editierbar
  • Vierstellige TLDs werden jetzt auch verarbeitet