1 | Introduction |
---|
2 | ============ |
---|
3 | |
---|
4 | This package allows to build dropdown menu through the web with portal_actions. |
---|
5 | Submenus are built from a tree of nested Category Actions and Actions. |
---|
6 | The other strategy used to populate submenus is Plone default NavigationStrategy, |
---|
7 | the one used in navigation portlet. |
---|
8 | |
---|
9 | This project is successor of qPloneDropDownMenu. |
---|
10 | |
---|
11 | Building you dropdown menu with portal_actions |
---|
12 | ---------------------------------------------- |
---|
13 | |
---|
14 | Starting from Plone 3 portal actions introduced CMF Action Category |
---|
15 | containers, it opened opportunity to build nested actions trees. Though CMF Action |
---|
16 | Category does not behave as a regular action, it has different set of properties. |
---|
17 | We introduced convention in quintagroup.dropdownmenu that requires to have |
---|
18 | a specially named Action for each Actions Category. The id of each such action |
---|
19 | must be build using the rule: |
---|
20 | |
---|
21 | action_id = prefix + category_id + suffix |
---|
22 | |
---|
23 | where: |
---|
24 | |
---|
25 | 'category_id' is id of correspondent CMF Action Category |
---|
26 | 'prefix' defined in DropDownMenu configlet, default value '' |
---|
27 | 'suffix' defined in DropDownMenu configlet, default value '_sub' |
---|
28 | |
---|
29 | So, the actions structure can look like: |
---|
30 | |
---|
31 | / portal_tabs |
---|
32 | |- home |
---|
33 | |- blog_sub |
---|
34 | |-/ blog |
---|
35 | | |-- 2009 |
---|
36 | | |-- 2010 |
---|
37 | |
---|
38 | By default the root of dropdown menu is 'portal_tabs' category. |
---|
39 | |
---|
40 | Compatibility |
---|
41 | ----------- |
---|
42 | |
---|
43 | Plone 3.0 - 3.3 |
---|
44 | Plone 4 |
---|
45 | |
---|
46 | |
---|
47 | Installation |
---|
48 | ------------ |
---|
49 | |
---|
50 | * add quintagroup.dropdownmenu to your buildout |
---|
51 | * install in Plone with Quick Installer |
---|
52 | * find more details inside docs/INSTALL.txt |
---|