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.