Deutsches Handbuch Direct Mail

Copyright

Extension Key: tut_de_direct_mail

Copyright 2007, <acherzog@web.de>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents

Einführung	3

Was beinhaltet die Extension?	3

Anforderungen	3

Benutzerhandbuch	4

Zusammenfassung des Direct Mail Prozesses	4

1. Newsletter anlegen	4

2. Kategorisierung der Content Elemente	4

3. Direct Mail anlegen	4

4. Eine Empfängerliste anlegen	4

5. Einen Test versenden	4

6. Mailer Engine aufrufen	4

7. Status von Massen-Emails anzeigen	4

Anlegen des Direct Mail Modules	5

Das Modul Funktionsmenu	5

1. Newsletter	5

2. Direct Mail	5

3. Empfängerlisten	5

4. Mailer Engine Status	5

5. Quickmail	5

6. Kategorie - Konvertierung	6

7. Modul-Konfiguration	6

Das Optionsmenu der Direct Mail Funktionen	6

1. Fetch and compile mail content: Abrufen und zusammenstellen von Mail Inhalten	6

2 Testmail senden	6

3 Massenversand	6

4 Statistiken dieser Mail ansehen	6

Personalisierung von Direct Mail Inhalten	7

Kategoriesierung des Newsletter Inhaltes	8

Typen von Empfängerlisten	8

1. Aus/von Seiten (From pages)	8

2. Plain Text	9

3. Statische Listen	9

4. Spezielle Abfragen	9

5. Aus anderen Empfängerlisten	9

CSV Import von Emailadressen	9

Konfiguration	10

Installation der Extension	10

Einen Direct Mail Ordner anlegen	11

Konfiguration in der Page TSConfig	11

Konfigurierung des TS Templates für Newsletter – Seiten	16

Konfiguration der der Plain Textausgabe	17

Constants	17

Setup	17

Konfiguration der Plain Text Wiedergabe von News Datensätzen	20

Setup	20

Konfiguration der Kategorien	21

Setup	22

Aktivierung der Klick-Statistiken	23

Konfiguration des Backend-Benutzerzugangs zu Direct Mail Funktionen	24

Konfiguration des mailer engine cron task	24

Nutzung von Sendmail im Verzögerungsmodus	25

Konfiguration der Analyse zurückgesandter Mails	26

Upgrading auf Version 2.0+	27

Troubleshooting	29

Direct Mails werden nicht versendet	29

Massen Mails werden nur übergeben, nachdem eine andere Mail vom selben MAC OS X Server gesendet wurde	29

Bekannte Probleme	31

Tutorial	32

Installation	32

Sysordner erstellen	32

Newsletter erstellen	36

Template	37

Konfiguration der Kategorien	37

Newsletter versenden	38

Empfänger erstellen	38

Testmail versenden	41

Massenversand	41

Versand manuell anstoßen	42

plain text content could not be fetched	42

HTML Mail – Ansicht des Newsletters	42

Plain Text Ansicht der Seite	43

Personalisierte Emails	44

Einbinden von tt_news Datensätzen	46

Zum Abschluss:	47

Versionsinformationen	48

Bekannnte Probleme	49

plain text content could not be fetched	49

Template wird nicht gefunden	49

Kategorien	49

Aufräumen	49

Static Info Tables	49

Emails Plain Text personalisieren	49

Dieses deutsche Handbuch besteht zum einen Teil aus der Übersetzung des Benutzerhandbuchs der Extensionautoren und zuim anderen aus einem Tutorial für die Step-by-Step – Installation der Extension anhand eines Beispiels. Für Hinweise und konstruktive Kritik, kontaktieren Sie mich bitte per Email.

Einführung

Was beinhaltet die Extension?

Direct Mail ist ein erweitertes Newsletter-System mit anspruchsvollen Optionen für personalisierte Emails inklusive Antwort-Statistik. Die Extension verwaltet die Backend-Generierung von Mailings und Newslettern, beinhaltet aber kein Tools zur Anmeldung. Es wird empfohlen, die Extension in Verbindung mit Frontend-Anmeldungsplugins wie Direct Mail Subscription (direct_mail_subscription), Frontendbenutzerregistrierung (sr_feuser_register) oder Email Address Subscription (sr_email_subscribe) zu nutzen.

Anforderungen

Extension Direct Mail (extension key: direct_mail) benötigt TYPO3 4.0.0+ und PHP 4.1.0+.

Version 1.1.0 ist die letzte Version, die unter TYPO3 3.8 läuft.

Die Extension Address list (tt_address) ist wird zusätzlich benötigt.

Benutzerhandbuch

Zusammenfassung des Direct Mail Prozesses

Mit Direct Mail können Sie Newsletter-Seiten anlegen, die Abonnenten einer Empfängerliste zugesendet werden.

Im Folgenden sind die wichtigsten Schritte dieses Prozesses beschrieben.

1. Newsletter anlegen

Normalerrweise ist ein Newsletter eine normale Seite, die sich im Direct Mail Ordner befindet. Sie können die Seite im Browser ansehen oder auch als Plain Text wiedergeben.

2. Kategorisierung der Content Elemente

Sie können den Contentelementen des Newsletters Kategorien zuordnen. Die Newsletter können damit genau auf den einen Abonnenten zugeschnitten werden, je nachdem, welche Kategorie er abonniert hat.

3. Direct Mail anlegen

Eine Direct Mail ist ein Datensatz, der eine zusammengefasste Version von entweder einer Newsletter-Seite oder den Inhalt einer externen URL enthält. Zusätzlich enthält eine Drect Mail Informationen wie den Email-Betreff, Anhänge, Prioritätseinstellungen, Antwortadressen etc. Für jede Direct Mail wird geloggt, wer die Email empfangen hat und ob darauf reagiert wurde.

4. Eine Empfängerliste anlegen

Es gibt eine ganze Reihe von Möglichkeiten, Empfängerlisten anzulegen. Empfängerlisten sollten im Vorhinein angelgt werden. Wenn benötigt, können sie wiederverwendet werden.

5. Einen Test versenden

Sie sollten eine Testmail versenden um zu gewährleisten, dass alles auch wie gewünscht funktioniert.

6. Mailer Engine aufrufen

Hier finden Sie eine Auflistung des aktuellen Versandes der Direct Mails zu spezifischen Empfängerlisten.

7. Status von Massen-Emails anzeigen

Hier wird der Emailversand überwacht, es werden Antwortstatistiken angezeigt und hier können auch die zurückgesendeten Emails bearbeitet werden.

An jedem Punkt können Sie die kontextsensitive Hilfe aufrufen. Auch Backendformulare, um Direct Mails zu editieren enthalten diese Hilfe – ebenso die Empfängerlisten für jedes Feld.

Anlegen des Direct Mail Modules

Dazu klicken Sie die Direct Mail Option im Webmodul an. Es erscheint eine Liste von vorhandenen Direct Mail Ordnern. Klicken Sie einen Ordner an, werden Sie zu einer Seite der Extension, dem Direct Mail Modul, geleitet. Die Seiten des Direct Mail Modules verfügen über ein Funktionsmenu, das in der oberen rechten Ecke des Backends angezeigt wird.

Das Modul Funktionsmenu

Die Funktionen des Direct Mail Moduls sind die folgenden, aber ihre Verfügbarkeit kann durch die Benutzerrechte eingeschränkt sein (s. Backend Konfiguration: Benutzerzugriff zu Direct Mail Funktionen).

1. Newsletter

Mit dieser Funktion könen Sie ein Newsletter erstellen oder ein Bestehendes auswählen. Wenn Sie ein bestehendes Newsletter im Seitenbaum auswählen, können Sie das Newsletter ansehen und editieren, Kategorien hinzufügen, Direct Mails basierend auf diesem Newsletter ansehen oder ein neues Newsletter, basierend auf diesem, anlegen.

2. Direct Mail

Hier können Sie eine neue Direct Mail, basierend auf einem Newsletter oder einer externen URL anlegen. Sie können auch eine vorhandene Direct Mail ansehen und editieren. Hier können Sie aus einem Optionsmenu jede Akiton auswählen, die Sie benötigen.

3. Empfängerlisten

Diese Funktion ermöglicht Ihnen, neue Empfängerlisten anzulegen, CSV-Adressdaten zu importieren, um eine neue Empfängerliste zu erstellen, zu einem bestehenden Empfängerlisten-Formular verlinken oder eine bestehende Empfängerliste auswählen. Dies leitet Sie zu einer Ansicht, in der Sie die Anzahl aller Abonnenten jedesTyps in einer Liste vorfinden. Sie haben die Möglichkeit diese eben nur aufzulisten oder als CSV Datei herunterzuladen.

4. Mailer Engine Status

Mit Hilfe dieser Funktion können Sie den momentanen Status der Direct Mails, die für den Massenversand vorgesehen sind, ansehen und den Mailer Engine manuell aufrufen, wenn er nicht automatisch aufgerufen wird.

