PHPackages                             piwind/username-request - 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 &amp; Authorization](/categories/authentication)
4. /
5. piwind/username-request

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

piwind/username-request
=======================

Allow users to request new usernames

v1.3.0(1y ago)0238MITPHP

Since May 16Pushed 1y agoCompare

[ Source](https://github.com/piwind/username-request)[ Packagist](https://packagist.org/packages/piwind/username-request)[ RSS](/packages/piwind-username-request/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (2)Used By (0)

Username Request
================

[](#username-request)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/7426c2b38b441bc945c33983ec6f4d2dd4605f83d27fed74fcd523fb9cde8839/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f706977696e642f757365726e616d652d726571756573742e737667)](https://packagist.org/packages/piwind/username-request) [![Total Downloads](https://camo.githubusercontent.com/7f0fb7a650b899478cce1737eb12386f2b75ae50e363806fc22126b8b9fe70da/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f706977696e642f757365726e616d652d726571756573742e737667)](https://packagist.org/packages/piwind/username-request)

A [Flarum](http://flarum.org) extension. Allows users to request new usernames which can be approved by moderators or admins.

About This Fork
---------------

[](#about-this-fork)

This repository is a fork of [FriendsOfFlarum/username-request](https://github.com/FriendsOfFlarum/username-request), with bug fixes and text optimization.

Installation &amp; Updating
---------------------------

[](#installation--updating)

Install with composer:

```
composer require piwind/username-request:"*"
```

Updating:

```
composer update piwind/username-request
```

Usage
-----

[](#usage)

**If nickname changes are open to all users:**

- In the `flarum/nicknames` extension, set the **"Edit Own Nickname"** permission to **"Members"**.
- In this extension, set the **"Request nickname change"** permission to **"Admin"** only.

**If nickname changes require approval:**

- In the `flarum/nicknames` extension, set the **"Edit Own Nickname"** permission to **"Admin"** only.
- In this plugin, set the **"Request nickname change"** permission to **"Members"**.

With these permission settings, the user settings page will display only **one** nickname change button (instead of two duplicate buttons) for all non-admin accounts.

如果更改昵称是开放的，则插件 `flarum/nicknames` 中的 **"更改个人昵称"** 的权限设置为 **"注册用户"**，本插件的 **"申请更改昵称"** 的权限设置为 **"管理"**。

如果更改昵称需要申请并审核通过，则插件 `flarum/nicknames` 中的 **"更改个人昵称"** 的权限设置为 **"管理"**，本插件的 **"申请更改昵称"** 的权限设置为 **"注册用户"**。

基于以上权限设置，能确保除了管理员之外的所有账户，用户设置页都是只显示一个更改昵称的按钮，而不是两个重复的按钮。

TODO
----

[](#todo)

- resources/views/emails/nicknameRequestRejected.blade.php 下的old\_nickname用的是$user-&gt;display\_name，这个是不一定的
- 申请更改用户名、申请更改昵称，点按钮后如果已经有提交的申请会弹出不同的窗口，但是刷新网页后无法看到申请的状态（是否已经提交申请请求）
- 限制n天内只能修改一次用户名/昵称

Links
-----

[](#links)

- [Packagist](https://packagist.org/packages/piwind/username-request)
- [GitHub](https://github.com/piwind/username-request)

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance50

Moderate activity, may be stable

Popularity11

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

367d ago

### Community

Maintainers

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

---

Top Contributors

[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (16 commits)")[![piwind](https://avatars.githubusercontent.com/u/45837397?v=4)](https://github.com/piwind "piwind (15 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![KyrneDev](https://avatars.githubusercontent.com/u/13856015?v=4)](https://github.com/KyrneDev "KyrneDev (8 commits)")[![Ralkage](https://avatars.githubusercontent.com/u/2059356?v=4)](https://github.com/Ralkage "Ralkage (6 commits)")[![karaok491](https://avatars.githubusercontent.com/u/72854852?v=4)](https://github.com/karaok491 "karaok491 (4 commits)")[![askvortsov1](https://avatars.githubusercontent.com/u/38059171?v=4)](https://github.com/askvortsov1 "askvortsov1 (3 commits)")[![dsevillamartin](https://avatars.githubusercontent.com/u/6401250?v=4)](https://github.com/dsevillamartin "dsevillamartin (3 commits)")[![iPurpl3x](https://avatars.githubusercontent.com/u/18526076?v=4)](https://github.com/iPurpl3x "iPurpl3x (1 commits)")[![DavideIadeluca](https://avatars.githubusercontent.com/u/146922689?v=4)](https://github.com/DavideIadeluca "DavideIadeluca (1 commits)")[![datlechin](https://avatars.githubusercontent.com/u/56961917?v=4)](https://github.com/datlechin "datlechin (1 commits)")[![SychO9](https://avatars.githubusercontent.com/u/20267363?v=4)](https://github.com/SychO9 "SychO9 (1 commits)")

---

Tags

flarumFriends of Flarum

### Embed Badge

![Health badge](/badges/piwind-username-request/health.svg)

```
[![Health](https://phpackages.com/badges/piwind-username-request/health.svg)](https://phpackages.com/packages/piwind-username-request)
```

###  Alternatives

[fof/oauth

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

50118.7k41](/packages/fof-oauth)[fof/user-bio

Add a user bio to user profiles

2196.5k9](/packages/fof-user-bio)[fof/doorman

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

2537.2k2](/packages/fof-doorman)[fof/drafts

Allow users to create post and discussion drafts

1771.1k5](/packages/fof-drafts)[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)

PHPackages © 2026

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