BhMTddlmZmZGddZGddZGddeZy ) )ABCMetaabstractmethodc`eZdZdZgZgZdZdZdZdZ gZ fdZ dZ dZ dZd dZd d ZxZS) CMSAppzBase class for creating apphooks. Apphooks live in a file called ``cms_apps.py``. To create an AppHook subclass ``CMSApp`` in ``cms_apps.py`` :: class MyAppHook(CMSApp): name = "Problem solver" NTcD|jrt|jddr]|jj|k7rDtd|jjjd|jjd||j_t ||S)z We want to bind the CMSapp class to a specific AppHookConfig, but only one at a time Checking for the runtime attribute should be a sane fix cmsappNz?Only one AppHook per AppHookConfiguration must exists. AppHook z already defined for z AppHookConfig) app_configgetattrr RuntimeError__name__super__new__)cls __class__s >s~~x63>>;P;PTW;W"--668O8O %(CNN !ws##ctd)zr Returns all the apphook configuration instances. To be implemented by apphook subclass. 0Configurable AppHooks must implement this methodNotImplementedErrorselfs r get_configszCMSApp.get_configs, ""TUUrctd)z Returns the apphook configuration instance linked to the given namespace To be implemented by apphook subclass. rr)r namespaces r get_configzCMSApp.get_config4rrctd)z Returns the url to add a new apphook configuration instance (usually the model admin add view) To be implemented by apphook subclass. rrrs rget_config_add_urlzCMSApp.get_config_add_url<s""TUUrc |jS)a Returns the menus for the apphook instance, eventually selected according to the given arguments. By default, it returns the menus assigned to :py:attr:`CMSApp._menus`. The method accepts page, language and generic keyword arguments: you can customize this function to return different list of menu classes according to the given arguments. If no menus are returned, then the user will need to attach menus to pages manually in the admin. If no page and language are provided, this method **must** return **all the menus used by this apphook**. Example:: if page and page.reverse_id == 'page1': return [Menu1] elif page and page.reverse_id == 'page2': return [Menu2] else: return [Menu1, Menu2] :param page: page the apphook is attached to :param language: current site language :return: list of menu classes )_menusrpagelanguagekwargss r get_menuszCMSApp.get_menusEs8{{rc |jS)a Returns the urlconfs for the apphook instance, eventually selected according to the given arguments. By default, it returns the urls assigned to :py:attr:`CMSApp._urls` The method accepts page, language and generic keyword arguments: you can customize this function to return different list of menu classes according to the given arguments. This method **must** return a non-empty list of urlconfs, even if no argument is passed. :param page: page the apphook is attached to :param language: current site language :return: list of urlconfs strings )_urlsr"s rget_urlszCMSApp.get_urlscs$zzr)NN)r __module__ __qualname____doc__r(r!nameapp_namer permissionsexclude_permissionsrrrrr&r) __classcell__)rs@rrrsS E F DHJK$ VVV<rrceZdZdZdZy) CMSAppConfigaZ .. versionadded:: 4.0 Base class that all cms app configurations should inherit from. CMSAppConfig live in a file called ``cms_config.py``. Apps subclassing ``CMSAppConfig`` can set ``cms_enabled = True`` for their app config to use django CMS' wizard functionality. Additional wizzwards are listed in the app config's ``cms_wizzards`` property. The second functionality that django CMS offers is attaching Model objects to the toolbar. To use this functionality, set list the Model classes in ``cms_toolbar_enabled_models`` and have ``cms_enabled = True`` c||_y)N)r )rdjango_app_configs r__init__zCMSAppConfig.__init__s +rN)r r*r+r,r6rrr3r3xs  ,rr3c&eZdZdZedZdZy)CMSAppExtensiona .. versionadded:: 4.0 Base class that all cms app extensions should inherit from. App extensions allow apps to offer their functionality to other apps, e.g., as done by djangocms-versioning. CMSAppExtensions live in a file called ``cms_config.py``. cy)a Implement this method if the app provides functionality that other apps can use and configure. This method will be run once for every app that defines an attribute like ``_enabled`` as ``True`` on its cms app config class. So for example, if app A with label "app_a" implements this method and app B and app C define ``app_a_enabled = True`` on their cms config classes, the method app A has defined will run twice, once for app B and once for app C. :param cms_config: the cms config class of the app registering for additional functionality :type cms_config: :class:`CMSAppConfig` subclass Nr7)r cms_configs r configure_appzCMSAppExtension.configure_apps$ rcy)zOverride this method to run code after all CMS extensions have been configured. This method will be run once, even if no cms app config sets its ``_enabled`` attribute to ``True``Nr7rs rreadyzCMSAppExtension.readys rN)r r*r+r,rr<r>r7rrr9r9s   & rr9) metaclassN)abcrrrr3r9r7rrrAs+'qqh,,*$ $ r