&g1ddlmZ ddlmZddlmZddl m Z ddl mZGddeZGd d eeZGd d eeZGd deeZy#e$rddl mZddlm ZYOwxYw))apps)reverse) gettext_lazy) ugettext_lazy) mark_safe)AppListElementMixincJeZdZdZdZdZdZdZdZdZ dZ dZ d dZ dZ d Zd Zy) MenuItema This is the base class for custom menu items. A menu item can have the following properties: ``title`` String that contains the menu item title, make sure you use the django gettext functions if your application is multilingual. Default value: 'Untitled menu item'. ``url`` String that contains the menu item URL. Default value: '#'. ``css_classes`` A list of css classes to be added to the menu item ``li`` class attribute. Default value: []. ``accesskey`` The menu item accesskey. Default value: None. ``description`` An optional string that will be used as the ``title`` attribute of the menu-item ``a`` tag. Default value: None. ``enabled`` Boolean that determines whether the menu item is enabled or not. Disabled items are displayed but are not clickable. Default value: True. ``template`` The template to use to render the menu item. Default value: 'admin_tools/menu/item.html'. ``children`` A list of children menu items. All children items must be instances of the ``MenuItem`` class. zUntitled menu item#NTzadmin_tools/menu/item.htmlc |||_|||_|D])}t|j|st ||||+|j xsg|_|j xsg|_yN)titleurlhasattr __class__setattrchildren css_classes)selfrrkwargskeys O/var/www/html/djangosite/lib/python3.12/site-packages/admin_tools/menu/items.py__init__zMenuItem.__init__>sm  DJ ?DH 0Ct~~s+c6#;/ 0 + ++1rcy)a Like for menus, menu items have a ``init_with_context`` method that is called with a ``django.template.RequestContext`` instance as unique argument. This gives you enough flexibility to build complex items, for example, let's build a "history" menu item, that will list the last ten visited pages:: from admin_tools.menu.items import MenuItem class HistoryMenuItem(MenuItem): title = 'History' def init_with_context(self, context): request = context['request'] # we use sessions to store the visited pages stack history = request.session.get('history', []) for item in history: self.children.append(MenuItem( title=item['title'], url=item['url'] )) # add the current page to the history history.insert(0, { 'title': context['title'], 'url': request.META['PATH_INFO'] }) if len(history) > 10: history = history[:10] request.session['history'] = history Here's a screenshot of our history item: .. image:: images/history_menu_item.png N)rcontexts rinit_with_contextzMenuItem.init_with_contextLsH rc|j}|j|k(xs8t|jDcgc]}|j |s|c}dkDScc}w)z Helper method that returns ``True`` if the menu item is active. A menu item is considered as active if it's URL or one of its descendants URL is equals to the current URL. r) get_full_pathrlenr is_selected)rrequest current_urlcs rr"zMenuItem.is_selectedrsT ++- xx;&J DMMDqQ]]7-CD E I JDs A Acy)z Helper method that returns ``True`` if the menu item is empty. This method always returns ``False`` for basic items, but can return ``True`` if the item is an AppList. Frrs ris_emptyzMenuItem.is_empty|s r)NN)__name__ __module__ __qualname____doc__rrr accesskey descriptionenabledtemplaterrrr"r(rrrr r sH$L !E CKIKG+HH 2$ LJrr c0eZdZdZdfd ZdZdZxZS)AppLista A menu item that lists installed apps an their models. In addition to the parent :class:`~admin_tools.menu.items.MenuItem` properties, the ``AppList`` has two extra properties: ``models`` A list of models to include, only models whose name (e.g. "blog.comments.Comment") match one of the strings (e.g. "blog.*") in the models list will appear in the menu item. ``exclude`` A list of models to exclude, if a model name (e.g. "blog.comments.Comment") match an element of this list (e.g. "blog.comments.*") it won't appear in the menu item. If no models/exclude list is provided, **all apps** are shown. Here's a small example of building an app list menu item:: from admin_tools.menu import items, Menu class MyMenu(Menu): def __init__(self, **kwargs): super(MyMenu, self).__init__(**kwargs) self.children.append(items.AppList( title='Applications', exclude_list=('django.contrib',) ) The screenshot of what this code produces: .. image:: images/applist_menu_item.png .. note:: Note that this menu takes into account user permissions, as a consequence, if a user has no rights to change or add a ``Group`` for example, the ``django.contrib.auth.Group model`` child item won't be displayed in the menu. c t|jdg|_t|jdg|_|jdg|_|jdg|_t t|"|fi|y)z2 ``AppListMenuItem`` constructor. modelsexclude include_list exclude_listN) listpopr4r5r6r7superr2rrrrrs rrzAppList.__init__sm6::h34 FJJy"56 "JJ~r:"JJ~r: gt%e6v6rc |j|d}i}|D]\}}|ds|jdds|jj}||vr6t j |j |j||gd||<||dj|jj|j||dt|jD]}||}t|d|d } ||djd ||dD]&} | jjtd i| (|jj| y ) Please refer to :meth:`~admin_tools.menu.items.MenuItem.init_with_context` documentation from :class:`~admin_tools.menu.items.MenuItem` class. r#changeviewF)rrr4r4rrrrc |dS)Nrr)xs rz+AppList.init_with_context..s 1W:r)rNr)_visible_modelsget_meta app_label django_appsget_app_config verbose_name_get_admin_app_list_urlappendverbose_name_plural_get_admin_change_urlsortedkeysr sortr) rritemsrmodelpermsrGappapp_dictitem model_dicts rrzAppList.init_with_contextsg $$WY%78! LE5(Ouyy'? --I$$229=JJ77wG #Y OH % , ,8811%A.   $))+& 'CCyH(7"3%ID Ih  $ $)= $ >"3i1 =  $$X%; %;< = MM  & 'rc2t|jdk(S)a Helper method that returns ``True`` if the applist menu item has no children. >>> from admin_tools.menu.items import MenuItem, AppList >>> item = AppList(title='My menu item') >>> item.is_empty() True >>> item.children.append(MenuItem(title='foo')) >>> item.is_empty() False >>> item.children = [] >>> item.is_empty() True rr!rr's rr(zAppList.is_empty 4==!Q&&rr r)r*r+r,rrr( __classcell__rs@rr2r2s(T7'B'rr2c0eZdZdZdfd ZdZdZxZS) ModelLista A menu item that lists a set of models. In addition to the parent :class:`~admin_tools.menu.items.MenuItem` properties, the ``ModelList`` has two extra properties: ``models`` A list of models to include, only models whose name (e.g. "blog.comments.Comment") match one of the strings (e.g. "blog.*") in the include list will appear in the dashboard module. ``exclude`` A list of models to exclude, if a model name (e.g. "blog.comments.Comment" match an element of this list (e.g. "blog.comments.*") it won't appear in the dashboard module. Here's a small example of building a model list menu item:: from admin_tools.menu import items, Menu class MyMenu(Menu): def __init__(self, **kwargs): super(MyMenu, self).__init__(**kwargs) self.children += [ items.ModelList( 'Authentication', ['django.contrib.auth.*',] ) ] .. note:: Note that this menu takes into account user permissions, as a consequence, if a user has no rights to change or add a ``Group`` for example, the ``django.contrib.auth.Group model`` item won't be displayed in the menu. c t|xsg|_t|xsg|_|jdg|_|jdg|_t t|"|fi|y)z, ``ModelList`` constructor. r6r7N) r8r4r5r9r6r7r:r`r)rrr4r5rrs rrzModelList.__init__s_6r?Fr@N)rDrErFrMrNr rrL)rrrRrSrTrrrWs rrzModelList.init_with_contexts $$WY%78! 'LE5(Ouyy'?KK33E,,UG>> from admin_tools.menu.items import MenuItem, ModelList >>> item = ModelList(title='My menu item') >>> item.is_empty() True >>> item.children.append(MenuItem(title='foo')) >>> item.is_empty() False >>> item.children = [] >>> item.is_empty() True rrZr's rr(zModelList.is_empty-r[r)NNNr\r^s@rr`r`s"H 9 ''rr`c@eZdZdZedZdfd ZdZdZxZ S) Bookmarksa A menu item that lists pages bookmarked by the user. This menu item also adds an extra button to the menu that allows the user to bookmark or un-bookmark the current page. Here's a small example of adding a bookmark menu item:: from admin_tools.menu import items, Menu class MyMenu(Menu): def __init__(self, **kwargs): super(MyMenu, self).__init__(**kwargs) self.children.append(items.Bookmarks('My bookmarks')) c tt| |fi|d|jvr|jj dyy)Nbookmark)r:rerrrLr;s rrzBookmarks.__init__Rs> i'88 T-- -    # #J / .rc*ddlm}|jj|djD]D}|j j tt|j|jFt|j sd|_ yy)r=r)Bookmarkr#)userFN) admin_tools.menu.modelsriobjectsfilterrjrrLr rrrr!r/)rrribs rrzBookmarks.init_with_contextWsw 5!!((gi.@.E.E(F FA MM )AGG*rysw+<$:.1tvtnf'h+f'RO'-O'd)-)s <0;