Administration → Groups
In the Groups menu of the administration site administrators can:
In the Groups menu of the administration institution administrators can:
Administration → Groups → Administer groups
Note
Administer groups is only accessible by site administrators.
You see an overview of all the groups on the site.
Administer groups
Warning
When you delete a group, all its content - forum posts, files and pages - will be deleted permanently and cannot be restored.
You can specify a default group file quota in Plugins. This allows you to limit the file space that each group can take up. Here you can update the file quota for just one group.
Change the group file quota
You get to this page by clicking the Manage button next to a group on the Administer groups page.
Add to or remove administrators from a group by clicking the Manage button next to a group on the Administer groups page.
Add or remove group administrators
Note
You can also double-click a name and it will be moved to the other side.
Administration → Groups → Group categories
Note
Group categories is only accessible by site administrators.
Group categories help you to filter your groups more easily on the My groups and Find groups pages. A group administrator can always assign one group category to a group if categories are enabled.
Manage group categories
Note
Group categories are not hierarchical and are available to everybody on the site. Any user who can create groups can assign a group category when the feature has been enabled.
Administration → Groups → Add groups by CSV
Note
Both site and institution administrators can add and update groups by CSV file.
You can create multiple groups at once by uploading basic information about them via a CSV file.
Add and update groups by CSV
Here is a full list of all the possible fields that you can specify:
controlled - Group administrators can add users to the group without their consent, and members cannot leave the group.
description - Brief description about the purpose of this group.
displayname - The group name that appears around the site.
editroles - You can choose which roles will be allowed to create and edit pages owned by the group. If your group contains only members and administrators, then “Group administrators” and “Everyone except members” are identical. These edit permissions will also be used by default for new group files. Permissions can be changed on individual files in the group files area.
- all: everyone in the group
- notmembers: everyone except members in a course group that has tutors and administrators
- admin: only group administrators
hidden - Choose to not list this group on the Find groups page.
hidemembers - Choose to hide group members from non-members.
hidemembersfrommembers - Choose to hide group members from everybody but the group administrator.
invitefriends - Choose to allow group members to invite their friends to the group.
open - Allow users to join the group without approval from the group administrator.
public - Allow people who are not logged in to view this group including the forums.
quota - Define the group file quota.
request - Allow users to send membership requests to group administrators.
roles - Choose to have a course or standard group. The roles in these group types are:
- course: member, tutor, administrator
- standard: member, administrator
shortname - This is the name used to identify this group in the database. This should be only one word. It is also used to identify the group when you add or update its members by CSV.
submitpages - Choose to allow the submission of pages to this group. If you create a course group, this setting is automatically chosen.
suggestfriends - Allow group members to send their friends a recommendation to join this group.
usersautoadded - Choose to have all new users on the site added to the group automatically.
Note
For fields that require a Yes / No value, you need to put a numeric value into the CSV file:
Sample CSV file for a group upload
When you look at your CSV file in a text editor and not a spreadsheet software, the above sample file looks like this:
Warning
Do not delete this CSV file if you intend to make changes to your groups in bulk or if you want to add group members in bulk to these groups. There is no easy way to retrieve the group shortname unless you consult the database on the backend of Mahara.
Administration → Groups → Update group members by CSV
Note
Both site and institution administrators can add and update group members by CSV file.
You can easily update members of groups that you have created via a CSV file.
Update group members by CSV
Warning
If you manually added users to a group whose members you want to update via CSV file, these users will be removed from that group when you update the group membership and do not have them listed in the CSV file. Thus, be careful once you have added users manually.
Always leave at least one administrator in a group.
Note
You can only update group membership by CSV of users who belong to the institution in which you created the groups by CSV. All other users must be added manually.
Sample CSV file for updating group membership
When you look at your CSV file in a text editor and not a spreadsheet software, the above sample file looks like this:
Note
If you have many groups and could easily lose the overview, create one CSV file per group.