peopleinside / flarum-ext-first-post-approval
Flarum extension to hold the first posts of new users for moderator approval.
Package info
github.com/PeopleInside/flarum-ext-first-post-approval
Type:flarum-extension
pkg:composer/peopleinside/flarum-ext-first-post-approval
Requires
- php: ^8.0
- flarum/approval: ^1.0 || ^2.0
- flarum/core: ^1.0 || ^2.0
- flarum/flags: ^1.0 || ^2.0
Suggests
- peopleinside/flarum-ext-antiflood: Complements first-post approval by preventing rapid-fire posting from both new and existing users.
This package is auto-updated.
Last update: 2026-06-22 16:05:51 UTC
README
This extension holds the first n posts and/or discussions from users for approval.
Some groups can be excluded from the rule on the permissions page.
When a post is approved, it counts +1 towards the number of first posts to approve.
When a discussion is approved, it counts +1 towards the number of first discussions to approve, and also +1 towards the number of first posts.
If you don't set a number of discussions to approve, new discussions will be held for approval based on the number of posts of the user. For example if you require 2 posts to be approved but 0 discussions, if one of the first two interactions of the user is to create a discussion, that discussion will be held for approval. But if they first create two replies that get approved, they can then create their first discussion without approval.
Existing users
If you install this extension on a forum with an existing user base, you might want to manually update the first_post_approval_count and first_discussion_approval_count columns on the users table to prevent existing users from being subjected to the first post approval.
Any number equal or higher than the number configured in the extension settings will cause the approval to be skipped.
Alternatively, you can exclude some groups on the permissions page.
Installation
Flarum's Approval and Flags extensions must be enabled.
composer require peopleinside/flarum-ext-first-post-approval
Updating
To update the extension to the latest version, run:
composer update peopleinside/flarum-ext-first-post-approval
php flarum cache:clear
Uninstalling
To completely remove the extension from your Flarum installation:
composer remove peopleinside/flarum-ext-first-post-approval
php flarum cache:clear
Recommendations
To build a complete moderation toolkit for your forum, this extension works best when combined with:
AntiFlood by PeopleInside
While First Post Approval reviews the very first posts of new users, AntiFlood prevents rapid-fire posting from all users, protecting your forum from spam bursts and accidental flooding. Together, they cover both new accounts and established members.
Install it via Composer:
composer require peopleinside/flarum-ext-antiflood
Support
This extension is under minimal maintenance.
It was developed for a client and released as open-source for the benefit of the community. I might publish simple bugfixes or compatibility updates for free.
This is a fork of https://github.com/clarkwinkelmann/flarum-ext-first-post-approval that introduce support for Flarum 2.0 while try also to have a good code security and some improvements.