peopleinside/flarum-ext-first-post-approval

Flarum extension to hold the first posts of new users for moderator approval.

Maintainers

Package info

github.com/PeopleInside/flarum-ext-first-post-approval

Type:flarum-extension

pkg:composer/peopleinside/flarum-ext-first-post-approval

Transparency log

Statistics

Installs: 61

Dependents: 0

Suggesters: 1

Stars: 0

Open Issues: 0

2.1.9 2026-06-22 16:05 UTC

README

Latest Stable Version Total Downloads GitHub issues

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.