Introducing Social Groups for Flarum 2
Let your community form its own spaces — members can create groups, post discussions, manage membership, and more. Fully independent from Flarum tags.
flarum-extension v2.1.0 MIT License PHP 8.3+ Flarum ^2.0 community groups social
🔗 Links
✦ What is Social Groups?
Social Groups adds a full community-within-a-community system to Flarum 2. Instead of relying on tags to organize people, members can create their own spaces — with their own discussions, membership, and identity. Think Reddit communities or Facebook Groups, native inside Flarum.
Each group gets a dedicated URL, a banner, an avatar, member roles, approval flows, invite system, and an independent discussion feed. No Flarum tags required, no data mixed with your main forum.
⚙ Features
| Feature | Description |
|---|
| 📂 Group Directory | Responsive card grid at /groups with server-side search, banners, avatars, and member counts. |
| 🔐 Open or Approval | Groups can allow anyone to join instantly, or queue join requests for creator/moderator review. |
| 📨 Invite System | Creators and mods can invite any forum user by username, bypassing open/approval flows entirely. |
| 💬 Group Discussions | Fully independent discussion feed per group — separate from Flarum's tag system. 20 per page with pagination. |
| 🖼️ Image Uploads | Group avatars and full-width banners stored on your server. JPEG, PNG, GIF, WebP up to 5 MB. |
| 👑 Member Roles | Creator, Moderator, and Member roles. Promote/demote from the sidebar without leaving the group page. |
| 🎨 Theme Compatible | All colors use CSS custom properties, so it adapts automatically to any Flarum 2 theme including Avocado. |
| 🔔 Notifications | Group creator receives in-app notifications when someone joins an open group or a join request arrives. |
| 🛡️ Admin Permissions | Control which user groups can create social groups via the standard Flarum Admin → Permissions UI. |
📋 Requirements
| Dependency | Version |
|---|
| PHP | ≥ 8.3 |
| Flarum | ^2.0 |
| PHP extensions | fileinfo, curl |
⚡ Installation
Install via Composer, run the migrations, clear the cache, then enable the extension in Admin → Extensions.
Install:
# 1. Require the package
composer require ernestdefoe/social-groups
# 2. Run database migrations
php flarum migrate
# 3. Clear the cache
php flarum cache:clear
Update:
composer update ernestdefoe/social-groups
php flarum migrate
php flarum cache:clear
⚖ License
MIT License
Copyright © 2026 Ernestdefoe. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files, to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, subject to the standard MIT terms.
Full license text available in the GitHub repository.
💬 If you run into any issues, have questions, or want to suggest a feature — open an issue on GitHub or reply in this thread. Pull requests welcome!
