ShaunSocial docs ShaunSocial user guide
Version 1.5.6
  • 1.5.6 (this version)

ShaunSocial user guide 1.5.6 / Features

Chat

AdminMember

Chat lets members write to each other in private conversations and in group chats: text, photos, files, GIFs, voice messages, replies and reactions, with requests for new conversations, editing of sent messages and a chat box that stays open while members browse. This page shows admins the chat settings and permissions, and shows members how to start conversations, handle requests, run a group chat, edit messages and send voice messages.

How this page was checked

Checked against the 1.5.6 code; the AdminCP settings and the chat page were compared with a demo site. The member steps (requests, groups, editing, voice messages) were read from the code, not run; screenshots follow.

Chat settings#

Admin

Last updated: 2026-11-17 · v1.5.6

Chat is always available; there is no switch to turn it off for the whole site. To keep a member role out of chat, switch off Allow sending messages in its permissions (below). The screen saves each setting as soon as you change it.

The Chat card of General Configuration: message photo and character limits, supported file formats, the bubble chat, GIF and group chat switches, group limits, message editing, edit window, edit history, the Edited label and the message sound
AdminCP → Site Settings → General Configuration → Chat: the limits, the bubble chat, GIF, group chat, message editing and sound settings. Screenshot taken 2026-11-17.
SettingAfter installingWhat it does
Message - maximum photos can be sent10how many photos one message may carry. 0 or empty means no limit. Above the limit members see "You can only send 10 photos at a time." (with your number)
Message - maximum characters can be sent1000the longest text of one message, also when a message is edited. 0 or empty means no limit for new messages; an edited message can still be at most 1,000 characters
Supported file formatstxt, doc, docx, csv, xls, xlsx, ppt, pptx, pdf, ai, psdthe file types members may attach, as extensions separated by commas. The largest file is the site's upload size (see The other General Settings)
Enable Bottom Bubble Chatonon computers, a round chat button at the bottom right of every page that opens a docked chat box (see The chat box on computers). Off: no button, and every chat opens on the Chat page
Enable Gifsonoffers Choose a GIF when writing a message. The GIFs come from GIPHY and need the GIPHY key entered in the post settings (see Post settings); without a key the picker finds nothing
Enable Group Chatonoff: the New group button is hidden and no new group can be created; groups that already exist keep working. The group options in members' notification settings are hidden too
Maximum group members200the most members one group may have, the creator included. 0 means no limit. Every message is delivered to every member, so keep it at 500 or less
Group name - maximum characters100the longest group name
Group description - maximum characters500the longest group description
Enable message editingonoff: members cannot edit sent messages, and the edit button is hidden everywhere (see Editing messages)
Message edit window (minutes)15how long after sending a message can still be edited. 0 means no time limit
Store message edit historyonkeeps each earlier version of an edited message, so admins can read it in the message logs. Off: only the current text is kept
Show "(Edited)" labelonshows (edited) under a message that was changed. Off: an edit replaces the text without any sign
Play a sound on new messageonplays a short sound in the browser when a message arrives in a conversation the member is not reading. Muted conversations stay silent, and the browser plays at most one sound every three seconds, however many conversations receive messages
For your server administrator

New messages appear without reloading only when live updates run (see Live updates: Reverb on your server or Pusher); without them members see new messages when they reload the page. Voice messages need FFmpeg (see FFmpeg: needed for videos).

The new-message sound is the file public/sounds/message.mp3. To use another sound, replace that file with a short MP3 of the same name. An upgrade puts the original file back, so keep a copy of yours.

Who may use chat#

PermissionMember role after installingWhat it does
Allow sending messagesonoff: members of the role cannot open chat at all and see "You don't have send message permission."
Max voice message length (duration - seconds) can record120the longest voice message, in seconds (see Voice messages)
Allow creating group chatsonoff: members of the role cannot create groups, but can still take part in groups others add them to
Allow editing your own chat messagesonoff: members of the role cannot edit their messages

