Skip to main content

A customizable dropdown menu

Project description

Customizable navigation menu for Plone. Features include:

  • Manually defining entries for the navigation menu
  • Setting conditions on single entries
  • Generating a submenu automatically by reading the contents of a given folder
  • Generating a submenu manually from static pages
  • Both submenu types can exist for a single entry
  • No opinionated styles for the menu. Give it your own style in your site theme.
  • Handles multiple configurations, bound to different paths. Useful for handling subsites, for example.

Basic configuration

This is how the control panel looks like:

docs/example1.jpg

Below the title you can find tabs. Each tab holds the configuration for a single path. We will go into detail about this later, for now we will work on the main tab, which has the name of the current Plone site.

The path field holds the root path of this configuration. Every path under this one will use this menu.

Following the path field there is a list of menu items (only one is shown in the picture). Each menu item is a collapsible, sortable (by dragging up and down) and removable fieldset of five fields.

tab_title is the title of the menu entry. It’s the string that will be printed on the main navigation menu.

Navigation folder is the path of the folder from which we can automatically generate a submenu.

Additional columns is the path of a folder that contains pages. The text of the pages will be added in the generated submenu. This can be used in addition to the Navigation folder field, for example to add an image to the generated submenu, but can also be used alone, to generate a static customized submenu.

If we use one or both the previous fields, the main navigation link will toggle the collapsible submenu that was generated.

Simple link overrides the previous two fields and can be used to create a simple link to a specified url.

Condition is an expression that is verified to decide whether to show the menu entry. Defaults to python: True when creating new entries, can be changed to python: False to hide the entry, as a basic configuration, but more complex expressions are allowed. See a complete list here: http://docs.plone.org/develop/plone/functionality/expressions.html#expression-variables

After the entries list, you can find another button (Add item) that adds a new menu entry.

Adding multiple menus

If you click the Plus icon on the tabs on top of the control panel, you can add an additional menu configuration. This is an example of what you will see just after clicking it:

docs/example2.jpg

A new tab has been created with a temporary title /new1, this is not going to change unless you insert a proper path and save the changes. Upon loading the page, the widget looks for an object that has the specified path and uses the title of that object as the panel title.

The path has to be set to the path that you want the root of the new menu to be. For example, if you want a different menu to be used for a subsite, set the path field to the subsite root path.

A first menu entry is automatically created for you at this time, with teh default name “New”. Click it to open it and start editing.

When you are editing a menu configuration different from the main site configuration, you will see an additional red button at the bottom of the screen, saying “Remove this menu”. This removes the whole tab.

BEWARE: removing a menu means losing everything you wrote in it so far.

Nevertheless, keep in mind that no changes will be saved to the configuration of any menu, until you click the blue Save button at the botton of the control panel.

Events

Three different custom events will be fired from the menu links:

  • editablemenu.submenu.opened: when the menu finishes sliding down
  • editablemenu.submenu.closed: when the menu finishes sliding up
  • editablemenu.submenu.loaded: when the menu finishes loading new content

Installation

Install collective.editablemenu by adding it to your buildout:

[buildout]

 ...

 eggs =
     collective.editablemenu

and then running “bin/buildout”

Compatibility

This add-on has been tested on Plone versions 5.0 and 5.1.

For Plone 4 compatibility, use version 0.10.2 (a dedicated branch is coming soon…)

Upgrading old versions

From 2.1.0 version, we drop an old unused configuration that has been replaced since 2.0.0. To do this, we needed to delete some unused code/interfaces.

If you have very old versions of this product (< 0.10.0) you should install 2.0.0 version and perform upgrade-steps, before installing the latest one.

Development

In this product there are several static resources:

  • sass styles
  • React app for the configuration menu
  • Js for the rendered menu

To compile the widget configuration app:

Go to src/collective/editablemenu/browser/static/js/widget folder.

Then install dependencies:

yarn

And finally compile React app:

yarn build

After that, you need compile all the resources and bundle them for resource registries bundles:

Go in the project’s root and install dependencies for Grunt:

npm install

And finally compile and uglify the resources:

npm run compile

License

The project is licensed under the GPLv2.

Contributors

Changelog

2.3.0 (2019-09-10)

  • Added the options to customize dynamic sections labels [pnicolli]

2.2.0 (2019-07-05)

  • Add python3 support. [cekk]

2.1.1 (2019-05-24)

  • Fixed submenu_detail_view.pt so that condition do not call folder object. [eikichi18]

2.1.0 (2018-12-20)

  • Don’t break the viewlet if the context is not in the structure mapping. [cekk]

Breaking:

  • Remove unused classes/interfaces for old-style registry entries from code. See the README for upgrading informations (only if you came from < 0.10.0). [cekk]

2.0.0 (2018-10-11)

Breaking:

  • Rewrote menu templates to improve accessibility [pnicolli]
  • Handled aria-expanded and ESC keypress event via ES [nzambello]

1.2.0 (unreleased)

  • Remove unused old code [cekk]
  • Fix menu render when there are no settings for the current folder [cekk]
  • Add initial test suite (functional and acceptance)
  • Add test suite (functional and acceptance) [cekk]

1.1.0 (2018-05-15)

  • Added custom events when the menu is opened, closed and loaded [pnicolli]

1.0.1 (2018-04-27)

  • Fixed deprecated plone.directives.form import [pnicolli]

1.0.0 (2018-03-12)

  • Fix zcml condition for registering the global_sections viewlet. It was adding two different viewlets simultaneously on Plone 5, now one of those is gone. [pnicolli]
  • plone.protect js script was being added to the submenu html, now it’s removed manually from the async response. [pnicolli]
  • Moved configuration format to using a json string [daniele-andreotti]
  • Completely new controlpanel layout [pnicolli]
  • Fix choose_site_menu_config method to take the right path [fdelia]

0.10.2 (2017-09-13)

  • Fix url generation for simple_link field. Now can handle correctly both internal or external links. [cekk]

0.10.1 (2017-01-23)

  • Fix upgrade steps [lucabel]

0.10.0 (2017-01-20)

  • BREAKING: Submenus are now created inside the menu <li> element, instead of after the whole <ul> [pnicolli]

0.9.1 (2016-12-02)

  • Added Dexterity support for the static portion of the menu [pnicolli]
  • Page template now loaded inside the class to allow easier viewlet cloning [pnicolli]
  • Add simple “not expansible” link in menu [lucabel]
  • Add possibility to condition tab visibility the same way portal_tabs did it [lucabel]
  • Add Plone5 compatibility (no resourse registry) [cekk]

0.9.0 (2016-03-15)

  • Fix MANIFEST.in and trove classifiers in order to release package on PyPI [ale-rt]

0.2.1 (2016-01-11)

  • Fix js call [cekk]

0.2.0 (2016-01-11)

  • Fix registry problems [cekk]

0.1.0 (2016-01-05)

  • Initial release. [cekk]

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 collective.editablemenu, version 2.3.0
Filename, size File type Python version Upload date Hashes
Filename, size collective.editablemenu-2.3.0.tar.gz (473.5 kB) File type Source Python version None Upload date Hashes View hashes

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 DigiCert DigiCert EV certificate StatusPage StatusPage Status page