PHPackages                             ernestdefoe/group-messages - 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. [Utility & Helpers](/categories/utility)
4. /
5. ernestdefoe/group-messages

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

ernestdefoe/group-messages
==========================

Group conversations for Flarum — multi-participant private messages with names, icons, roles, participant management, and read receipts, built on flarum/messages.

2.0.2(1mo ago)0152↑22.2%MITPHPPHP ^8.2CI passing

Since May 30Pushed 1mo agoCompare

[ Source](https://github.com/ernestdefoe/group-messages)[ Packagist](https://packagist.org/packages/ernestdefoe/group-messages)[ Docs](https://github.com/ernestdefoe/group-messages)[ RSS](/packages/ernestdefoe-group-messages/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (4)Versions (5)Used By (0)

Group Messages
==============

[](#group-messages)

[![Floxum](https://camo.githubusercontent.com/6adb5d4cf2d2b248e7f4df81d7aaf1a7217aa973d44d820484f2227ae944e9e8/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f67726f75702d6d657373616765732f62616467652f6e616d65)](https://floxum.com/extension/ernestdefoe/group-messages)[![Version](https://camo.githubusercontent.com/0033f42cfac70792e0d70c228c1cdd2f6690599fc1efb6e76721b9fa240d9380/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f67726f75702d6d657373616765732f62616467652f686967686573742d76657273696f6e)](https://floxum.com/extension/ernestdefoe/group-messages)[![Downloads](https://camo.githubusercontent.com/2dbc005a9e7dcbf2157da949c9b6dbf539f25b22ab6552ad949f5415de29ec4e/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f67726f75702d6d657373616765732f62616467652f646f776e6c6f616473)](https://floxum.com/extension/ernestdefoe/group-messages)[![Review](https://camo.githubusercontent.com/78cd4570e4a6ec1c9c5d2a10c23a02a5ae1d02c5aa13dbd5930c891f7f4bdaec/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f67726f75702d6d657373616765732f62616467652f726576696577)](https://floxum.com/extension/ernestdefoe/group-messages)[![License](https://camo.githubusercontent.com/1f11edd2bbe827f7852505ce8d76dc6c76f9a8c3d27694df776dab2675649a29/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f67726f75702d6d657373616765732f62616467652f6c6963656e7365)](https://floxum.com/extension/ernestdefoe/group-messages)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE.md)[![Latest Stable Version](https://camo.githubusercontent.com/285935e94248c1ff2907afa429ee4194a8488af959eeaf95b1abe2c77b7587b6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65726e6573746465666f652f67726f75702d6d657373616765732e737667)](https://packagist.org/packages/ernestdefoe/group-messages)

A [Flarum](https://flarum.org) extension that turns private messages into **group conversations**. It builds on [`flarum/messages`](https://github.com/flarum/messages) — adding extra people, a name and icon, roles, participant management, read receipts, reactions, replies and quoting — without changing how one-on-one direct messages work.

Features
--------

[](#features)

- **Group conversations** — start a conversation with two or more other people, give it a name and an emoji icon.
- **Participant management** — add or remove people, leave a group, and (for the owner) promote or demote moderators.
- **Roles** — every group has an owner and optional moderators; everyone else is a member. Controls are shown based on your role.
- **Reactions** — react to any message with an emoji; reactions are grouped with counts.
- **Reply** — reply to a specific message, with a "replying to" indicator in the composer and an inline reference on the sent message.
- **Quote** — drop a markdown blockquote of any message into the composer.
- **Read receipts** — see small avatars of the participants who have read the latest message.

Direct (1-on-1) messages are left completely untouched.

Screenshots
-----------

[](#screenshots)

A group conversation — custom name and icon, participant count, message reactions, replies with an inline reference, and per-message actions:

[![A group conversation with reactions and a reply](screenshots/conversation.png)](screenshots/conversation.png)

Starting a new group — pick people, give it a name and an emoji icon, write the first message:

[![The new group message composer](screenshots/compose.png)](screenshots/compose.png)

Managing a group — rename and re-icon, add or remove people, promote or demote moderators, or leave:

[![The group settings modal](screenshots/manage.png)](screenshots/manage.png)

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

[](#installation)

```
composer require ernestdefoe/group-messages
```

This extension requires [`flarum/messages`](https://github.com/flarum/messages) to be installed and enabled.

Updating
--------

[](#updating)

```
composer update ernestdefoe/group-messages
php flarum migrate
php flarum cache:clear
```

Usage
-----

[](#usage)

- Open the **messages** dropdown (envelope icon) and choose **"New group message"** to start a group.
- Inside a group, use the **"…"** menu → **Group settings** to rename it, change its icon, add or remove people, manage moderators, or leave.
- Under each message you'll find the reaction picker, **Reply** and **Quote** actions.

### Permissions

[](#permissions)

Creating and using groups reuses the existing direct-message permission (`flarum/messages`' "send private messages"). No new permission is added — anyone who can send a DM can start a group.

Development
-----------

[](#development)

```
cd js
npm install
npm run build      # or: npm run dev
```

After changing PHP or rebuilding JS on a site:

```
php flarum assets:publish
php flarum cache:clear
```

Links
-----

[](#links)

- [Packagist](https://packagist.org/packages/ernestdefoe/group-messages)
- [GitHub](https://github.com/ernestdefoe/group-messages)
- [Report an issue](https://github.com/ernestdefoe/group-messages/issues)

Support
-------

[](#support)

Questions, bug reports, and feature requests:

- **Support forum:**
- **Issues:**

License
-------

[](#license)

This extension is licensed under the [MIT License](LICENSE.md).

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance90

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~3 days

Total

4

Last Release

46d ago

Major Versions

v0.1.0 → 2.0.22026-06-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/c9978664264055711c21fbcf73c937f758df771d9cb40f6a25370b10123e7abc?d=identicon)[ernestdefoe](/maintainers/ernestdefoe)

---

Top Contributors

[![ernestdefoe](https://avatars.githubusercontent.com/u/24905286?v=4)](https://github.com/ernestdefoe "ernestdefoe (21 commits)")

---

Tags

messageschatPrivate Messagesflarumgroupflarum-extension

### Embed Badge

![Health badge](/badges/ernestdefoe-group-messages/health.svg)

```
[![Health](https://phpackages.com/badges/ernestdefoe-group-messages/health.svg)](https://phpackages.com/packages/ernestdefoe-group-messages)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59120.6k14](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1034.8k7](/packages/fof-discussion-language)[flarum-lang/french

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

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

User profile builder extension for your Flarum forum.

2025.4k6](/packages/fof-masquerade)[datlechin/flarum-link-preview

Automatically display a rich preview of the link contents.

1717.8k](/packages/datlechin-flarum-link-preview)

PHPackages © 2026

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