{"id":15026719,"url":"https://github.com/joho1968/cloudbridge-mattermost","last_synced_at":"2025-10-17T00:15:37.745Z","repository":{"id":52084178,"uuid":"314222288","full_name":"joho1968/cloudbridge-mattermost","owner":"joho1968","description":"Provides Mattermost 5-9 integration for WordPress 5/6.","archived":false,"fork":false,"pushed_at":"2024-06-25T10:17:21.000Z","size":399,"stargazers_count":5,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-23T22:13:01.097Z","etag":null,"topics":["mattermost","mattermost-bot","oauth2","php","php74","php81","wordpress","wordpress-development","wordpress-hardening","wordpress-plugin","wordpress-security","wordpress5","wordpress59","wordpress60","wordpress65"],"latest_commit_sha":null,"homepage":"https://github.com/joho1968/cloudbridge-mattermost","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joho1968.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-19T11:07:41.000Z","updated_at":"2025-01-23T09:57:59.000Z","dependencies_parsed_at":"2024-06-25T11:28:49.051Z","dependency_job_id":"78c51a84-3753-4433-930e-f9a93def5cf4","html_url":"https://github.com/joho1968/cloudbridge-mattermost","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joho1968%2Fcloudbridge-mattermost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joho1968%2Fcloudbridge-mattermost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joho1968%2Fcloudbridge-mattermost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joho1968%2Fcloudbridge-mattermost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joho1968","download_url":"https://codeload.github.com/joho1968/cloudbridge-mattermost/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248104276,"owners_count":21048314,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mattermost","mattermost-bot","oauth2","php","php74","php81","wordpress","wordpress-development","wordpress-hardening","wordpress-plugin","wordpress-security","wordpress5","wordpress59","wordpress60","wordpress65"],"created_at":"2024-09-24T20:04:57.160Z","updated_at":"2025-10-17T00:15:37.739Z","avatar_url":"https://github.com/joho1968.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Software License](https://img.shields.io/badge/License-GPL%20v2-green.svg?style=flat-square)](LICENSE) [![PHP 8.1\\+](https://img.shields.io/badge/PHP-8.1-blue?style=flat-square)](https://php.net) [![PHP 7.4\\+](https://img.shields.io/badge/PHP-7.4-blue?style=flat-square)](https://php.net) [![WordPress 5.5](https://img.shields.io/badge/WordPress-5.5-orange?style=flat-square)](https://wordpress.org) [![WordPress 6.8](https://img.shields.io/badge/WordPress-6.8-orange?style=flat-square)](https://wordpress.org) [![Mattermost 5](https://img.shields.io/badge/Mattermost-5-blue?style=flat-square)](https://mattermost.com) [![Mattermost 6](https://img.shields.io/badge/Mattermost-6-blue?style=flat-square)](https://mattermost.com) [![Mattermost 7](https://img.shields.io/badge/Mattermost-7-blue?style=flat-square)](https://mattermost.com) [![Mattermost 8](https://img.shields.io/badge/Mattermost-8-blue?style=flat-square)](https://mattermost.com) [![Mattermost 9](https://img.shields.io/badge/Mattermost-9-blue?style=flat-square)](https://mattermost.com) [![Mattermost 10](https://img.shields.io/badge/Mattermost-10-blue?style=flat-square)](https://mattermost.com)\n\n# Cloudbridge Mattermost (CBMM)\n\nMattermost integration for WordPress. Tested with Mattermost 5.30.1+ and WordPress 5.5+.\n\n## Description\n\nThis WordPress plugin provides integration with Mattermost.\n\nThe WordPress slug is `cloudbridge-mattermost`.\n\nThe plugin is also available on [wordpress.org](https://wordpress.org/plugins/cloudbridge-mattermost/)\n\nThe plugin provides `OAuth2 authentication` functionality for logging into WordPress via Mattermost.\n\nThe plugin provides `OAuth2 authentication` functionality for registering new WordPress users via Mattermost.\n\nThe plugin additionally provides the following `notification` functionality, using an `incoming webhook` in Mattermost:\n\n* Notifications for successful login\n* Notifications for failed login\n* Notifications for unknown user login attempt\n* Notifications for password reset\n* Notifications for plugin activation\n* Notifications for plugin deactivation\n* Notifications for plugin uninstallation\n* Notifications for new/edited user\n* Notifications for deleted user\n* Notifications for admin e-mail change\n\nThe plugin can also make use of additional functionality such as posting to a specific channel/user, overriding bot names, and additionally mention specific users.\n\n### Other notes\n\n* This plugin may work with earlier versions of WordPress\n* This plugin has been tested with PHP `7.4.x` and `8.1.x` at the time of this writing\n* This plugin has been tested with WordPress `5.5.x` to `6.8.x` at the time of this writing\n* This plugin has been tested with Mattermost `5.x` to `10.x` at the time of this writing\n* This plugin optionally makes use of the `mb_` PHP functions\n* This plugin may create entries in your PHP error log (if active)\n* This plugin contains no Javascript\n* This plugin contains no tracking code and does not process or store any information about users\n\n## Installation\n\nThis section describes how to install the plugin and get it working.\n\n1. Upload the `cloudbridge-mattermost` folder to the `/wp-content/plugins/` directory (or install it from the 'Plugins' menu in WordPress)\n2. Activate the plugin through the 'Plugins' menu in WordPress\n3. Configure the basic settings, such as the webhook URL\n\n## Frequently Asked Questions\n\n### Is the plugin locale aware\n\nCloudbridge 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.\n\nFor 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).\n\n### Are there any incompatibilities\n\nThis is a hard question to answer. There are no known incompatibilities.\n\n### Is there a way to customize the Mattermost login button\n\nThe short answer is yes. The long answer follows:\n\nAdd a filter hook in your functions.php or elsewhere like so:\n\n\u003e add_filter('cbmm_login_filter', 'name_of_your_function', 10, 1);\n\nYour function will receive one argument, which is an associative array with three items: url, text, and full.\n\nThe '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.\n\nYour 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.\n\n### What callback URL do I have to setup on Mattermost\n\nThe URL should be:\n`https://\u003cthe name of your site\u003e/wp-content/plugins/mattermost/includes/cbmm-oauth2.php`\n\nIf your `wp-content/plugins` is not in a standard place, then you will need to replace that with the correct URL to it.\n\n## Changelog\n\n### 2.2.2\n* Added support for admin e-mail change notification\n* Added support for inhibiting admin e-mail address change e-mail sending\n* Verified with Mattermost 8.x, 9.x, 10.x and WordPress 6.8.x\n* Thanks to Nelson (castillo-n) for various fixes (PR#1)\n* Added missing property `$cbmm_site_label` to class\n* Removed use of `FILTER_SANITIZE_STRING` (deprecated in PHP 8.1)\n* Removed use of uninitialized variables (exception handling)\n* Changed link to documentation for Mattermost webhooks\n\n### 2.2.1\n* Refactor code to prevent warnings in PHP log while checking roles\n* Verified with Mattermost 8.x, 9.x and WordPress 6.5.x\n* Updated various dependencies\n\n### 2.2.0\n* Improved support for Mattermost accounts with 2FA/MFA enabled\n* Added possibility to register new users via Mattermost!\n* Added possibility to register new users only via Mattermost!\n* Verified with Mattermost 7.x and WordPress 6.x\n* Updated various dependencies\n\n### 2.1.0\n* Verified with WordPress 5.8\n* Support for Cloudflare\n* Minor fixes\n\n### 2.0.0\n* Added `OAuth2 support`, you can now login to WordPress via Mattermost!\n* Changed emoji for admin link to a more suitable one (:link:)\n\n### 1.1.0\n* Moved notifications to a separate tab\n* Added notifications for password reset\n* Added notification for plugin activation\n* Added notification for plugin deactivation\n* Added notification for plugin uninstallation\n* Added notification for new/edited user\n* Added notification for deleted user\n* Added general notice emoji (:bell:)\n* Added setting to force notifications to be en_US locale (English)\n* Login/Login failure hooks are only hooked if webhook URL has been configured\n* Corrected locale display/handling of some strings\n* Updated donate link\n\n### 1.0.0\n* Initial release\n\n## Upgrade Notice\n\n### 2.2.2\n* Simply install/upgrade 2.x to 2.2.0 and walk through the settings\n\n### 2.2.1\n* Simply install/upgrade 2.x to 2.2.0 and walk through the settings\n\n### 2.2.0\n* Simply install/upgrade 2.x to 2.2.0 and walk through the settings\n\n### 2.1.0\n* Simply install/upgrade 2.x to 2.1.0 and walk through the settings\n\n### 2.0.0\n* Simply install/upgrade 1.x to 2.0.0 and walk through the settings\n\n### 1.1.0\n* Simply install/upgrade 1.0.0 to 1.1.0 and walk through the settings\n\n### 1.0.0\n* Initial release\n\n## License\n\nPlease see [LICENSE](LICENSE) for a full copy of GPLv2\n\nCopyright 2020-2025 [Joaquim Homrighausen](https://github.com/joho1968); all rights reserved.\n\nThis file is part of Cloudbridge Mattermost (CBMM). Cloudbridge Mattermost is free software.\n\nYou may redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation.\n\nCloudbridge Mattermost is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with the CBMM package. If not, write to:\n\n```\nThe Free Software Foundation, Inc.,\n51 Franklin Street, Fifth Floor\nBoston, MA  02110-1301, USA.\n```\n\n## Credits\n\nThe Cloudbridge Mattermost WordPress Plugin was written by Joaquim Homrighausen while converting :coffee: into code.\n\nCloudbridge Mattermost is sponsored by [WebbPlatsen i Sverige AB](https://webbplatsen.se), Sweden :sweden:\n\nCommercial support and customizations for this plugin is available from WebbPlatsen i Sverige AB in Sweden :sweden:\n\nIf you find this plugin useful, the author is happy to receive a donation, good review, or just a kind word.\n\nIf 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.\n\nThis plugin can also be downloaded from [code.webbplatsen.net](https://code.webbplatsen.net/wordpress/cloudbridge-mattermost/) and [WordPress.org](https://wordpress.org/plugins/cloudbridge-mattermost/)\n\nKudos to [The League of Extraordinary Packages](https://thephpleague.com/).\n\n### External references\n\nThese links are not here for any sort of endorsement or marketing, they're purely for informational purposes.\n\n* Mattermost; https://mattermost.com\n* me; :monkey: https://joho.se and https://github.com/joho1968\n* WebbPlatsen; https://webbplatsen.se and https://code.webbplatsen.net\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoho1968%2Fcloudbridge-mattermost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoho1968%2Fcloudbridge-mattermost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoho1968%2Fcloudbridge-mattermost/lists"}