====== SwiftMailer plugin ======

---- plugin ----
description: This plugin uses the SwiftMailer class to send DokuWiki mails and supports using a remote SMTP (with optional auth) without relying on PHP's mail() function
author     : Andreas Gohr
email      : andi@splitbrain.org
type       : action
lastupdate : 2011-02-05
compatible : 2009-12-25+, 2010-11-07 "Anteater", 2011-05-25 "Rincewind", "Angua"
depends    : 
conflicts  : 
similar    : 
tags       : email, smtp, smtpauth

downloadurl: http://github.com/splitbrain/dokuwiki-plugin-swiftmail/zipball/master
sourcerepo : http://github.com/splitbrain/dokuwiki-plugin-swiftmail/
bugtracker : http://github.com/splitbrain/dokuwiki-plugin-swiftmail/issues
donationurl: http://donate.dokuwiki.org/Swiftmail
----

This plugin replaces the way how DokuWiki sends emails. Instead of relying on PHP's built-in [[phpfn>mail]] function, it uses the [[http://www.swiftmailer.org|SwiftMailer]] library. This is especially useful when configuring PHP for sending mails is complicated (Windows) or not possible. SwiftMail is included in the plugin and needs not to be downloaded separately.


===== Download and Installation =====

Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the download link given above. Refer to [[:Plugins]] on how to install plugins manually.

==== Changes ====

{{rss>http://github.com/feeds/splitbrain/commits/dokuwiki-plugin-swiftmail/master date}}

===== Configuration =====

All config options can be set in the [[config|configuration manager]] under the "Swiftmail Plugin Settings" section (see screenshot). **Additionally you need to set up the [[config:mailfrom]] option, which is in the "Advanced Settings" section of the configuration manager.** 

{{ :plugin:swiftmail.png?nolink&800 |SwiftMail Plugin Settings}}


When the last option is enabled the whole SMTP session will be printed directly to the screen when sending the mail fails.