Saltar al contenido principal
Version: 2.x

Messages

Messages: private conversations between members. Bundled with Flarum 2.0.

The Messages extension (flarum/messages) lets members talk to each other privately, in one-to-one conversations away from the forum's discussions. It is a bundled extension, but it is not enabled on new installs.

Instalación​

The extension ships with Flarum. Enable it from the Extensions page of the admin panel.

If it is not present in your install, require it like any other package, then enable it:

composer require flarum/messages
php flarum cache:clear

Conversations​

A conversation is between two members. A member can start one with:

  • Send a message on the other member's profile;
  • Send a Message on the Messages page, which asks who the message is for.

Messaging someone you already have a conversation with continues that conversation rather than starting another.

Only the two members of a conversation can see it. That includes admins and moderators: they can't read conversations they aren't part of.

Members who can't reply​

Members can only message someone who could reply: someone whose groups have Send private messages. A member who is suspended, or who hasn't confirmed their email address, has only a guest's permissions, so they can't reply.

When a member chooses who to message, anyone who can't reply is shown as Can't reply to messages and can't be chosen. On that person's profile, Send a message is unavailable and says This user cannot reply. In an existing conversation with them, the reply box is gone and the conversation shows This user cannot reply.

Admins, and any group you grant Message users without messaging permission, can message them anyway. Once one of them has sent a message in a conversation, everyone in it can reply there, so a suspended member can answer a moderator. That member still can't start conversations of their own.

When you update from an earlier release, conversations that an admin has already written in are opened to replies in the same way.

The Messages page​

Members open the Messages page from the Messages icon in the header, which counts the conversations with something unread, or from Messages in the forum's navigation. The page lists their conversations, with the open conversation beside the list on wider screens.

From the page, members can:

  • sort their conversations by Latest activity, Newest or Oldest;
  • mark a conversation as read, or all of them with Mark all as read;
  • see a conversation's participants and when it started, with Details.

Notificaciones​

When someone sends a member a message, the member gets an email. They get one email per conversation, then no more about that conversation until they've read it.

Members can turn these emails off with Someone sends me a message in the notification settings on their Settings page.

The Messages icon in the header shows new messages whether or not the member is emailed.

Deleting messages​

Members can delete their own messages if you allow it. Choose how long they have under Delete own messages on the Permissions page of the admin panel:

OptionA member can delete a message they sent
Indefinitelyat any time
For 10 minutesfor 10 minutes after sending it
Until next replyuntil someone sends another message in the conversation
Nevernever

Until you choose an option, members can't delete their messages.

Deleting a message removes it for both members, and it can't be undone. Deleting the last message left in a conversation deletes the conversation.

Members can find text from their own conversations in the forum's search, where matches appear under Messages. Guests never see this section.

Flood control​

So that a new account can't flood members' inboxes, each member can:

  • send one message every 10 seconds;
  • start at most 10 new conversations an hour.

Grant Send messages without throttling to any group that should skip these limits, such as your moderators.

Permisos​

Set these on the Permissions page of the admin panel:

PermissionGranted to by defaultWhat it allows
Send private messagesMembersStarting conversations and sending messages.
Message users without messaging permissionAdmins onlyMessaging members who can't send messages themselves. They can then reply in that conversation. See Members who can't reply.
Delete own messagesNobodyDeleting messages the member sent, for the time you choose. See Deleting messages.
Send messages without throttlingAdmins onlySending messages without flood control.
View IP addresses of messagesAdmins onlySeeing the IP address each message was sent from. Messages records it for every message.

Working with other extensions​

ExtensionWhat it adds to Messages
RealtimeNew messages appear in an open conversation as they are sent, the header's count updates straight away, and members see when the other person is typing.
MentionsMembers can mention other members and posts in their messages.
StatisticsThe PM started and PM replies statistics count conversations and the replies in them.
AuditThe audit log records when a member starts a conversation and each message they send, with who it was sent to. It never records what a message says.
GDPRA member's data export includes their messages. Erasing a member deletes their messages; anonymising them removes the IP addresses recorded with their messages. Nobody, admins included, can message an anonymised member, in a new conversation or an existing one, and they aren't offered when choosing who to message.