FoF OAuth

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

Compatible with Flarum v1.1.1

Latest release 1.1.1

7,961 downloads

released on Oct 8, 2020

Tags

OAuth by FriendsOfFlarum

License Latest Stable Version OpenCollective Donate

A Flarum extension. Allow users to log in with GitHub, Twitter, Facebook, Discord, GitLab, Google and LinkedIn!

Installation

composer require fof/oauth:"*"

Updating

composer update fof/oauth

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-Microsoft 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 GitHub

An extension by FriendsOfFlarum.

© 2022 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.