Skip to content

Index

hypha.core.wagtail.admin

register_public_site_setting module-attribute 

register_public_site_setting = register_decorator

SettingModelAdmin 

SettingModelAdmin(parent=None)

Bases: WagtailRegisterable

The core SettingModelAdmin class. It has minimal implementation that allows adding a SettingModelAdmin class just like ModelAdmin to the ModelGroupAdmin as an item.

The BaseSiteSetting still needs to be registered with @register_setting decorator and will show up in the setting menu.

Don't allow initialization unless self.model is set to a valid model

Source code in hypha/core/wagtail/admin/options.py 
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
def __init__(self, parent=None):
    """
    Don't allow initialization unless self.model is set to a valid model
    """
    if not self.model or not issubclass(self.model, BaseSiteSetting):
        raise ImproperlyConfigured(
            "The model attribute on your '%s' class must be set, and "
            "must be inherit BaseSiteSetting class." % self.__class__.__name__
        )
    self.parent = parent

    self.is_pagemodel = issubclass(self.model, Page)
    self.permission_helper = self.get_permission_helper_class()(
        self.model, self.inspect_view_enabled
    )

model class-attribute instance-attribute 

model = None

inspect_view_enabled class-attribute instance-attribute 

inspect_view_enabled = False

permission_helper_class class-attribute instance-attribute 

permission_helper_class = None

parent instance-attribute 

parent = parent

is_pagemodel instance-attribute 

is_pagemodel = issubclass(model, Page)

permission_helper instance-attribute 

permission_helper = get_permission_helper_class()(model, inspect_view_enabled)

get_menu_item 

get_menu_item(order=None)
Source code in hypha/core/wagtail/admin/options.py 
40
41
def get_menu_item(self, order=None):
    return SettingMenuItem(self.model)

get_admin_urls_for_registration 

get_admin_urls_for_registration()
Source code in hypha/core/wagtail/admin/options.py 
43
44
def get_admin_urls_for_registration(self):
    return ()

get_permission_helper_class 

get_permission_helper_class()

Returns a permission_helper class to help with permission-based logic for the given model.

Copied from the wagtail's ModelAdmin

Source code in hypha/core/wagtail/admin/options.py 
46
47
48
49
50
51
52
53
54
55
56
57
def get_permission_helper_class(self):
    """
    Returns a permission_helper class to help with permission-based logic
    for the given model.

    **Copied from the wagtail's ModelAdmin**
    """
    if self.permission_helper_class:
        return self.permission_helper_class
    if self.is_pagemodel:
        return PagePermissionHelper
    return PermissionHelper

get_permissions_for_registration 

get_permissions_for_registration()

Utilised by Wagtail's 'register_permissions' hook to allow permissions for a model to be assigned to groups in settings. This is only required if the model isn't a Page model, and isn't registered as a Snippet

Copied from the wagtail's ModelAdmin

Source code in hypha/core/wagtail/admin/options.py 
59
60
61
62
63
64
65
66
67
68
69
70
71
def get_permissions_for_registration(self):
    """
    Utilised by Wagtail's 'register_permissions' hook to allow permissions
    for a model to be assigned to groups in settings. This is only required
    if the model isn't a Page model, and isn't registered as a Snippet

    **Copied from the wagtail's ModelAdmin**
    """
    from wagtail.snippets.models import SNIPPET_MODELS

    if not self.is_pagemodel and self.model not in SNIPPET_MODELS:
        return self.permission_helper.get_all_model_permissions()
    return Permission.objects.none()