EXT: Web>Plugins, Direct Mail - Extended¶

What does it do?¶

This extension extends the Web>Plugins, Direct Mail module in the following ways:

the Web>Plugins, Direct Mail module, extension key direct_mail, and most of its submodules may be translated through the language files of this extension (except the module configuration submodule and the mailing list CSV import dialog);

• the main menu of Direct Mail is also translated (by extending module Web>Plugins, extension key plugin_mgm);
• UserTSConfig may actually be used to control access to the submodules of the Direct Mail module (by extending module Web>Plugins, extension key plugin_mgm);
• honor $TYPO3_CONF_VARS["SYS"]["curlUse"] (by extending system class t3lib_dmailer);
• correctly set the return path (by extending system class t3lib_dmailer);
• correct some misbehaviors: new dmail record being created instead of editing a newly created dmail record, erroneous list of pages shown under "Create a new Direct Mail from newsletter" (by extending module Web>Plugins, Direct Mail module, extension key direct_mail);
• newsletters sent by the mailer engine receive less bad points from spam filtering software; this extension allows to configure the mailer to use quoted-printable or 8bit encoding in place of base64 encoding, corrects the message id, corrects missing boundary, etc. (by extending system class t3lib_dmailer);
• the number of newsletters sent per cycle by the mailer engine and the language used in its notification messages may also be configured with extension configuration variables (by extending system class t3lib_dmailer);
• the use of jump URL's may be configured with the module configuration submodule;
• perform further analysis of the reason texts for the returned mails (by extending system class t3lib_readmail);
• provide finer options for action on returned mails (by extending Web>Plugins, Direct Mail module).

Languages¶

The extension is currently available in Brazilian, Dutch, English, Finnish, French, German and Spanish.

Requirements¶

TYPO3 3.5.0 or more recent.

Version 0.3.1 is the last version of this extension. All corrections and features of this extension are now moved into the base extension : Direct Mail 2.0 for use with TYPO3 4.0+.

Credits¶

Thanks to Martin Kutschker , Robert Böttner , Andreas Schwarzkopf , Bertrand Mure and Urs Weiss for sharing their improvements and corrections to this extension.

Extension configuration¶

Upon installation, the following extension configuration variables may be set:

• the encoding to be used to send the direct mails; default value is “quoted-printable”;
• the TYPO3 language code of the language to be used by the mailing engine cron task when progress messages are sent to the administrator; default value is “en”;
• number of messages sent per cycle of the mailing engine cron task; default value is 50;
• additional DB fields of the recipient : additional fields that may be substituted in the direct mail messages.

UserTSConfig¶

UserTSConfig may be used to control access to the submodules of the Direct Mail module with statements such has:

mod.web_modules.dmail.menu.dmail_mode {

## Enabling the 'Newsletters' submodule:

news= 1

## Enabling the 'Direct Mails' submodule:

direct= 1

## Enabling the 'Mailer Engine Status' submodule:

mailerengine = 1

## Enabling the 'Recipient list' submodule:

recip = 1

## Enabling the 'QuickMail' submodule:

quick= 1

## Enabling the 'Module Configuration' submodule:

conf = 1

## Enabling the 'Instructions' submodule:

help = 1

}

Module configuration¶

This extension adds a new module configuration variable allowing to enable or disable the use of jump URL's.

Mailer Engine cron task configuration¶

This extension also provides an alternative mailer engine script that may be configured as a cron task on the server with a statement such as:

/home/....../public_html/typo3conf/ext/sr_direct_mail_ext/mod/dmai lerd.phpsh> /dev/null

or

/home/....../public_html/typo3/ext/sr_direct_mail_ext/mod/dmailerd .phpsh> /dev/null

Note that the absolute path to the script must be specified.

dmailerd.phpsh is a shell script and requires the availability of a PHP binary, "/usr/bin/php”. Depending on your server configuration, you may have to edit the first line of the script to refer to the location of the PHP binary.

Note that the extension is designed to localize the messages issued by the mailer engine. For this reason, the dmailer cron task provided with the base extension may not work once this extension is installed.