Description
This WordPress plugin provides integration with Mattermost.
The plugin provides OAuth2 authentication functionality for logging into WordPress via Mattermost.
The plugin provides OAuth2 authentication functionality for registering new WordPress users via Mattermost.
The plugin additionally provides the following notification functionality, using an incoming webhook in Mattermost:
- Notifications for successful login
- Notifications for failed login
- Notifications for unknown user login attempt
- Notifications for password reset
- Notifications for plugin activation
- Notifications for plugin deactivation
- Notifications for plugin uninstallation
- Notifications for new/edited user
- Notifications for deleted user
The plugin can also make use of additional functionality such as posting to a specific channel/user, overriding bot names, and additionally mention specific users.
Other notes:
- This plugin may work with earlier versions of WordPress
- This plugin has been tested with WordPress 5.5.3 to 6.5.5 at the time of this writing
- This plugin has been tested with Mattermost 5.x to 9.x at the time of this writing
- This plugin optionally makes use of the
mb_PHP functions - This plugin may create entries in your PHP error log (if active)
- This plugin contains no Javascript
- This plugin contains no tracking code and does not process or store any information about users
Credits
The Cloudbridge Mattermost WordPress Plugin was written by Joaquim Homrighausen while converting caffeine into code.
Cloudbridge Mattermost is sponsored by WebbPlatsen i Sverige AB, Stockholm, Sweden.
Commercial support and customizations for this plugin is available from WebbPlatsen i Sverige AB in Stockholm, Sweden.
If you find this plugin useful, the author is happy to receive a donation, good review, or just a kind word.
If there is something you feel to be missing from this plugin, or if you have found a problem with the code or a feature, please do not hesitate to reach out to [email protected].
This plugin can also be downloaded from code.webbplatsen.net and GitHub
Installation
This section describes how to install the plugin and get it working.
- Upload the contents of the
cloudbridge-mattermostfolder to the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Configure the basic settings, such as the webhook URL
- To enable OAuth2 authentication, you’ll need to configure your Mattermost instance to allow this: OAuth 2.0 Applications
FAQ
-
Is the plugin locale aware
-
Cloudbridge Mattermost uses standard WordPress functionality to handle localization/locale. The native language localization of the plugin is English. It has been translated to Swedish by the author.
For notifications sent to Mattermost, there is a setting since 1.1.0 that will allow you to override all such messages to be in en_US locale (English).
-
Are there any incompatibilities
-
This is a hard question to answer. There are no known incompatibilities.
-
The short answer is yes. The long answer follows:
Add a filter hook in your functions.php or elsewhere like so:
add_filter(‘cbmm_login_filter’, ‘name_of_your_function’, 10, 1);
Your function will receive one argument, which is an associative array with three items: url, text, and full.
The ‘url’ item contains the url to the OAuth2 handler for the plugin, you should not modify this. The ‘text’ item contains the prompt (“Use Mattermost to login”). The ‘full’ item contains the entire HTML output for the additional Mattermost login section on the WordPress login form.
Your function should always return an associative array. If you want to update just the ‘text’ item, simply do so in the array passed to your function and then return the same array. If you want to completely replace the full HTML output, add an item named ‘override’ to the returned array.
Reviews
Contributors & Developers
“Cloudbridge Mattermost” is open source software. The following people have contributed to this plugin.
Contributors
“Cloudbridge Mattermost” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “Cloudbridge Mattermost” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.2.1
- Refactor code to prevent warnings in PHP log while checking roles
- Verified with Mattermost 8.x, 9.x and WordPress 6.5.x
- Updated various dependencies
2.2.0
- Improved support for Mattermost accounts with 2FA/MFA enabled
- Added possibility to register new users via Mattermost
- Added possibility to register new users only via Mattermost
- Verified with Mattermost 7.x and WordPress 6.x
- Updated various dependencies
2.1.0
- Verified with WordPress 5.8
- Support for Cloudflare
- Minor fixes
2.0.0
- Added OAuth2 support, you can now login to WordPress via Mattermost!
- Changed emoji for admin link to a more suitable one (:link:)
1.1.0
- Moved notifications to a separate tab
- Added notifications for password reset
- Added notification for plugin activation
- Added notification for plugin deactivation
- Added notification for plugin uninstallation
- Added notification for new/edited user
- Added notification for deleted user
- Added general notice emoji (:bell:)
- Added setting to force notifications to be en_US locale (English)
- Login/Login failure hooks are only hooked if webhook URL has been configured
- Corrected locale display/handling of some strings
- Updated donate link
1.0.0
- Initial release