o hmp@sVddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZmZddlmZmZmZddl m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(ddl)m*Z*m+Z+ddl,m-Z-ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5GdddZ6Gddde6Z7Gddde6Z8ddZ9dS))settings)site) Permission)checks)ImproperlyConfigured)Model)re_path) mark_safe)hooks)register_admin_url_finder)check_panels_in_model)Menu) ObjectList*extract_panel_definitions_from_model_class)PageReferenceIndexTranslatableMixin)AdminURLHelper ButtonHelperDjangoORMSearchHandlerModelAdminURLFinderPageAdminURLHelperPageButtonHelperPagePermissionHelperPermissionHelper) GroupMenuItemModelAdminMenuItem)ThumbnailMixin)ChooseParentView CreateView DeleteViewEditView HistoryView IndexView InspectViewc@s<eZdZdZdZdZdZddZddZdd Z d d Z d S) WagtailRegisterablez Base class, providing a more convenient way for ModelAdmin or ModelAdminGroup instances to be registered with Wagtail's admin area. FTcstdfdd}tdfdd}jrd}njr"d}nd}|r1t|fd d }r@td fd d }dS)Nregister_permissionscSN) get_permissions_for_registrationselfr+Z/var/www/html/ndineBlogger/venv/lib/python3.10/site-packages/wagtail_modeladmin/options.pyr'2zGWagtailRegisterable.register_with_wagtail..register_permissionsregister_admin_urlscr(r))get_admin_urls_for_registrationr+r,r+r.r06r/zFWagtailRegisterable.register_with_wagtail..register_admin_urlsregister_settings_menu_itemregister_admin_menu_itemcr(r)) get_menu_itemr+r,r+r.r3Cr/zKWagtailRegisterable.register_with_wagtail..register_admin_menu_item construct_explorer_page_querysetcs|||Sr))modify_explorer_page_queryset) parent_pagequerysetrequestr,r+r.r5LszSWagtailRegisterable.register_with_wagtail..construct_explorer_page_queryset)r registeradd_to_settings_menuadd_to_admin_menu"will_modify_explorer_page_querysetregister_admin_url_findersregister_indexing)r-r'r0 menu_hookr3r5r+r,r.register_with_wagtail1s" z)WagtailRegisterable.register_with_wagtailcCdSr)r+r,r+r+r.r>Vz.WagtailRegisterable.register_admin_url_finderscCrBr)r+r,r+r+r.r?YrCz%WagtailRegisterable.register_indexingcCsdS)NFr+r,r+r+r.r=\rCz6WagtailRegisterable.will_modify_explorer_page_querysetN) __name__ __module__ __qualname____doc__r;r<exclude_from_explorerrAr>r?r=r+r+r+r.r&'s% r&cseZdZdZdZdZdZdZdZdZ dZ dZ gZ gZ dZdZdZdZdZdZdZdZdZiZeZeZeZeZe Z!e"Z#e$Z%d Z&d Z'd Z(d Z)d Z*d Z+d Z,e-Z.iZ/dZ0dZ1dZ2gZ3gZ4gZ5gZ6gZ7gZ8gZ9dZ:dwd d Z;d d ZddZ?ddZ@ddZAddZBddZCddZDddZEdwd d!ZFd"d#ZGd$d%ZHd&d'ZId(d)ZJdwd*d+ZKd,d-ZLd.d/ZMd0d1ZNd2d3ZOd4d5ZPd6d7ZQd8d9ZRd:d;ZSdd?ZUd@dAZVdBdCZWdDdEZXdFdGZYdHdIZZdJdKZ[dLdMZ\dNdOZ]dPdQZ^dRdSZ_dTdUZ`dxdWdXZadYdZZbd[d\Zcd]d^Zdd_d`ZedadbZfdcddZgdedfZhdwdgdhZididjZjdkdlZkdmdnZldodpZmfdqdrZndsdtZodudvZpZqS)y ModelAdminau The core modeladmin class. It provides an alternative means to list and manage instances of a given 'model' within Wagtail's admin area. It is essentially comprised of attributes and methods that allow a degree of control over how the data is represented, and other methods to make the additional functionality available via various Wagtail hooks. N)__str__r+FT-dcCsx|jr t|jtstd|jj|jj|_t|jt|_ ||_ | |j|j |_ |}||j|jd|_t|_dS)zV Don't allow initialisation unless self.model is set to a valid model zUThe model attribute on your '%s' class must be set, and must be a valid Django model.) base_url_pathN)model issubclassrr __class__rD_metaoptsr is_pagemodelparentget_permission_helper_classinspect_view_enabledpermission_helperget_url_helper_classrN url_helperdefault_django_admin_site admin_site)r-rUurl_helper_classr+r+r.__init__s  zModelAdmin.__init__cC|jr|jS|jr tStS)zt Returns a permission_helper class to help with permission-based logic for the given model. )permission_helper_classrTrrr,r+r+r.rV z&ModelAdmin.get_permission_helper_classcCr_r))r]rTrrr,r+r+r.rYs zModelAdmin.get_url_helper_classcCr_)zd Returns a ButtonHelper class to help generate buttons for the given model. )button_helper_classrTrrr,r+r+r.get_button_helper_classraz"ModelAdmin.get_button_helper_classcCs|jp|jjS)zF Returns the label text to be used for the menu item. ) menu_labelrSverbose_name_pluraltitler,r+r+r.get_menu_labelszModelAdmin.get_menu_labelcC|jS)z@ Returns the name to be used for the menu item. menu_item_namer,r+r+r.get_menu_item_namezModelAdmin.get_menu_item_namecCs|jr|jS|jr dSdS)a  Returns the icon to be used for the menu item. The value is prepended with 'icon-' to create the full icon class name. For design consistency, the same icon is also applied to the main heading for views called by this class. zdoc-full-inversesnippet) menu_iconrTr,r+r+r. get_menu_icons zModelAdmin.get_menu_iconcC |jpdS)aG Returns the 'order' to be applied to the menu item. 000 being first place. Where ModelAdminGroup is used, the menu_order value should be applied to that, and any ModelAdmin classes added to 'items' attribute will be ordered automatically, based on their order in that sequence.  menu_orderr,r+r+r.get_menu_orders zModelAdmin.get_menu_ordercCrh)zq Return a sequence containing the fields/method output to be displayed in the list view. ) list_displayr-r9r+r+r.get_list_displayzModelAdmin.get_list_displaycCs|jp ||dS)z Return the name of the field/method from list_display where action buttons should be added. Defaults to the first item from get_list_display() r)list_display_add_buttonsrwrvr+r+r.get_list_display_add_buttonssz'ModelAdmin.get_list_display_add_buttonscCrh)zw Return a sequence containing the fields/method output to be displayed in spreadsheet exports. ) list_exportrvr+r+r.get_list_exportrxzModelAdmin.get_list_exportcCs t|jS)zL Return the empty_value_display value defined on ModelAdmin )r empty_value_display)r- field_namer+r+r.get_empty_value_display z"ModelAdmin.get_empty_value_displaycCs2|j}ttddrt|jtrd|vr|d7}|S)z Returns a sequence containing the fields to be displayed as filters in the right sidebar in the list view. WAGTAIL_I18N_ENABLEDFlocale)r) list_filtergetattrrrPrOr)r-r9rr+r+r.get_list_filter s  zModelAdmin.get_list_filtercCrp)zh Returns a sequence defining the default ordering for results in the list view. r+)orderingrvr+r+r. get_ordering zModelAdmin.get_orderingcCs:|jj}||}|r|j|}|jr|jdd}|S)zi Returns a QuerySet of all model instances that can be edited by the admin site. r)depth)rO_default_manager get_querysetrorder_byrTexclude)r-r9qsrr+r+r.r"s    zModelAdmin.get_querysetcCrp)z Returns a sequence defining which fields on a model should be searched when a search is initiated from the list view. r+) search_fieldsrvr+r+r.get_search_fields0rzModelAdmin.get_search_fieldscCs||p||S)zq Returns an instance of ``self.search_handler_class`` that can be used by ``IndexView``. )search_handler_classr)r-r9rr+r+r.get_search_handler7s zModelAdmin.get_search_handlercCrh)zv Returns a dictionary of additional kwargs to be sent to ``SearchHandler.search_queryset()``. )extra_search_kwargs)r-r9 search_termr+r+r.get_extra_search_kwargs@rxz"ModelAdmin.get_extra_search_kwargscCiS)z Return a dictionary of HTML attributes to be added to the `` element for the supplied `obj` when rendering the results table in `index_view`. `data-object-pk` is already added by default. r+)r-objcontextr+r+r.get_extra_attrs_for_rowGsz"ModelAdmin.get_extra_attrs_for_rowcCsgS)z Return a list of additional CSS class names to be added to the table cell's `class` attribute when rendering the output of `field_name` for `obj` in `index_view`. Must always return a list. r+r-rr~r+r+r.#get_extra_class_names_for_field_colOz.ModelAdmin.get_extra_class_names_for_field_colcCr)z Return a dictionary of additional HTML attributes to be added to a table cell when rendering the output of `field_name` for `obj` in `index_view`. Must always return a dictionary. r+rr+r+r.get_extra_attrs_for_field_colYrz(ModelAdmin.get_extra_attrs_for_field_colcCs |jpiS)zf Returns a sequence specifying custom prepopulated fields slugs on Create/Edit pages. )prepopulated_fieldsrvr+r+r.get_prepopulated_fieldscrz"ModelAdmin.get_prepopulated_fieldscCrh)z` Returns a list or tuple of fields names to be excluded from Create/Edit pages. )form_fields_excluder,r+r+r.get_form_fields_excludeirlz"ModelAdmin.get_form_fields_excludecCrhr))index_view_extra_cssr,r+r+r.get_index_view_extra_cssoz#ModelAdmin.get_index_view_extra_csscCrhr))index_view_extra_jsr,r+r+r.get_index_view_extra_jsrrz"ModelAdmin.get_index_view_extra_jscCrhr))form_view_extra_cssr,r+r+r.get_form_view_extra_cssurz"ModelAdmin.get_form_view_extra_csscCrhr))form_view_extra_jsr,r+r+r.get_form_view_extra_jsxrz!ModelAdmin.get_form_view_extra_jscCrhr))inspect_view_extra_cssr,r+r+r.get_inspect_view_extra_css{rz%ModelAdmin.get_inspect_view_extra_csscCrhr))inspect_view_extra_jsr,r+r+r.get_inspect_view_extra_js~rz$ModelAdmin.get_inspect_view_extra_jscCsV|js(g}|jjD]}|j|jvr%|jr%|jr|js%|j r%| |jq |S|jS)al Return a list of field names, indicating the model fields that should be displayed in the 'inspect' view. Returns the value of the 'inspect_view_fields' attribute if populated, otherwise a sensible list of fields is generated automatically, with any field named in 'inspect_view_fields_exclude' not being included. ) inspect_view_fieldsrOrR get_fieldsnameinspect_view_fields_excludeconcrete is_relation auto_created related_modelappend)r- found_fieldsfr+r+r.get_inspect_view_fieldss  z"ModelAdmin.get_inspect_view_fieldscC"d|i}|j}|jdi||S)z Instantiates a class-based view to provide listing functionality for the assigned model. The view class used can be overridden by changing the 'index_view_class' attribute. model_adminNr+)index_view_classas_viewr-r9kwargs view_classr+r+r. index_viewszModelAdmin.index_viewcCr)a% Instantiates a class-based view to provide 'creation' functionality for the assigned model, or redirect to Wagtail's create view if the assigned model extends 'Page'. The view class used can be overridden by changing the 'create_view_class' attribute. rNr+)create_view_classrrr+r+r. create_viewszModelAdmin.create_viewcCr)aZ Instantiates a class-based view to allows a parent page to be chosen for a new object, where the assigned model extends Wagtail's Page model, and there is more than one potential parent for new instances. The view class used can be overridden by changing the 'choose_parent_view_class' attribute. rNr+)choose_parent_view_classrrr+r+r.choose_parent_viewszModelAdmin.choose_parent_viewcC$||d}|j}|jdi||S)z Instantiates a class-based view to provide 'inspect' functionality for the assigned model. The view class used can be overridden by changing the 'inspect_view_class' attribute. r instance_pkNr+)inspect_view_classrr-r9rrrr+r+r. inspect_views zModelAdmin.inspect_viewcCr)a Instantiates a class-based view to provide 'edit' functionality for the assigned model, or redirect to Wagtail's edit view if the assigned model extends 'Page'. The view class used can be overridden by changing the 'edit_view_class' attribute. rNr+)edit_view_classrrr+r+r. edit_views zModelAdmin.edit_viewcCr)aE Instantiates a class-based view to provide 'delete confirmation' functionality for the assigned model, or redirect to Wagtail's delete confirmation view if the assigned model extends 'Page'. The view class used can be overridden by changing the 'delete_view_class' attribute. rNr+)delete_view_classrrr+r+r. delete_views zModelAdmin.delete_viewcCs$||d}|j}|jdi||S)Nrr+)history_view_classrrr+r+r. history_views zModelAdmin.history_viewcCst|dr |j}|St|dr|j}t|}|St|jdr$|jj}|St|jdr4|jj}t|}|S|}t|j|d}t|}|S)a, Returns the appropriate edit_handler for this modeladmin class. edit_handlers can be defined either on the model itself or on the modeladmin (as property edit_handler or panels). Falls back to extracting panel / edit handler definitions from the model class. edit_handlerpanels)r)hasattrrrrrOrr)r-rrfields_to_excluder+r+r.get_edit_handlers(    zModelAdmin.get_edit_handlerindexcCs:|jj}|jj}d|||fd||fd|fgS)z Utility function that provides a list of templates to try for a given view, when the template isn't overridden by one of the template attributes on the class. zmodeladmin/%s/%s/%s.htmlzmodeladmin/%s/%s.htmlzmodeladmin/%s.html)rS app_labellower model_name)r-actionrrr+r+r. get_templatess    zModelAdmin.get_templatescC|jp|dS)z Returns a template to be used when rendering 'index_view'. If a template is specified by the 'index_template_name' attribute, that will be used. Otherwise, a list of preferred template names are returned. r)index_template_namerr,r+r+r.get_index_templatezModelAdmin.get_index_templatecCr)a Returns a template to be used when rendering 'choose_parent_view'. If a template is specified by the 'choose_parent_template_name' attribute, that will be used. Otherwise, a list of preferred template names are returned. choose_parent)choose_parent_template_namerr,r+r+r.get_choose_parent_template z%ModelAdmin.get_choose_parent_templatecCr)z Returns a template to be used when rendering 'inspect_view'. If a template is specified by the 'inspect_template_name' attribute, that will be used. Otherwise, a list of preferred template names are returned. inspect)inspect_template_namerr,r+r+r.get_inspect_templaterzModelAdmin.get_inspect_templatecCr)z Returns a template to be used when rendering 'history_view'. If a template is specified by the 'history_template_name' attribute, that will be used. Otherwise, a list of preferred template names are returned. history)history_template_namerr,r+r+r.get_history_templaterzModelAdmin.get_history_templatecCr)z Returns a template to be used when rendering 'create_view'. If a template is specified by the 'create_template_name' attribute, that will be used. Otherwise, a list of preferred template names are returned. create)create_template_namerr,r+r+r.get_create_template%rzModelAdmin.get_create_templatecCr)z Returns a template to be used when rendering 'edit_view'. If a template is specified by the 'edit_template_name' attribute, that will be used. Otherwise, a list of preferred template names are returned. edit)edit_template_namerr,r+r+r.get_edit_template.rzModelAdmin.get_edit_templatecCr)z Returns a template to be used when rendering 'delete_view'. If a template is specified by the 'delete_template_name' attribute, that will be used. Otherwise, a list of preferred template names are returned. delete)delete_template_namerr,r+r+r.get_delete_template6rzModelAdmin.get_delete_templatecCst||p|S)z Utilised by Wagtail's 'register_menu_item' hook to create a menu item to access the listing view, or can be called by ModelAdminGroup to create a submenu )rrt)r-orderr+r+r.r4?szModelAdmin.get_menu_itemcCs0ddlm}|js|j|vr|jStjS)z 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 r)SNIPPET_MODELS) wagtail.snippets.modelsrrTrOrXget_all_model_permissionsrobjectsnone)r-rr+r+r.r*Gs   z+ModelAdmin.get_permissions_for_registrationc Cst|jd|j|jddt|jd|j|jddt|jd|j|jddt|jd|j|jddf}|jrT|t|jd|j |jddf}|j rj|t|jd|j |jddf}|j r|t|jd|j |jddf}|S) z Utilised by Wagtail's 'register_admin_urls' hook to register urls for our the views that class offers. r)rrrrrrr)rrZget_action_url_patternrget_action_url_namerrrrWrhistory_view_enabledrrTr)r-urlsr+r+r.r1Ss\              z*ModelAdmin.get_admin_urls_for_registrationcCs |jo|jSr))rTrHr,r+r+r.r=s z-ModelAdmin.will_modify_explorer_page_querysetcCs|jr |jr ||j}|Sr))rTrHnot_typerO)r-r7r8r9r+r+r.r6s  z(ModelAdmin.modify_explorer_page_querysetc$ttdfdd}dS)Nrcstjd}|S)N modeladmin)r rO) app_configsrerrorsr,r+r.modeladmin_model_checks z@ModelAdmin.register_with_wagtail..modeladmin_model_checksuperrArr:r-rrQr,r.rA z ModelAdmin.register_with_wagtailcCs2|jstdtf|j|jd}t|j|dSdS)N_ModelAdminURLFinder)rXrZ)rTtyperrXrZr rO)r- finder_classr+r+r.r>sz%ModelAdmin.register_admin_url_finderscCst|jdSr))rregister_modelrOr,r+r+r.r?szModelAdmin.register_indexingr))r)rrDrErFrGrOrdrjrnrsruryr{rrrWrr}rlist_select_related list_per_pagerrrUrr$rr rr"rr%rr!rr#rrrrrrrrrrrrrr`r]rbrrrrrrrrNr^rVrYrcrgrkrortrwrzr|rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr4r*r1r=r6rAr>r? __classcell__r+r+rr.rI`s                       5  rIcseZdZdZdZdZdZdZdZddZ ddZ dd Z d d Z d d Z ddZddZddZddZddZddZddZfddZddZd d!ZZS)"ModelAdminGroupz Acts as a container for grouping together mutltiple PageModelAdmin and SnippetModelAdmin instances. Creates a menu item with a submenu for accessing the listing pages of those instances r+NcCs(g|_|jD] }|j||dqdS)z When initialising, instantiate the classes within 'items', and assign the instances to a 'modeladmin_instances' attribute for convenient access later )rUN)modeladmin_instancesitemsr)r-ModelAdminClassr+r+r.r^s zModelAdminGroup.__init__cCs|jp|Sr))rdget_app_label_from_subitemsr,r+r+r.rgszModelAdminGroup.get_menu_labelcCrhr)rir,r+r+r.rkrz"ModelAdminGroup.get_menu_item_namecCs|jD] }|jjSdS)NrM)rrSrrfr-instancer+r+r.rs z+ModelAdminGroup.get_app_label_from_subitemscCrp)Nzfolder-open-inverse)rnr,r+r+r.ro zModelAdminGroup.get_menu_iconcCrp)Nrqrrr,r+r+r.rtrzModelAdminGroup.get_menu_ordercCs(|jrt|d}t|||SdS)z Utilised by Wagtail's 'register_menu_item' hook to create a menu for this group with a submenu linking to listing pages for any associated ModelAdmin instances )rN)rr get_submenu_itemsrrt)r-submenur+r+r.r4szModelAdminGroup.get_menu_itemcCs2g}d}|jD]}||j|d|d7}q|S)Nr)r)rrr4)r- menu_items item_orderrr+r+r.rs   z!ModelAdminGroup.get_submenu_itemscCs&tj}|jD]}||B}q|S)z Utilised by Wagtail's 'register_permissions' hook to allow permissions for a all models grouped by this class to be assigned to Groups in settings. )rrrrr*)r-rrr+r+r.r*s  z0ModelAdminGroup.get_permissions_for_registrationcCs d}|jD]}||7}q|S)z Utilised by Wagtail's 'register_admin_urls' hook to register urls for used by any associated ModelAdmin instances r+)rr1)r-rrr+r+r.r1s z/ModelAdminGroup.get_admin_urls_for_registrationcCstdd|jDS)Ncss|]}|VqdSr))r=).0rr+r+r. s  zEModelAdminGroup.will_modify_explorer_page_queryset..)anyrr,r+r+r.r=sz2ModelAdminGroup.will_modify_explorer_page_querysetcCs|jD] }||||}q|Sr))rr6)r-r7r8r9rr+r+r.r6s z-ModelAdminGroup.modify_explorer_page_querysetcr)Nrcs$g}jD] }|t|jq|Sr))rextendr rO)rrrmodeladmin_classr,r+r.rs zEModelAdminGroup.register_with_wagtail..modeladmin_model_checkrrrr,r.rAr z%ModelAdminGroup.register_with_wagtailcC|jD]}|qdSr))rr>rr+r+r.r>  z*ModelAdminGroup.register_admin_url_finderscCr"r))rr?rr+r+r.r?r#z!ModelAdminGroup.register_indexing)rDrErFrGrrdrjrsrnr^rgrkrrortr4rr*r1r=r6rAr>r?rr+r+rr.rs,      rcCs|}||S)zT Method for registering ModelAdmin or ModelAdminGroup classes with Wagtail. )rA)r!rr+r+r.modeladmin_registersr$N): django.confrdjango.contrib.adminrr[django.contrib.auth.modelsr django.corerdjango.core.exceptionsrdjango.db.modelsr django.urlsrdjango.utils.safestringr wagtailr wagtail.admin.admin_url_finderr wagtail.admin.checksr wagtail.admin.menur wagtail.admin.panelsrrwagtail.modelsrrrhelpersrrrrrrrrmenusrrmixinsrviewsrr r!r"r#r$r%r&rIrr$r+r+r+r.s4           ( $ 9L o