Moderator roles have two more switches in the Chat group of permissions, for viewing and purging the edit history of messages, and the Manage Messages permission opens the message logs. Reading members' messages is explained in Message logs; moderator roles in Moderator roles.

Conversations and message requests#

Member

Last updated: 2026-11-17 · v1.5.6

Open chat with the Chat icon in the header (on a phone, Chat in the bar at the bottom). The number on the icon counts the conversations with unread messages. The Chat page lists your conversations, the most recent first.

Emma Carter's Chat page with the All, Private and Groups tabs, the search field, four conversations and the open conversation with Liam Nguyen
The Chat page: the All, Private and Groups tabs, the search field, the conversation list and an open conversation. Screenshot taken 2026-11-17.
  • Tabs: All, Private (conversations with one member) and Groups, each with the number of conversations that have unread messages.
  • Search finds a conversation by the name of the member or the group.
  • The three dots on a conversation offer Mark as Read or Mark as Unread. A bell with a line through it means you stopped notifications for that conversation.
  • On a phone, the list fills the screen; tap a conversation to open it full screen and the back arrow to return.
The conversation with Liam Nguyen on a phone: back arrow, name, options, the messages and the Write Message field
A conversation on a phone fills the screen, with the back arrow, the member's name, the options and the message field. Screenshot taken 2026-11-17.

Start a conversation#

  1. Open the member's profile and click Message.

    What you should see: the conversation with that member opens, on the Chat page or in the chat box (see The chat box on computers).

  2. Type in Write Message and press Enter, or click the send button.
  • The Message button is there only when the member accepts messages from you. Each member decides in Settings → Privacy → Who can send you a message: Everyone (after signing up), My followers (only members who follow them) or No One. Once you have a conversation with someone, the button stays. The site's admins and moderators can write to any member.
  • You can also send a post to members with Share → Send Message, or reply to a story; both arrive in chat. Writing to a business page works the same way (see Chatting with a page).

Message requests#

A new private conversation starts as a request: the first message does not land in the other member's list but in their Requests.

  1. The member gets the notification "[name] wants to chat." and sees [number] request next to the Chat title.
  2. They open Requests and the conversation. Under the messages are three buttons: Accept, Block and Delete.
  3. Accept moves the conversation to their list, and both of you can write freely.
A message request from Chloe Dubois under Requests, with the first message and the Accept, Block and Delete buttons
A message request: the first message with the Accept, Block and Delete buttons. Screenshot taken 2026-11-17.
  • Until the request is accepted, the sender sees Wait for request to be accepted above the message field. They can keep writing; everything they send waits in the same request.
  • Clicking Message on the sender's profile also accepts the request.
  • Delete removes the request and its messages from your side. If the sender writes again, the conversation comes back as a new request. Block also blocks the member.
  • Switch the notification off with New chat request under Related to message in Settings → Notifications (see the Member account and settings page).

What you can send#

The buttons next to the message field, and the plus button (More) beside them, add more than text:

IconWhat it does
Attach Photosadds photos to the message (10 at most after installing). You can also drag photos onto the conversation or paste them into the field. Photos and files cannot go in the same message
Attach Filesadds files of the types your site allows, such as PDF or Word documents
Choose a GIFsearches GIFs and sends the one you click. Shown while the site allows GIFs in chat
Send a voicerecords a voice message (see Voice messages)
Send Fundsends money from your wallet, in private conversations only. Shown when the site's eWallet is on and your role may send funds (see the eWallet page)
Emojithe smiley in the field adds an emoji

A message may hold up to 1,000 characters after installing. A link in a message shows a preview.

Reply, react, copy, unsend#

Point at a message to show its buttons:

  • Reply quotes the message above your answer (Replying to; the cross cancels). Click a quote to jump to the original message.
  • Reaction adds a reaction to the message.
  • Copy copies the text.
  • Edit, on your own text messages, changes the text (see Editing messages).
  • Unsend, on your own messages, removes the message for everyone after the question "Do you want to unsend this message?". The others see Message has been unsent in its place. There is no time limit.

