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

ShaunSocial user guide 1.5.6 / Features

Groups

AdminMember

Groups are communities inside your site: members create a group around a topic, others join it, and the group has its own feed, members and rules. This page shows members how to find, join, create and run a group, and shows admins how to approve, disable and promote groups, how to manage the group categories and which settings control the feature.

How this page was checked

Checked against the 1.5.6 code. The steps for creating and running a group were read from the code, not run; screenshots follow.

Finding, joining and using groups#

Member

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

Click Groups in the main menu (https://example.com/groups). The page has up to five tabs; visitors who are not signed in see Explore and All Groups only.

The Groups page of Emma Carter: Create new group, the Explore, Your Feeds, All Groups, For you and Joined tabs, recent group posts, and the New Groups and Popular Groups blocks
The Groups page: Create new group, the five tabs and the New Groups and Popular Groups blocks. Screenshot taken 2026-11-17.
TabWhat it shows
Explorethe latest posts from all public groups, so you can see what is happening and join a group you like
Your Feedsthe latest posts from the groups you belong to. Empty until you join one: "Start joining groups or create new group to see updates here."
All Groupsevery active group, the newest first. Narrow it with Keyword (part of the group name) and Category, then click Search. When nothing matches, "No groups found" offers Clear filters
For yougroups that use hashtags you follow or have shown interest in (see Hashtags and people pages)
Joinedthe groups you belong to

Posts from the groups you belong to also appear in your home feed (see What the home feed shows). Groups are found by the site search too, on the Group tab of the results.

The group page#

The group page of Weekend Hikers: the cover, the name with its edit pencil, Public and Health and Fitness, 6 members, the Leave, Manage, notification, search and options buttons, the Feeds, Info, Media, Members and Events tabs and the post box
A group page: the cover, the name, Public or Private, the categories, the members, the buttons and the Feeds, Info, Media, Members and Events tabs. Screenshot taken 2026-11-17.
  • At the top: the cover picture, the name, Public or Private, the categories (click one to see other groups in it) and the number of members.
  • Buttons: Join, Leave or Cancel Request; Manage for the owner and moderators (with a number when join requests or posts are waiting); the bell for your notification settings (see Group notification settings); the magnifier to search the group (see Searching inside a group); and the three dots with Report and Share.
  • Feeds is the group's own feed; it also shows the posts made in the group's own events. Info shows the description, categories, hashtags, privacy, the recent activity, the newest members and the group rules. Media collects the photos and videos posted in the group. Members lists the owner (under Admin), the moderators and the members, with a search box. Events lists the group's events while the Events feature is on (see the Events page).
  • In a closed group, people who are not members see the top of the page and the Info tab only: no posts, media or member list. The site's super admins and moderators can see a closed group's content without joining.

Join or leave a group#

  1. Open the group and click Join.
  2. If the group has rules, the window Group rules opens. Read them and click Accept & Join.

    What you should see: in a public group you are a member at once and the button changes to Leave. In a closed group the button changes to Cancel Request until the owner or a moderator answers; when they approve, you get the notification "Welcome to" followed by the group name.

  • Leave asks "Do you want to leave this group?". To come back to a closed group you have to ask again.
  • The owner cannot leave ("You can't leave this group."): transfer the group to someone else first (see Transfer the group).
  • You cannot see or join a group whose owner or moderators banned you.

Post in a group#

The group's Feeds tab has the same post box as the home page (see Create a post). Who may post is set by the group: all members, or only the owner and moderators. Visitors are asked to sign in, and people who are not members are asked to join first.

  • Post approval: when the group reviews posts, your post is not shown until the owner or a moderator accepts it. A bar "[number] pending posts" appears above the feed; Manage post lists your waiting posts, and Delete withdraws one. You get "approved your post in a group." or "rejected your post in a group."; a rejected post is deleted.
  • Comments: only members can comment. Posts in groups have no Who can comment? choice and no Share button.
  • Changing your post: you can edit and delete your own posts while the group does not review posts. In a group that reviews posts, ask the owner or a moderator; they can edit and delete every post in the group.

Your groups in Lists#

Lists → Groups (https://example.com/lists/groups) lists the groups you own or moderate, with a Status filter: All (the default), Active, Pending (waiting for an admin), Hidden (hidden by its owner) and Disable (switched off by an admin). A pending or disabled group cannot be opened or changed until an admin approves or reactivates it; a hidden group shows "This group is hidden now": the owner also gets Open Now, moderators only the message (see Hide a group).

Creating a group#

Member

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

  1. On the Groups page, click Create new group.
  2. Fill in the form (see the table below) and click Continue.

    What you should see: "Your group has been created." and the new group page, with you as its owner and first member. If your site reviews new groups, you see "Your group is pending for approval." and Lists → Groups instead; you get the notification "Your group '…' is approved now" when an admin approves it.

  3. On the group page, upload a cover picture with the button on the cover. Until you do, the site's default cover is shown.
The empty Create new group form: Group Name, Description, Categories, Hashtags, Group Type with Public Group and Closed Group, and the Cancel and Continue buttons
The Create new group form with the name, description, categories, hashtags and the two group types. Screenshot taken 2026-11-17.
FieldWhat to enter
Group Namerequired, up to 255 characters
Descriptionwhat the group is about, up to 1024 characters
Categoriesrequired: at least one category
Hashtagsmembers who follow these hashtags see the group in their For you tab
Group TypePublic Group ("Everyone can join") or Closed Group (people ask to join and the owner or a moderator approves them). See Public and closed groups

Whether you may create groups and how many a day depends on your member role: you may see "You don't have group creation permission." or "To prevent spam, we only allow you to share a maximum of [x] groups per day." (see Group settings and role permissions).

Change the name, description, categories and hashtags#

The owner and the moderators change the name with the pencil next to it, and the description, categories and hashtags with the pencils on the Info tab. In a group description, formatting signs such as ** are shown as typed (formatting works in posts only, see Markdown formatting).

Group rules#

Rules are shown to everyone on the Info tab and to each person who joins, who must click Accept & Join.

  1. As the owner, open the Info tab and click Create New Rule under Group rules.
  2. Enter a Title (up to 255 characters) and a Description (up to 1024 characters), and click Save.
  3. Drag the rules to change their order; the pencil changes a rule and the bin deletes it.

Public and closed groups, hiding a group#

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

A group is created as public or closed. On the group page a closed group is labelled Private.

Public groupClosed group
Who can joinanyone signed in, at onceanyone signed in, after the owner or a moderator approves the request
Who sees the posts, media and memberseveryone, visitors includedmembers only. Others see the top of the page and the Info tab
Listed in All Groups and searchyesyes
Posts shown on the Explore tabyesno
Can be changedto closed, by the ownerno: a closed group stays closed, to protect its members' privacy

Make a public group closed: as the owner, open the Info tab, click the pencil next to Group Privacy, choose the closed type and click Save. This cannot be undone. People who were already members stay members.

Hide a group#

The owner can hide a group for a while, for example during a reorganisation. A hidden group cannot be opened by anyone, its posts leave the home feeds, and it is not listed or found by search. Nothing is deleted.

  1. Click Manage on the group page, then the Settings tab, and click Hide Group.
  2. Confirm "Are you sure you want to hide this group? All members can't access this group until you re-open it" with Ok and enter your password.

    What you should see: "Hide Group Successfully."

  3. To open it again, go to Lists → Groups, click the group (status Hidden), click Open Now and enter your password. You see "Open Group Successfully."

Only the owner can hide and re-open a group. A group can also be switched off by an admin; it then shows "This group is disabled by admin" and only an admin can reactivate it (see Manage groups).

Running a group: owner, moderators and the Manage page#

Member

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

Every group has one owner (the member who created it, shown under Admin) and can have moderators. In posts, the owner and moderators carry the label Admin.

TaskOwnerModerator
Change the name, description, categories, hashtags and cover; pin posts; approve posts and join requests; remove and ban members; change the group settingsyesyes
Post without approvalyesyes
Add and remove moderatorsyesno (a moderator can only step down)
Transfer the group, make it closed, write the rules, hide, re-open or delete the groupyesno

Owners and moderators click Manage on the group page. The number on the button counts the join requests and posts waiting. The Manage page has four tabs:

The Manage page of Weekend Hikers seen by its owner Liam Nguyen, Manage Members tab: the Admin and Moderators, Members, Pending Requests and Bans sub-tabs, Liam as Admin with Transfer, and Emma Carter as moderator with Remove and Add moderator
The Manage page of a group on Manage Members, with Admin & Moderators, Members, Pending Requests and Bans. Screenshot taken 2026-11-17.
TabWhat it holds
InsightsEngagement (likes and comments), New Members and Active members for the last 28 days, and charts of new members and posts for the last 7 days
Manage MembersAdmin & Moderators, Members, Pending Requests and Bans (see below)
Manage Poststhe posts waiting for approval (see Approve posts)
SettingsPost Approval, Who can post, Web Address, and for the owner Hide Group and Delete Group (see Group settings)

Add or remove a moderator#

  1. As the owner, open Manage → Manage Members → Admin & Moderators and click Add moderator.
  2. Under Username, type part of the person's name, choose them in the list and click Add.
  3. Enter your password in Enter Password.

    What you should see: the person in the Moderators list. They get the notification "added you as moderator of a group.". Someone who was not a member yet becomes a member and moderator at once.

Remove next to a moderator makes them a normal member again; they get "removed you as moderator of a group.". A moderator can remove themselves the same way. Banned people cannot be made moderators.

Transfer the group#

  1. As the owner, open Manage → Manage Members → Admin & Moderators and click Transfer.
  2. In Transfer Admin Account, type part of the new owner's name under Username, choose them and click Transfer.
  3. Enter your password in Enter Password.

    What you should see: the new owner under Admin. They get "transferred ownership of a group."; you stay in the group as a normal member.

The new owner does not have to be a member yet. You cannot transfer the group to yourself or to someone banned from it.

When the owner deletes their account, the groups they own are deleted with it, so transfer a group first if it should continue.

Members, join requests and bans#

  • Members lists the members (people and business pages) with a search box. Remove takes someone out of the group; they can join again. Ban removes them and keeps them out.
  • Pending Requests (closed groups) lists the people asking to join. Approve or Reject one request, or tick several and use Approve Selected or Reject Selected. Approved people get "Welcome to" followed by the group name.
  • Bans: "People who are banned can't find the group in search, see any of the content within the group or receive new invitations to the group." Unban lets someone back; they have to join again. Moderators of the group and the site's own admins cannot be banned.

Approve posts#

Switch on Post Approval in the Settings tab to review each post before it appears. Posts by the owner and moderators are never held back.

  1. Open Manage → Manage Posts. Narrow the list by Keyword, Author, Start Date, End Date and content type, sort by Newest first or Oldest first, and click Search.
  2. Click Accept to publish a post, or Reject to delete it. The author is told either way.

An accepted post appears in the feed as a new post, and members get the notification for new posts then.

Group settings#

The owner and the moderators change these settings in Manage → Settings; only the owner sees Hide Group and Delete Group.

The Settings tab of the Manage page of Weekend Hikers: the Post Approval switch, Who can post set to All members, the Web Address weekend-hikers, and the Save, Hide Group and Delete Group buttons
The Settings tab of the Manage page: Post Approval, Who can post, Web Address, Save, Hide Group and Delete Group. Screenshot taken 2026-11-17.
SettingWhat it does
Post Approvalon: posts by members wait in Manage Posts until accepted. Off (after creating): posts appear at once
Who can postAll members (after creating) or Admins and moderators
Web Addressthe last part of the group's address, https://example.com/groups/<id>/<web-address>, up to 128 characters. Links that use the old address stop working

Click Save after changing them. Delete Group (owner only) asks "Are you sure you want to delete this group?" and your password, then deletes the group with all its posts, members and rules. This cannot be undone.

Pinning posts in a group#

Member

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

Use a pinned post for an announcement every member should see.

  1. As the owner or a moderator, open the three-dot menu of a post in the group and choose Pin Post.

    What you should see: "Post is pinned." and the post at the top of the group's feed.

  2. To put it back in its place, choose Unpin Post in the same menu.

Several posts can be pinned; the most recently pinned comes first. Members get the notification "new pinned post in '…'." unless they switched it off (see Group notification settings). Pinning to the home page and to a profile is explained in Pinning posts.

Liam Nguyen's post about trail etiquette in Weekend Hikers, marked ADMIN and PINNED
A pinned post at the top of a group's feed. Screenshot taken 2026-11-17.

Group notification settings#

Member

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

Each member chooses which group activity sends them a notification. Click the bell on the group page; the window Notification Settings opens. Each switch is saved as soon as you change it. All are on when you join.

SwitchWho sees itThe notification
A post is createdevery member"create a new post in '…'." for each new post (also when a waiting post is accepted)
A post is pinnedevery member"new pinned post in '…'."
Join Requestsowner and moderators"requested to join '…" when someone asks to join a closed group
Post Approval Requestsowner and moderators"new post in '…' that needs your approval."; click it to open the waiting post

The author of a post and the member who pinned it are not notified about their own action. In a busy group, switch off A post is created to receive fewer notifications.

The Notification Settings window of a group with four switches, all on: Join Requests, Post Approval Requests, A post is pinned and A post is created
The Notification Settings window of a group with its switches. Screenshot taken 2026-11-17.
For site admins

These notifications are sent by the cron job, a few members at a time every minute, so in a large group they reach everyone over several minutes. Without a working cron job they are not sent at all (see What stops when the cron job does not run).

Groups admin, categories and settings#

Admin

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

Group settings and role permissions#

The screen saves each setting as soon as you change it.

The Group part of AdminCP General Configuration: the Enable and Auto approve switches, both on, and the Cover group default image with its file chooser
AdminCP → General Configuration → Group: Enable, Auto approve and the default cover. Screenshot taken 2026-11-17.
SettingAfter installingWhat it does
Enableonoff: the Groups menu entries disappear, group pages and feeds can no longer be opened, and group posts leave the home feed, bookmarks and the other lists. Nothing is deleted: switch it on again and everything comes back. The AdminCP Groups menu stays
Auto approveonon: new groups are active right away. Off: new groups wait for an admin (see below)
Cover group default imagea standard picturethe cover shown on groups whose owner uploaded none. A picture of 1024×395 pixels is recommended

Who may create groups, and how many a day, is set per role in AdminCP → Users → Manage User Roles → Permissions → Group: Allow group creation (on after installing) and Maximum number of groups can create per day (0 is unlimited) (0). Super admins and moderators are not held to the daily limit; see Per-day limits. The refusal messages can be changed with the pencil under each permission.

Manage groups#

Super admins see this screen; moderators need the Manage Groups switch in their role (see Moderator roles). The list shows every group, newest first, with ID, Name (click it to open the group), Status, Popular and Created. Filter by status (Active, Hidden, Pending, Disable), by Popular / Not popular or by name, and click Search.

AdminCP Groups list with the status and popular filters, the search field and four groups with ID, Name, Status, Popular, Created and the Delete, Disable, Popular or Remove Popular and Admin manage actions
AdminCP → Core Features → Groups → Manage Groups: the filters and the groups with their actions. Screenshot taken 2026-11-17.

Each action asks for confirmation:

ActionShown onWhat it does
Approvepending groupsmakes the group active. The owner gets "Your group '…' is approved now"
Disableactive groupscloses the group to everyone, its members and owner included, and takes its posts out of the home feeds. The owner gets "Your group '…' is disabled now"
Activedisabled groupsopens the group again. The owner gets "Your group '…' is active now"
Popular / Remove Popularall groupsadds the group to, or removes it from, the Popular Groups block
Admin manageall groupslists the group's members with their role (Owner, Moderator) and e-mail. Login as user (for admins with the Manage Users permission) signs you in as that member, to fix the group on the owner's behalf
Deleteall groupsdeletes the group with its posts, members, rules and requests. This cannot be undone. Tick several groups and click Delete under the list to delete them together
  • Groups waiting for approval: while Auto approve is off, every super admin and moderator gets the notification "created a new group and waiting for your approval" for each new group. It opens Manage Groups; filter by Pending.
  • Hidden groups were hidden by their owner; only the owner can open them again (see Hide a group).
  • Blocks: the Groups page and the group page are laid out in the Layout editor (pages Groups and Group Profile Page). New Groups shows the newest active groups. Popular Groups shows only the groups you marked Popular: up to the block's number of items, picked at random from the 50 popular groups with the most members.
  • Members can report a group from its three-dot menu; reports are handled in the Moderation Center.

Group categories#

The categories members choose when they create a group, and filter by in All Groups. The site comes with 17: Sports, Technology, Art, Entertainment, Gaming, Politics, Business, Culture, Science, Food, Animals, Education, Fashion & Beauty, Health & Fitness, News, Cryptocurrency and Travel. Moderators need the Group Categories switch in their role.

AdminCP Group Categories list: drag handles, the categories from Sports to Food, Active Yes and the Edit and Delete actions
AdminCP → Core Features → Groups → Group Categories: the categories with their Active column, Edit and Delete. Screenshot taken 2026-11-17.
  1. Click Create new.
  2. Enter the Name. To make it a sub-category, choose a Parent; leave it empty for a main category. The Parent list is shown only when other main categories exist, and not for a category that has sub-categories of its own.
  3. Leave Active on and click Submit.

    What you should see: "Group category has been created." and the category in the list.

  • Rename a category: click Edit, then Translate under the name, and change the name there for each language (see Translate a name or text). The Name field itself cannot be changed after creating.
  • Order: drag the rows to set the order members see.
  • Active off hides the category from the choice.
  • Delete removes the category and its sub-categories from the list and from the choice members see. Groups that used it keep their other categories.

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-17browse, create, owner-moderators, pin-posts, adminCorrections after review: the order of the steps for adding a moderator and transferring a group, moderators can change the group settings, event posts in the Feeds tab, staff access to closed groups, hidden groups for moderators, the Status and Clear filters details, the Parent list, how Popular Groups are picked.
2026-11-17owner-moderatorsAdded: deleting the owner's account deletes the groups they own.