History of GroupsPackage
^This package is in Beta! It is very stable. If you decide to install and run it please contact will-at-tekimaki.com or wjames5 on IRC, we are actively debugging and will work with you to setup the package and fix any problems.^
!Configuration
Groups package is a rather complex package, with complex relationships with other packages. These instructions will help you set up your groups package to optimally work for you install
!!Required Configuration
These settings are required for the groups package to work correctly. Without following these configurations you may experience security and other problems.
* __Install Boards Package__
+ GroupsPackage leverages the BoardsPackage to create discussion forums for each group. GroupsPackage at this time automatically assumes you want your groups to have a discussion forum, so at this time Boards is a requirement.
* __Users Groups Permissions Configuration__
+ When assigning permissions to different base groups (admin, editors, registered, anonymous) it is important to not assign the same permission to both registered users and anonymous users. Pick one. Registered users automagically inherit permissions from anonymous users, so if you want both to have the same permission assign the permission to anonymous group. You can configure your users groups permissions in the admin panel, select Users->Permission Maintenance
* __Run LibertySecure:Register Default Permissions__
+ LibertySecurePackage is designed to properly jail any content that may have custom permissions assigned. Groups package makes use of custom permissions to enable private groups and private group content. To properly jail this content you MUST install the LibertySecure package and in the admin panel run Register Default Permissions when you set up your site, and anytime you install new content types on your site.
* __Install and Configure Moderations and ModComments Packages__
+ Moderations and ModCommentsPackage are required for groups to moderate their forum. Once you install and activate both, in ModComments enable __Allow admins to moderate comments__ in the Administration panel.
!!Highly Recommended Configuration
We highly recommend these settings as well like how Groups package works when configured this way.
* __Hide Groups Choices from User Registration Panel__
+ The Users package lets you display groups users can join at registration time. We recommend disabling this. You can do so in the Users:Login Settings in the Administration panel. It is at the bottom of the list. The UI is a little wonky here - the option to select none is not clear. Select the empty row in the list to display none. The reason we recommend disabling this feature is a) the UI is not well developed; when only one group is available to join the user can not opt out. b) if you have many public groups on your site a very long, and rather annoying, list will be displayed.
!Features
!!Group Types
* User Created Groups — Ability for users with the right permission to create a new group.
* Public Groups — Ability to create groups which any site member can subscribe and post to the group.
* Announce Only — Ability to create groups which anybody can read but you must be group admin in order to post to it.
* Private Groups — Ability to create groups which only members can view and require an invitation to join. Private groups are hidden from lists, and all group related content is also automatically private as well. User can view these groups they have been invited to and accept or reject the invitation.
!!Membership Administration
* View Member Control — admins can control if members only can view members or if anyone can view members
!!Group Administration:
* Content Type Selection — group admins can select which content types group members can create/use in their group (blogs, maps, wiki pages, etc)
* Per Content Item Permissions – group admins can designate if content within public content groups is private and public - so that access can be limited on per content item basis
* Message Moderation — admins can moderate messages, including ability to delegate moderation ability to a subset of group members.
* Group Manager Email Blasts — admins can email members directly and privately without posting to the message board
!!Layout and Theming
* Group Layout - the group can customize the display of its home page, choosing to display various content types or messages or a mix. A group can also add additional modules to the left and right columns.
* Group Created Content is displayed as within Group – for example display blog posts created by the group at the groups url.
* Group Theming — each group can select a look and feel for its pages.
* Group Language — each group can be displayed in the language used by the group.
!!Messaging
* Comments -> Email — Ability to send comments on the group via Email. Members will be able to opt in or out of receiving such messages.
* Email -> Comments — Ability to send email to comments on the group.
* Files Manager - Central repository of files uploaded to the group
!!Group Administration Roles
*__Can admin group content__
+Group members with this permission can edit and control all content that is part of the group
*__Can create group content__
+Group members with this permission can create content in the group. Content is limited by types of content the group creator has allowed to be created for the group, such as wiki pages or blog posts.
*__Can submit content to group for inclusion__
+Slightly different than creating content, this regulates which users can submit content to the group. @TODO this might get yanked.
*__Can admin group members__
+Group members with this permission can assign rolls to members, and approve or ban memberships.
*__Can send invitations to the group__
+Group members with this permission can invite people to the group. When members are invited they are automatically approved to be members. This permission is useful on private groups which restrict membership.
*__Can view group members__
+Group members with this permission can see a list of who else is in the group.
*__Can admin group forums__
+Group members with this permission can moderate forum messages posted to the group.
*__Can post messages to group forums__
+Group members with this permission can post messages to the group forum. By default this permission is available to all members, but can be useful in creating announcement type groups.
!Future Development
!!!!Wishlist
* After approval of a forum or topic post it would be nice if moderations could redirect to the source content. This might not be possible.
* Make Boards an option. This would require extensive checking to make sure some features are turned off if not utilized.
!!!!Related Desirable Features
* Jailed attachments - attachment access should be restricted by perms on the group, but this needs to happen in at the Liberty level so that it would happen automagically for all packages.
!Configuration
Groups package is a rather complex package, with complex relationships with other packages. These instructions will help you set up your groups package to optimally work for you install
!!Required Configuration
These settings are required for the groups package to work correctly. Without following these configurations you may experience security and other problems.
* __Install Boards Package__
+ GroupsPackage leverages the BoardsPackage to create discussion forums for each group. GroupsPackage at this time automatically assumes you want your groups to have a discussion forum, so at this time Boards is a requirement.
* __Users Groups Permissions Configuration__
+ When assigning permissions to different base groups (admin, editors, registered, anonymous) it is important to not assign the same permission to both registered users and anonymous users. Pick one. Registered users automagically inherit permissions from anonymous users, so if you want both to have the same permission assign the permission to anonymous group. You can configure your users groups permissions in the admin panel, select Users->Permission Maintenance
* __Run LibertySecure:Register Default Permissions__
+ LibertySecurePackage is designed to properly jail any content that may have custom permissions assigned. Groups package makes use of custom permissions to enable private groups and private group content. To properly jail this content you MUST install the LibertySecure package and in the admin panel run Register Default Permissions when you set up your site, and anytime you install new content types on your site.
* __Install and Configure Moderations and ModComments Packages__
+ Moderations and ModCommentsPackage are required for groups to moderate their forum. Once you install and activate both, in ModComments enable __Allow admins to moderate comments__ in the Administration panel.
!!Highly Recommended Configuration
We highly recommend these settings as well like how Groups package works when configured this way.
* __Hide Groups Choices from User Registration Panel__
+ The Users package lets you display groups users can join at registration time. We recommend disabling this. You can do so in the Users:Login Settings in the Administration panel. It is at the bottom of the list. The UI is a little wonky here - the option to select none is not clear. Select the empty row in the list to display none. The reason we recommend disabling this feature is a) the UI is not well developed; when only one group is available to join the user can not opt out. b) if you have many public groups on your site a very long, and rather annoying, list will be displayed.
!Features
!!Group Types
* User Created Groups — Ability for users with the right permission to create a new group.
* Public Groups — Ability to create groups which any site member can subscribe and post to the group.
* Announce Only — Ability to create groups which anybody can read but you must be group admin in order to post to it.
* Private Groups — Ability to create groups which only members can view and require an invitation to join. Private groups are hidden from lists, and all group related content is also automatically private as well. User can view these groups they have been invited to and accept or reject the invitation.
!!Membership Administration
* View Member Control — admins can control if members only can view members or if anyone can view members
!!Group Administration:
* Content Type Selection — group admins can select which content types group members can create/use in their group (blogs, maps, wiki pages, etc)
* Per Content Item Permissions – group admins can designate if content within public content groups is private and public - so that access can be limited on per content item basis
* Message Moderation — admins can moderate messages, including ability to delegate moderation ability to a subset of group members.
* Group Manager Email Blasts — admins can email members directly and privately without posting to the message board
!!Layout and Theming
* Group Layout - the group can customize the display of its home page, choosing to display various content types or messages or a mix. A group can also add additional modules to the left and right columns.
* Group Created Content is displayed as within Group – for example display blog posts created by the group at the groups url.
* Group Theming — each group can select a look and feel for its pages.
* Group Language — each group can be displayed in the language used by the group.
!!Messaging
* Comments -> Email — Ability to send comments on the group via Email. Members will be able to opt in or out of receiving such messages.
* Email -> Comments — Ability to send email to comments on the group.
* Files Manager - Central repository of files uploaded to the group
!!Group Administration Roles
*__Can admin group content__
+Group members with this permission can edit and control all content that is part of the group
*__Can create group content__
+Group members with this permission can create content in the group. Content is limited by types of content the group creator has allowed to be created for the group, such as wiki pages or blog posts.
*__Can submit content to group for inclusion__
+Slightly different than creating content, this regulates which users can submit content to the group. @TODO this might get yanked.
*__Can admin group members__
+Group members with this permission can assign rolls to members, and approve or ban memberships.
*__Can send invitations to the group__
+Group members with this permission can invite people to the group. When members are invited they are automatically approved to be members. This permission is useful on private groups which restrict membership.
*__Can view group members__
+Group members with this permission can see a list of who else is in the group.
*__Can admin group forums__
+Group members with this permission can moderate forum messages posted to the group.
*__Can post messages to group forums__
+Group members with this permission can post messages to the group forum. By default this permission is available to all members, but can be useful in creating announcement type groups.
!Future Development
!!!!Wishlist
* After approval of a forum or topic post it would be nice if moderations could redirect to the source content. This might not be possible.
* Make Boards an option. This would require extensive checking to make sure some features are turned off if not utilized.
!!!!Related Desirable Features
* Jailed attachments - attachment access should be restricted by perms on the group, but this needs to happen in at the Liberty level so that it would happen automagically for all packages.