Installation & Setup
How to install the Minimum Post Characters extension for phpBB 3.3.x.
Installation & Setup
Minimum Post Characters (vaultbb/minpostchars) is a free, standalone phpBB 3.3.x extension that enforces a minimum character count on posts on a per-forum basis. It requires no VaultBB Core dependency and works on any standard phpBB 3.3.x installation.
Requirements
| Requirement | Minimum Version |
|---|---|
| phpBB | 3.3.0 |
| PHP | 7.2.0 |
| MySQL / MariaDB | Any version supported by phpBB 3.3.x |
| VaultBB Core | Not required |
Minimum Post Characters is a GPL-2.0 free extension. It does not depend on VaultBB Core and will function identically on any phpBB 3.3.x installation, with or without VaultBB products present.
Installing Minimum Post Characters
Upload the files
Download or clone the extension. Upload the vaultbb/minpostchars/ folder to ext/vaultbb/minpostchars/ in your phpBB root:
{phpbb_root}/
└── ext/
└── vaultbb/
└── minpostchars/
├── composer.json
├── ext.php
├── config/
│ └── services.yml
├── event/
│ └── main_listener.php
├── language/
│ └── en/
│ ├── common.php
│ └── permissions_minpostchars.php
├── migrations/
│ ├── install_schema.php
│ ├── install_permissions.php
│ └── install_data.php
└── adm/
└── style/
└── event/
└── acp_forums_normal_settings_append.htmlEnable the extension
In the phpBB ACP, navigate to:
ACP → Customise → Extension Management → Extensions
Find Minimum Post Characters in the list and click Enable. phpBB will automatically run the database migrations, which:
- Create the
phpbb_vaultbb_minpostcharsdatabase table - Register the
u_minpostchars_bypasspermission in the phpBB permissions system
Configure exempt groups
Navigate to ACP → Permissions and assign the "Can bypass minimum post character requirement" permission to whichever user groups should be exempt from the minimum character check. This permission appears in the Posting category in both Group Permissions and User Permissions.
Set per-forum minimums
Navigate to ACP → Forums → Manage Forums, edit any forum, and locate the Minimum characters per post field near the bottom of the form. Set it to a positive integer, or leave it at 0 to disable the restriction for that forum.
Database Table Created
phpbb_vaultbb_minpostchars
Stores the per-forum minimum character configuration. One row per forum that has a non-zero minimum configured.
| Column | Type | Description |
|---|---|---|
forum_id | UINT | Primary key — the phpBB forum ID |
min_chars | UINT | Minimum required visible character count for this forum |
Upgrading
- Disable the extension in ACP → Customise → Extensions.
- Replace the
ext/vaultbb/minpostchars/folder with the new version. - Re-enable — phpBB will run any new migrations automatically.
- Your per-forum settings and permission assignments are preserved across the upgrade.
Uninstalling
- Navigate to ACP → Customise → Extension Management → Extensions.
- Click Disable next to Minimum Post Characters.
- Click Delete Data to purge — this drops the
phpbb_vaultbb_minpostcharstable, removes the registered permission, and clears any cached forum settings. - Delete the
ext/vaultbb/minpostchars/folder from your server.
Purging the extension removes all per-forum minimum character configuration. If you plan to reinstall, note down your per-forum settings before purging.