quintagroup.dropdownmenu

Introduction

The product allows you to build a responsive multilevel drop-down menu that will provide your visitors with organized and intuitive navigation. On mobile devices your top menu bar transforms into one drop-down. By clicking on the title or a small arrow next to it all-level menu items appear below the title.

This package allows to build dropdown menu through the web with portal_actions. Submenus are built from a tree of nested Category Actions and Actions.

The other strategy used to populate submenus is Plone default NavigationStrategy, the one used in navigation portlet.

This project is successor of qPloneDropDownMenu.

Building you dropdown menu with portal_actions

Starting from Plone 3 portal actions introduced CMF Action Category containers, it opened opportunity to build nested actions trees. Though CMF Action Category does not behave as a regular action, it has different set of properties. We introduced convention in quintagroup.dropdownmenu that requires to have a specially named Action for each Actions Category. The id of each such action must be build using the rule::

action_id = prefix + category_id + suffix

where:

:category_id: is id of correspondent CMF Action Category
:prefix: defined in DropDownMenu configlet, default value '' :suffix: defined in DropDownMenu configlet, default value '_sub'

So, the actions structure can look like::

• portal_tabs |- home |- blog_sub |-+ blog | |-- 2009 | |-- 2010

By default the root of dropdown menu is 'portal_tabs' category.

Menu caching

If the menu built with Navigation strategy is entirely public it can be cached for all users. If Authenticaded users should see some non public items the menu can be cached for anonymous only.

Caching in case of involving the portal_actions strategy is effective only in case if all the action are public and have no extra conditions. In case some conditions are applied per action switch off caching.

Compatibility

• Plone 4.x sample CSS file based on Sunburst theme provided
• Plone 3.x the default CSS file has to be overridden

Installation

• add http://good-py.appspot.com/release/plone.app.registry/1.0b2 to versions in your buildout for Plone<4.1
• add quintagroup.dropdownmenu to eggs in your buildout
• install Plone DropDown Menu in Plone via Site Setup -> Add-ons

Find more details on the topic inside docs/INSTALL.txt

Contributors

• Volodymyr Cherepanyak [chervol]
• Vitaliy Podoba [piv]
• Yuriy Gvozdovych [gvizdyk]
• Olha Pelishok [olha]
• Taras Melnychuk [fenix]
• Roman Kozlovskyi [kroman0]
• Malthe Borch

Changelog

1.3.4 - June 09, 2015

• Fixed mobile dropdown menu [kroman0]

1.3.3 - June 09, 2015

• Cleanup templates [kroman0]

• Added upgrade step for version 1.3 [kroman0]

1.3.2 - June 05, 2015

• Fixed styled for mobile dropdown [roman.ischiv]

1.3.1 - May 25,2015

• Fixed bug with image directory [roman.ischiv]

1.3 - May 22,2015

• Added js script for mobile dropdown menu [roman.ischiv]

1.2.14 - November 18, 2013

• Deleted unnecessary portal top styles.

1.2.13 - July 30, 2013

• Updated condition for 'mobileMenu' [kroman0]

• Fixed 'item_remote_url' [kroman0]

• Updated css media for package [gvizdyk]

• Hidden mobile menu for print [gvizdyk]

• Updated styles for mobile navigations [gvizdyk]

• Updated condition for include styles for mobile device [gvizdyk]

• Use getRemoteUrl for links [kroman0]

• The cache key of portal tabs was updated (thanks: richardc). [potar]

• Fixed getting navigation root [kroman0]

1.2.12 - April 02, 2013

• Fixed 'no record' error [kroman0]

• Added sections heading [kroman0]

• Fixed empty class attributes [kroman0]

• Fixed html validation of mobile layout [kroman0]

• Cleanup templates [kroman0]

• Wraped mobile menu in div [kroman0]

• Added ids for navigation [kroman0]

1.2.11 - August 10,2012

• layout added for mobile skins [kroman0] 1.2.10 - May 10, 2012 property decorator removed - Plone 3.3.6 compatibility issue fix fixed Plone 4.1.5 compatibility issue when accessing action id attribute 1.2.9 - May 2, 2012 fixed issue that significantly reduced menu caching performance [malthe] 1.2.8 - Apr 23, 2012 fixed styles for a drop-down menu list in IE7 [gvizdyk] 1.2.7 - Jan 31, 2012 added cache switch for tabs 1.2.6 - Jan 26, 2012 revisited caching key strategies, added language and anonymous switch added caching switch to control panel 1.2.5 - Oct 21, 2011 added cache header for csshover.htc view to allow proxy and browser to cache it. 1.2.4 - Sep 07, 2011 documentation formatting fixed 1.2.3 - Sep 05, 2011 Live search with dropdown menu overlaps fixed 1.2.2 - June 21, 2011 Fixed caching content tabs and action tabs portal_action generated menu caching is conditional and switched off for now 1.2.1 - June 15, 2011 Caching fixed 1.2 - Apr 6, 2011 Changed z3c.autoinclude includeDependencies to simple include to work in plone 3.2 [kroman0] drop-down overlay bug fixed [wald] cleared unnecessary classes, changed styles to current and hover element [gvizdyk] Fixed uninstallation. Added unisntallation with QI [mylan] Tests refactoring [mylan] 1.1.1 - Sep 23, 2010 fixed the docs markup [chervol] 1.1 - Sep 22, 2010 removed debug code [chervol] fixed the dropdown CSS fixed the Home tab highlight 1.0 - Sep 08, 2010 Initial release