Wenn Sie eine der gelisteten Direct Mails aufrufen, werden Sie zu den Direct Mail Funktionen geleitet, und können dort die Statistiken betrachten.

5. Quickmail

Diese einfache Funktion ermöglicht den Versand kurzer Mitteilungen und versendet sie sofort an die Empfängerliste. Hier sind weder Newsletter noch Direct Mails einbezogen.

6. Kategorie - Konvertierung

Diese Funktion ist ein Migrationstool, das es ermöglicht, Ihre Datenbank in die neuen Direct Mail Kategorien zu konvertieren (vorgestellt in Version 2.0). Bitte lesen Sie hierzu den entsprechenden Teil des Handbuches.

7. Modul-Konfiguration

Dieses Administrationstool konfiguriert den Direct Mail Ordner. Bitte lesen Sie näheres im weiteren Verlauf dieses Handbuches.

Zu den ersten 5 oben genannten Funktionen finden Sie Unterstützung in der kontextsensitiven Hilfe.

Das Optionsmenu der Direct Mail Funktionen

Die Direct Mail Funktion besitzt ein Unter- oder Optionsmenu. Hier können Sie die Aktionen einer vorhandenen Direct Mail ausführen. Mögliche Aktionen finden Sie hier aufgeführt, aber ihr Vorhandensein hängt vom momentanen Status der Direct Mails ab.

1. Fetch and compile mail content: Abrufen und zusammenstellen von Mail Inhalten

Diese Funktion ermöglicht Inhalte abzurufen oder zu erfassen – in einem speziellen Format für spätere Mailings. Diese Aktion muss im Vorhinein durchgeführt werden - vor jeder anderen Aktion.

Sie sollten sich die Eigenschaften der Direct Mail auf dem Bildschirm ansehen und wenn nötig editieren, bevor Sie den Content abrufen.

2. Testmail senden

Senden Sie eine Testmail um sicherzustellen, dass alles auch wie gewünscht funktioniert.

3. Massenversand

Hiermit planen Sie den aktuellen Versand von Direct Mails zu einer speziellen Empfängerliste.

4. Statistiken dieser Mail ansehen

Mit dieser Option können Sie die Statistiken für diese Direct Mails und der dazugehörenden Antworten ansehen, um Aktivitäten rund um diese Mails aktivieren. Diese Option steht nur zur Verfügung, nachdem der Massenversand initiiert wurde.

Personalisierung von Direct Mail Inhalten

Sie können Ihre Mails personalisieren, indem Sie die folgenden Marker in die Inhaltselemente der Newsletterseite einbinden. Diese Marker werden durch die entsprechenden Werte jedes Empfänger-Datensatzes ersetzt, wenn die Werte verfügbar sind. Hier sehen Sie die Liste der vordefinierten Marker:

###USER_uid### (the unique id of the recipient)

###USER_name### (full name)

###USER_firstname### (first name calculated)

###USER_NAME### and ###USER_FIRSTNAME### will insert uppercase versions of the equivalents

###USER_title###

###USER_email###

###USER_phone###

###USER_www###

###USER_address###

###USER_company###

###USER_city###

###USER_zip###

###USER_country###

###USER_fax###

###SYS_TABLE_NAME###

###SYS_MAIL_ID###

###SYS_AUTHCODE###

Zusätzliche Felder aus der Empfängertabelle (beispielsweise durch eine andere Extension definiert) können via Extension Manager konfiguriert werden.

Sie müssen zur “Information”- Ansicht der Extension Direct Mail wechseln und finden dort eine kommaseparierte Liste von Datenbankfeldern in “Additional database fields for the recipient...” (addRecipFields) um weitere Marker setzen zu können.

Das kann gemäß dem Bitmuster wie oben angezeigt, erstellt werden:

###USER_<ein feld>###.

Diese Personalisierung funktioniert nur für Empfängerlisten vom Typ “from pages” (aus Seiten) oder auch für “From recipient Lists”, wenn diese “From pages” -Listen enthält.

Kategoriesierung des Newsletter Inhaltes

Der Inhalt der Newsletter kann kategorisiert werden, damit jeder Abonnent nur die Newsletter erhält, die ihn auch interessieren.

Die Abonnenten können ihre speziellen Interessen angeben, indem sie sich bei bestimmten Kategorien eintragen. Das können Sie über ein Frontend-Plugin wie Direct Mail Subscription, Frontendbenutzerregistrierung oder Email Address Subscription tun.

Die Kategorien werden im Backend über die standardmäßigen Einstellungen für das Anlegen und Editieren im Backend erstellt.

Üblicherweise werden sie im Direct Mail Ordner oder einem Unterordner angelegt. Das hängt von der generellen Konfiguration Ihrer Extension ab.

Die Titel der Kategorien können in verschiedenen Sprachen angeboten werden. Weitere Informationen über die individuellen Felder der Create/Edit – Formulare finden Sie in der kontextsensitiven Hilfe zu den Feldern.

Wenn die Kategorien angelegt sind, können sie verwendet werden um die Inhaltselemente zu kategorisieren. Das kann über die normalen Backendformulare für jedes Contentelement erfolgen oder aber für alle Inhaltselemente einer Newsletterseite.

Dazu gehen Sie wie folgt vor:

Wählen Sie die Newsletter Funktion von Direct Mail aus;

klicken Sie eines der Newsletter in der Liste an;

Weisen Sie den Inhaltselementen Kategorien in den relevanten Abschnitten des Formulars zu. Wenn Sie das nicht tun, also keine Kategorien setzen, wird dieses Element in allen Mails berücksichtigt;

Klicken Sie den Buttton “Update category settings” am Ende des Formulars an.

Typen von Empfängerlisten

Es gibt 5 Typen von Empfängerlisten

1. Aus/von Seiten (From pages)

Eine Liste, die dynamisch aus den Datensätzen, die auf der Webseite gefunden werden erstellt wird. Sie wählen die Seite mit dem “Starting Point” Feld (Ausgangspunkt); Sie können Datensätze aus Unterseiten einbeziehen, wenn Sie die Checkkbox “include page subtree” anklicken. Sie müsssen die Art der Datensätze, die Sie selektieren wollen aus der speziellen Tabelle auswählen: Adresse, Webseitenbenutzer, Benutzergruppe.

Wenn Webseitenbenutzer ausgewählt ist und eine Webseiten-Benutzergruppe gefunden wird, werden alle Benutzer dieser Gruppe in die Liste einbezogen. Sie können diese Selektion aber auch eingrenzen: durch die Kategorien.

2. Plain Text

Eine einfach Liste von Emailadressen, die durch Leerzeichen, durch Komma oder Zeilenumbruch getrennt wird.Wenn Sie das Listenformat (list format) ändern, können Sie, einen pro Zeile, einen Namen und Adresse, durch Komma getrennt, eintragen. Wenn Sie Direct Mails zu solch einer Empfängerliste senden, werden nur Textmails gesendet. Außerdem werden nur nichtkategorisierte Inhalte gesendet.

3. Statische Listen

Eine Liste von individuell selektierten Datensätzen. Der Typ kann Adresse, Webseitenbenutzer und/oder Benutzergruppe sein. Wenn eine Benutzergruppe ausgewählt wird, werden alle Gruppenmitglieder dieser Gruppe berücksichtigt.

4. Spezielle Abfragen

Eine dynamische Liste, die über eine SQL Abfrage erstellt wird. Nachdem Sie die Liste erstellt haben, können Sie die Query für eine der Tabellen spezifizieren, Adresse, Webseitenbenutzer oder individuell definierte Tabelle. Um dies zu tun müssen Sie die Empfängerlisten-Funktion von Direct Mail auswählen und den Listentitel anklicken.

5. Aus anderen Empfängerlisten

Eine dynamische Liste, die aus anderen Empfängerlisten erstellt wird und zwar individuell aus der Epfängerlistentabelle.

Weitere Informationen finden Sie in der kontextsensitiven Hilfe.

CSV Import von Emailadressen

Die Funktion “Empfängerliste” bietet die Möglichkeit CSV oder kommaseparierte Listen von Adressdatensätzen zu importieren und daraus Empfängerlisten zu generieren.

Die zu importierenden Datensätze werden zeilenweise eingegeben. Jeder Datensatz ist eine kommaseparierte Liste von Feldinhalten. Sie können auch Semikolon oder Doppelpunkt als Feldtrennzeichen benutzen.

In der ersten Zeile können Sie eine kommaseparierte Liste von Feldnamen eintragen. Die erste Zeile liefert die Struktur des Datensatzes der darauf folgt.

Wenn Sie keine Felddefinitionen in der ersten Zeile angeben, wird die Struktur “Name, Email” sein.

Jeder Feldname in der ersten Zeile wird wie folgt analysiert:

1. Der Feldname ist eine der folgenden aus der Liste:

uid, name, title, email, phone, www, address, company, city, zip, country, fax, module_sys_dmail_html, module_sys_dmail_category;

