It's better when it's simple

User Tools

Site Tools


SwiftMailer Plugin

Compatible with DokuWiki

  • 2015-08-10 "Detritus" unknown
  • 2014-09-29 "Hrun" yes
  • 2014-05-05 "Ponder Stibbons" unknown
  • 2013-12-08 "Binky" yes

plugin 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

Last updated on
Conflicts with

Tagged with email, smtp, smtpauth

:!: You should consider using the new SMTP Plugin instead

This plugin replaces the way DokuWiki sends emails. Instead of relying on PHP's built-in mail function, it uses the 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 does not need to be downloaded separately.

Download and Installation

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



All config options can be set in the configuration manager under the “Swiftmail Plugin Settings” section (see screenshot). Additionally you need to set up the mailfrom option, which is in the “Notification Settings” section of the configuration manager.

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.


The plugin adds a new item to the Admin screen. Using this you can trigger sending a test mail from DokuWiki. If something goes wrong sending this mail, a detailed log is printed.

Known Issues

HTML mails and attachments not supported

This plugin does only support sending plain text emails. HTML mails and attachments are currently not supported (See Issue #7).

Use the the newer SMTP Plugin instead.

Authentication failed (Gmail)

Gmail denies the access of swiftmail as the security is deemed not secure enough. The workaround is to reduce the security level to allow “less secure” app to access Gmail.

Allowing less secure web to access your account

Authentication failed for certain passwords (Gmail)

I had chosen a password containing a dash (“-”). I received “Authentication failed” errors. Simply changing the password to one without a dash got it working.

plugin/swiftmail.txt · Last modified: 2015-09-13 18:09 by Aleksandr