Groups
Groups in BuddyPress are gatherings of members, posts, and any other user-generated content.
If enabled by the site administrator, any member can create a group in BuddyPress. When a member creates a group, this person automatically becomes the group administrator.
Group administrators can also approve requests to join the private group, invite friends to congregate within a hidden group, establish communications among members, extend privileges to other members, and enable new features (such as Group Forums if enabled by Super Admin) among others.
Sections
The following is a table of contents outlining each specific area that the Groups component entails:
- Groups Directory
- Single Group
- Group Header
- Activity (group home page)
- Members
- Send Invites
- Admin
- Groups Management Panels
- Link: Group Settings and Roles
- Link: How To Join A Private Group
Groups Directory
The Groups Directory is a page where users can find all the created groups on your BuddyPress site.
The following outlines each actionable item on the Groups Directory page:
Sections
- Create a Group button/link – Shown beside the Groups page title to logged in member if the Site/Super Admin has enabled group creation by members.
- Search Groups search form
- All Groups – with total number of registered users who have logged in at least once after BuddyPress was activated in the installation.
- Selectbox – Show: Last Active (default), Most Members, Newly Created, or Alphabetical
- List of Groups created in the site including time active stamp, group description, number of members and group privacy setting. Only Public and Private Groups are seen in list by regular members. Super/Site Admin sees all groups including Hidden groups.Action buttons – for logged in members only
- Join Group button – for groups listed as Public, button visible to logged in members only.
- Request Membership button – for groups listed as Private, button is visible to logged in members only.
- ( Membership in Hidden groups is by invitation only.)
- My Groups – for logged in users only. This includes a counter of the total number of groups you have created and/or joined inOptions
- Selectbox – Show: Last Active (default), Most Members, Newly Created, or Alphabetical
- List of Groups you are a member of – Public, Private and Hidden (only by you and Super Admin)
- Leave Group button – visible to logged in members of Public, Private and Hidden Groups. You cannot leave the group if you are the only Group Admin.
Single Group Header
When users visits a single group page, they will see a group header with various actionable items available to them.
The following outlines each area of a group’s header:
Sections
- Group Avatar or Site Default Avatar
- Group Name
- Group Description
- Group Admin/s with avatar/s
- Group Mod/s (if any) with avatar/s
- Join Group button (for a Public group) or Request Membership button (for a Private Group) or Leave Group button (for Public, Private or Hidden Group)
Home Page
Each group has a homepage. The group’s Activity Stream is the default Home tab for any group.
Here, all members who are a member of the group can add status updates for the group.
Sections
- RSS feed
- Selectbox: Show: Everything (default), Updates, Group Memberships
- Status Update – visible to all logged in group members onlyOptions
- Text Area box
- Post In – Selectbox: Member’s Profile Page or to one of Member’s Groups
- Post Update button
- List of Group activities. Following buttons/links are visible to logged in group members onlyOptions
- Comment button
- Reply to Comment link
- Favorite button or Remove Favorite button
- Delete button – visible only to Group Admin, Group Moderator and Super/Site Admin.
Members
Each group has a “Members” page where users can find out who has joined the group.
List of Group Members
Sections
- Member Avatar
- Member Nice Name
- Member Active Since
- Action buttons
- Options
- Add Friend (friendship request) button – visible to logged in group members
- Cancel Friendship Request button – visible to the group member who made the friendship request
- Cancel Friendship button – visible to the group member whose friendship request was accepted
- Favorite button or Remove Favorite button
Send Invites
Each group has a “Send Invites” page where users can invite other users to join the group.
The visibility of this link is dependent on what option the Group Admin chose on the group settings page — “Admin > Settings > Group Invitations: All group Members, Group Admins and Mods only, or Group admins only”.
Options
- Info: Select people to invite from your friends list.
- List of your friends with checkbox beside each name is shown in panel.
- Select friend and the friend is automatically listed in invite list.
- Remove Invite button – click to remove friend/s from list prior to sending invitation
- Send Invites button – click to send invitation/notification to one or group of friend/s
Admin
Each group has an “Admin” page where group administrators can configure various aspects of the group.
These group admin pages are only visible to the group’s administrators and the Super/Site Admins of your WordPress installation.
The following outlines each admin page available to group administrators:
Sections
- DetailsOptions
- Group Name (required) text area
- Group Description (required) text area
- Notify group members of changes via email – Yes or No option
- Save Changes button
- Settings
- Privacy Options – Group Admin selects from among three options (About Group Privacy Options)Options
- This is a public groupOptions
- Any site member can join this group.
- This group will be listed in the groups directory and in search results.
- Group content and activity will be visible to any site member.
- This is a private groupOptions
- Only users who request membership and are accepted can join the group.
- This group will be listed in the groups directory and in search results.
- Group content and activity will only be visible to members of the group.
- This is a hidden groupOptions
- Only users who are invited can join the group.
- This group will not be listed in the groups directory or search results.
- Group content and activity will only be visible to members of the group.
- This is a public groupOptions
- Group Invitations – select which members of this group are allowed to invite others?Options
- All group members
- Group admins and mods only
- Group admins only
- Save Changes button
- Privacy Options – Group Admin selects from among three options (About Group Privacy Options)Options
- AvatarOptions
- Upload an image to use as an avatar for this group. The image will be shown on the main group page, and in search results.- .jpg, .gif or .png format
- Choose File button (no file chosen)
- Upload Image button
- If you’d like to remove the existing avatar but not upload a new one, please use the delete avatar button.
- Delete Avatar button
- Upload an image to use as an avatar for this group. The image will be shown on the main group page, and in search results.- .jpg, .gif or .png format
- Members
- List of members according to member’s role in group – visible to Group Admin and Super/Site Admin only. (About Group Roles).
- Administrator/s – If there’s only one Group Admin, there will be no button to demote or remove the user as there must always be a group admin position.Option
- Demote to Member button – Shows up only if there’s more than one Group Admin
- Moderator/sOptions
- Promote to Admin button
- Demote to Member button
- Member/sOptions
- Kick & Ban button
- Promote to Mod button
- Promote to Admin button
- Remove from Group button
- Administrator/s – If there’s only one Group Admin, there will be no button to demote or remove the user as there must always be a group admin position.Option
- List of members according to member’s role in group – visible to Group Admin and Super/Site Admin only. (About Group Roles).
- Delete
- WARNING: Deleting this group will completely remove ALL content associated with it. There is no way back, please be careful with this option.
- Checkbox: I understand the consequences of deleting this group.
- Delete Group button
Groups Management Panels
BuddyPress provides admin dashboard panels to help you manage the Groups created in your site, including membership and settings (added in BuddyPress 1.7).Sections
- General TypeOptions
- All
- Public
- Private
- Hidden
- Bulk Actions: Delete (Apply)
- Search All Groups form
- Pagination
- List of All GroupsColumns
- Name: Avatar and Group NameOptions
- Visit: Goes to Group’s home page in the front end of the site
- Edit: Opens up a new Group Management panel in dashboard to edit the GroupSections
- Name and DescriptionInputs
- Name of Group
- Text area for Description of Group
- Add New MembersInput
- Start typing a username to add a member
- Manage MembersTypes
- AdministratorsColumns
- ID: User ID Number
- Name: Avatar and Username which link to the Member’s Activity > Personal page in frontend
- Group RoleSelectbox
- Administrator (default)
- Moderator
- Member
- Banned
- Remove from Group (Member cannot be removed if said member is the only Group Administrator)
- Moderators: Either “No members of this type” if there is no Group Mod orColumns
- ID: User ID Number
- Name: Avatar and Username which link to the Member’s Activity > Personal page in frontend
- Group RoleSelectbox
- Administrator
- Moderator (default)
- Member
- Banned
- Remove from Group
- Members: Either “No members of this type” if there are no members yet orColumns
- ID: User ID Number
- Name: Avatar and Username which link to the Member’s Activity > Personal page in frontend
- Group RoleSelectbox
- Administrator
- Moderator
- Member (default)
- Banned
- Remove from Group
- Banned Users Either “No members of this type” if there is no banned user orColumns
- ID: User ID Number
- Name: Avatar and Username which link to the Member’s Activity > Personal page in frontend
- Group RoleSelectbox
- Administrator
- Moderator
- Member
- Banned (default)
- Remove from Group
- AdministratorsColumns
- SaveOptions
- Delete Group link
- Save Changes button
- SettingsElements
- Checkbox: Enable discussion forum (if bbPress plugin is activated and Group Forums are enabled in bbPress Settings page)
- PrivacyOptions
- Public (default)
- Private
- Hidden
- Who can invite others to this group?Options
- All group members (default)
- Group admins and mods only
- Group admins only
- Name and DescriptionInputs
- Delete: Opens up the Delete Groups panel in dashboardElements
- You are about to delete the following groups:
- List of Group/s to be deleted
- This action cannot be undone. (warning)
- Delete Permanently button or Cancel button
- Description
- Status: Private, Public or Hidden
- #Members: Number of members and Sorting of groups by number of members
- Last Active: Date and Time
- Name: Avatar and Group NameOptions