wagtail 6.1.3__py3-none-any.whl → 6.2rc1__py3-none-any.whl

wagtail/users/forms.py

@@ -1,4 +1,5 @@
 from itertools import groupby
+from warnings import warn
 
 from django import forms
 from django.conf import settings
@@ -21,6 +22,7 @@ from wagtail.models import (
     GroupPagePermission,
     Page,
 )
+from wagtail.utils.deprecation import RemovedInWagtail70Warning
 
 User = get_user_model()
 
@@ -29,6 +31,11 @@ standard_fields = {"email", "first_name", "last_name", "is_superuser", "groups"}
 # Custom fields
 if hasattr(settings, "WAGTAIL_USER_CUSTOM_FIELDS"):
     custom_fields = set(settings.WAGTAIL_USER_CUSTOM_FIELDS)
+    warn(
+        "The `WAGTAIL_USER_CUSTOM_FIELDS` setting is deprecated. Use a custom "
+        "`UserViewSet` subclass and override `get_form_class()` instead.",
+        RemovedInWagtail70Warning,
+    )
 else:
     custom_fields = set()
 

wagtail/users/locale/en/LC_MESSAGES/django.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-04-18 17:28+0100\n"
+"POT-Creation-Date: 2024-07-19 16:26+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -22,63 +22,63 @@ msgstr ""
 msgid "Wagtail users"
 msgstr ""
 
-#: forms.py:48
+#: forms.py:55
 msgid "Required. Letters, digits and @/./+/-/_ only."
 msgstr ""
 
-#: forms.py:53
+#: forms.py:60
 msgid "This value may contain only letters, numbers and @/./+/-/_ characters."
 msgstr ""
 
-#: forms.py:79
+#: forms.py:86
 msgid "A user with that username already exists."
 msgstr ""
 
-#: forms.py:80
+#: forms.py:87
 msgid "The two password fields didn't match."
 msgstr ""
 
-#: forms.py:83
+#: forms.py:90
 msgid "Email"
 msgstr ""
 
-#: forms.py:84
+#: forms.py:91
 msgid "First Name"
 msgstr ""
 
-#: forms.py:85
+#: forms.py:92
 msgid "Last Name"
 msgstr ""
 
-#: forms.py:88
+#: forms.py:95
 msgid "Password"
 msgstr ""
 
-#: forms.py:91
+#: forms.py:98
 msgid "Leave blank if not changing."
 msgstr ""
 
-#: forms.py:95
+#: forms.py:102
 msgid "Password confirmation"
 msgstr ""
 
-#: forms.py:98
+#: forms.py:105
 msgid "Enter the same password as above, for verification."
 msgstr ""
 
-#: forms.py:103 forms.py:240 views/users.py:95
+#: forms.py:110 forms.py:247 views/users.py:109
 msgid "Administrator"
 msgstr ""
 
-#: forms.py:106 forms.py:242
+#: forms.py:113 forms.py:249
 msgid "Administrators have full access to manage any object or setting."
 msgstr ""
 
-#: forms.py:236
+#: forms.py:243
 msgid "A group with that name already exists."
 msgstr ""
 
-#: forms.py:371
+#: forms.py:378
 msgid "You cannot have multiple permission records for the same page."
 msgstr ""
 
@@ -160,15 +160,16 @@ msgstr ""
 msgid "Snug"
 msgstr ""
 
-#: models.py:92
+#. Translators: "Density" is the term used to describe the amount of space between elements in the user interface
+#: models.py:93
 msgid "density"
 msgstr ""
 
-#: models.py:112
+#: models.py:113
 msgid "user profile"
 msgstr ""
 
-#: models.py:113
+#: models.py:114
 msgid "user profiles"
 msgstr ""
 
@@ -305,8 +306,8 @@ msgid "Object permissions"
 msgstr ""
 
 #: templates/wagtailusers/groups/includes/formatted_permissions.html:29
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:166
-#: views/groups.py:92 views/users.py:149
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:167
+#: views/groups.py:92 views/users.py:163
 msgid "Name"
 msgstr ""
 