2. Der Feldname wird ausgelassen. In diesem Falle werden die entsprechenden Werte ausgelassen.

3. Der Feldname kann mit “user_” beginnen - in der Annahme, dass die Tabelle tt_address mit dem speziellen Feldnamen erweitert wurde.

4. Zusätzlich können Felder denen “[code]” angehängt wurde genutzt werden. In diesem Fall wird, wenn der Wert im importierten Datensatz nicht 0 (not null) ist, “[+value]” addiert; diese Nummer zum Feldwert. “[-value]” überschreibt jeden vorhandenen Wert in diesem Feld.

Beispiel für eine CSV Feldspezifikation:

;user_date;name;email;zip;phone;user_age[=20]

180;14-12-06;Max Mustermannl;m.mustermann@mustermann.com;;12345678;x

181;14-12-06;John Doe;johndoe@johndoe.com;;90 12 34 56;

182;14-12-06;Jane Doe;janedoe@janedoe.de;;234567890;x

Konfiguration

Installation der Extension

Importieren und installieren Sie die Extension über den Extension Manager. Es kann sein, dass noch die Extension tt_address benötigt wird, sie wird dann angefordert, da sie vorausgesetzt wird, wenn sie noch nicht installiert wurde.

Es können Updates der Datenbankstruktur erforderlich sein. Klicken Sie den “make updates” Button.

Wenn die Extension Direct Mail installiert ist, erscheint ein Bereich Direct Mail im Webmodul, damit der Benutzer das Admin-Tool benutzen kann. Der Extension Manager Dialog erlaubt bei der Installation die folgenden Konfigurationsvariablen.:

Sprache des Cron-Prozesses

Der TYPO3 Sprachcode der benutzten Sprache des Mail Engine Cron Prozesses, wenn die “Fortschritt-	Nachrichten” an den Administrator gesendet werden. Default ist “en”

Anzahl der Nachrichten pro Zyklus

Anzahl der gesendeten Nachrichten, die in einem Durchgang gesendet werden, voreingetragen sind 50.

Zusätzliche Datenbankfelder zum Empfängerliste

Zusätzliche Felder, die in den Direct Mail Nachrichten ersetzt werden

Aktivierung der Verzögerung

Nutzen Sie den Verzögerungsmodus. Dieser wird aber nur für das Sendmailprogramm unter Unix/Linux angewendet. Der Default-Wert ist 0. Diese Funktion kann nicht gesetzt werden, wenn PHP im Safe-mode aktiviert ist.

Aktivierung von Plain Text der News

Wenn das gesetzt ist, wir ein Skript aktiviert um die News (tt_news Datensätze) in Plain Text wiederzugeben, um sie dann als Plain Text Inhalte der Emailnachrichten wiederzugeben.

Wenn Sie von einer älteren Version auf 2.0+ aktualiseren, wird ein zusätzlicher Eintrag in der Drop-down Menu – Funktion des Extension Managers angezeigt: Update! Diese Option stellt eine Funktion bereit, einige Tabellen in Ihrer Datenbank zu konvertieren.

Lesen Sie bitte weiteres im entsprechenden Teil dieses Handbuches.

Einen Direct Mail Ordner anlegen

Jeder Ablauf des Direct Mail Moduls arbeitet aus einem speziell konfigurierten Sysfolder heraus. Sie können mehrere Direct Mail Folder konfigurieren.

Um einen Direct Mail Ordner anzulegen, gehen Sie wie folgt vor:

Erstellen Sie eine neue Seite im Seitenbaum

Wählen Sie Sysfolder (und nichts fanderes) für diese Seite aus.

Geben Sie einen Seitentitel an

Fügen Sie das Plugin “Direct Mail” in diese Seite, also den Sysfolder ein.

Sobald dieser Sysfolder erstellt ist, sollte sein Titel in der Liste der gültigen Direct Mail Ordner erscheinen, wenn Sie im Backend das Modul Menu Optionen im Webmodul > Direct Mail benutzen. Wenn Sie den Titel des Ordners anklicken sollte eine Seite mit dem Drop-down Funktionsmenu angezeigt werden.

Konfiguration in der Page TSConfig

Die Direct Mail Konfigurationseigenschaften werden in der Seiten TSConfig im Direct Mail Ordner unter dem Schlüssel mod.web_modules.dmail gesetzt.

Diese Eigenschaften können bequem gesetzt werden, wenn Sie die Direct Mail Modul Funktion “Module configuration” nutzen. Die folgenden Eigenschaften setzen default-Werte für die entsprechenden Eigenschaften von Direct Mail. Diese Eigenschaften von Direct Mail bedingen, dass die Header in die Direct Mail Nachrichten eingefügt sind.

Property:	Data type:	Description:
from_email	string	Default value for the 'From' or sender email address of direct mails. (Required) Note: This email address appears as the originating address or sender address in the direct mails received by the recipients.
from_name	string	Default value for 'From' or sender name of direct mails. (Required) Note: This name appears as the name of the author or sender in the direct mails received by the recipients.
replyto_email	string	Default value for 'Reply To' email address. Note: This is the email address to which replies to direct mails are sent. If not specified, the 'From' email is used.
replyto_name	string	Default value for 'Reply To' name. Note: This is the name of the 'Reply To' email address. If not specified, the 'From' name is used.
return_path	string	Default return path email address. Note: This is the address to which non-deliverable mails will be returned to. Note: If you put in the marker ###XID###, it'll be substituted with the unique id of the mail recipient. Note: The return path email address cannot be set by the Direct Mail module if PHP is running with safe_mode enabled.
organisation	string	Name of the organization sending the mail.
priority	int+	Default priority of direct mails. Possible values are: 1 - High 3 - Normal 5 – Low Default: 3

Die folgenden Eigenschaften setzen default Werte für die entsprechenden Eigenschaften von Direct Mail. Diese Eigenschaften bedingen / bestimmen das Format des Inhaltes der Direct Mail Nachrichten.

Property:	Data type:	Description:
sendOptions	int+	Default value for the format of email content. If in doubt, set it to 3 (Plain and HTML). The recipients are normally able to select their preferences anyway. Possible values are: 1 - Plain text only 2 - HTML only 3 - Plain and HTML Default: 3
includeMedia	boolean	Default value for this direct mail option: if set, images and other media are incorporated into the HTML mail content. Note: When this option is set on a direct mail, images and other media are encoded and incorporated into the messages. Sent messages will be heavier to transport. When the option is not set, images and media are included in HTML content by absolute reference (href) to their location on the site where they reside. Default: 0
flowedFormat	boolean	Default value for this direct mail option: if set, text will flow normally in the plain text content of email messages. Note: If the option is set, plain text mail content will still be broken in fixed length lines, as is standard for plain text email content, but so-called flowed format will be used. This will allow client agents that support this format to display the text as normally flowing text. The option is ignored if 'quoted-printable' is used. Note: this setting will produce email headers with 'format=flowed'. See http://www.ietf.org/rfc/rfc3676.txt for more information. Note: In order for plain text content to be correctly rendered for effective use of this option, the flowedFormat property should also be set in the TS template of the plain text rendering plugin.

Die folgenden Eigenschaften spezifizieren die Parameter für die Abläufe von verschiedenen Funktionen im Direct Mail Modul. Diese Eigenschaften spezifizieren die Parameter um den Inhalt der Direct Mails abzurufen.

Property:	Data type:	Description:
HTMLParams	string	Default value for additional URL parameters used to fetch the HTML content from a TYPO3 page. Note: The specified parameters will be added to the URL used to fetch the HTML content of the direct mail from a TYPO3 page. If in doubt, leave it blank.
plainParams	string	Default value for additional URL parameters used to fetch the plain text content from a TYPO3 page. Note: The specified parameters will be added to the URL used to fetch the plain text content of the direct mail from a TYPO3 page. Note: If in doubt, set it either to '&type=99' or, when TemplaVoila is used, to '&print=1'. Default: &type=99
use_domain	Int+	Uid of default sys_domain record of the domain that should be used for fetching content from internal TYPO3 pages. Note: When a domain is specified on a direct mail, the domain will also be used in all internal links contained in mail content. Note: When no domain is specified on a direct mail, the domain in use in the backend when the direct mail is compiled is used to fetch internal TYPO3 pages.

Die folgenden Eigenschaften spezifizieren den Inhalt

Property:	Data type:	Description:
quick_mail_encoding	string	Content transfer encoding to use when sending quick mails. Possible values: quoted-printable base64 8bit Default: quoted-printable
direct_mail_encoding	string	Default value for the content transfer encoding of direct mails. Possible values: quoted-printable base64 8bit Default: quoted-printable
quick_mail_charset	string	Character set to use when sending quick mails. Default: iso-8859-1
direct_mail_charset	string	Default character set for direct mails built from external pages. Note: This is the character set used in direct mails when they are built from external pages and character set cannot be auto-detected. Note: Direct mails based on internal TYPO3 pages will be sent with the character set in which they are rendered as determined by their TS template. Default: iso-8859-1

