PHPackages                             fof/first-post-approval - 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. fof/first-post-approval

ActiveFlarum-extension

fof/first-post-approval
=======================

Hold posts and discussions from new users for approval

1.0.0(yesterday)019—4.2%MITPHPPHP ^8.0CI passing

Since Aug 16Pushed yesterdayCompare

[ Source](https://github.com/FriendsOfFlarum/first-post-approval)[ Packagist](https://packagist.org/packages/fof/first-post-approval)[ Docs](https://friendsofflarum.org)[ Fund](https://opencollective.com/fof/donate)[ RSS](/packages/fof-first-post-approval/feed)WikiDiscussions 2.x Synced today

READMEChangelog (2)Dependencies (6)Versions (4)Used By (0)

First Post Approval by FriendsOfFlarum
======================================

[](#first-post-approval-by-friendsofflarum)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/bdeaa3e5bfd636597c5bc9b4ad01971e07c14ea0ebef9249072328cff17803ba/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f662f66697273742d706f73742d617070726f76616c2e737667)](https://packagist.org/packages/fof/first-post-approval) [![Total Downloads](https://camo.githubusercontent.com/b377d91dc7dbe7420889a643cdade6c465764abf99670ce47f4eb526eb78fb95/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666f662f66697273742d706f73742d617070726f76616c2e737667)](https://packagist.org/packages/fof/first-post-approval) [![OpenCollective](https://camo.githubusercontent.com/1903c197bb0307e60d6328653532b8a6b9890b898fbc92e314ab39d699491e74/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f70656e636f6c6c6563746976652d666f662d626c75652e737667)](https://opencollective.com/fof/donate)

A [Flarum](http://flarum.org) extension. Hold the first n posts and/or discussions from new users for approval.

Installation
------------

[](#installation)

```
composer require fof/first-post-approval
```

Flarum's **Approval** and **Flags** extensions must also be enabled.

Updating
--------

[](#updating)

```
composer update fof/first-post-approval
php flarum migrate
php flarum cache:clear
```

Documentation
-------------

[](#documentation)

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

[](#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.

### FriendsOfFlarum Byobu

[](#friendsofflarum-byobu)

Private discussions cannot be held for approval, so if the [FriendsOfFlarum Byobu](https://github.com/FriendsOfFlarum/byobu) extension is enabled, users who are still subject to first post approval are prevented from starting them. This is enforced by the API, not just hidden in the interface.

If you would rather let new users message each other freely, turn off **Prevent private discussions until approved** in the extension settings.

Credits
-------

[](#credits)

This extension was originally developed by [Clark Winkelmann](https://clarkwinkelmann.com/) for a client and released as open-source. It has since been adopted and is now maintained by [FriendsOfFlarum](https://friendsofflarum.org/).

Links
-----

[](#links)

[![OpenCollective](https://camo.githubusercontent.com/8ea53c451470d1a72789d650c77e2b22eee915f7fbf2cbeeeeaa25f47301efe2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d667269656e64736f66666c6172756d2d3434414545353f7374796c653d666f722d7468652d6261646765266c6f676f3d6f70656e2d636f6c6c656374697665)](https://opencollective.com/fof/donate)

- [Packagist](https://packagist.org/packages/fof/first-post-approval)
- [GitHub](https://github.com/FriendsOfFlarum/first-post-approval)
- [Discuss](https://discuss.flarum.org/d/39689)

An extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum).

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance100

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

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

4

Last Release

1d ago

Major Versions

1.x-dev → 2.0.0-beta.12026-08-16

### Community

Maintainers

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

---

Top Contributors

[![clarkwinkelmann](https://avatars.githubusercontent.com/u/5264300?v=4)](https://github.com/clarkwinkelmann "clarkwinkelmann (10 commits)")[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (5 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (3 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")

---

Tags

extensionflarummoderationapprovalfirst-post

### Embed Badge

![Health badge](/badges/fof-first-post-approval/health.svg)

```
[![Health](https://phpackages.com/badges/fof-first-post-approval/health.svg)](https://phpackages.com/packages/fof-first-post-approval)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

13129.1k](/packages/flarum-lang-russian)[flarum-lang/french

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

1941.0k](/packages/flarum-lang-french)[fof/masquerade

User profile builder extension for your Flarum forum.

2026.0k7](/packages/fof-masquerade)

PHPackages © 2026

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