PHPackages                             sas\_sam/flarum-regrole - 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. sas\_sam/flarum-regrole

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

sas\_sam/flarum-regrole
=======================

Allow users to assign roles to themselves during registration.

1.0.5(2y ago)05191MITJavaScript

Since Mar 12Pushed 2y agoCompare

[ Source](https://github.com/SasSam/flarum-regrole)[ Packagist](https://packagist.org/packages/sas_sam/flarum-regrole)[ RSS](/packages/sas-sam-flarum-regrole/feed)WikiDiscussions master Synced 1mo ago

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

Registration Roles
==================

[](#registration-roles)

[![MIT license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/SasSam/flarum-regrole/blob/master/LICENSE) [![Latest Stable Version](https://camo.githubusercontent.com/a886b753bc1a2da769185fdd408477cbe06aa06af00908da561795106f1c1b80/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7361735f73616d2f666c6172756d2d726567726f6c652e737667)](https://packagist.org/packages/sas_sam/flarum-regrole) [![Total Downloads](https://camo.githubusercontent.com/4d1469cee97b9b7c39f95b0a510c275c4ab6e27a9739482671ebff0f58b16d92/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7361735f73616d2f666c6172756d2d726567726f6c652e737667)](https://packagist.org/packages/sas_sam/flarum-regrole)

**Note:** This package is a fork of [the-turk/flarum-regrole](https://github.com/the-turk/flarum-regrole). This package is very handy; however, it has become broken since Flarum v1.7.2 was released ([Discuss](https://discuss.flarum.org/d/24500-registration-roles/62)). The original package has been abandoned as the author is busy. Hence, the fork was the only way to fix it. The version number is continuing the original version number.

Allow users to assign roles to themselves during registration. You can also force existing users.

[![Registration Roles](https://camo.githubusercontent.com/49708f1d478b7015f77f6446102de4d73331229f1293253356caa797a577691b/68747470733a2f2f692e6962622e636f2f4b6846703368512f7265672d526f6c652d5369676e2d55702d4d6f64616c2e706e67)](https://camo.githubusercontent.com/49708f1d478b7015f77f6446102de4d73331229f1293253356caa797a577691b/68747470733a2f2f692e6962622e636f2f4b6846703368512f7265672d526f6c652d5369676e2d55702d4d6f64616c2e706e67)

[Settings Screenshot](https://i.imgur.com/U4URUoG.png)

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

[](#installation)

```
composer require sas_sam/flarum-regrole:"*"
```

Updating
--------

[](#updating)

```
composer update sas_sam/flarum-regrole
php flarum cache:clear
```

Usage
-----

[](#usage)

Enable the extension and set allowed roles from the extension's settings. Also enable the "Force users to assign at least one role to themselves" option to force guests as well as existing users (users with "Edit user groups" permission will be excluded) to have at least one of those allowed roles.

**! Attention:** I've tested this extension as much as I can. However, any malfunction of this extension may cause fatal errors during registration and your users might be unable to use your forum. So please test it yourself (register to your forum and login as existing user if you're forcing them to choose a role) after installation to see if everything is working fine for everyone.

Links
-----

[](#links)

- [Flarum Discuss post](https://discuss.flarum.org/d/34279-registration-roles-fork)
- [Source code on GitHub](https://github.com/SasSam/flarum-regrole)
- [Changelog](https://github.com/SasSam/flarum-regrole/blob/master/CHANGELOG.md)
- [Report an issue](https://github.com/SasSam/flarum-regrole/issues)
- [Download via Packagist](https://packagist.org/packages/sas_sam/flarum-regrole)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 59.4% 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 ~0 days

Total

2

Last Release

788d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8873880a50bff03f5362a9d820cc05a75be67e134281043473251b75b549372a?d=identicon)[SasSam](/maintainers/SasSam)

---

Top Contributors

[![SasSam](https://avatars.githubusercontent.com/u/496429?v=4)](https://github.com/SasSam "SasSam (19 commits)")[![hasan-ozbey](https://avatars.githubusercontent.com/u/48382593?v=4)](https://github.com/hasan-ozbey "hasan-ozbey (6 commits)")[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (5 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (2 commits)")

---

Tags

registrationflarumrole

### Embed Badge

![Health badge](/badges/sas-sam-flarum-regrole/health.svg)

```
[![Health](https://phpackages.com/badges/sas-sam-flarum-regrole/health.svg)](https://phpackages.com/packages/sas-sam-flarum-regrole)
```

###  Alternatives

[fof/oauth

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

50118.7k41](/packages/fof-oauth)[fof/doorman

Create invite codes for users to sign up and be assigned to a group

2537.2k2](/packages/fof-doorman)[maicol07/flarum-ext-sso

SSO for Flarum

468.3k](/packages/maicol07-flarum-ext-sso)[fof/terms

Ask users to accept terms of use before using the forum

1367.8k1](/packages/fof-terms)[fof/passport

The OAuth2 (and Laravel passport) compatible oauth extension

3013.3k](/packages/fof-passport)[foskym/flarum-oauth-center

Allow user to authorize the third clients

221.4k](/packages/foskym-flarum-oauth-center)

PHPackages © 2026

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