.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ======== 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: Sendmail ======== Extension Key: **maag\_sendmail** Copyright 2004-2006, Urs Maag, 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: 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: Introduction ------------ .. _What-does-it-do: 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: Requirements ^^^^^^^^^^^^ This extension requires TYPO3 4.1.6+ and PHP 5.0+. .. _Languages: Languages ^^^^^^^^^ Error messages from the phpmailer class takes the property $GLOBALS['LANG']->lang for setting the error language. .. _Users-manual: 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: Configuration ------------- .. _General: General ^^^^^^^ .. _TypoScript-Reference: TypoScript Reference ^^^^^^^^^^^^^^^^^^^^ Please note that the following properties TS template setup are written in a “plugin.maag\_sendmail” section. .. ### BEGIN~OF~TABLE ### .. _mailer: mailer """""" .. container:: table-row Property mailer Data type string / stdWrap Description Type of mailer. Can be smtp, mail, sendmail, qmail Default mail .. _mailHost: mailHost """""""" .. container:: table-row Property mailHost Data type string / stdWrap Description If mailer = smtp: Hostname of SMTP-Mail-Server Default .. _port: port """" .. container:: table-row Property port Data type int / stdWrap Description If mailer = smtp: Port of SMTP-Mail-Server Default 25 .. _smtpAuth: smtpAuth """""""" .. container:: table-row Property smtpAuth Data type boolean Description If mailer = smtp: Should the SMTP-Mail-Server use smtp authentication? Default 0 .. _username: username """""""" .. container:: table-row Property username Data type string / stdWrap Description If mailer = smtp: Username of authentication Default .. _password: password """""""" .. container:: table-row Property password Data type string / stdWrap Description If mailer = smtp: Password of authentication Default .. _secure: secure """""" .. container:: table-row Property secure Data type string / stdWrap Description If mailer = smtp, for secure transfers (e.g. gmail): / ssl / tls Default .. _fromName: fromName """""""" .. container:: table-row Property fromName Data type string / stdWrap Description Name of sender. Takes this name, if no other name is defined (in formmail) Default .. _fromName-pattern: fromName.pattern """""""""""""""" .. container:: table-row 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: fromAddress """"""""""" .. container:: table-row 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: replayEmail.pattern """"""""""""""""""" .. container:: table-row 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: charSet """"""" .. container:: table-row Property charSet Data type string / stdWrap Description charSet of the email Default UTF-8 .. _redirect-success-pid: redirect.success.pid """""""""""""""""""" .. container:: table-row Property redirect.success.pid Data type int / stdWrap Description Page ID to redirect, if mail sent successfully Default .. _redirect-failed-pid: redirect.failed.pid """"""""""""""""""" .. container:: table-row 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 .. ###### END~OF~TABLE ###### .. _TypoScript-Setup: 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 = \| } .. _To-Do-list: To-Do list ---------- nothing yet to do. .. _Changelog: 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. |img-1| Sendmail - 3 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102