It's better when it's simple

User Tools

Site Tools


SwiftMailer Plugin

Compatible with DokuWiki

Hrun, Ponder Stibbons, Binky, Weatherwax

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

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Similar to smtp

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

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually. Note: this plugin is not compatible with PHP 7+.



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.

Incompatible with PHP 7

This plugin is incompatible with PHP 7 (see issue #31), use the SMTP Plugin instead.

plugin/swiftmail.txt · Last modified: 2022-07-30 00:16 by Klap-in

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki