In the week of May 27th 2024, Extiverse will be merged into one unified platform: flarum.org. Read more

FoF OAuth

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

Compatible with Flarum v1.8.5

Latest release 1.3.0

1 downloads

released on Oct 8, 2020

Tags

OAuth by FriendsOfFlarum

License Latest Stable Version Total Downloads OpenCollective

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!

Screenshots

Default provider settings example provider setup example

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

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

OpenCollective

An extension by FriendsOfFlarum.

© 2024 Hyn by DaniĆ«l "Luceos" Klabbers. All rights reserved. · Extensions and extension information is provided by the respective (copyright holding) authors. · Extiverse is not affiliated to the Flarum project or Flarum foundation. · Images on Extiverse pages are from Unsplash.