Table of Contents
SwiftMailer Plugin
Compatible with DokuWiki
Hrun, Ponder Stibbons, Binky, Weatherwax
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
This extension is marked as obsoleted. Therefore it is hidden in the Extension Manager and the extension listing. Furthermore, it is candidate for removal.
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
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+.
Changes
- Merge pull request #33 from dokuwiki-translate/lang_update_756_151948… (2018-03-05 19:56)
- translation update (2018-02-24 16:10)
- Merge pull request #32 from dokuwiki-translate/lang_update_497 (2017-08-26 11:46)
- translation update (2017-08-26 11:15)
- Version upped (2016-02-03 18:20)
- Merge pull request #30 from splitbrain-forks/php7-signature (2016-02-03 12:55)
- Adjust method signatures to match parent (2016-02-03 12:47)
- Version upped (2016-01-24 14:16)
Configuration
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.
When the last option is enabled the whole SMTP session will be printed directly to the screen when sending the mail fails.
Testing
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.
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.