Skip to main content

Plone's content menu implementation

Project description

Introduction contains the logic that powers Plone’s content menu which is part of the toolbar.

It provides the menus items (and its submenues) for

  • factories menu (order=10)
  • workflows menu (order=20)
  • actions menu (order=30)
  • display menu (order=40)
  • manage portlets menu (order=50)

Note that menu items are ordered by an ‘ordered’ property. To allow third party products to slot their own sub-menus in between the default menu items, these are registered with gaps.

Custom menus

Custom menus are registered in configure.zcml like so:

    title="The 'My' menu - allows to do new exciting stuff"

im the class looks like so:

# -*- coding: utf-8 -*-
from plone.memoize.instance import memoize
from zope.browsermenu.interfaces import IBrowserMenu
from import BrowserMenu
from import BrowserSubMenuItem
from zope.component import getMultiAdapter
from zope.i18nmessageid import MessageFactory
from zope.interface import implementer

_ = MessageFactory('my.fancy')

class IMyMainMenuItem(IBrowserMenu):
    """The main my menu item.

    You may want to place this in

class IMyMenu(IBrowserMenu):
    """The my menu.

    You may want to place this in

class MyMainMenuItem(BrowserSubMenuItem):
    # This is in fact a submenu item of the parent menu, thus the name
    # of the inherited class tells it, don't be confused.

    title = _(u'label_my_menu', default=u'My')
    description = _(u'title_my_menu',
                    default=u'My for the current content item')
    submenuId = 'my_fance_menu'

    order = 35
    extra = {
        'id': 'my-fance-menu',
        'li_class': 'plonetoolbar-content-my-fancy'

    def __init__(self, context, request):
        super(BrowserSubMenuItem, self).__init__(context, request)
        self.context_state = getMultiAdapter(
            (context, request),

    def action(self):
        # return the url to be loaded if clicked on the link.
        # even if a submenu exists it will be active if javascript is disbaled
        return self.context.absolute_url()

    def available(self):
        # check if the menu is available and shown or not
        return True

    def selected(self):
        # check if the menu should be shown as selected
        return False

class ActionsMenu(BrowserMenu):

    def getMenuItems(self, context, request):
        """Return menu item entries in a TAL-friendly form."""
        results = []

        # here a single item is added. do what needed to add several entrys
            'title': 'My item 1',
            'description': 'An my item',
            'action': '/url/to/action',
            'selected': False,
            'icon': 'some_icon_class',
            'extra': {
                'id': 'plone-contentmenu-my-fancy-one',
                'separator': None,
                'class': 'my-class pat-plone-modal',
                'modal': 'width: 400'
            'submenu': None,

        return results

Source Code

Contributors please read the document Process for Plone core’s development

Sources are at the Plone code repository hosted at Github.


2.3.0 (2019-06-27)

New features:

  • Add support for Python 3.8 [pbauer] (#25)

2.2.4 (2018-09-23)

Bug fixes:

  • Fix sorting of portletmanager-menuitems in py3. [pbauer]

2.2.3 (2018-02-05)

Bug fixes:

  • Use get_installer in tests. [maurits]

2.2.2 (2017-02-12)

Bug fixes:

  • Fix portlets ZCML title registration. [gforcada]

2.2.1 (2016-11-10)

Bug fixes:

  • Don’t extract dynamic messages with i18ndude. [vincentfretin]

2.2 (2016-11-01)

New features:

  • Make portlet manager names translatable. Add an “All” option for portlet manager management. [alecm]
  • Display menu reorganization. Selected view/item should be on top of section and headings should appear as headings. [alecm]
  • Add ability to specify a short title for the collapsed sidebar by setting extras[‘shortTitle’], in the same way as stateTitle. [MatthewWilkes]

Bug fixes:

  • Add default icon for top-level toolbar entries [alecm]
  • Code cleanup. [gforcad]

2.1.9 (2016-10-03)

New features:

  • Documentation in README added. [jensens]

Bug fixes:

  • Minor code cleanup, some micro-optimizations. [jensens]

2.1.8 (2016-05-26)


  • Optimized display menu’s check for index_html. [davisagli]

2.1.7 (2016-02-19)


  • Fixed test (don’t expect role from pac-tests). [pbauer]

2.1.6 (2015-08-20)

  • Fix: Permission check ManageWorkflowPolicies was always on fallback to ManagerPortal. Now checks the correct permission after using the pkg_resources.get_distribution api for checking (never catch an ImportError). [jensens]
  • pep8, zca decorators, plone code conventions [jensens]
  • do not open manage portlets in a modal [vangheem]

2.1.5 (2015-07-18)

  • hide submenu so screen readers do not read full contents every time [vangheem]
  • get rid of “more options”, reorder menu, show actions in folder contents, better accessibility. [vangheem]

2.1.4 (2015-05-05)

  • Rerelease due to double distribution ending up on PyPI. [maurits]

2.1.3 (2015-05-04)

  • Change test-setup to allow testing AT and DX. [pbauer]
  • Fix Dexterity tests to use’ browser layer. Fix tests to work with new unified view names. [thet]
  • Don’t show the menu-item to add content to a folderish default_page if no content can be added to it. [pbauer]
  • pat-modal pattern has been renamed to pat-plone-modal [jcbrand]

2.1.2 (2014-10-23)

  • Fix “Manage Portlets” menus not appearing for “Site Administrators”. [@rpatterson]
  • Integration of the new markup update and CSS for both Plone and Barceloneta theme. This is the work done in the GSOC Barceloneta theme project. [albertcasado, sneridagh]
  • New toolbar markup based in ul li tags for the contentActions menus. [albertcasado, sneridagh]

2.1.1 (2014-04-13)

  • Add csrf tokens to menu urls that need it.
  • Allow custom modal attributes for more links [do3cc]

2.1.0 (2014-02-26)

  • Add markup changes related to new Barceloneta theme. [bloodbare]

2.0.9 (2014-01-27)

  • Don’t break if there’s no portal_actionicons tool. [davisagli]
  • Ported tests to [tomgross]

2.0.8 (2013-03-05)

2.0.7 (2012-12-09)

  • add prefix to id tag for display menu dropdown items, fixes #11927 and #10894 [maartenkling]

2.0.6 (2012-07-02)

  • Use zope.browsermenu and remove Zope 2.12 BBB code. [hannosch]

2.0.5 (2012-02-07)

  • Restore the workflow menu on the folder contents page as it is the only way to change the state of the folder when it has a default page. Improves the fix to [rossp]

2.0.4 - 2011-07-04

  • Set height/width of contentmenu icons through browser menu code. [thomasdesvenain]

2.0.3 - 2011-05-12

  • We need permission to see Placeful policy in workflow menu. [thomasdesvenain]

2.0.2 - 2011-01-03

  • Depend on Products.CMFPlone instead of Plone. [elro]
  • Add test coverage for factory expression context when a front-page object is used for a folder. Fix in [rossp]
  • Fix the addContext in the FactoriesSubMenuItem to make it possible to add content to a folderish object that set as the default view on its parent folder. This closes [WouterVH]

2.0.1 - 2010-07-18

  • Update license to GPL version 2 only. [hannosch]

2.0 - 2010-07-01

2.0b3 - 2010-06-13

  • Added optional compatibility with zope.browsermenu. [hannosch]

2.0b2 - 2010-02-17

  • Show “add new” menu when there are one or more addable types. Showing a link when only one type was addable caused conflicts with the dropdown JavaScript. Closes [esteele, davisagli]
  • Query the types tool instead of the action tools to find add actions in FactoriesSubMenuItem. This fixes a discrepancy in action URLs. [wichert]

2.0b1 - 2010-01-24

  • Removed the checking for hideChildren when a single item is present, this makes the styling consistent again. The menu is really a one-item menu, and we put it in the header as a shortcut that you can click directly. This fixes [limi]

2.0a2 - 2009-12-27

  • Adjust factory menu to use the new getIconExprObject method. [hannosch]
  • Removed no longer required dependency. [hannosch]
  • Hide the actions, display and workflow menus on the folder contents page. This closes [hannosch]
  • Avoid a bogus getToolByName indirection via getSite(). [hannosch]
  • Noted missing zope.publisher dependency and prefer absolute imports. [hannosch]
  • Mark selected display always with ‘actionMenuSelected’ class and stop using bullet points. References [dukebody]

2.0a1 - 2009-11-14

  • Specified package dependencies and assorted cleanups. [hannosch]
  • Avoid a deprecation warning for calling the actions method from the context_state state view without passing in an action category. [hannosch]
  • Updated action and icon handling in the actions menu to take advantage of the icon being stored on the action itself. [hannosch]
  • Added support for the new add_view_expr property available on FTIs. This can be used to construct a URL for add views. [optilude]

1.1.7 - 2009-03-07

1.1.6 - 2008-10-07

1.1.5 - 2008-08-18

  • Add a span with a “noMenuAction” class around disable menus, allowing them to be styled. [wichert]

1.1.3 - 2008-07-07

  • Adjusted tests to reflect new behavior introduced by the last change. [hannosch]
  • Do not show the display menu if it is disabled (i.e. there is an index_html item in the folder). The previous behavior was confusing for users: the description with the hint to remove the index_html object was never shown and users only got a unusable menu item. The new behavior makes the display menu consistent with other parts of the Plone UI. [wichert]
  • Add an actionMenuSelected class to selected menu items so they can be styled (same class as used in Plone 2.5). Do not remove the <span> tag around the &bull; for selected items so it can be removed when proper CSS styling is used. [wichert]

1.0.7 - 2008-03-09

  • Correct the content menu html: the icons in menus should have an empty alt-attribute since the alternative text if no image can be seen is the label of the menu item itself. Move the description to the title attribute so it still shows up as tooltip. [wichert]
  • Fixed an issue with non ISelectableBrowserDefault aware content. This closes [deo]

1.0.6 - 2008-01-06

  • Fixed display menu to show the default page title correctly when the default-page is not a contained content item with DC metadata fields. Thanks to George Lee for finding this. [optilude]

1.0.5 - 2008-01-02

  • Fixed display menu to show the default page title when not currently viewing it as well as the display of markup contained in translations. This fixes [witsch]
  • Removed loop that does nothing in, in WorkflowMenu.getMenuItems(). [dreamcatcher]

1.0.3 - 2007-11-09

1.0b1 - 2007-03-05

  • Initial package structure. [zopeskel]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for, version 2.3.0
Filename, size & hash File type Python version Upload date (27.1 kB) View hashes Wheel py2.py3 (37.2 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page