Search by

ernestdefoe / permission-desk

ernestdefoe

Permission Desk: a group-first replacement for Flarum's admin Permissions page. See and edit what each group can do in plain words, check what one member can do and why, compare and copy groups, apply presets, review every change before saving, and undo it from the history.

Package info

github.com/ernestdefoe/permission-desk

Language:TypeScript

Type:flarum-extension

pkg:composer/ernestdefoe/permission-desk

Fund package maintenance!

Buy Me A Coffee

Statistics

Installs: 7

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.0.0 2026-11-19 13:02 UTC

This package is auto-updated.

Last update: 2026-11-19 13:22:57 UTC


README

A replacement for Flarum 2's admin Permissions page. Instead of one huge grid of icons, you pick a group and read what it can do in plain words, change it with switches, and review every change before it's saved. Every save can be undone from History. It's built for forums with a lot of tags: 100, 200, more.

What a group can do

What it does

  • Groups. Pick a group and see everything it can do, sorted by area (viewing, posting, replying, moderation…) or by extension, Everywhere or inside one restricted tag. Each permission says what it means ("Can permanently delete anyone's posts") and where it comes from ("via Members"). Search finds a permission by name.
  • Permissions. Every permission and who has it, with filters: what everyone can do, what one group can do, admin only, risky ones, and permissions left over from extensions that are no longer installed.
  • Tags. Every tag in your forum's tree (children under their parents, collapsible), with View, Start and Reply for one group as buttons you click. Search by name or by "Parent › Child", filter to restricted tags, open tags, tags a group can't see, or tags that differ from Everywhere. A warning shows when a child tag's parent is hidden from the group, because the child is then hidden too.
  • Bulk changes across tags. Select tags and allow or take away view, start, reply or everyday moderation for a group, copy every permission from another tag, or restrict and unrestrict them. Restricting first copies Everywhere's permissions into the tag, so nobody gains or loses anything the moment you do it.
  • Check a member. Type a name and see what that one member can do and why: which group gives it, or why not. Unconfirmed email and suspensions are shown the way Flarum treats them (as a guest).
  • Review before saving. Changes are staged, never saved on a click. The review lists them in plain words, flags the risky ones in red (those need a tick), and says when a permission won't work without another ("Also needs: Delete posts", with a button to add it). Add a note for History if you like.
  • History, undo and restore. Every save is one entry with who, when and the note. Undo reverses one entry; Restore to here puts every permission back the way it was right after it. Both open the review first. Rows changed since are skipped, never overwritten. Changes made elsewhere (the classic grid, an extension's install, a command) are found by a nightly check and logged too.
  • Compare, copy and presets. Compare two groups side by side, copy one group's permissions to another, and apply a preset: Read only, Member (Flarum's default), Trusted member, Moderator or Tag moderator. Save any group as your own preset.
  • The classic grid is one click away, for anyone who wants it.

Every tag, for one group

Bulk changes across tags

The review

History

Check a member

Built for a lot of tags

The Tags tab shows every tag for one group on one screen, with search and filters, so 100+ tags stay manageable. Everywhere else a searchable tag picker replaces the long dropdowns, an opened permission lists only the tags where it differs from Everywhere (with a button to make them all match), and the review and History fold the same change across many tags into one line ("in 6 tags", opening to their names).

Safe by design

  • It writes only Flarum's own group_permission table, and only through Flarum's own permission handler, once per permission, inside one transaction. Nothing is half saved.
  • If someone else changed one of the same permissions while you were editing, the whole save is refused, so nothing is overwritten.
  • Admin only. With flarum/audit installed, every change is also in the audit log.

The Tags tab on a phone

It works on phones and in dark mode.

Dark mode

Works with

All optional.

Install

composer require ernestdefoe/permission-desk
php flarum migrate
php flarum cache:clear

Then enable it in the admin. The Permissions page opens Permission Desk. Run Flarum's scheduler (php flarum schedule:run every minute from cron) so changes made outside Permission Desk are logged nightly; History also checks whenever it's opened and before every save.

Update

composer update ernestdefoe/permission-desk
php flarum migrate
php flarum cache:clear

Links

MIT licensed. ☕ If you like the things I have built, consider buying me a coffee.