cts projects and software logo

E-Mail konfigurieren

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.

Impressum | Datenschutz-Erklärung | AGB | Kontaktformular | ©2008 cts projects&software