@@ -335,40 +336,40 @@ msgstr ""
 msgid "Custom permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:112
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:113
 msgid "Toggle all"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:115
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:116
 msgid "Toggle all add permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:119
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:120
 msgid "Toggle all change permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:123
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:124
 msgid "Toggle all delete permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:128
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:129
 msgid "Toggle all publish permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:134
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:135
 msgid "Toggle all lock permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:140
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:141
 msgid "Toggle all unlock permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:146
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:147
 msgid "Toggle all custom permissions"
 msgstr ""
 
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:156
-#: templates/wagtailusers/groups/includes/formatted_permissions.html:159
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:157
+#: templates/wagtailusers/groups/includes/formatted_permissions.html:160
 msgid "Other permissions"
 msgstr ""
 
@@ -411,12 +412,12 @@ msgstr ""
 msgid "Roles"
 msgstr ""
 
-#: templates/wagtailusers/users/create.html:61 views/users.py:266
+#: templates/wagtailusers/users/create.html:61 views/users.py:280
 msgid "Add user"
 msgstr ""
 
 #: templates/wagtailusers/users/edit.html:50
-#: templates/wagtailusers/users/edit.html:71 views/users.py:340
+#: templates/wagtailusers/users/edit.html:71 views/users.py:355
 msgid "Delete user"
 msgstr ""
 
@@ -435,6 +436,10 @@ msgid ""
 "href=\"%(wagtailusers_add_url)s\">add some</a>?"
 msgstr ""
 
+#: templatetags/wagtailusers_tags.py:64
+msgid "Can view"
+msgstr ""
+
 #: utils.py:53
 #, python-format
 msgid "user %(id)s (deleted)"
@@ -462,12 +467,12 @@ msgid_plural "%(num_parent_objects)d users have been deleted"
 msgstr[0] ""
 msgstr[1] ""
 
-#: views/bulk_actions/set_active_state.py:11 views/users.py:118
-#: views/users.py:174
+#: views/bulk_actions/set_active_state.py:11 views/users.py:132
+#: views/users.py:188
 msgid "Active"
 msgstr ""
 
-#: views/bulk_actions/set_active_state.py:11 views/users.py:176
+#: views/bulk_actions/set_active_state.py:11 views/users.py:190
 msgid "Inactive"
 msgstr ""
 
@@ -493,7 +498,7 @@ msgid_plural "%(num_parent_objects)d users have been marked as inactive"
 msgstr[0] ""
 msgstr[1] ""
 
-#: views/groups.py:82 wagtail_hooks.py:93
+#: views/groups.py:82 views/groups.py:153
 msgid "Groups"
 msgstr ""
 
@@ -528,58 +533,58 @@ msgstr ""
 msgid "Group '%(object)s' deleted."
 msgstr ""
 
-#: views/users.py:99 views/users.py:185
+#: views/users.py:113 views/users.py:199
 msgid "Last login"
 msgstr ""
 
-#: views/users.py:105
+#: views/users.py:119
 msgid "Group"
 msgstr ""
 
-#: views/users.py:135
+#: views/users.py:149
 msgid "Add a user"
 msgstr ""
 
-#: views/users.py:138 wagtail_hooks.py:73 wagtail_hooks.py:131
+#: views/users.py:152 views/users.py:392 views/users.py:429
 msgid "Users"
 msgstr ""
 
-#: views/users.py:159
+#: views/users.py:173
 msgid "Username"
 msgstr ""
 
-#: views/users.py:166
+#: views/users.py:180
 msgid "Admin"
 msgstr ""
 
-#: views/users.py:167
+#: views/users.py:181
 msgid "Access level"
 msgstr ""
 
-#: views/users.py:178
+#: views/users.py:192
 msgid "Status"
 msgstr ""
 
-#: views/users.py:230
+#: views/users.py:244
 #, python-format
 msgid "More options for '%(title)s'"
 msgstr ""
 
