🎯 Overview
Introducing the Custom Landing Page extension — a powerful Flarum add-on that lets you create stunning, fully customizable landing pages for your community without leaving the Flarum admin panel.
What Makes This Different?
Unlike other landing page extensions that inject content inside Flarum's layout, this one intercepts the request at the PHP middleware layer and returns your raw HTML before Flarum ever loads.
✅ Complete HTML freedom — Your page is the entire document
✅ No Flarum JS/CSS loaded — Faster, cleaner, more lightweight
✅ Guest-only mode — Logged-in users see the normal forum
✅ Smart URL handling — Auto-detects fof/direct-links for clean login URLs
✅ Dynamic templates — Insert forum title, URL, and login/register links automatically
✅ Works on Flarum 1.8.x and 2.x
Key Features
⚙️ Simple Configuration
Just go to Admin → Extensions → Custom Landing Page and set:
- Enable/disable the extension
- Toggle guest-only mode
- Paste your HTML
🔗 Template Variables
Dynamically insert values with these placeholders:
{{ forum_title }} — Your forum name{{ forum_url }} — Forum base URL{{ login_url }} — Login link (auto-detects clean routes){{ register_url }} — Register link (auto-detects clean routes){{ year }} — Current year
🚀 Smart Login Handling
- With
fof/direct-links → resolves to /login and /register
- Without it → falls back to
/?modal=login and /?modal=register (Flarum SPA handles it)
Installation
composer require tapao/custom-landing-page
php flarum migrate
php flarum cache:clear
Then enable in your admin panel.
Use Cases
🎯 Beautiful welcome experience for new members
📢 Event or campaign landing pages with custom design
🏢 Brand showcase pages with full design control
⚡ Lightning-fast first impressions (no Flarum SPA overhead)
Example
<!DOCTYPE html>
<html lang="en">
<head>
<title>{{ forum_title }}</title>
</head>
<body>
<h1>Welcome to {{ forum_title }}</h1>
<a href="{{ login_url }}">Login</a>
<a href="{{ register_url }}">Join Now</a>
</body>
</html>
Compatibility
✅ Flarum 1.8.x (PHP 8.1+)
✅ Flarum 2.x (PHP 8.1+)
Questions? Drop them below! Feedback and suggestions are welcome. 🙌
Github: Tapao-NonSen/Custom-Landing-Page
Packagist: https://packagist.org/packages/tapao/custom-landing-page