In a private conversation, the other member's small picture under a message shows how far they have read, and Typing ... shows that they are writing. When the site translates member content, See translation appears under messages in other languages (see Auto-translating member content).

Mute, delete, block, report#

The three dots at the top of a private conversation offer:

OptionWhat it does
Reportreports the conversation to the site's moderators; choose a reason and send. Reports arrive in the Moderation Center (see Moderation Center)
Delete Messagesafter "Are you sure you want to delete all messages?", removes all messages of the conversation from your side. The other member keeps them
Delete Roomremoves the conversation and its messages from your list. When the other member writes again, the conversation comes back with the new message
Blockblocks the member: the conversation disappears and neither of you can write to the other
Stop Notifications / Turn on Notificationsmutes the conversation: no push notification, no sound, and it no longer counts in the number on the Chat icon

How you hear about new messages#

  • The number on the Chat icon and the conversation's unread count.
  • A short sound in the browser, when the site has it switched on and you are not reading that conversation.
  • A push notification "[Message] ..." on the devices where you allowed notifications, while you are not reading that conversation. In the browser this needs the site's progressive web app (see Progressive web app).
  • Bell notifications only for requests, group invitations, ownership transfers, admin role changes and mentions in groups; messages themselves do not create bell notifications.

The chat box on computers#

On a window at least 1,024 pixels wide, a round chat button sits at the bottom right of every page except the Chat and Chatbot pages. Click it to open a chat box with your conversations on the left and the open conversation on the right; the cross closes it. While it is available, Message buttons and chat notifications open the conversation in this box, so you can keep browsing. The Chat icon in the header still opens the full Chat page. The site's admins can switch the box off (see Chat settings).

The chat box docked at the bottom right of the home page, with the conversation list on the left and the conversation with Liam Nguyen on the right
The chat box docked at the bottom right of the home page, with the conversation list and an open conversation. Screenshot taken 2026-11-17.

Group chat#

Member

Last updated: 2026-11-17 · v1.5.6

A group chat is one conversation with three or more members. It has a name, an optional description and photo, an owner, and admins the owner chooses.

Create a group#

  1. On the Chat page (or in the chat box), click New group, the round plus next to the title.

    What you should see: the New group window.

  2. Optional: click Change photo to give the group a picture.
  3. Enter the Group name (up to 100 characters after installing) and, if you like, a Group description (up to 500).
  4. Choose who joins, in List name:
    • Specific members: type names in Members and pick them.
    • One of your lists: everyone on that list joins; Manage Lists opens your lists (see Lists).
    • Custom List: pick members and enter a Custom List Name; the members are also saved as a new list, so you can choose them again next time.
  5. Click Create.

    What you should see: "Group created." and the new group, starting with the line "[you] created the group with [names]".

The New group window with the photo, Group name, Group description, List name set to Specific members and two members picked
The New group window: the photo, Group name, Group description, List name and Members. Screenshot taken 2026-11-17.
  • A group needs at least two members besides you ("At least two members are required to create a group."), and can have up to 200 members, you included, after installing.
  • Members are added straight away, without a request, whatever their message privacy. Members who blocked you, or whom you blocked, cannot be added ("You cannot add this user.").
  • The New group button appears only while the site allows group chats and your role may create them.

Group info and who can do what#

Click the group's name at the top of the conversation (or the three dots → Info) to open the group info: the photo, name and description, and the members with their role (owner, admin).

The info of the group Ridge hike crew: photo, name and description with edit buttons, Add, and four members with the owner and admin labels and their options
The group info: the photo, name and description with their edit buttons, Add, and the members with their roles and options. Screenshot taken 2026-11-17.
ActionWhoHow
Change the name, description or photoowner, adminsEdit group name, Edit description, Change photo in the group info
Add membersowner, adminsAdd in the group info, then pick members in the Add member window; each new member gets "[name] invited you to join [group]."
Make or remove an adminownerthe member's options → Make group admin / Remove group admin; the member is notified
Remove a memberownerthe member's options → Remove from group
Hand the group overownerthe member's options → Transfer Ownership. The new owner is notified; you stay in the group as an admin
Leaveeveryone but the ownerthree dots → Leave Room. The owner must transfer the group first ("Please transfer group ownership before leaving.")
Delete the groupowner, when alone in itthree dots → Delete Group, after "Delete "[name]" permanently? All messages will be removed."

