DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
Sendmail¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed by: | Urs Maag |
Changed: | 2010-04-24T21:44:58.320000000 |
Author: | Urs Maag |
Email: | urs@maag-matzingen.ch |
Info 3: | |
Info 4: |
Sendmail¶
Extension Key: maag_sendmail
Copyright 2004-2006, Urs Maag, <urs@maag-matzingen.ch>
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¶
Sendmail 1
Introduction 1
What does it do? 1
Requirements 1
Languages 1
Users manual 1
Configuration 2
General 2
TypoScript Reference 2
TypoScript Setup 2
To-Do list 3
Changelog 3
Introduction¶
What does it do?¶
The Sendmail plugin let you send the form emails over smtp, mail, sendmail or qmail. Sending over smtp with user authentication is also available.
The plugin takes the email message and sends it with the phpmailer class version 2.0.0 rc3.
The Sendmail plugin extends the typo3 class t3lib_formmail.php.
Requirements¶
This extension requires TYPO3 4.1.6+ and PHP 5.0+.
Languages¶
Error messages from the phpmailer class takes the property $GLOBALS['LANG']->lang for setting the error language.
Users manual¶
First, the extension must be installed. After the extension is installed the mails would be sent over maag_sendmail.
Configuring the plugin, see in section Configuration.
Configuration¶
General¶
TypoScript Reference¶
Please note that the following properties TS template setup are written in a “plugin.maag_sendmail” section.
mailer¶
Property
mailer
Data type
string / stdWrap
Description
Type of mailer. Can be smtp, mail, sendmail, qmail
Default
mailHost¶
Property
mailHost
Data type
string / stdWrap
Description
If mailer = smtp:
Hostname of SMTP-Mail-Server
Default
port¶
Property
port
Data type
int / stdWrap
Description
If mailer = smtp:
Port of SMTP-Mail-Server
Default
25
smtpAuth¶
Property
smtpAuth
Data type
boolean
Description
If mailer = smtp:
Should the SMTP-Mail-Server use smtp authentication?
Default
0
username¶
Property
username
Data type
string / stdWrap
Description
If mailer = smtp:
Username of authentication
Default
password¶
Property
password
Data type
string / stdWrap
Description
If mailer = smtp:
Password of authentication
Default
secure¶
Property
secure
Data type
string / stdWrap
Description
If mailer = smtp, for secure transfers (e.g. gmail):
<empty> / ssl / tls
Default
fromName¶
Property
fromName
Data type
string / stdWrap
Description
Name of sender. Takes this name, if no other name is defined (in formmail)
Default
fromName.pattern¶
Property
fromName.pattern
Data type
string
Description
Pattern for creating the from name.Define the pattern like ###name### ###prename###. Take any field name defined in the standard mail form.
Default
fromAddress¶
Property
fromAddress
Data type
string / stdWrap
Description
Email address of sender. Takes this address, if no other email address is defined (in formmail)
Default
replayEmail.pattern¶
Property
replayEmail.pattern
Data type
string
Description
Pattern for creating the replayEmail.Define the pattern like ###...###. Take any field name defined in the standard mail form.
Default
charSet¶
Property
charSet
Data type
string / stdWrap
Description
charSet of the email
Default
UTF-8
redirect.success.pid¶
Property
redirect.success.pid
Data type
int / stdWrap
Description
Page ID to redirect, if mail sent successfully
Default
redirect.failed.pid¶
Property
redirect.failed.pid
Data type
int / stdWrap
Description
Page ID to redirect, if mail sent unsuccessfully.
If the send mail failed, there is a parameter “mailError” added to the url.
Default
TypoScript Setup¶
When installing this extension, you should use the following setting (example):
plugin.maag_sendmail {
mailer = smtp
mailHost = smtp.gmail.com
port = 465
smtpAuth = 1
username = user
password = pw
fromName = Default Sender
fromName.pattern = ###prename### ###name###
replayEmail.pattern =
fromAddress = Default Sender Address
charSet = UTF-8
secure = ssl
redirect.success.pid =
redirect.failed.pid =
}
Example to take the errormessage from a failed mail sending:
temp.Content = COA
temp.Content {
10 = TEXT
10.data = GPvar:mailError
10.dataWrap = <strong>|</strong>
}
To-Do list¶
nothing yet to do.
Changelog¶
Version 1.1.4:
Updated the PHPMailer to version 5.1
Version 1.1.3:
New Property “replayEmail.pattern” for setting the replay email with any field of the form
Version 1.1.2:
New Property “fromName.pattern” for setting the from name with any field of the form
Version 1.1.1:
Property to make secure transfers (for example for gmail)
Version 1.1.0:
Initial version.
Sendmail - 3