-#: views/users.py:265
+#: views/users.py:279
 #, python-format
 msgid "User '%(object)s' created."
 msgstr ""
 
-#: views/users.py:287
+#: views/users.py:301
 #, python-format
 msgid "User '%(object)s' updated."
 msgstr ""
 
-#: views/users.py:288
+#: views/users.py:302
 msgid "The user could not be saved due to errors."
 msgstr ""
 
-#: views/users.py:341
+#: views/users.py:356
 #, python-format
 msgid "User '%(object)s' deleted."
 msgstr ""

wagtail/users/models.py

@@ -89,6 +89,7 @@ class UserProfile(models.Model):
         SNUG = "snug", _("Snug")
 
     density = models.CharField(
+        # Translators: "Density" is the term used to describe the amount of space between elements in the user interface
         verbose_name=_("density"),
         choices=AdminDensityThemes.choices,
         default=AdminDensityThemes.DEFAULT,

wagtail/users/templates/wagtailusers/groups/includes/formatted_permissions.html

@@ -96,7 +96,8 @@
                                     <fieldset class="w-p-0">
                                         <legend class="w-sr-only">{% trans "Custom permissions" %}</legend>
                                         {% for custom_perm in content_perms_dict.custom %}
-                                            {% include "wagtailadmin/shared/forms/single_checkbox.html" with name="permissions" value=custom_perm.perm.id checked=custom_perm.selected text=custom_perm.name attrs=custom_perm.attrs %}
+                                            {% trans custom_perm.name as custom_perm_label %}
+                                            {% include "wagtailadmin/shared/forms/single_checkbox.html" with name="permissions" value=custom_perm.perm.id checked=custom_perm.selected text=custom_perm_label attrs=custom_perm.attrs %}
                                         {% endfor %}
                                     </fieldset>
                                 {% endif %}
@@ -170,7 +171,7 @@
             <tbody>
                 {% for perm_tuple in other_perms %}
                     <tr>
-                        <td class="title"><label for="{{ perm_tuple.1.id_for_label }}" class="w-label-3">{{ perm_tuple.0.name }}</label></td>
+                        <td class="title"><label for="{{ perm_tuple.1.id_for_label }}" class="w-label-3">{% trans perm_tuple.0.name %}</label></td>
                         <td>
                             {{ perm_tuple.1.tag }}
                         </td>

wagtail/users/templatetags/wagtailusers_tags.py

@@ -6,6 +6,7 @@ from django.contrib.auth import get_permission_codename
 from django.contrib.auth.models import Permission
 from django.contrib.contenttypes.models import ContentType
 from django.utils.text import camel_case_to_spaces
+from django.utils.translation import gettext_noop
 
 from wagtail import hooks
 from wagtail.admin.models import Admin
@@ -55,6 +56,14 @@ def normalize_permission_label(permission: Permission):
     return label
 
 
+# normalize_permission_label will return "Can view" for Django's standard "Can view X" permission.
+# formatted_permissions.html passes these labels through {% trans %} - since this is a variable
+# within the template it will not be picked up by makemessages, so we define a translation here
+# instead.
+
+VIEW_PERMISSION_LABEL = gettext_noop("Can view")
+
+
 @register.inclusion_tag("wagtailusers/groups/includes/formatted_permissions.html")
 def format_permissions(permission_bound_field):
     """

wagtail/users/tests/__init__.py

@@ -2,6 +2,12 @@ from .test_admin_views import (
     CustomGroupViewSet,
     CustomUserCreationForm,
     CustomUserEditForm,
+    CustomUserViewSet,
 )
 
-__all__ = ["CustomGroupViewSet", "CustomUserCreationForm", "CustomUserEditForm"]
+__all__ = [
+    "CustomGroupViewSet",
+    "CustomUserViewSet",
+    "CustomUserCreationForm",
+    "CustomUserEditForm",
+]

wagtail/users/tests/test_admin_views.py

@@ -33,12 +33,16 @@ from wagtail.models import (
 )
 from wagtail.test.utils import WagtailTestUtils
 from wagtail.test.utils.template_tests import AdminTemplateTestUtils
-from wagtail.users.forms import UserCreationForm, UserEditForm
+from wagtail.users.forms import GroupForm, UserCreationForm, UserEditForm
 from wagtail.users.models import UserProfile
 from wagtail.users.permission_order import register as register_permission_order
 from wagtail.users.views.groups import GroupViewSet
-from wagtail.users.views.users import get_user_creation_form, get_user_edit_form
-from wagtail.users.wagtail_hooks import get_group_viewset_cls
+from wagtail.users.views.users import (
+    UserViewSet,
+    get_user_creation_form,
+    get_user_edit_form,
+)
+from wagtail.users.wagtail_hooks import get_viewset_cls
 from wagtail.users.widgets import UserListingButton
 from wagtail.utils.deprecation import RemovedInWagtail70Warning
 
@@ -53,6 +57,10 @@ def test_avatar_provider(user, default, size=50):
     return "/nonexistent/path/to/avatar.png"
 
 
+class CustomGroupForm(GroupForm):
+    pass
+
+
 class CustomUserCreationForm(UserCreationForm):
     country = forms.CharField(required=True, label="Country")
     attachment = forms.FileField(required=True, label="Attachment")
@@ -66,6 +74,18 @@ class CustomUserEditForm(UserEditForm):
 class CustomGroupViewSet(GroupViewSet):
     icon = "custom-icon"
 
+    def get_form_class(self, for_update=False):
+        return CustomGroupForm
+
+
+class CustomUserViewSet(UserViewSet):
+    icon = "custom-icon"
+
+    def get_form_class(self, for_update=False):
+        if for_update:
+            return CustomUserEditForm
+        return CustomUserCreationForm
+
 
 class TestUserFormHelpers(TestCase):
     def test_get_user_edit_form_with_default_form(self):
@@ -80,25 +100,45 @@ class TestUserFormHelpers(TestCase):
         WAGTAIL_USER_CREATION_FORM="wagtail.users.tests.CustomUserCreationForm"
     )
     def test_get_user_creation_form_with_custom_form(self):
-        user_form = get_user_creation_form()
+        with self.assertWarnsMessage(
+            RemovedInWagtail70Warning,
+            "The `WAGTAIL_USER_CREATION_FORM` setting is deprecated. Use a custom "
+            "`UserViewSet` subclass and override `get_form_class()` instead.",
+        ):
+            user_form = get_user_creation_form()
         self.assertIs(user_form, CustomUserCreationForm)
 
     @override_settings(WAGTAIL_USER_EDIT_FORM="wagtail.users.tests.CustomUserEditForm")
     def test_get_user_edit_form_with_custom_form(self):
-        user_form = get_user_edit_form()
+        with self.assertWarnsMessage(
+            RemovedInWagtail70Warning,
+            "The `WAGTAIL_USER_EDIT_FORM` setting is deprecated. Use a custom "
+            "`UserViewSet` subclass and override `get_form_class()` instead.",
+        ):
+            user_form = get_user_edit_form()
         self.assertIs(user_form, CustomUserEditForm)
 
     @override_settings(
         WAGTAIL_USER_CREATION_FORM="wagtail.users.tests.CustomUserCreationFormDoesNotExist"
     )
     def test_get_user_creation_form_with_invalid_form(self):
-        self.assertRaises(ImproperlyConfigured, get_user_creation_form)
+        with self.assertWarnsMessage(
+            RemovedInWagtail70Warning,
+            "The `WAGTAIL_USER_CREATION_FORM` setting is deprecated. Use a custom "
+            "`UserViewSet` subclass and override `get_form_class()` instead.",
+        ):
+            self.assertRaises(ImproperlyConfigured, get_user_creation_form)
 
     @override_settings(
         WAGTAIL_USER_EDIT_FORM="wagtail.users.tests.CustomUserEditFormDoesNotExist"
     )
     def test_get_user_edit_form_with_invalid_form(self):
-        self.assertRaises(ImproperlyConfigured, get_user_edit_form)
+        with self.assertWarnsMessage(
+            RemovedInWagtail70Warning,
+            "The `WAGTAIL_USER_EDIT_FORM` setting is deprecated. Use a custom "
+            "`UserViewSet` subclass and override `get_form_class()` instead.",
+        ):
+            self.assertRaises(ImproperlyConfigured, get_user_edit_form)
 
 
 class TestGroupUsersView(AdminTemplateTestUtils, WagtailTestUtils, TestCase):
@@ -466,7 +506,6 @@ class TestUserCreateView(AdminTemplateTestUtils, WagtailTestUtils, TestCase):
     )
     @override_settings(
         WAGTAIL_USER_CREATION_FORM="wagtail.users.tests.CustomUserCreationForm",
-        WAGTAIL_USER_CUSTOM_FIELDS=["country", "document"],
     )
     def test_create_with_custom_form(self):
         response = self.post(
@@ -1625,7 +1664,7 @@ class TestGroupIndexView(AdminTemplateTestUtils, WagtailTestUtils, TestCase):
         self.assertEqual(names, ["Editors", "Moderators", "Photographers"])
 
 
-class TestGroupIndexResultsView(WagtailTestUtils, TestCase):
+class TestGroupIndexResultsView(AdminTemplateTestUtils, WagtailTestUtils, TestCase):
     def setUp(self):
         self.login()
 
@@ -1637,7 +1676,7 @@ class TestGroupIndexResultsView(WagtailTestUtils, TestCase):
         self.assertEqual(response.status_code, 200)
         self.assertTemplateUsed(response, "wagtailadmin/generic/listing_results.html")
         # response should not contain page furniture
-        self.assertNotContains(response, "Add a group")
+        self.assertBreadcrumbsNotRendered(response.content)
 
     def test_search(self):
         response = self.get({"q": "Hello"})
@@ -2397,7 +2436,7 @@ class TestGroupEditView(AdminTemplateTestUtils, WagtailTestUtils, TestCase):
 
     def test_is_custom_permission_checked(self):
         # Add a permission from the 'custom permission' column to the user's group
-        custom_permission = Permission.objects.get(codename="view_fancysnippet")
+        custom_permission = Permission.objects.get(codename="view_fullfeaturedsnippet")
         self.test_group.permissions.add(custom_permission)
 
         response = self.get()
@@ -2566,44 +2605,76 @@ class TestGroupHistoryView(WagtailTestUtils, TestCase):
 
 
 class TestGroupViewSet(TestCase):
+    app_config_attr = "group_viewset"
+    default_viewset_cls = GroupViewSet
+    custom_viewset_cls = CustomGroupViewSet
+    create_form_cls = CustomGroupForm
+    edit_form_cls = CustomGroupForm
+
     def setUp(self):
         self.app_config = apps.get_app_config("wagtailusers")
 
-    def test_get_group_viewset_cls(self):
-        self.assertIs(get_group_viewset_cls(self.app_config), GroupViewSet)
+    def test_get_viewset_cls(self):
+        self.assertIs(
+            get_viewset_cls(self.app_config, self.app_config_attr),
+            self.default_viewset_cls,
+        )
 
-    def test_get_group_viewset_cls_with_custom_form(self):
+    def test_get_viewset_cls_with_custom_form(self):
         with unittest.mock.patch.object(
             self.app_config,
-            "group_viewset",
-            new="wagtail.users.tests.CustomGroupViewSet",
+            self.app_config_attr,
+            new=f"wagtail.users.tests.{self.custom_viewset_cls.__name__}",
         ):
-            group_viewset = get_group_viewset_cls(self.app_config)
-        self.assertIs(group_viewset, CustomGroupViewSet)
+            group_viewset = get_viewset_cls(self.app_config, self.app_config_attr)
+        self.assertIs(group_viewset, self.custom_viewset_cls)
         self.assertEqual(group_viewset.icon, "custom-icon")
+        viewset = group_viewset()
+        self.assertIs(viewset.get_form_class(for_update=False), self.create_form_cls)
+        self.assertIs(viewset.get_form_class(for_update=True), self.edit_form_cls)
 
-    def test_get_group_viewset_cls_custom_form_invalid_value(self):
+    def test_get_viewset_cls_custom_form_invalid_value(self):
         with unittest.mock.patch.object(
-            self.app_config, "group_viewset", new="asdfasdf"
+            self.app_config, self.app_config_attr, new="asdfasdf"
         ):
-            with self.assertRaises(ImproperlyConfigured) as exc_info:
-                get_group_viewset_cls(self.app_config)
-            self.assertIn(
-                "asdfasdf doesn't look like a module path", str(exc_info.exception)
-            )
+            with self.assertRaisesMessage(
+                ImproperlyConfigured,
+                f"Invalid setting for WagtailUsersAppConfig.{self.app_config_attr}: "
+                "asdfasdf doesn't look like a module path",
+            ):
+                get_viewset_cls(self.app_config, self.app_config_attr)
 
-    def test_get_group_viewset_cls_custom_form_does_not_exist(self):
+    def test_get_viewset_cls_custom_form_does_not_exist(self):
         with unittest.mock.patch.object(
             self.app_config,
-            "group_viewset",
+            self.app_config_attr,
             new="wagtail.users.tests.CustomClassDoesNotExist",
         ):
-            with self.assertRaises(ImproperlyConfigured) as exc_info:
-                get_group_viewset_cls(self.app_config)
-            self.assertIn(
+            with self.assertRaisesMessage(
+                ImproperlyConfigured,
+                f"Invalid setting for WagtailUsersAppConfig.{self.app_config_attr}: "
                 'Module "wagtail.users.tests" does not define a "CustomClassDoesNotExist" attribute/class',
-                str(exc_info.exception),
-            )
+            ):
+                get_viewset_cls(self.app_config, self.app_config_attr)
+
+
+class TestUserViewSet(TestGroupViewSet):
+    app_config_attr = "user_viewset"
+    default_viewset_cls = UserViewSet
+    custom_viewset_cls = CustomUserViewSet
+    create_form_cls = CustomUserCreationForm
+    edit_form_cls = CustomUserEditForm
+
+    def test_registered_permissions(self):
+        group_ct = ContentType.objects.get_for_model(Group)
+        qs = Permission.objects.none()
+        for fn in hooks.get_hooks("register_permissions"):
+            qs |= fn()
+        registered_user_permissions = qs.filter(content_type=group_ct)
+        self.assertEqual(
+            set(registered_user_permissions.values_list("codename", flat=True)),
+            {"add_group", "change_group", "delete_group"},
+        )
 
 
 class TestAuthorisationIndexView(WagtailTestUtils, TestCase):
@@ -2957,3 +3028,17 @@ class TestTemplateTags(WagtailTestUtils, TestCase):
             top_level_custom_button.text.strip(),
             "Show profile",
         )
+
+
+class TestAdminPermissions(WagtailTestUtils, TestCase):
+    def test_registered_user_permissions(self):
+        user_ct = ContentType.objects.get_for_model(User)
+        model_name = User._meta.model_name
+        qs = Permission.objects.none()
+        for fn in hooks.get_hooks("register_permissions"):
+            qs |= fn()
+        registered_user_permissions = qs.filter(content_type=user_ct)
+        self.assertEqual(
+            set(registered_user_permissions.values_list("codename", flat=True)),
+            {f"add_{model_name}", f"change_{model_name}", f"delete_{model_name}"},
+        )

wagtail/users/views/groups.py

@@ -149,6 +149,10 @@ class GroupViewSet(ModelViewSet):
     model = Group
     ordering = ["name"]
     add_to_reference_index = False
+    menu_name = "groups"
+    menu_label = _("Groups")
+    menu_order = 601
+    add_to_settings_menu = True
 
     index_view_class = IndexView
     add_view_class = CreateView