Die folgenden Eigenschaften setzen default Werte für die entsprechenden Eigenschaften von Direct Mail. Diese Eigenschaften bestimmen, wie mit Links in Emailinhalten verfahren wird.

Property:	Data type:	Description:
use_rdct	boolean	If set, links longer than 76 characters found in plain text content will be redirected: long URL's will be substituted with ?RDCT=[md5hash] parameters. Note: This configuration determines how Quick Mails are handled and further sets the default value for Direct Mails. Default: 0
long_link_mode	boolean	If set and if use_rdct is set, all links in plain text content will be redirected, not only links longer than 76 characters. Default: 0
enable_jump_url	boolean	If set, the use of jump URL's will be enabled so that click statistics can be produced. Default: 0
authcode_fieldList	list	Default list of fields to be used in the computation of the authentication code included in unsubscribe links and in jump URL's in direct mails. Default: uid

Die folgenden Eigenschaften spezifizieren die Parameter für die Abläufe von verschiedenen Funktionen in Direct Mail.

Property:	Data type:	Description:
http_username	string	The username used to fetch the mail content, if mail content is protected by HTTP authentication. Note: The username is NOT sent in the mail! Note: If you do not specify a username and password and a newsletter page happens to be protected, an error will occur and no mail content will be fetched.
http_password	string	The password used to fetch the mail content, if mail content is protected by a HTTP authentication. Note: The password is NOT sent in the mail! Note: If you do not specify a username and password and a newsletter page happens to be protected, an error will occur and no mail content will be fetched.
userTable	string	Custom-defined table that may be used to send direct mails in addition to fe_users and tt_address tables. Note: The following columns must be defined in the custom-defined table: uid, name, title, email, phone, ww, address, company, city, zip, country, fax, module_sys_dmail_category, module_sys_dmail_html
test_tt_address_uids	list of UIDs	List of UID numbers of test recipients. Before sending mails, you should test the mail content by sending test mails to one or more test recipients. The available recipients for testing are determined by this list of UID numbers. So first, find out the UID numbers of the recipients you wish to use for testing, then enter them here in a comma-separated list.
test_dmail_group_uids	list of UIDs	List of UID numbers of test recipient lists. Alternatively to sending test-mails to individuals, you can choose to send to a whole list. This is the list of recipient list UID numbers available for this action.

Konfigurierung des TS Templates für Newsletter – Seiten

Newsletterseiten sind normale Seiten. Ihre Wiedergabe/Ausgabe ist im TS Template konfiguriert.

Das TS Template sollte keine Frames enthalten

Wenn Sie Formulare in eine Newsletter – Seite einfügen, sollten Sie die GET Methode benutzen. Mit POST könnte passieren, dass keine Daten auf die Seite transferiert werden.

Konfiguration der der Plain Textausgabe

Am besten erstellen Sie immer auch eine Plain Text Email – Version.

Dazu müssen Sie das statische Template “Direct Mail Plain Text” in Ihr TS Template einfügen. Das statische Template beinhatet ein vordefiniertes Template zur Wiedergabe des Plain Text – Inhaltes und macht es als Seitentyp 99 zugänglich.

Sie können das Template an Ihre Bedürfnisse anpassen.

In Versionen, die älter als 2.0 sind, ist dieses Template unter “plugin.alt.plaintext(99)” zu finden. Das statische Template arbeitet nur mit Versionen 2.0+.

Hier folgt das statische Template “Direct Mail Plain Text”:

Constants

plugin.tx_directmail_pi1 {

# cat=plugin.tx_directmail_pi1/file; type=file[html,htm,tmpl,txt]; label= Template File for plain text version: &type=99 defines plain text rendering for page content.

file.template = EXT:direct_mail/pi1/tx_directmail_pi1_plaintext.tmpl

# cat=plugin.tx_directmail_pi1//; type=string; label= Site url: Enter the url of the site here.

siteUrl = http://www.example.test/

# cat=plugin.tx_directmail_pi1/enable/; type=boolean; label= Use flowed format: The same option should be set on the direct mail.

FlowedFormat = 0

# cat=plugin.tx_directmail_pi1/enable/; type=boolean; label= Double line feeds: Line feeds found in bodytext will be doubled in the plain text version.

doubleLF = 0

# cat=plugin.tx_directmail_pi1//; type=string; label= Split char to remove from graphical headers: Headers built as GIFBUILDER objects may contain split characters. If specified here, they will be removed from headers of type 5 in the plain text version.

removeSplitChar =

}

Setup

plugin.tx_directmail_pi1 = USER

plugin.tx_directmail_pi1.userFunc = tx_directmail_pi1->main

