Forum Pro
A native, database-backed community forum for Grav 2.0. Members, topics, reactions, private messages, notifications, live updates, moderation, spam defense, search and a Discourse importer, all running inside your own Grav site.
Forum Pro is a complete, self-hosted discussion platform that runs inside your Grav site. It is not an iframe, not a hosted widget and not a subscription. Forum pages are ordinary Grav pages: they inherit your theme, live at any route you choose, are indexed by search engines, and every post is stored in a database you own.
Important
Premium products require the free License Manager plugin. Install it and add your product license before installing Forum Pro.
Requirements
| Requirement | Notes |
|---|---|
Grav >= 2.0.0-rc.8 |
Forum Pro is not compatible with Grav 1.7 |
PHP >= 8.3 |
Tested against 8.3 and 8.4 |
API plugin >= 1.0.0-rc.8 |
Powers the Admin Next integration |
| A database | SQLite (zero-config default), MySQL 8+ / MariaDB 10.6+, or PostgreSQL 14+ |
Several optional plugins each unlock more:
| Plugin | Unlocks |
|---|---|
email |
Outbound notification and digest mail |
sync + sync-mercure |
Live updates, presence and typing indicators |
ai-pro |
The hourly AI spam review |
yetisearch-pro |
Fuzzy search with tuned relevance |
codesh |
Server-side syntax highlighting in fenced code blocks |
form |
The invisible proof-of-work captcha on register and login |
None of these are required. Forum Pro degrades cleanly when they are absent: without sync you get a plain server-rendered forum, without codesh code blocks render unhighlighted, and so on.
What's in the box
- Discussions with sections, categories, topics, threaded replies, Markdown with @mentions and quotes, attachments, reactions, polls, tags, accepted answers, bookmarks and full revision history.
- A member system of its own, with registration, email verification, password reset, profiles, avatars, ranks, badges, groups, titles and a member directory. Grav accounts link in automatically.
- Moderation through scoped moderator roles, a review queue on the forum itself, a bulk queue in the admin, per-category premoderation, member reports, bans with appeals and content disposition, an audit log and a daily digest.
- Spam defense in three independent stages (heuristics, an optional self-hosted ML classifier, an optional hourly AI review) plus provisional-account restrictions and an invisible captcha.
- Notifications through an in-app bell with live toasts, watch levels per topic and per forum, and email that mirrors the bell with immediate, daily or weekly delivery.
- Private messages between members, one-to-one or in groups, with archiving, blocking, bulk cleanup and reporting.
- Search over published posts, permission-filtered, using either a built-in engine or YetiSearch Pro.
- Live updates through the
syncplugin, with Mercure push or automatic polling fallback. - Article comments that turn any Grav page into a commentable article backed by a real forum topic.
- A Discourse importer that brings members (with working passwords), content, history and files across in one command.
Where to start
- Installation gets the forum running, picks a database, and mounts it at the route you want.
- Configuration is the complete reference for every config block.
- Administration walks through the Forum area in Admin Next.
If you are moving an existing community across, read Migrating from Discourse before you do anything else. The importer is idempotent, but planning the cutover is easier before you start than after.
Installation
Install Forum Pro, choose and secure a database, mount the forum at the route you want, and get the background worker running.
Configuration
The complete Forum Pro configuration reference, block by block, with the admin tab each option lives under.
Administration
A tour of the Forum area in Admin Next, the Forum Activity report, the dashboard widget, and the permissions that gate them.
Members and Accounts
How Forum Pro's account system works, how Grav accounts link in, and how ranks, badges, groups, titles, avatars and profiles fit together.
Moderation
Scoped moderator roles, the on-forum review queue, premoderation, member reports, bans with content disposition, undo, the audit log, legal holds and the daily digest.
Spam Protection
The three-stage spam pipeline (heuristics, a self-hosted ML classifier, an hourly AI review), provisional-member restrictions, and the invisible captcha.
Notifications and Email
The notification bell, live toasts, watch levels, email preferences and digests, the delivery queue, and private messages.
Article Comments
Turn any Grav page into a commentable article whose discussion lives in the forum, with one Twig call and a counter helper for listings.
Search
The built-in full-text engine, the YetiSearch Pro engine, result filters and permission scoping, and rebuilding the index.
Live Updates
Live replies, presence and typing indicators, permission-aware channels, Mercure push versus polling, and in-page navigation.
Theming
The design token chain, giving the forum your accent colour, dark mode detection, template overrides, icons, accessibility and SEO.
File Storage
Content-addressed blob storage for attachments and avatars, moving to S3 or Cloudflare R2, CDN delivery, and the sync commands.
Migrating from Discourse
Import a Discourse backup into Forum Pro, rehost its files, plan the DNS cutover and 301 old URLs to their new homes.
Privacy and Retention
Member self-deletion, retention windows, IP anonymization, legal holds, and what the background worker actually purges.
CLI Reference
Every bin/plugin forum-pro command, what it does, when to run it, and which ones are safe on a live forum.