Skip to content

Latest commit

 

History

History
41 lines (33 loc) · 3.2 KB

README.md

File metadata and controls

41 lines (33 loc) · 3.2 KB
Raw

Isango

MyBB Simple Social Login / Registration Plugin Using OAuth2

Compatibility

  • MyBB 1.8.x
  • PHP 7.1+

Implemented Features

  • The plugin can be functionally isolated with a master switch without losing settings, customization and without affecting required running background processes.
  • Administrators can choose to restrict registering new accounts while keeping only login ability.
  • Several modes of inputs are available: Big buttons with text, Small buttons with icon only and a select dropdown. All modes are rendered and available globally.
  • Administrators can choose to allow only one connection per service for a member.
  • Users can login / register through several social gateways in a click.
  • Currently supported: Amazon, Discord, Facebook, Github, Google, Imgur, LinkedIn, Microsoft, Spotify, Twitch, WordPress, Yahoo & Yandex. New services will be added to the plugin over time; however (advanced) users can easily implement other services by creating configuration .ini of the expected service in required pattern (no programming needed). Once a configuration file is created and placed inside inc/plugins/isango folder only re-anabling the plugin will activate the new service with the plugin.
  • Ability to send automated welcome private message to the newly registered user intimating the random password used to register the account.
  • Administrators can choose the usergroup from ACP Plugin Settings under which the new users will be registered and placed, defaults to Registered (gid 2).
  • Users can add the authentication connections from user control panel which will help them logging in using the already registered services.
  • Secure cross email match with user registration table.
  • This plugin, by design, doesn't store access token obtained from providers so that in case of a database compromise your social accounts still remain secure.

Planned features so far

  • Optional ability to allow new users to input desired username while registering with Isango. Currently the plugin attempts to decide a suitable username based on available data received from the used service.
  • Adding more services to the plugin

Installation

  • Exactly same like any other plugins. Users need to upload the files inside upload folder of the package maintaining the already made structure using any FTP / WebDav and install / activate the plugin from ACP.
  • Users need to create App for the website at the service provider's developer site to obtain App ID / Secret which are required to input through MyBB ACP Plugin settings. For detail guidelines on creating App for individual service providers please refer Wiki.

The callback url for all gateways is: http(s)://{$your_site}/member.php?action=login&gateway={$gateway}

For example, if your site is forums.com and you are making app for google, the redirect url you have to set is: https://forums.com/member.php?action=login&gateway=google

For those providers who don't allow fragmented callback url, just set: https://forums.com/member.php ...and it will all work good.

External Dependency:

No external OAuth library has been used in this plugin. It has been implemented complying minimum possible OAuth2 requirements.