plugin.tx_directmail_pi1 {

siteUrl = {$plugin.tx_directmail_pi1.siteUrl}

flowedFormat = {$plugin.tx_directmail_pi1.flowedFormat}

header.defaultType = 1

header.date = D-m-Y

header.datePrefix = |###HEADER_DATE_PREFIX### |

header.linkPrefix = | ###HEADER_LINK_PREFIX### |

header.1.preLineLen = 76

header.1.postLineLen = 76

header.1.preBlanks=1

header.1.stdWrap.case = upper

header.2 < .header.1

header.2.preLineChar=*

header.2.postLineChar=*

header.3.preBlanks=2

header.3.postBlanks=1

header.3.stdWrap.case = upper

header.4 < .header.1

header.4.preLineChar= =

header.4.postLineChar= =

header.4.preLineBlanks= 1

header.4.postLineBlanks= 1

header.5.removeSplitChar = {$plugin.tx_directmail_pi1.removeSplitChar}

header.5.preBlanks=1

header.5.autonumber=1

header.5.prefix = |: >> |

defaultOutput (

|

[###UNRENDERED_CONTENT### ###CType### ]

|

)

uploads.header = |###UPLOADS_HEADER###|

images.header = |###IMAGES_HEADER###|

images.linkPrefix = | ###IMAGE_LINK_PREFIX### |

images.captionHeader = |###CAPTION_HEADER###|

bulletlist.0.bullet = |* |

bulletlist.1.bullet = |# |

bulletlist.2.bullet = | - |

bulletlist.3.bullet = |> |

bulletlist.3.secondRow = |. |

bulletlist.3.blanks = 1

menu =< tt_content.menu.20

shortcut =< tt_content.shortcut.20

shortcut.0.conf.tt_content =< plugin.tx_directmail_pi1

shortcut.0.tables = tt_content

bodytext.doubleLF = {$plugin.tx_directmail_pi1.doubleLF}

bodytext.stdWrap.parseFunc.tags {

link =< lib.parseFunc_RTE.tags.link

typolist = USER

typolist.userFunc = tx_directmail_pi1->typolist

typolist.siteUrl = {$plugin.tx_directmail_pi1.siteUrl}

typolist.bulletlist =< plugin.tx_directmail_pi1.bulletlist

typohead = USER

typohead.userFunc = tx_directmail_pi1->typohead

typohead.siteUrl = {$plugin.tx_directmail_pi1.siteUrl}

typohead.header =< plugin.tx_directmail_pi1.header

typocode = USER

typocode.userFunc = tx_directmail_pi1->typocode

typocode.siteUrl = {$plugin.tx_directmail_pi1.siteUrl}

}

}

includeLibs.tx_directmail_pi1 = EXT:direct_mail/pi1/class.tx_directmail_pi1.php

tx_directmail_pi1 >

tx_directmail_pi1 = PAGE

tx_directmail_pi1.typeNum=99

tx_directmail_pi1.config {

disableAllHeaderCode = 1

additionalHeaders = Content-type:text/plain

}

tx_directmail_pi1.10 = TEMPLATE

tx_directmail_pi1.10 {

template = FILE

template.file = {$plugin.tx_directmail_pi1.file.template}

marks.CONTENT < styles.content.get

marks.CONTENT.renderObj = < plugin.tx_directmail_pi1

marks.DATE = TEXT

marks.DATE.data = date:U

marks.DATE.strftime = %e. %B %Y

}

Konfiguration der Plain Text Wiedergabe von News Datensätzen

Wenn Sie News Datensätze in Ihre Newsletter-Seite einfügen, indem Sie “insert records” als Elementtyp verwenden, können Sie die Plain Text – Wiedergabe der News erstellen. Fügen Sie einfach das statische Template “Direct Mail News Plain Text” in ihr TS Template ein. Hier ist die Reihenfolge wichtig. Das statische Template “Direct Mail News Plain Text” muss nach dem “Direct Mail Plain Text” folgen.

Danach können Sie Ihr Template anpassen.

Hier folgt das statische Template “Direct Mail News Plain Text”:

Setup

plugin.tx_directmail_pi1 {

shortcut.0.conf.tt_news =< plugin.tt_news

shortcut.0.conf.tt_news.code = PLAINTEXT

shortcut.0.conf.tt_news.defaultCode = PLAINTEXT

shortcut.0.conf.tt_news.displayCurrentRecord = 1

shortcut.0.conf.tt_news.plainTextConf < plugin.tx_directmail_pi1

shortcut.0.tables = tt_content,tt_news

tt_news_author.defaultType = 3

tt_news_author.date = D-m-Y

tt_news_author.prefix = |###TT_NEWS_AUTHOR_PREFIX### |

tt_news_author.datePrefix = |###TT_NEWS_AUTHOR_DATE_PREFIX### |

tt_news_author.emailPrefix = | ###TT_NEWS_AUTHOR_EMAIL_PREFIX### |

tt_news_author.1.preLineLen = 76

tt_news_author.1.postLineLen = 76

tt_news_author.1.preBlanks=1

tt_news_author.1.stdWrap.case = upper

tt_news_author.2 < .tt_news_author.1

tt_news_author.2.preLineChar=*

tt_news_author.2.postLineChar=*

tt_news_author.3.preBlanks=1

tt_news_author.3.stdWrap.case = upper

tt_news_author.4 < .tt_news_author.1

tt_news_author.4.preLineChar = =

tt_news_author.4.postLineChar = =

tt_news_author.4.preLineBlanks= 1

tt_news_author.4.postLineBlanks= 1

tt_news_short < .bodytext

tt_news_short.header = |###TT_NEWS_SHORT_HEADER### |

tt_news_bodytext < .bodytext

tt_news_bodytext.header = |###TT_NEWS_BODYTEXT_HEADER### |

}

Konfiguration der Kategorien

Wenn Sie die Direct Mail Kategorien nutzen möchten, gehen Sie wie folgt vor:

Zunächst fügen Sie das statische Template “Direct Mail Content Boundaries” in Ihr TS Template des Direct Mail Ordners (Direct Mail folder) ein. Das gewährleistet, dass die Inhaltsbereiche in die Seite eingefügt werden und angezeigt wird, wann Kategorieanweisungen gefunden werden. Das statische Template stellt sicher, dass die Contentelemente sowohl als HTML- als auch als Plain Text eingefügt werden. Gesetzt wird das Einfügen über die TS Setup Eigenschaft

config.insertDmailerBoundaries = 1

Das ist im statischen Template “Direct Mail Content Boundaries” bereits gesetzt.

Nun müssen die Kategorien, die den Inhaltselementen, den Adressdatensätzen, den Frontenduser-Ordnern oder Empfängerlisten zugewiesen werden sollen, über die Seiten TSConfig festgelegt werden. Dazu sollten Sie die folgenden Eigenschaften in die Seiten TSConfig des Direct Mail Ordners und evtl. auf jeder Seite, deren Unterseiten Datensätze beinhalten, die von Direct Mail berücksichtigt werden, einfügen.

TCEFORM.tt_content.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = pid_list

TCEFORM.tt_address.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = pid_list

TCEFORM.fe_users.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = pid_list

TCEFORM.sys_dmail_group.select_categories.PAGE_TSCONFIG_IDLIST = pid_list

Wo also pid_list die Liste der Seiten-IDs auf der die Kategorien gefunden werden ist, werden diese übergeben.

Letztlich, wenn die Kategorie-Konfigurierung auf der Seite und den Unterseiten erstellt ist, möchten Sie unter Umständen, dass das Kategoriefeld in den Backendformularen angezeigt wird. Das wird erreicht, wenn Sie folgende Eigenschaften in der Seiten TSConfig der selben Seite setzen.

TCEFORM.tt_content.module_sys_dmail_category.disabled = 0

TCEFORM.tt_address.module_sys_dmail_category.disabled = 0

TCEFORM.fe_users.module_sys_dmail_category.disabled = 0

TCEFORM.sys_dmail_group.select_categories.disabled = 0

Das “Direct Mail Content Boundaries” statische Template:

Setup

// Configuring the insertion of dmailer boundaries

includeLibs.tx_directmail_container = EXT:direct_mail/res/scripts/class.tx_directmail_container.php

// In html content

tt_content.stdWrap.postUserFunc = tx_directmail_container->insert_dMailer_boundaries

// In old plaintext content static tenmplate

lib.alt_plaintext.renderObj.userProc < tt_content.stdWrap.postUserFunc

lib.alt_plaintext.renderObj.userProc.useParentCObj = 1

// In new direct mail plain text plugin

plugin.tx_directmail_pi1.userProc < tt_content.stdWrap.postUserFunc

plugin.tx_directmail_pi1.userProc.useParentCObj = 1

// Enable the insertion of content boundaries

config.insertDmailerBoundaries = 1

Aktivierung der Klick-Statistiken

Um die Statistiken zu aktivieren, klicken Sie die Checkbox in der "Module configuration” an:

Dadurch werden die Links in der Email registriert und die Klicks darauf werden gezählt.

Die Form-URLs werden nicht über das jump URL Feature adressiert, sondern direkt zur Seite gelinkt.

Ein schöner Trick ist es, ein clear.gif in das HTML-Template einzufügen und den Parameter dmailerping=1 in den Tag einzubeziehen. Das erzwingt die Erfassung der URL des Bildes durch die jump URL Registrierung. D. h., wenn diese Mail geöffnet wurde, wird das registriert. Das ist ein zusätzliches Merkmal zum regulären Feature, welches alle Links, die in den Mail angeklickt werden, mitzählt.

Beispiel:

<img src="typo3conf/ext/direct_mail/res/gfx/dmailerping.gif" width="1" height="1" dmailerping="1" />

Beachten Sie bitte, dass das Ergebniss der Jump URL Settings des oben gezeigten HTML-Tags ist, dass das src Attribut erstetzt wird durch eines, welches zur Adresse des Skripts weiterletet. Solche Attribute im HTML von Emails können durch Spamfilter-Software deaktiviert werden.

Konfiguration des Backend-Benutzerzugangs zu Direct Mail Funktionen

Die TSConfig kann genutzt werden, um den Zugriff auf die Direct Mail Funktionen zu kontrollieren. Das kann über die Seiten TSConfig (wie bei den Kategorien) und über die Benutzer TSConfig geschehen.

Über das Admin-Tool können die Zugriffsregeln für jeden Backendbenutzer und jede -gruppe gesetzt werden

Die Eigenschaften der Benutzer TSConfig sind hier beschrieben:

http:://typo3.org/documentation/document-library/references/doc_core_tsconfig/current/view/

Property:	Data type:	Description:	Default:
tabmenu	boolean	Display direct mail menu as tabbed menu. Default: disabled	1
dmail_mode.[function]	boolean	Enables/disables the specified function. Possible functions are: news ('Newsletters' function) direct ('Direct Mails' function) quick ('Quick Mail' function) recip (Recipient Lists' function) mailengine ('Mailer Engine Status' function) .disable_trigger (disable manual invocation of mailer engine; enabled by default) convert ('Categories Conversion' function) conf ('Module Configuration' function)	all functions are enablled

[page:mod.web_modules.dmail.menu; beuser:page.mod.web_modules.dmail.menu]

Für die Benutzer, die Direct Mails, Empfängerlisten oder Kategorien anlegen dürfen, müssen die Rechte zur Modifikation in den entsprechenden Tabellen gesetzt werden (table modify).

Konfiguration des mailer engine cron task

Die Mailer Engine kann vom Direct Mail Backend Modul aufgerufen werden.

Wenn Ihre Newsletter zu zahlreichen Empfängern versendet werden sollen, bietet diese Extension ein Mailer Engine-Skript, das als Cron task auf dem Server konfiguriert werden kann.

In diesem Beispiel wird die Mailer Engine alle 5 Minuten aufgerufen, und prüft, ob Mails versendet werden müssen.

Wenn die Installation lokal erfolgte:

*/5 * * * * /home/....../public_html/typo3conf/ext/direct_mail/mod/dmailerd.phpcron> /dev/null

Wenn die Installation global erfolgte:

*/5 * * * * /home/....../public_html/typo3/ext/direct_mail/mod/dmailerd.phpcron> /dev/null

Beachten Sie, dass hier der absolute Pfad zum Skript eingetragen sein muss.

Das Skript dmailerd.phpcron ist ein Shell-Skript und benötigt die Verfügbarkeit einer PHP binary, “usr/bin/php”. Abhängig von Ihrer Serverkonfiguration können Sie die erste Zeile des Skripts ändern, um zu der Stelle zu weisen, an der sich die binary befindet.

Nutzung von Sendmail im Verzögerungsmodus

Diese Option könnnen sie nur nutzen, wenn Sie Sendmail in einer Linux/Unix Umgebung einsetzen.

Wenn Sie viele Mails über die Mailer Engine versenden, verzögert sich der Prozess eventuell - verursacht durch den Versuch des Mailservers, die Empfänger-Domain jeder Mail zu lokalisieren. Das kann zur Konsequenz haben, dass es zu Zeitüberschreitungen kommt, die bewirken, das es zu einem Fehler bei der Cron-Anfrage führt oder der Cron-Task ausgelöst wird, bevor der vorhergende Vorgang beendet werden konnte. In letzterem Fall kann das dazu führen, das einige Mail vielfach versendet werden.

Solche Probleme können verhindert werden, wenn der Sendmail-Verzögerungsprozess genutzt wird. Hierbei wird jede Mail in eine Warteschleife zur späteren Bearbeitung durch Senmail gestellt. Dadurch wird der Cron task um einiges schneller angesprochen.

Sie können den Verzögerungsmodus aktivieren, indem Sie die entsprechende Variable im Installationsmonitor der Extension setzen. Diese Option kan nur verwendet werden, wenn die Emails mit der Mailer Engine Cron Task versendet werden.

Die folgenden Variablen müssen gesetzt sein.

Beispiel:

DAEMON=yes

SMQUEUE=10m

QUEUE=30m

Dieses Beispiel bedeutet folgendes: Die Email Warteschleife wird alle 10 Minuten geleert. Wenn ein Problem beim Versuch zu senden auftritt, werden die Mails in eine andere Schleife gestellt und die Übergabe wird nun alle 30 Minuten versucht.

Weitere Informationen für die Sendmail Konfiguration finden Sie hier: http://www.sendmail.org/.

Konfiguration der Analyse zurückgesandter Mails

Es gibt mehrere Möglichkeiten diese Konfiguration durchzuführen.

Vorgeschlagen wird ein Ansatz der auf dem Open Source Programm “fetchmail” basiert. Weitere Informationen zu fetchmail finden Sie hier: The fetchmail home page .

Erstellen Sie eine Mailbox (popbox) für die zurückgesendeten Mails, z. B. bounce@pophost.org. Diese Popbox muss auf der gleichen Maschine laufen, wie die TYPO3 Installation.

Nutzen Sie die Modul-Konfigurationsfunktion des Direct Mail Moduls, um die gleichen Adressen im “Return Path” - Feld in der Seiten TSConfig zu konfigurieren. Fügen Sie hier die Returnpath Emailadresse ein. Das ist die Adresse, an die nicht lieferbare Mails zurückgeschickt werden. Wenn Sie den Marker dort ###XID##l# einpflegen, wird er durch die eindeutige ID der Mail/des Empfängers ersetzt.

fetchmail kann eine Mailbox lesen und dann mit den Mails etwas tun. Hier wird fetchmail genutzt, um die zurückgekommenen Mails in das Skript “returnmail.phpsh” zu leiten. Fetchmail benutzt einen Konfigurationsdatensatz, der außerhalb des Webzugangs-Ordners liegen sollte. Zum Beispiel im Rootverzeichnis: /root/.fetchmailrc. ls -l auf diesen Dantesatz sieht ungefähr so aus:

-rwx--x--- 1 root root 208 Jun 20 12:50 /root/.fetchmailrc

Fügen Sie diese Zeile in die Datei .fetchmailrc und ersetzen dann die Variable my.pophost.org durch den Namen Ihres Mailservers. Den Benutzernamen und das Passwort der Popbox ersetzen Sie durch den Namen und das Passwort Ihrer Bounce-Mailbox:

poll my.pophost.org timeout 40 username "username-of-popbox" password "password-

of-popbox" flush mda	"/path/to/your/TYPO3/installation/typo3conf/ext/direct_mail/mod/returnmail.phpsh"

Hier muss der absolute Pfad spezifiziert sein. Wenn die Extension Global installiert ist, ersetzen Sie Typo3conf durch Typo3 im oben genannten Pfad. Sellen Sie sicher, dass das Skript returnmail.phpsh ausreichende Rechte zur Ausführung auf dem Server hat. Beachten Sie bitte, dass es sich bei diesem Skript um ein Shell-Skript handelt, das eine php-Binary voraussetzt, “usr/bin/php”. Abhängig von Ihrer Serverkonfiguration müssen Sie die erste Zeile anpassen, um dorthin zu weisen.

Wenn Sie diverse Direct Mail Ordner konfiguriert haben, jeden mit einer eigenen Return-Mailbox, brauchen Sie jeweils eine gleichartige Zeile für jede Mailbox.

Nutzen Sie das Kommando “crontab -e” (als root), oder das cPanel Ttool, um die folgende Cron-Task hinzuzufügen. Sie benötigen nur einen, auch wenn Sie diverse Ordner für Direct Mail nutzen. Dieses Bsispiel aktiviert den Cron-task alle 10 Minuten:

*/10 * * * * fetchmail> /dev/null

Nutzen Sie das Direct Mail Modul um ein Newsletter zu Bounce-Adressen zu senden. Benutzen Sie die Statistik-Funktion, um sicherzustellen, dass die gebouncte Mail akzeptiert und in den Statistiken angezeigt wird.

Upgrading auf Version 2.0+

Es gibt zwei hauptsächliche Dinge, die Sie beim Update auf Version 2.0+ berücksichtigen müssen:

das neue statische Template (s. “Konfiguration Plain Textausgabe” und “Konfiguration der Kategorien”)

Die Umstellung der Kategorien: in älteren Versionen wurden Kategorien in der Seiten TSConfig definiert. Ab Version 2.0 gibt es hierfür eine eigene Tabelle.

Beim Update ist es notwendig, existierende Kategorien in der Seiten TSConfig zu konvertieren und entsprechende Direct Mail Kategorien in den Direct Mail Ordnern anzulegen. Wenn bestimmte Kategorien Inhaltselementen zugeordnet sind (oder Adressen, Frontendbenutzern, Empfängerlisten), muss diese Zuordnung ebenfalls konvertiert werden, um sie den neu erstellten Kategorien zuzuweisen. Die Konvertierung kann nicht rückgängig gemacht werden. Erstellen Sie vorher eine Datensicherung. Beim Update gibt es eine zusätzliche Option im Drop-down – Menu des Extension Managers: UPDATE! Diese wird angezeigt, wenn bereits ein Direct Mail Ordner vorhanden ist und bereits eine Direct Mail Kategorie existiert. Wenn Sie die UPDATE! Option auswählen, werden die Kategorien in der Seiten TSConfig in neue Direct Mail Kategorien konvertiert. Die Direct Mail Kategorien werden in jedem Direct Mail Ordner erstellt, für den in der Seiten TSConfig Kategorien definiert sind.

Die Konvertierung von Kategorieanweisungen in Inhaltselementen, Adressen, Frontendbenutzern und Empfängerlisten werden ebenfalls versandt.

Wenn die Nutzung von Kategorien bisher nicht konfiguriert wurde, schlägt der Prozesss fehl aber der Versuch wird zu einem späteren Zeitpunkt wiederholt, wenn die “Categories conversion” - Funktion des Direct Mail Moduls genutzt wird.

Der nächste Schritt ist, die Nutzung von Kategorien zu konfigurieren (s. dort).

Beachten Sie, dass die Konvertierung von Kategorieanweisungen nur simuliert wird, bis Sie effektiv die Konvertierung bestätigen.

Einmal bestätigt, werden die Datensätze aktualisiert – das kann nicht rückgängig gemacht werden.

Wenn Kategorien konfiguriert werden, können Sie wieder versuchen, die Konvertierung von Kategorieumgebungen mit der Option “Categories Conversion” mit dem Funktionsmenu von Direct Mail zu konvertiereun.

Diese Funktion bietet eine Statistik sowohl über die Abarbeitung als auch über die fertige Konvertierung. Außerdem werden die Datensätze gelistet, die nicht konvertiert wurden. Diese Ausnahme wird normalerweise aufgrund der Tatsache, dass die Nutzung von Kotegorien nicht für diesen Datensatz-Typ konfiguriert wurde im Seitenbaum in dem es gefunden wirde, zustande kommen.

Trotzdem es nicht rückgängig zu machen ist, kann die Konvertierung so oft wie notwendig durchgeführt werden, ohne dass etwas Schlimmes passiert.

Troubleshooting

Direct Mails werden nicht versendet

Checkliste:

Direct Mail Boundaries sollten auch in einer HTML Plain Text Version der Seite, die genutzt wird Mails zu erstellen, erscheinen. Andererseits bleiben personalisierte Mails leer und können nicht versendet werden.

Wenn Sie nur HTML Mails nutzen, stellen Sie sicher, dass dies auch bei allen Empfängern aktiviert ist, sonst werden die Mails nicht verschickt.

Stellen Sie sicher, dass Inhalte vorhanden sind. Versuchen Sie ein Inhaltselement einzubinden, das an alle Empfänger versendet werden soll, auch wenn Sie keine Kategorien angegeben haben. Personlisierte Mails die leer sind, werden nicht versendet.

Eine einfache Testmail verifiziert, dass der Mailversand funktioniert.

Der Versand einer Testmail an eine Testadresse oder Test-Empfängerliste die mit der “Module Configuration”-Funktion konfiguriert werden stellt sicher, dass die Personalisierung von Nachrichten funktioniert.

Massen Mails werden nur übergeben, nachdem eine andere Mail vom selben MAC OS X Server gesendet wurde

Problembeschreibung:

Aufrufen von Massenmailergebnissen dadurch, dass eine Admin-Mail erstellt wurde, die sagt, dass der Prozess gestartet wurde.

Stunden später wurde kein Newsletter erhalten, auch keine Admin-Mail, die sagt, dass der Versand gestoppt wurde.

Nachdem eine Form-Mail von einer anderen Domain auf dem Server aufgerufen wurde, kommen alle Nachrichten an.

Alle – Newsletter und Admin-Email hatten den gleichen Zeitstempel, wie die erste Admin-Email.

Es wurde nun ein Newsltter an eine von Benutzerliste in tt_address gesendet. In dieser Liste befindet sich nur eine Adresse.

Diskussion:

Eine Googleanfrage brachte den Hinweis, dass ein Autorisierungsproblem mit Sendmail bestand. Hier kann chmod und chown bearbeiten Abhilfe schaffen.

Siehe hier: http://www.entropy.ch/software/macosx/php/welcome_de.html (german)

Lösung:

Es musste die Gruppe im “postfix” - Verzeichnis geändert werden.

sudo chmod g-w /

und

sudo chgrp smmsp /var/spool/postfix

Quelle:

http://bugs.typo3.org/view.php?id=2570

Bekannte Probleme

Schauen Sie oder informieren sie sich im TYPO3 Bugtracker unter Projekt tx_directmail.

Sie können Support erhalten, wenn Sie sich zu diesem Newsletter anmelden: news://news.netfielders.de/typo3.projects.direct-mail.

Tutorial

Installation

Installieren Sie zunächst die Frontendbenutzerregistrierung (s. Tutorial zu sr_feuser_register) zum abonnieren der Newsletter. Sie können auch andere Tools verwenden (s. Handbuch).

Installieren Sie tt_address und direct_mail.

In der Vorgängerversion funktioniert die Plain Textausgabe nicht korrekt. Dazu müssen Sie die Datei mod/class.mod_web_dmail.php

in der Extesnion Direct Mail editieren. Damit die Datei bei einem eventuellen Update nicht verloren geht, speichern Sie sie bitte lokal.

Das gilt nicht mehr für die Version 2.2, die hier installiert wurde.

Nach der Installation laden Sie die Seite neu und sehen im Webmodul den Bereich Direct Mail.

Sysordner erstellen

Erstellen Sie nun eine neue Seite, den Direct Mailordner. Dieser Ordner muss ein Sysfolder sein.

Vergeben Sie den notwendigen Seitentitel und fügen Sie dann das Plugin Direct Mail auf der Seite ein – nicht als Seiteninhalt. Das ist eine häufige Fehlerquelle. Als Seiteninhalt steht das Plugin nämlich gar nicht zur Verfügung.

Tragen Sie die im Bild gezeigten TS-Konfigurationen in die Seiten TSConfig des Sysordners ein.

Wenn Sie nun das Direct Mail Modul im Bereich Web anklicken und den Sysordner im Seitenbaum anklicken, erhalten Sie die folgende Ansicht

Wählen Sie nun in der rechten oberen Ecke des Contentbereichs in der Combobox “Modulkonfiguration” aus. Nehmen Sie dort die notwendigen Einstellungen vor – wenn nicht schon im vorigen Schritt manuell eingetragen. Das Ergebnis ist das gleiche.

S. auch den Bereich “Page TSConfig” im entsprechenden Teil des Handbuches.

Newsletter erstellen

Erstellen Sie nun eine Seite für Ihre Newsletter.

Wählen Sie im Webmodul Direct Mail, im Seitenbaum den Sysordern an und wählen aus der Combobox “Newsletter” aus. Dann klicken Sie auf den Link:

“Klicken Sie hier, um eine neue Typo3-Seite, die Sie später als Newsletter verschicken können, anzulegen”.

Erstellen Sie nun eine normale TYPO3 Seite, unterhalb des Sysordners, vergeben den Titel der Seite und legen dann einen Inhalt für das Newsletter an, zunächst einmal einen ganz normalen Text.

Wenn Sie Kategorien verwenden möchten (s. auch den entsprechenden Bereich im Handbuch), müssen diese Kategorien den entsprechenden Seiten zugewiesen verwenden.

Nehmen wir das Beispiel mit dem eben angelegten Newsletter und setzen in die Seiten TSConfig des Sysordners die ID der Seite ein.

TCEFORM.tt_content.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = pid_list

TCEFORM.tt_address.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = pid_list

TCEFORM.fe_users.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = pid_list

TCEFORM.sys_dmail_group.select_categories.PAGE_TSCONFIG_IDLIST = pid_list

Damit das Kategoriefeld in den Backendformularen angezeigt wird, muss noch dieser Bereich in die Seiten TSConfig aller betroffenen Seiten gesetzt werden.

TCEFORM.tt_content.module_sys_dmail_category.disabled = 0

TCEFORM.tt_address.module_sys_dmail_category.disabled = 0

TCEFORM.fe_users.module_sys_dmail_category.disabled = 0

TCEFORM.sys_dmail_group.select_categories.disabled = 0

Vergessen Sie nicht, das statische Template “Direct Mail Content Boundaries” in Ihr Template einzufügen.

Wenn Sie noch kein TS Template angelegt haben, erstellen Sie nun ein eigenes Template für Direct Mail und speichern es in Ihrem Template Ordner ab.

Exkurs:

Erstellen Sie einen Sysordner für Ihre Templates. Wählen Sie dort “Neuen Datensatz anlegen”, -> Template aus und erstellen Ihr Template. Im Haupttemplate Ihrer Seite binden Sie über “Include Basis Template” dieses neue Template ein. So behalten Sie eine gute Übersicht über Ihre Extensiontemplates.

Template

Wählen Sie nun das Template der Direct Mail Extension aus und fügen folgende Zeilen in Ihr Setup ein.

Vergessen Sie nicht, auch die statischen Templates einzubeziehen.

Konfiguration der Kategorien

Erstellen Sie nun eine Kategorie für dieses Newsletter.

Wählen Sie im Webmodul “Seite” aus und im Seitenbaum Ihren Sysordner der Frontendbenutzer. Klicken Sie den Link “Neuen Datensatz anlegen” an und wählen Sie “Direct-Mail-Kategorie” aus.

Im Beispiel wurde eine Kategorie test erstellt. Diese Kategorie muss jetzt den Inhaltselementen den Empfängerlisten und den Frontendbenutzerordnern zugewiesen werden.

Über die Seiten TSConfig binden Sie hier die ID des Frontendbenutzerordners ein.

TCEFORM.fe_users.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = 43

TCEFORM.tt_content.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = 43 TCEFORM.tt_address.module_sys_dmail_category.PAGE_TSCONFIG_IDLIST = 43

TCEFORM.sys_dmail_group.select_categories.PAGE_TSCONFIG_IDLIST = 43

Wichtig:

Dies muss auf allen Seiten und in allen Sysordnern geschehen, die von Direct Mail genutzt werden: also alle Seiten und Sysordner der Benutzerregistrierung und alle Seiten und Sysfolder der Direct Mail. Nur Unterseiten, die diese TSConfig Einstellungen erben, können Sie unberücksichtigt lassen (s. auch den entsprechenden Teil im Handbuch, für die Frontendbenutzerregistrierung s. das deutsche Tutorial).

Newsletter versenden

Sie haben bereits eine Seite für Ihre Newsletter angelegt und einen Seiteninhalt erstellt. Diese Seite können Sie nun mit oder ohne Kategorieangaben versenden.

Bitte beachten Sie bei Anlegen eines Newsletters, dass die Kategorieauswahl erst angezeigt wird, wenn Sie die Seite mit dem Inhalt gespeichert haben. Dann erst ist die Auswahl der Kategorie auf der Seite, bzw. dem Contentelement möglich.

Empfänger erstellen

Erstellen Sie nun im Direct Mail Modul eine Empfängerliste.

Klicken Sie auf den Link “Neue Versandiste erstellen”.

Erstellen Sie eine Empfängerliste auf der Basis “von Seiten” und ordnen Sie als Ausgangspunkt den Ordner mit den Frontendbenutzern zu. Vergeben Sie einen sprechenden Namen für die Liste und wählen Sie die Checkbox “Webbenutzer” aus.

Zusätzlich können, müssen aber nicht, Kategorien ausgewählt werden. Wird keine Kategorie ausgewählt, werden alle Frontendbenutzer im Sysforlder “Webbenutzer” ausgewählt, egal, ob dem Newsletter Kategorien zugewiesen worden sind.

Bei statischen Listen werden die Kategorien ignoriert und zwar insofern, dass die Mails zwar versendet werden, aber leer bleiben.

Wählen Sie jetzt im Webmodul Direct Mail aus und klicken die Newsletterseite an.

Klicken Sie auf “Versand dieser Seite erstellen”.

Nun erhalten Sie die folgende Ansicht:

Wählen Sie aus der zweiten Combobox “Inhalt der E-mail generieren” und Sie gelangen zu folgender Ansicht.

Klicken Sie auf den Button “Inhalt der E-Mail generieren”.

In vielen Installationen müssen Sie vorher den Frontend Cache löschen. Wenn Sie das vergessen, werden Sie informiert: Es erscheint ein “zurück” Button. Starten Sie die Mailgenerierung neu und – löschen Sie vorher den Cache.

Testmail versenden

Versenden Sie zunächst wie folgt eine Test E-Mail um sicherzustellen, dass der Versand funktioniert.

Klicken Sie den “Senden” Button und Ihre Testmail wird gesendet.

Massenversand

Stoßen Sie nun den Massenversand an.

Wählen Sie die entsprechende Versandgruppe aus, klicken Sie den Button “An alle Empfänger der Versandgruppe versenden” und Ihre E-Mails werden versendet.

Wenn Sie andere Versandgruppen erstellen möchten, die nicht auf der hier gezeigten Basis erstellt werden, sehen Sie die entsprechenden Bereiche im Handbuch an.

Versand manuell anstoßen

Sofern Ihre Konfiguration den automatischen Versand von Newslettern nicht erlaubt, können Sie den Versand manuell anstoßen.

Wählen Sie im Direct Mail Modul Versand-Status und klicken den Link “Versand anstoßen” an. Daraufhin sollten Ihre Mails, die bereits für den Versand vorbereitet sind, verschickt werden.

Da jeweils nur 50 E-Mails versendet werden, klicken Sie bei einer größeren Anzahl von Direct Mails “Versand anstoßen”.

Jetzt erhalten Sie die folgende Ansicht.

Wie Sie im Versandstatus sehen, wurden zwei Direct Mails versendet. Das ist korrekt, denn nur zwei der Frontendbnutzer haben die entsprechende Kategorie.

plain text content could not be fetched

Dieses Problem taucht in vielen Installationen auf. Abhilfe schafft hier momentan vor dem “Fetch and Compile” der Email den Cache zu löschen. Seltsamerweise funktioniert der Versand späterer Emails dann ab und an ohne den Cache zu löschen.

HTML Mail – Ansicht des Newsletters

Wenn Sie Html-Emails versenden, dann sieht Ihre Newsletter wie folgt aus (bitte verzeihen Sie die nicht ganz korrekte Wiedergabe des Banners der Seite, da diese Bilder über Outlook erscheinen und der IE 6 keine halbtransparenten Bilder darstellen kann. Im IE 7 ist dieser Fehler des Browsers behoben).

.

Plain Text Ansicht der Seite

Die Templates der Mails wurden bis zu diesem Zeitpunkt in keiner Weise angepasst. Um die HTML Templates anzupassen und an Ihre Bedürfnisse anzupassen gehen Sie wie gewohnt bei der Editierung vor. Die URL für das Abbestellen des Newsletters, die im Plaintext Template wie folgt lautet:

Unsubscribe link: http://herzogkienast.de/?id=85&cmd=edit&aC=###SYS_AUTHCODE###&rU=###USER_uid###

sollten Sie durch die ID der Seite mit der Registrierung ersetzen. In diesem Fall also die 85.

Personalisierte Emails

Um Ihre E-Mails zu personalisieren, müssen entsprechende Marker in den Seiteninhalt eingebunden werden. Stellen Sie sicher, dass keine Standardanrede im Plain Text Template vorhanden ist, sonst erhalten Sie beide Anreden.

Sofern Sie den Marker wie unten angezeigt nutzen, stellen Sie sicher, dass die entsprechenden Felder in der Registrierung auch genutzt werden. Kein Inhalt – keine Anrede. Im Handbuch finden Sie die möglichen Marker, die Sie verwenden können um die Mails zu personalisieren.

Einbinden von tt_news Datensätzen

Sie können Ihre Newsletter aus tt_news Datensätzen erstellen, richtiger: tt_news Datensätze in Ihre Newsletter einbinden.

Installieren Sie zunächst, wenn noch nicht geschehen tt_news über den Extensionmanager. Informationen dazu finden Sie im entsprechenden Manual.

Wenn Sie News Datensätze einbinden, gehen Sie wie folgt vor.

Im Template von Direct Mail muss unter (“Include static form extensions”) das staitsche Template für die Wiedergabe der News im Plain Text angegeben werden.

Erstellen Sie wie bereits beschrieben im Sysfolder von Direct Mail eine neue Seite für die Newsletter aus News. Das ist zwar nicht zwingend notwendig, erleichtert aber die Übersicht.

Wenn Sie nun einen Newsdatensatz einstellen, können Sie dies über “Insert record” als Inhaltselement tun.

Erstellen Sie also einen Inhalt vom Typ “Datensatz einfügen” und wählen die gewünschte(n) News aus dem Sysfolder der tt_news aus.

Im Beispiel ist die Seite mit den News ausgewählt. Momentan gibt es nur eine Nachricht.

Die Templates auch von tt_news sind im Beispiel noch nicht angepasst.

Versionsinformationen

Die hier eingeesetzten Extensions und TYPo3 haben folgende Version:

TYPO3 4.03 (auch getestet unter 4.0.4)

Direct Mail 2.2.0

Frontendbenutzerregistrierung 2.5.5

tt_news: 2.4.0

fh_library o.o.15

Static Info Tables 2.0.0

Bekannnte Probleme

plain text content could not be fetched

Dieses Problem taucht in vielen Installationen auf. Abhilfe schafft hier momentan vor dem “Fetch and Compile” der Email den Cache zu löschen. Seltsamerweise funktioniert der Versand späterer Emails dann manchmal ohne den Cache zu löschen.

Wenn es mal wieder nicht geht – den Cache löschen.

Template wird nicht gefunden

Wenn Sie Template Dateien anlegen, stellen Sie sicher, dass alle auf der korrekten Ebene sind, sonst werden sie nicht gefunden. Beachten Sie auch die korrekte Zuweisung der Templates.

Kategorien

Stellen Sie sicher, dass die Kategorien korrekt zugewiesen werden und im richtigen Sysfolder sind.

Stellen Sie sicher, dass Sie module_sys_dmail_category zu den “Registration Form Fields” hinzugefügt haben.

Aufräumen

Wenn Sie testen, fallen eine Menge Daten an, die Sie im phpMyadmin löschen sollten, da ja (hoffentlich) alle Dateien nur zum Löschen markiert wurden. Auch gelöschte Sysordner und Templates sollten von Zeit zu Zeit entfernt werden. Das wirkt manchmal Wunder.

Static Info Library

In einigen Umgebungen kann es zu Problemen bei der Integration der Static Info Tables kommen.

In einem Fall war das Problem, dass sr_static_info ebenfalls installiert war und in der Frontendbenutzerregistrierung dann nichts angezeigt wurde.

Es genügt dann nicht, nur die sr_static_info zu deinstallieren. Sie müssen außerdem über das Installtool, Database Analyser die nicht genutzen Tabellen entfernen.

Wählen Sie “Compare” und Sie erhalten eine Liste der Felder die hinzugefügt, bzw. entfernt werden sollen.

Danach funktionienen die Ländereinstellungen.

Emails Plain Text personalisieren

Vergessen Sie nicht, das Default Template zu ändern und dort die Standardanrede “Hello” zu entfernen. Speichern Sie das geänderte Template und definieren Sie in den Constants diesen Pfad.

Direct Mail funktioniert gar nicht

Auf manchen Seiten funktioniert Direct Mail einfach nicht. Vielleicht funktionieren noch Testmails und Quickmails.

In komplett “extensionfreien” Umgebungen lässt es sich jedoch installieren und läuft. Installieren Sie also Direct Mail und alle benötigten Extensions als erstes. Kontrollieren Sie nach jeder weiteren Extensioninstallation, ob Direct Mail weiterhin funktioniert.

Wunschliste

Berücksichtigung von Frontend-Benutzergruppen:

Bevor Versandaktivitäten durchgeführt werden, sollen die Mails verschiedenen Benutzergruppen zugeordnet werden können, zusätzlich zu den Kategorien.

Mehrsprachiger Versand:

Sofern eine mehrsprachige Seite vorhanden ist, soll die Mail nur an die Benutzer versendet werden, die in der Frontendbenutzerregistrierung die entsprechende Sprache oder ein entsprechendes Land ausgewählt haben. Die Sprachauswahl kann über die Static Info Tables erfolgen.

Deutsches Handbuch Direct Mail -

Deutsches Handbuch Direct Mail

Installation von Direct Mail

Kasper Skårhøj

2002-11-01T00:32:00

Andrea Herzog-Kienast

Andrea Herzog-Kienast