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:
- user_optin, lostpassword
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.