fof/oauth

Allow users to log in with GitHub, Twitter, Facebook, Google, and more!

1.6.6 2023-12-04 08:35 UTC

Requires

• flarum/core: ^1.8.1
• fof/extend: ^1.3.3
• league/oauth1-client: ^1.10.1
• league/oauth2-facebook: ^2.2.0
• league/oauth2-github: ^3.1.0
• league/oauth2-google: ^4.0.1
• league/oauth2-linkedin: ^5.1.2
• omines/oauth2-gitlab: ^3.3.0
• wohali/oauth2-discord-new: ^1.2.1

Requires (Dev)

• flarum/phpstan: *
• flarum/testing: ^1.0.0

Replaces

• flarum/auth-facebook: *
• flarum/auth-github: *
• flarum/auth-twitter: *
• fof/auth-discord: *
• fof/auth-gitlab: *
• luuhai48/oauth-google: *
• luuhai48/oauth-linkedin: *

MIT

• David Sevilla Martin
• IanM

• oauth
• github
• twitter
• google
• facebook
• linkedin
• gitlab
• discord
• flarum
• friendsofflarum

README

A Flarum extension. Allow users to log in with various OAuth providers

Bundled providers

By default these providers are included:

• Discord
• Facebook
• Github
• Gitlab
• Google
• LinkedIn
• Twitter

Additional providers

Additional OAuth providers are available for this extension. Here's a handy list of known extensions, let us know if you know of any more and we'll get them added!

• Amazon
• Apple
• Slack
• Line
• Microsoft *experimental
• Twitch
• Auth0

Screenshots

Default provider settings example

Login/signup example with Github, Twitter, Twitch and Google enabled.

Installation

composer require fof/oauth

Updating

composer update fof/oauth
php flarum cache:clear

Configuration

Translation

You can replace the text for the forum sign in buttons in two ways.

• Use fof-oauth.forum.providers.<name> to replace the name of the provider on the forum side
• Use fof-oauth.forum.log_in.with_<name>_button to replace the entire button "Log In with " text

Extending

It is possible to add additional Providers using an extender. See OAuth-Amazon for an example of how to accomplish this but basically:

• In your new extension, require fof/oauth as a dependency
• Define a new Provider which extends FoF\OAuth\Provider
• From your new extensions extend.php, register the provider (new FoF\OAuth\Extend\RegisterProvider(MyNewProvider::class))
• Provide the required translations under the fof-oauth namespace. See the linked example extension for details on which keys are required.
• (optionally) Provide an admin panel link to fof/oauth for easy configuration. Again, see the linked example.
• (optionally) Provide any CSS required to style your new login button. See the linked example.

Links

• Discuss
• Packagist
• GitHub

An extension by FriendsOfFlarum.