Email-Konfiguration
Ab Version 2.0 befinden sich die Emailtexte in Templates im Unterverzeichnis /emailtemplates. Innerhalb dieses Verzeichnisses sind die einzelnen Vorlagendateien unterteilt in /html- und /plain- (Nur-Text) E-Mails. Es gibt verschiedene Templates, deren Benennung wie folgt lauten muss:
- response (Für Kontaktaufnahme durch einen Anzeigenleser zu dem Inserenten)
- tellad (Für die Weiterempfehlung einer Anzeige an einen Freund)
telladcomplete (Für die vollständige Weiterempfehlung; Wegfall ab Version 4.5) - releasesubmit (Freischaltungs-/Informations-Email bei Aufgabe einer Anzeige)
- lostpassword (Für Neuzusendung eines verlorenen Benutzerpassworts)
- useroptin (Opt-in Email; Bestätigung der Benutzer-Email und Aktivierung des Benutzerkontos)
- contact (Allgemeiner Kontakt über das Kontaktformular)
Angehängt wird jeweils ein .GER für die deutsche Fassung bzw. ein .ENG für die englische Fassung. Bitte beachten Sie auf Unix-basierten Systemen dass die Darstellung in Grosschreibung erfolgen muss, da das FileSystem "case-sensitiv" arbeitet. Weitere Sprachfassungen erhalten analog ein sinnvolles Kürzel. Siehe Customizing von Sprachfassungen.
Die Editierung kann mit einem einfachen Texteditor wie z.B. dem Notepad bzw. mit einem speziellen HTML-Editor (z.B. Macromedia Dreamweaver) erfolgen. Platzhalter werden zur Kenntlichmachung in geschweifte Klammern eingeschlossen. Zum Beispiel:
Diese Email wurde von {DomainName} um {DateTime} geschrieben.
Übersicht der Email-Platzhalter
Folgende variable Elemente (Platzhalter) können in den Text eingebaut werden:
Globale Platzhalter
Globale Platzhalter sind in allen E-Mail-Vorlagen verfügbar, die von ClassAd versendet werden.
| Platzhalter |
Verwendungszweck |
| DomainName |
Web-URL
z.B. www.xyz.com |
| IndexLink |
Vollständige URL zur Startseite
z.B. http://www.xyz.com/index.php |
| NewAdLink |
Vollständige URL zur Anzeigenaufgabe
z.B. http://www.xyz.com/newad.php |
| AdminLink |
Vollständige URL zur Administrations-Oberfläche
z.B. http://www.xyz.com/admin.php |
| PicActiveLink |
Vollständige URL zur Freischaltung von Bildern (Adminbereich)
z.B. http://www.xyz.com/picturerelease.php |
| DateTime |
Aktuelles Datum und Zeit (sprachspezifisch formatiert) |
| IpAddress |
IP-Adresse des zugreifenden Clients |
| Version |
Version des Kleinanzeigenmarktes |
| Program |
Programmname
cts ClassAd |
| ProviderShortInfo |
Betreiber-Kurzinformation; siehe Konfiguration |
Anzeigenspezifische Platzhalter
Anzeigenspezifische Platzhalter sind dort verfügbar, wo eine versendete E-Mail sich auf eine bestimmte Anzeige bezieht. Im Einzelnen können die Variablen in folgenden Vorlagen verwendet werden:
- response, tellad, releasesubmit
| Platzhalter |
Verwendungszweck |
| AdId |
Eindeutige Anzeigen-Identifikationsnummer |
| AdTitle |
Anzeigentitel |
| AdCategory |
Anzeigenrubrik
z.B. Mobilfunk-Artikel |
| AdText |
Vollständiger Text der Anzeige |
| AdLink |
Vollständige URL zur Anzeige
z.B. http://www.xyz.com/classifieds/showad.php?adid=83763 |
| AdInDate |
Einstelldatum der Anzeige (sprachspezifisch formatiert) |
| AdOutDate |
Auslaufdatum der Anzeige (sprachspezifisch formatiert) |
| AdName |
Name des Inserenten |
| AdZip |
Postleitzahl |
| AdCountry |
Landeskürzel
z.B. D |
| AdCountryLong |
Land
z.B. Deutschland |
| AdIpAddress |
IP-Adresse mit der die Anzeige aufgegeben wurde
z.B. 127.0.0.1 |
| AdViews |
Anzahl der Anzeigenansichten (Views) |
| AdContacts |
Anzahl der Anzeigenkontakte |
| AdTells |
Anzahl der Weiterempfehlungen |
| AdEmail |
E-Mail-Adresse |
| AdFax |
Faxnummer |
| AdPhone |
Telefonnummer |
| AdMobile |
Mobilfunknummer |
| AdHomepage |
Homepage-Link
z.B. http://www.projects-and-software.de |
| AdIcq |
ICQ-Nummer |
| AdAim |
AOL-Screenname |
| AdSkype |
Skype-Id |
| AdMsn |
MSN-Id |
| AdYahoo |
Yahoo-Id |
| AdAgeRestricted |
Anzeige der geschlossenen Benutzergruppe
gibt einen boolean (true/false)-Wert zurück, sollte mit Entscheidungsfunktion genutzt werden (siehe unten) |
| AdFeatured |
Anzeige ge-featured ("besondere Anzeige")
gibt einen boolean (true/false)-Wert zurück, sollte mit Entscheidungsfunktion genutzt werden (siehe unten) |
| AdType |
Anzeigentyp
gibt einen numerischen Wert zurück |
| AdTypeLong |
Anzeigentyp in Volltext
gibt Angebot | Gesuch | Verschiedenes zurück |
Benutzerspezifische Platzhalter
Platzhalter für Benutzer sind dort verfügbar, wo versendete E-Mails sich auch Benutzerspezifische Aktionen beziehen. Im Einzelnen können die Variablen in folgenden E-Mail-Vorlagen verwendet werden:
| Platzhalter |
Verwendungszweck |
| UserId |
Eindeutige Benutzer-Identifikationsnummer |
| UserRealname |
Benutzer Vor- und Nachname |
| UserName |
Benutzer Anmeldename |
| UserTitle |
Benutzer Anrede |
| UserAddress1 |
Adresszeile 1 |
| UserAddress2 |
Adresszeile 2 |
| UserCountry |
Landeskürzel der Adresse
z.B. D |
| UserCountryLong |
Landesname der Adresse
z.B. Deutschland |
| UserCity |
Ort |
| UserZip |
Postleitzahl |
| UserTel |
Telefonnummer |
| UserFax |
Faxnummer |
| UserEmail |
Email-Adresse |
| UserYahoo |
Yahoo-Id |
| UserMsn |
Msn-Id |
| UserSkype |
Skype-Id |
| UserYahoo |
Yahoo-Id |
| UserHomepage |
Vollständige Homepage-URL
z.B. http://www.projects-and-software.de |
| UserMobile |
Mobilfunk |
| UserAgeChecked |
Benutzer mit Berechtigungen für die geschlossene Benutzergruppe
gibt einen boolean (true/false)-Wert zurück, sollte mit Entscheidungsfunktion genutzt werden (siehe unten) |
| UserRights |
Benutzerrechte
gibt einen numerischen Wert zurück |
Bildlisten-Platzhalten
Insbesondere für HTML-Emails sind Bildlisten-Platzhalter ein interessantes Gestaltungsmittel im anzeigenbezogenen Kontext. Die entsprechenden Platzhalter sind in folgenden Vorlagendateien verfügbar.
- response, tellad, releasesubmit
| Platzhalter |
Verwendungszweck |
| PicturesAttached |
Anzahl der angefügten Bilder
gibt einen numerischen Wert zurück |
| PicInfoFull |
Voransichtsbilder der Anzeige
gibt div-Elemente zurück, die den vollständigen Link zu einer image-Datei enthalten zurück
z.B. <div><img src=""></div><div><img src=""></div> |
| PicInfoPlain |
|
Platzhalter für spezielle Aufgaben
Für spezielle Anwendungsfälle werden von ClassAd innerhalb bestimmter Vorlagen, spezifische Platzhalter bereitgestellt. Die folgende Tabelle listet diese Platzhalter auf und beschreibt Ihren Verfügbarkeitsbereich.
| Platzhalter |
Verwendungszweck |
Verfügbar in |
| ReleaseLinkComplete |
Komplette URL zur Freischaltung des Benutzerkontos durch Klick auf den Link
z.B. http://www.xyz.com/classifieds/releasesubmit.php?... |
user_optin |
| ReleaseCode |
Code, der zur Freischaltung eines Benutzers notwendig ist |
user_optin |
| ReleaseLink |
Link zur Freischaltseite (vollständige URL)
z.B. http://www.xyz.com/classifieds/releasesubmit.php |
user_optin |
| ContText |
Kontaktinformationen; Mitteilung eines Kontaktierenden |
response |
| ContName |
Kontaktinformationen; Names des Kontaktierenden |
response |
| ContCountry |
Kontaktinformationen; Land des Kontaktierenden |
response |
| ContZip |
Kontaktinformationen; PLZ des Kontaktierenden |
response |
| ContCity |
Kontaktinformationen; Ort des Kontaktierenden |
response |
| ContPhone |
Kontaktinformationen; Telefon des Kontaktierenden |
response |
| ContFax |
Kontaktinformationen; Fax des Kontaktierenden |
response |
| ContEmail |
Kontaktinformationen; E-Mail des Kontaktierenden |
response |
| FriendEmail |
E-Mail-Adresse der Empfehlungszielperson |
tellad |
| AdTellerName |
Name des Empfehlenden |
tellad |
| AdTellerMail |
E-Mail-Adresse des Empfehlenden |
tellad |
| AdTellerMessage |
Nachricht des Empfehlenden für die Zielperson |
tellad |
| NewPassword |
Neues Passwort des anfordernden Benutzers |
lostpassword |
| ReleaseLink |
Freischaltlink für Administratoren, um Benutzer freizuschalten |
releasesubmit |
| ContTitle |
Anrede des Kontaktierenden |
contact |
| ContName |
Name des Kontaktierenden |
contact |
| ContEmail |
Email des Kontaktierenden |
contact |
| ContText |
Nachricht des Kontaktierenden |
contact |
Spezielle Platzhalterfunktionen zur einfachen Flusssteuerung
In kleinem Rahmen implementiert ClassAd eine Möglichkeit, alternative Texte darzustellen oder Textblöcke auszublenden. Hierfür wird folgende Syntax verwendet:
{if UserAgeChecked}Das ist ein Text, der nur angezeigt wird, wenn der Benutzer Mitglied der geschlossenen Benutzergruppe ist.{/if}
{iif AdFeatured}Die Anzeige ist ge-featured!{else}Normale Anzeige, nicht ge-featured{/iif}
{if AdAgeRestricted}Auch
mehrere
Zeilen
sind möglich!{/if}
Beachten Sie, dass die Prüfvariable TRUE oder FALSE zurückgeben muss. Folgende Variablen können aktuell verwendet werden:
- UserAgeChecked
- AdFeatured
- AdAgeRestricted
Im Moment sind leider nur wenige Anwendungsbereiche möglich, in Zukunft sollen aber auch komplexere Anwendungen möglich gemacht werden.
