PHPackages                             mircle/flarum-ext-group-list - 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. [Utility & Helpers](/categories/utility)
4. /
5. mircle/flarum-ext-group-list

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

mircle/flarum-ext-group-list
============================

List select groups and their members

1.0.14(11mo ago)066MITJavaScript

Since Jul 22Pushed 11mo agoCompare

[ Source](https://github.com/xll98/flarum-ext-group-list)[ Packagist](https://packagist.org/packages/mircle/flarum-ext-group-list)[ RSS](/packages/mircle-flarum-ext-group-list/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (2)Versions (3)Used By (0)

Group List
==========

[](#group-list)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/ec8b8cd92b4a6a6f4104c0435eeca3280e3ae98ee7a4c02dd06a8eece99bd305/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6972636c652f666c6172756d2d6578742d67726f75702d6c6973742e737667)](https://packagist.org/packages/mircle/flarum-ext-group-list) [![Total Downloads](https://camo.githubusercontent.com/205f9e07c59206a83483a69ae132b4ea6f06612615e282684f448c90f945dee1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6972636c652f666c6172756d2d6578742d67726f75702d6c6973742e737667)](https://packagist.org/packages/mircle/flarum-ext-group-list) [![Donate](https://camo.githubusercontent.com/0d6e4d8b50b5983a58205941b1a581b1305903393b7a39da574e3f60af3c7f5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617970616c2d646f6e6174652d79656c6c6f772e737667)](https://www.paypal.me/mircle)

群组申请功能安装说明
==========

[](#群组申请功能安装说明)

功能概述
----

[](#功能概述)

本插件在原有群组列表功能基础上，新增了用户申请加入群组的功能，包括：

1. **用户申请功能**：用户可以申请加入特定群组，提交文字说明和图片
2. **图片上传**：使用 fof/upload 扩展进行图片上传
3. **管理员审核**：管理员可以在后台审核申请，批准或拒绝
4. **申请状态跟踪**：用户可以查看自己的申请状态

安装步骤
----

[](#安装步骤)

### 1. 安装依赖

[](#1-安装依赖)

确保已安装 `fof/upload` 扩展：

```
composer require fof/upload
```

### 2. 安装本插件

[](#2-安装本插件)

```
composer require mircle/flarum-ext-group-list
```

### 3. 运行数据库迁移

[](#3-运行数据库迁移)

```
php flarum migrate
```

### 4. 清理缓存

[](#4-清理缓存)

```
php flarum cache:clear
```

### 5. 设置权限

[](#5-设置权限)

在管理后台中，为相关用户组分配以下权限：

- `mircle-group-list.apply` - 申请加入群组
- `mircle-group-list.review-applications` - 审核群组申请

功能使用
----

[](#功能使用)

### 用户申请群组

[](#用户申请群组)

1. 访问群组列表页面 (`/groups`)
2. 在想要加入的群组下方点击"申请加入"按钮
3. 填写申请内容并上传相关图片
4. 提交申请，等待管理员审核

### 管理员审核申请

[](#管理员审核申请)

1. 在侧边栏点击"群组申请"链接
2. 查看待审核的申请列表
3. 点击"审核申请"按钮
4. 选择批准或拒绝，并填写审核意见
5. 提交审核结果

数据库结构
-----

[](#数据库结构)

新增的 `mircle_group_applications` 表包含以下字段：

- `id` - 主键
- `user_id` - 申请用户ID
- `group_id` - 目标群组ID
- `content` - 申请内容
- `status` - 申请状态 (pending/approved/rejected)
- `reviewed_by` - 审核人ID
- `reviewed_at` - 审核时间
- `review_comment` - 审核意见
- `created_at` - 创建时间
- `updated_at` - 更新时间

注意事项
----

[](#注意事项)

1. 同一用户对同一群组只能有一个待处理的申请
2. 申请被批准后，用户会自动加入该群组
3. 图片上传需要确保 fof/upload 扩展正常工作
4. 建议定期清理已处理的申请记录以优化数据库性能

故障排除
----

[](#故障排除)

### 常见问题

[](#常见问题)

1. **申请按钮不显示**

    - 检查用户是否有 `mircle-group-list.apply` 权限
    - 确认用户不在目标群组中
2. **图片上传失败**

    - 检查 fof/upload 扩展是否正确安装
    - 确认上传目录权限设置正确
3. **审核功能无法使用**

    - 检查管理员是否有 `mircle-group-list.review-applications` 权限

Links
-----

[](#links)

- [GitHub](https://github.com/mircle/flarum-ext-group-list)
- [Packagist](https://packagist.org/packages/mircle/flarum-ext-group-list)
- [Discuss](https://discuss.flarum.org/d/25386)

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance51

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 64.3% 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

347d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/49185575?v=4)[xll98](/maintainers/xll98)[@xll98](https://github.com/xll98)

---

Top Contributors

[![xll98](https://avatars.githubusercontent.com/u/49185575?v=4)](https://github.com/xll98 "xll98 (9 commits)")[![clarkwinkelmann](https://avatars.githubusercontent.com/u/5264300?v=4)](https://github.com/clarkwinkelmann "clarkwinkelmann (5 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/mircle-flarum-ext-group-list/health.svg)

```
[![Health](https://phpackages.com/badges/mircle-flarum-ext-group-list/health.svg)](https://phpackages.com/packages/mircle-flarum-ext-group-list)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59120.6k13](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1034.8k4](/packages/fof-discussion-language)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)[fof/gamification

Upvotes and downvotes for your Flarum community

4066.1k8](/packages/fof-gamification)[fof/best-answer

Mark a post as the best answer in a discussion

25154.0k20](/packages/fof-best-answer)

PHPackages © 2026

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