Cloudbridge Mattermost

ཞིབ་བརྗོད།

This WordPress plugin provides integration with Mattermost.

The plugin provides OAuth2 authentication functionality for logging into WordPress 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, 5.6, 5.7, and 5.8 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 support@webbplatsen.se.

This plugin can also be downloaded from code.webbplatsen.net and GitHub

སྒྲིག་འཇུག

This section describes how to install the plugin and get it working.

  1. Upload the contents of the cloudbridge-mattermost folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Configure the basic settings, such as the webhook URL
  4. 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.

Is there a way to customize the Mattermost login button

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.

གདེང་འཇོག

2020 ལོའི་ཟླ 12 ཚེས 2 ཉིན།
I manage a lot of WordPress sites and this plugin really help me.
གདེང་འཇོག 1 ཡོངས་སུ་ཀློག

བྱས་རྗེས་འཇོག་མཁན། & གསར་འབྱེད་པ།

“Cloudbridge Mattermost” is open source software. The following people have contributed to this plugin.

བྱས་རྗེས་འཇོག་མཁན།

“Cloudbridge Mattermost” has been translated into 1 locale. Thank you to the translators for their contributions.

ཁྱེད་ཀྱི་སྐད་ཡིག་ནང་ལ་ “Cloudbridge Mattermost” ཡིག་སྒྱུར་བྱོས།

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

དག་བཅོས་ཉིན་ཐོ།

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