Einrichtung eines Newsletters mit Direct Mail

Um die Extension Direct Mail zu installieren habe ich mich im Großen und Ganzen an folgende sehr gute Anleitung gehalten: Anleitung auf www.sk-typo3.de. Ein paar Dinge musste ich aber anpassen und deswegen habe ich mich entschieden ein kleines Tutorial zu erstellen.

Benötigte Extensions

Um Direct Mail zu Laufen zu bringen, werden folgende Extensions benötigt. Wie gewöhnlich in der unten angeführten Reihenfolge mit dem Extension Manager installieren.

• Address List (tt_address)
• Direct Mail (direct_mail)
• Direct Mail Subscription (direct_mail_subscription)

Sysordner anlegen

Die Extension Direct Mail benötigt zumindest 2 Sysordner: Einen um darinnen die Newsletter zu erstellen und eine zweiten um die Newsletter Adressen zu speichern.

Da das Aussehen des Newsletters unabhängig von der Website ist, wird der erste Sysordner auf der Rootline erstellt. Das Haupttemplate der Rootseite (bei mir "ARGE SVA Startpage") greift somit nicht und es kann problemlos ein eigenes Template erstellt werden.

Danach werden die Seinteneigenschaften des Sysordners Newsletter angepasst. Dort unter dem Punkt "Enthält Erweiterung" die Erweiterung "Direct Mail" angeben.

Der zweite Sysordner (bei mir "Adressen") befindet sich in dem Newsletter Ordner. Dort werden später die Datensätze mit den Abonnenten zu finden sein. Da es in meinem Fall mehrere Kategorien von Adressen gibt, habe ich noch zusätzlich Unterordner angelegt (Adr. Web und Adr. Pfarren).

Anmeldung für den Newsletter

Unterhalb des regulären Seitenbaums wird eine Seite angelegt auf der man sich für den Newsletter kann.

Dort wird die Erweiterung "Direct Mail Anmeldung" als Inhaltselement eingefügt.

Als Ausgangspunkt (dort werden Adressen gespeichert und gesucht) wird der Sysordner "Adressen" angegeben.

Als nächstes empfiehlt es sich das HTML-Template für die Newsletteranmeldung (typo3conf/ext/direct_mail_subscription/pi/fe_admin_dmailsubscrip.tmpl) in den "fileadmin" Ordner zu kopieren. Man kann danach das HTML-Template bearbeiten ohne im Ordner der Erweiterung etwas verändern zu müssen. Bei mir liegt das HTML-Template nun hier: fileadmin/templates_ext/newsletter_subscription.html

Die wichtigsten Einstellungen für die Newsletter Anmeldung lassen sich bequem über den Constant Editor erledigen. Dazu geht man in das Haupttemplate der Seite und wählt im Constant Editor die Seite PLUGIN.FEADMIN.DMAILSUBSCRIPTION.


Folgende Einträge sollten vorgenommen werde:

• Administration email: Emailadresse des Admin/Absenders
• Administration name: Name des Admin/Absenders
• Record PID: Sysordner in dem die Anmeldungen gesammelt werden (bei mir "Adressen")

Anschliessend werden die Constants unter Info/Modify aufgerufen und der Ort des eigenen HTML-Templates wird angegeben.

plugin.feadmin.dmailsubscription.file.templateFile = fileadmin/templates_ext/newsletter_subscription.html

Ab dann kann man kann das HTML-Template in einem Editor bearbeiten und nach belieben anpassen.

Damit ist die Anmeldung funktionsfähig und es sollte möglich sein sich probeweise beim Newsletter anzumelden. Nach erfolgreicher Anmeldung sollte ein neuer versteckter Datensatz im SysOrdner "Adressen" auftauchen und der Abonnent müsste ein Email mit dem Aktivierungslink erhalten haben. Der Eintrag wird erst sichtbar, sobald der  Abonnent auf den Aktivierungslink in dem Email klickt.

Typoscript Template für den Newsletter einrichten

