mirror of
https://gitlab.com/allianceauth/allianceauth.git
synced 2025-07-09 12:30:15 +02:00
74 lines
5.4 KiB
Markdown
74 lines
5.4 KiB
Markdown
# Group Management
|
|
|
|
In order to access group management, users need to be either a superuser, granted the `auth | user | group_management ( Access to add members to groups within the alliance )` permission or a group leader (discussed later).
|
|
|
|
## Group Requests
|
|
|
|
When a user joins or leaves a group which is not marked as "Open", their group request will have to be approved manually by a user with the `group_management` permission or by a group leader of the group they are requesting.
|
|
|
|
## Group Membership
|
|
|
|
The group membership tab gives an overview of all of the non-internal groups.
|
|
|
|
|
|
|
|
### Group Member Management
|
|
|
|
Clicking on the blue eye will take you to the group member management screen. Here you can see a list of people who are in the group, and remove members where necessary.
|
|
|
|
|
|
|
|
### Group Audit Log
|
|
|
|
Whenever a user Joins, Leaves, or is Removed from a group, this is logged. To find the audit log for a given group, click the light-blue button to the right of the Group Member Management (blue eye) button.
|
|
|
|
These logs contain the Date and Time the action was taken (in EVE/UTC), the user which submitted the request being acted upon (requestor), the user's main character, the type of request (join, leave or removed), the action taken (accept, reject or remove), and the user that took the action (actor).
|
|
|
|
|
|
|
|
## Group Leaders
|
|
|
|
Group leaders have the same abilities as users with the `group_management` permission, _however_, they will only be able to:
|
|
|
|
- Approve requests for groups they are a leader of.
|
|
- View the Group Membership and Group Members of groups they are leaders of.
|
|
|
|
This allows you to more finely control who has access to manage which groups.
|
|
|
|
## Settings
|
|
|
|
Here is a list of available settings for Group Management. They can be configured by adding them to your AA settings file (``local.py``).
|
|
Note that all settings are optional and the app will use the documented default settings if they are not used.
|
|
|
|
```eval_rst
|
|
+---------------------------------------------+-------------------------------------------------------------------------------------------+------------+
|
|
| Name | Description | Default |
|
|
+=============================================+===========================================================================================+============+
|
|
| ``GROUPMANAGEMENT_AUTO_LEAVE`` | Group members can leave their group without needing confirmation from their group leaders | ``False`` |
|
|
+---------------------------------------------+-------------------------------------------------------------------------------------------+------------+
|
|
| ``GROUPMANAGEMENT_REQUESTS_NOTIFICATION`` | Send Auth notifications to all group leaders for join and leave requests. | ``False`` |
|
|
+---------------------------------------------+-------------------------------------------------------------------------------------------+------------+
|
|
```
|
|
|
|
## Permissions
|
|
|
|
Group Management should be mostly done using group leaders, a series of permissions are included below for thoroughness.
|
|
|
|
```eval_rst
|
|
+--------------------------------+-------------------+------------------------------------------------------------------------------------+
|
|
| Permission | Admin Site | Auth Site |
|
|
+================================+===================+====================================================================================+
|
|
| auth.group_management | None | Can Approve and Deny all Group Requests, Can view and manage all group memberships |
|
|
+--------------------------------+-------------------+------------------------------------------------------------------------------------+
|
|
| groupmanagement.request_groups | None | Can Request Non-Public Groups |
|
|
+--------------------------------+-------------------+------------------------------------------------------------------------------------+
|
|
| groupmanagement.add_group | Can Add Models | None |
|
|
+--------------------------------+-------------------+------------------------------------------------------------------------------------+
|
|
| groupmanagement.change_group | Can Edit Models | None |
|
|
+--------------------------------+-------------------+------------------------------------------------------------------------------------+
|
|
| groupmanagement.delete_group | Can Delete Models | None |
|
|
+--------------------------------+-------------------+------------------------------------------------------------------------------------+
|
|
| groupmanagement.view_group | Can View Models | None |
|
|
+--------------------------------+-------------------+------------------------------------------------------------------------------------+
|
|
```
|