PHPackages                             alexanderomara/flarum-wp-users - 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. alexanderomara/flarum-wp-users

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

alexanderomara/flarum-wp-users
==============================

Flarum WP Users: Use WordPress for user accounts and authentication

1.5.3(1y ago)12469↓100%2[2 PRs](https://github.com/AlexanderOMara/flarum-wp-users/pulls)MPL-2.0PHPCI failing

Since Mar 29Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/AlexanderOMara/flarum-wp-users)[ Packagist](https://packagist.org/packages/alexanderomara/flarum-wp-users)[ Docs](https://github.com/AlexanderOMara/flarum-wp-users)[ RSS](/packages/alexanderomara-flarum-wp-users/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (16)Used By (0)

flarum-wp-users
===============

[](#flarum-wp-users)

Flarum WP Users: Use WordPress for user accounts and authentication

Overview
========

[](#overview)

This is an extension which uses a WordPress install to replace the user account authentication system, keeping the same usernames and emails.

It works by inserting an authentication middleware into Flarum which validates WordPress session cookies, and logs into a Flarum user (creating user if necessary).

Validating WordPress cookies is done by parsing the cookie and connecting to the WordPress database to validate the session; no WordPress code or plugins needed.

Because there is only one session cookie, when the user logs out they are logged out on both WordPress and Flarum.

Also want to use the same avatars that WordPress does? Check out my [flarum-gravatar](https://github.com/AlexanderOMara/flarum-gravatar) extension.

Installation
============

[](#installation)

1. Install WordPress.
2. Install Flarum in a subdirectory of your WordPress install.
    - If WordPress is installed at `example.com` you might install Flarum at `example.com/forum`.
    - Check Flarum install documentation for instructions to remove the `public` directory.
    - Use the same email address for the admin account as you did for WordPress, so they can merge.
3. Install this Flarum extension.

```
composer require AlexanderOMara/flarum-wp-users

```

4. Configure the extension with all the values it needs from the WordPress install.
5. Optionally enable the `WordPress` User Display Name driver under Administration to use the display names from WordPress users.

Notes
=====

[](#notes)

This extension prevents regular Flarum users from changing their username, email, or setting a password if one has not been set (users created by this extension do not have passwords set). Only an admin can set these values on the Flarum users (this should be avoided).

If a WordPress user's username or email changes, it will update the values on the Flarum user next time they authenticate with Flarum. If there are any conflits, so long as it is with a user that this extension manages, the conflicting user will be modified to a unique value; otherwise the user will not authenticate.

In a pinch you can bypass WordPress and login to the local account directly by adding `#localuser` to the URL bar (possible for Flarum accounts with a password set). This password will not update when the WordPress user changes their password.

Bugs
====

[](#bugs)

If you find a bug or have compatibility issues, please open a ticket under issues section for this repository.

License
=======

[](#license)

Copyright (c) 2020-2025 Alexander O'Mara

Licensed under the Mozilla Public License, v. 2.0.

If this license does not work for you, feel free to contact me.

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance68

Regular maintenance activity

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity64

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~143 days

Recently: every ~369 days

Total

14

Last Release

372d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3e36806b51e8bd9662c4a7f6aa9adb026503a8dac006ce64dea9033b60b3a071?d=identicon)[AlexanderOMara](/maintainers/AlexanderOMara)

---

Top Contributors

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

---

Tags

wordpressAuthenticationuserSSOintegrationaccountflarum

### Embed Badge

![Health badge](/badges/alexanderomara-flarum-wp-users/health.svg)

```
[![Health](https://phpackages.com/badges/alexanderomara-flarum-wp-users/health.svg)](https://phpackages.com/packages/alexanderomara-flarum-wp-users)
```

###  Alternatives

[maicol07/flarum-ext-sso

SSO for Flarum

468.3k](/packages/maicol07-flarum-ext-sso)[nomiscz/flarum-ext-auth-wechat

Allow users to log in with WeChat

152.5k](/packages/nomiscz-flarum-ext-auth-wechat)

PHPackages © 2026

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