Da der Newsletter für gewöhnlich ein anderes Aussehen als die Hauptseite hat, wird dafür ein eigenes Typoscript Template benötigt. Zu diesem Zweck wird für den Sysordner "Newsletter" ein neues Typoscript Template (Create template for a new site) angelegt. Das Template wird nach belieben benannt und es werden folgende Module unter "Include Static (from Extension)" eingebunden:

• CSS Styled Content: gewöhnliche Seitenausgabe (HTML-NEwsletter)
• Direct Mail Plain Text: Inhalt für die Plain Text-Emails erzeugen
• Direct Mail Content Boundaries

Dieses Template hat die Optionen "Clear Setup" und "Clear Constants" ausgewählt, um zu gewährleisten, dass keine Einstellungen des Haupttemplates vererbt werden.

Newsletter HTML Template einbinden

Der Newsletter ist eine ganz gewöhnliche Typo3 Seite, welche im Sysordner "Newsletter" erzeugt wird. Diese Seite kann ganz nach belieben mit den üblichen Typo3 Werkzeugen aufgebaut werden. Entweder man benutzt dafür ein reines Typoscript-Template wie in dem Beispiel auf www.sk-typo3.de, oder man bindet wie in meinem Beispiel eine HTML Vorlage ein:

#################
### CONSTANTS ###
#################

# Define Link Target
PAGE_TARGET = _self

# Allgemeiner Pfad
path = fileadmin/templates/newsletter/

#############
### SETUP ###
#############

##################################
### ALLGEMEINE KONFIGURATIONEN ###
##################################

config {
    #### LANGUAGE ####
    htmlTag_langKey = de-DE
    language = de
    locale_all = de_DE
   
    #### DOCTYPE XHTML ####
    doctype = xhtml_trans
    xhtml_cleaning = all
   
    #### REALURL ABSCHALTEN ####
    baseURL = 0
    tx_realurl_enable = 0
}

# Seitentitel anpassen
temp.pageTitle = TEXT
temp.pageTitle.value = <title>Newsletter</title>
page.headerData.10 < temp.pageTitle
config.noPageTitle = 1

# top Anker einstellen
tt_content.stdWrap.innerWrap2 = |<div class="top_anker"><a href="#">nach oben</a></div>

############################
### SEITEN KONFIGURATION ###
############################

page = PAGE
page {   
    # typeNum festlegen
    typeNum = 0
   
    # Stylesheet einbinden
    stylesheet = {$path}styles.css
   
    # Designvorlage einbinden
    10 =  TEMPLATE
    10.template = FILE
    10.template.file = {$path}newsletter_template.html
   
    10.workOnSubpart = DOKUMENT
    10.marks {
        # Inhaltselemente
        CONTENT < styles.content.get
    }
}

Nachdem ein funktionsfähiges Template erstellt wurde, kann man Newsletter Seiten direkt im Sysordner "Newsletter" oder über das Direct Mail Modul erstellen. Dazu auf Direct Mail klicken, dann in der mittleren Spalte den Sysordner "Newsletter" auswählen. Danach auf folgenden Link klicken: "Klicken Sie hier, um eine neue Typo3-Seite, die Sie später als Newsletter verschicken können, anzulegen. ". Die Seite wird benannt, gesichert und Inhaltselemente können nach belieben angelegt werden. Wenn alles richtig funktioniert hat, sollte man den Newsletter anhand der Seiten ID mit einem Webbrowser aufrufen können. Das Plain-Text Rendering überprüft man, indem man die URL mit dem Zusatz "&type=99" aufruft.

Newsletter versenden

Nun kann der Newsletter auch schon versendet werden. Dies geschieht wieder über das Modul "Direct-Mail > Direct-Mail". Ein sehr übersichtlicher Assistent führt hier durch alle 5 Schritte. Am besten die  einzelnen Menüpunkten von DirectMail anklicken und sich damit vertraut machen. Die meisten Punkte sind selbsterklärend und übersichtlich gegliedert. Im nächsten Blogbeitrag werde ich noch ein paar zusätzliche Einstellungen beschreiben und versuche zu erklären, wie ich mit der Erweiterung SL direct_mail Return die Analyse der nicht zustellbaren Emails aktiviert habe.