PHPackages                             import-ai/flarum-generic-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. import-ai/flarum-generic-oauth

Abandoned → [import-ai/flarum-oauth-passport](/?search=import-ai%2Fflarum-oauth-passport)Flarum-extension

import-ai/flarum-generic-oauth
==============================

Generic OAuth2 provider for Flarum

07

Since Jul 2Pushed 1y agoCompare

[ Source](https://github.com/import-ai/flarum-generic-oauth)[ Packagist](https://packagist.org/packages/import-ai/flarum-generic-oauth)[ RSS](/packages/import-ai-flarum-generic-oauth/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Log in with custom OAuth2 Server
================================

[](#log-in-with-custom-oauth2-server)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/e010d013ffe42316b86135b01a90e004d98ee71dcfbc1aa6dd3020e3806debc6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c743935302f6f617574682d67656e657269632e737667)](https://packagist.org/packages/blt950/oauth-generic) [![Total Downloads](https://camo.githubusercontent.com/10c11dc3d2689fcb9879bee563d6db3fbc13ac6e04282842fba467c9868411d8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626c743935302f6f617574682d67656e657269632e737667)](https://packagist.org/packages/blt950/oauth-generic)

A [Flarum](http://flarum.org) extension. Generic oauth provider for Flarum

[![](https://camo.githubusercontent.com/5ec831c4d9a31079425b65879e38c21aa0fd6ebdfc082b0af50ab1da7d7c8a3e/68747470733a2f2f6578746976657273652e636f6d2f657874656e73696f6e2f626c743935302f6f617574682d67656e657269632f6f70656e2d67726170682d696d616765)](https://camo.githubusercontent.com/5ec831c4d9a31079425b65879e38c21aa0fd6ebdfc082b0af50ab1da7d7c8a3e/68747470733a2f2f6578746976657273652e636f6d2f657874656e73696f6e2f626c743935302f6f617574682d67656e657269632f6f70656e2d67726170682d696d616765)

Features
--------

[](#features)

Adds a `Generic` provider to [FoF OAuth](https://github.com/FriendsOfFlarum/oauth) to enable `Login with ` functionality.

Installation
------------

[](#installation)

Install with composer:

```
composer require blt950/oauth-generic
```

Configuration
-------------

[](#configuration)

### Admin Panel

[](#admin-panel)

Example configuration, please consult your provider for the correct values.

- Client ID ``
- Client Secret ``
- Scope `` or empty
- Authorization Endpoint `https://yourprovider.com/oauth/authorize`
- Token Endpoint `https://yourprovider.com/oauth/token`
- User Information Endpoint `https://yourprovider.com/api/user`

To correctly find your user fields that might be nested in arrays, the parameters support nesting such as:

- User ID `data-id`
- Username `data-username`
- Email `data-personal-email`

Forcing or suggesting fields gives you the possiblity to force or pre-fill a suggested value when signing up the user.

- Force User ID `1` or `0`.
- Force Display Name `1` or `0`.
- Force Email `1` or `0`.

### Provider Name

[](#provider-name)

If you wish to change the name of provider you can do so by editing the locale file. I did not find a way to make this dynamic.

Updating
--------

[](#updating)

```
composer update blt950/oauth-generic
php flarum cache:clear
```

Requests and Issues
-------------------

[](#requests-and-issues)

Please file a pull request if you find issues or want to expand the functionality. Thank you for contributing.

### Known quirks and bugs

[](#known-quirks-and-bugs)

- The nickname input field in signup modal fills in username regardless of display name is provided. This is due to get fixed [in this pull request for a future Flarum version](https://github.com/flarum/framework/pull/4004)
- The icon of provider in admin panel is invisible due to FoF OAuth plugin forces a font-weight that won't display the font, it shows correctly other places though.
- The force settings are a boolean but have a string input, simply because boolean values are not supported for provider settings.

Links
-----

[](#links)

- [Packagist](https://packagist.org/packages/blt950/oauth-generic)
- [GitHub](https://github.com/blt950/flarum-ext-oauth-generic)
- [Discuss](https://discuss.flarum.org/d/34777-generic-and-customized-oauth2)

###  Health Score

14

—

LowBetter than 2% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity18

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1c6fa04ffefda5bef57e9401b6e723e2a56db702f5ea28b92e039febd0ea050f?d=identicon)[import-ai](/maintainers/import-ai)

---

Top Contributors

[![blt950](https://avatars.githubusercontent.com/u/2505044?v=4)](https://github.com/blt950 "blt950 (4 commits)")

### Embed Badge

![Health badge](/badges/import-ai-flarum-generic-oauth/health.svg)

```
[![Health](https://phpackages.com/badges/import-ai-flarum-generic-oauth/health.svg)](https://phpackages.com/packages/import-ai-flarum-generic-oauth)
```

PHPackages © 2026

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