PHPackages                             mrthat1996/oauth - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. mrthat1996/oauth

ActiveFlarum-extension[Authentication & Authorization](/categories/authentication)

mrthat1996/oauth
================

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

1.3.0(3y ago)08MITPHP

Since Oct 9Pushed 3y agoCompare

[ Source](https://github.com/mrthat1996/fof-oauth)[ Packagist](https://packagist.org/packages/mrthat1996/oauth)[ Docs](https://friendsofflarum.org)[ Fund](https://opencollective.com/fof/donate)[ RSS](/packages/mrthat1996-oauth/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (9)Versions (21)Used By (0)

OAuth by FriendsOfFlarum
========================

[](#oauth-by-friendsofflarum)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/c3457b8129ba2807d11de27cf2ab785e75adb1ac3c2335b5138a6eb1fc236c47/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f662f6f617574682e737667)](https://packagist.org/packages/fof/oauth) [![Total Downloads](https://camo.githubusercontent.com/07878f997c47037f922b91027b3018a1f9d1b7c5abd64c5151aa8b850652047a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666f662f6f617574682e737667)](https://packagist.org/packages/fof/oauthh) [![OpenCollective](https://camo.githubusercontent.com/1903c197bb0307e60d6328653532b8a6b9890b898fbc92e314ab39d699491e74/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f70656e636f6c6c6563746976652d666f662d626c75652e737667)](https://opencollective.com/fof/donate)

A [Flarum](http://flarum.org) extension. Allow users to log in with various OAuth providers

### Bundled providers

[](#bundled-providers)

By default these providers are included:

- Discord
- Facebook
- Github
- Gitlab
- Google
- LinkedIn
- Twitter

### Additional providers

[](#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](https://extiverse.com/extension/ianm/oauth-amazon)
- [Apple](https://extiverse.com/extension/blomstra/oauth-apple)
- [Slack](https://extiverse.com/extension/blomstra/oauth-slack)
- [Line](https://extiverse.com/extension/ianm/oauth-line)
- [Microsoft](https://github.com/imorland/flarum-ext-oauth-microsoft) \*experimental
- [Twitch](https://github.com/imorland/flarum-ext-oauth-twitch)
- [Auth0](https://extiverse.com/extension/lodge104/flarum-ext-oauth-auth0)

### Screenshots

[](#screenshots)

Default provider settings example [![provider setup example](https://user-images.githubusercontent.com/16573496/201470744-ca8be058-f79c-4fc4-8c19-3ac5af2bd44b.png)](https://user-images.githubusercontent.com/16573496/201470744-ca8be058-f79c-4fc4-8c19-3ac5af2bd44b.png)

Login/signup example with `Github`, `Twitter`, `Twitch` and `Google` enabled. [![example login](https://user-images.githubusercontent.com/16573496/201470704-91874f67-284a-4fb2-967c-fd9d0eff2d9f.png)](https://user-images.githubusercontent.com/16573496/201470704-91874f67-284a-4fb2-967c-fd9d0eff2d9f.png)

### Installation

[](#installation)

```
composer require fof/oauth
```

### Updating

[](#updating)

```
composer update fof/oauth
php flarum cache:clear
```

### Configuration

[](#configuration)

#### Translation

[](#translation)

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

- Use `fof-oauth.forum.providers.` to replace the name of the provider on the forum side
- Use `fof-oauth.forum.log_in.with__button` to replace the entire button "Log In with " text

### Extending

[](#extending)

It is possible to add additional `Providers` using an extender. See [OAuth-Amazon](https://github.com/imorland/flarum-ext-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

[](#links)

[![OpenCollective](https://camo.githubusercontent.com/8ea53c451470d1a72789d650c77e2b22eee915f7fbf2cbeeeeaa25f47301efe2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d667269656e64736f66666c6172756d2d3434414545353f7374796c653d666f722d7468652d6261646765266c6f676f3d6f70656e2d636f6c6c656374697665)](https://opencollective.com/fof/donate)

- [Discuss](https://discuss.flarum.org/d/25182)
- [Packagist](https://packagist.org/packages/fof/oauth)
- [GitHub](https://github.com/FriendsOfFlarum/oauth)

An extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum).

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor3

3 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~51 days

Total

16

Last Release

1279d ago

Major Versions

0.3.0 → 1.0.02021-05-22

### Community

Maintainers

![](https://www.gravatar.com/avatar/22009164e7292e7ddd4d288312337da58bf334581410d235bf1c705ddf7f8f7a?d=identicon)[mrthat1996](/maintainers/mrthat1996)

---

Top Contributors

[![clarkwinkelmann](https://avatars.githubusercontent.com/u/5264300?v=4)](https://github.com/clarkwinkelmann "clarkwinkelmann (20 commits)")[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (19 commits)")[![dsevillamartin](https://avatars.githubusercontent.com/u/6401250?v=4)](https://github.com/dsevillamartin "dsevillamartin (18 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (18 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![mrthat1996](https://avatars.githubusercontent.com/u/3494965?v=4)](https://github.com/mrthat1996 "mrthat1996 (3 commits)")[![Lier0](https://avatars.githubusercontent.com/u/28351075?v=4)](https://github.com/Lier0 "Lier0 (3 commits)")[![luuhai48](https://avatars.githubusercontent.com/u/39207570?v=4)](https://github.com/luuhai48 "luuhai48 (1 commits)")[![iamdarkle](https://avatars.githubusercontent.com/u/15818451?v=4)](https://github.com/iamdarkle "iamdarkle (1 commits)")

---

Tags

facebookgoogleoauthgithubgitlabtwitterlinkedindiscordflarumfriendsofflarum

### Embed Badge

![Health badge](/badges/mrthat1996-oauth/health.svg)

```
[![Health](https://phpackages.com/badges/mrthat1996-oauth/health.svg)](https://phpackages.com/packages/mrthat1996-oauth)
```

###  Alternatives

[fof/oauth

Allow users to log in with GitHub, Facebook, Google, Discord, GitLab, LinkedIn, and more!

50118.7k41](/packages/fof-oauth)[hwi/oauth-bundle

Support for authenticating users using both OAuth1.0a and OAuth2 in Symfony.

2.4k21.5M69](/packages/hwi-oauth-bundle)[socialconnect/auth

Social Connect Auth Component

568845.4k5](/packages/socialconnect-auth)[and/oauth

Simple and amazing OAuth library with many providers. Just try it out!

4645.2k2](/packages/and-oauth)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)