Joining, leaving, removals, new names and photos and owner changes appear as short lines in the conversation. A removed member can no longer open the group; an owner or admin can add them again. When the owner's account is deleted, the longest-serving admin becomes the owner, or else the longest-serving member.

Writing in a group#

  • Type @ and a name to mention a member of the group; they get "[name] mentioned you in a chat.".
  • Under your own messages, a tick shows that nobody has read the message yet, a ticked circle that some members have, and a filled circle that everyone has. Click it to see who read it (Seen by).
  • The three dots offer Info, Report, Delete Messages (from your side only), Leave Room or Delete Group, and Stop Notifications.
  • Group invitations, ownership transfers and admin role changes each have a switch under Related to message in Settings → Notifications.

Editing messages and edit history#

Member

Last updated: 2026-11-17 · v1.5.6

You can correct a message after sending it, for a short time.

  1. Point at your message and click Edit (the pencil).
  2. Change the text in Edit message.
  3. Press Enter or click Save; Esc or Cancel leaves the message as it was.

    What you should see: the new text, with (edited) under it.

Emma's last message open for editing in place, with the text field, the emoji button and the Cancel and Save links
A message being edited in place, with the Edit message field and the Cancel and Save links. Screenshot taken 2026-11-17.
  • Only your own text messages can be edited, including messages with a link and replies to stories. Photos, files, GIFs and voice messages cannot.
  • The time counts from sending: 15 minutes after installing. After that the pencil disappears, and a late save shows "Edit window has expired.". You can edit as often as you like within the time.
  • The others see the new text at once. An edit does not move the conversation up, notify anyone or count as unread; in a group, members you newly mention in the edit are notified.
  • Members cannot see earlier versions. When the site keeps the edit history, its admins can read every earlier version in the message logs (see Message logs).

Whether members may edit, for how long, whether the history is kept and whether (edited) is shown are set by the site's admins (see Chat settings and Who may use chat).

Voice messages#

Member

Last updated: 2026-11-17 · v1.5.6

Instead of typing, you can record a short message with your microphone.

  1. In the conversation, click Send a voice (the microphone). The first time, your browser asks whether the site may use the microphone: allow it.

    What you should see: a recording bar with a running time instead of the message field.

  2. Speak, then click the pause button to stop recording.
  3. Click play to listen to your recording, or the cross (Cancel recording) to throw it away.
  4. Click the send button.

    What you should see: the voice message in the conversation, with a play button and its length.

A voice message being recorded: the cancel cross, the recording bar with the stop button and the running time, and the send button
Recording a voice message: the cancel cross, the recording bar with its time and the send button. Screenshot taken 2026-11-17.
  • A voice message may be 120 seconds long for the Member role after installing. A longer recording is refused when you send it, with a message that gives the maximum in seconds. The site-wide Audio duration (120 seconds after installing) applies too.
  • The microphone is not offered while photos or files are attached to the message you are writing.
  • "No microphone connection. Please check your microphone settings." means the browser has no microphone or was not allowed to use it: allow the microphone for the site in your browser and try again.

For admins: the microphone appears only when FFmpeg is set up and switched on (see FFmpeg: needed for videos; Audio duration is in the same FFMPEG Configuration settings). The length per role is the Chat permission Max voice message length (see Who may use chat).

Change log#

Last updated: 2026-11-17 · v1.5.6

Date (GMT+7)SectionWhat changed
2026-11-17allFirst version for 1.5.6, written from the 1.5.6 code for members and for site owners and their admins.
2026-11-17settings, rooms-requestsCorrections after review: the sender of a request can keep writing, the character limit of edited messages, the sound limit across conversations, the name of the Chat permission group.
2026-11-17group-chatThe button that adds members in the group info is Add; it opens the Add member window.