Show branches or levels of your menu in a widget, or in content using a shortcode, with full customisation.
If you have a question or problem that is not covered here, please use the integrated Support forum.
Yep, 'fraid so :
I don't know. With all due respect (and a certain amount of confidence in the widget) I would venture to suggest that it is probably due to the option settings on the widget/shortcode. The quickest way to resolve any such issues is to use the widget's interactive "assist", and ensure that you set the current menu item correctly for the page(s) that you are having problems with. However, I am well aware that I not infallible (and it's been proven a fair few times!), so if you still have problems then please let me have as much information as possible (the shortcode for your settings is a good start?) and I will endeavour to help. Please note that simply reporting "It doesn't work" is not the most useful of feedbacks, and is unlikely to get a response other than, possibly, a request for more details.
The red cross to the left of each menu item toggles the Exclusions setting for the item and/or its descendants. The button has 3 settings :
Just click through the toggle states. When the Primary Filter is set to "Items", the green tick buttons to the right of each menu item work in the same way.
Note that if a green "Alternate settings" message is showing then the ticks and crosses buttons will show the approriate Alternative settings but they will be slightly opaque and they will not be clickable!
Once you are happy with the results, having tested all possible settings of "current menu item" (if it applies), then simply Save the widget. Alternatively, copy-paste the shortcode text - at the base of either the "assist" or the widget form - straight into your post (you do not need to Save the widget!). The widget does not have to Saved to test any of the options.
Yes, use a widget form. The shortcode for all the selected/specified options is show at the base of the widget (v3+) and the base of the "assist". The widget does not have to be placed within a widget area, it can also be used from the Inactive Widgets area. And you do not need to Save the widget just to get a shortcode!
Use the widget's interactive "assist" (see above). Within the representative menu structure, each menu item's id is set in its title
attribute, so should be seen when the cursor is moved over the item. A simpler way is to check the
Items option : the "assist" will
then show a green tick "checkbox" to the right of each menu item and you simply [un]check the items as required. Each selection will be reflected back into the
Items settings, and also in the shortcode texts.
The more painstaking way is to go to Appearance, Menus and select the relevant menu; hover over the edit, Remove, or Cancel link for an item and look in
the URL (the link's href) for
menu-item=NNN ... the NNN is the menu item id.
The "assist" shows a red cross "checkbox" to the left of each menu item, and [un]checking the items will refelect back into the options and
shortcode texts. Otherwise, it's the same principle as outlined above for
If you elect to include Branch [Ancestor] Siblings, you will only get the siblings, not their descendants (assuming they have any).
On the other hand, if you make
Starting at use 'Level' instead of 'Item' then siblings and their descendants will be added to the filter.
For example, let's say that Bravo and Charlie are sibling items immediately below Alpha, and that Bravo is the selected Branch Item,
Starting at set to "the Branch" (ie. Bravo). If you switch from "Item" to "Level" then both Bravo, Charlie, and all their descendants,
will become eligible for filtering. If you left "Item" enabled, and switched on the inclusion of Branch Siblings, then Bravo and Charlie
would both still be eligible, but only Bravo's descendants would be; not Charlie's!
The widget does not supply any ouput styling (at all!). This is because I have absolutely no idea where you are going to place either the widget (sidebar, footer, header, ad-hoc, etc?) or the shortcode (page content, post content, widget content, custom field, etc?) and everyone's requirements for styling are likely to be different ... possibly even within the same web page's output. So all styling is down to your theme, and if you wish to modify it you will need to add to your theme's stylesheet.
The safest way to do this is via a child theme, so that any changes you make will not be lost if/when the main theme gets updated. The best way to test your changes is by utilising the developer capabilities that are available in most modern browsers (personally, I could not do without Firefox and the Firebug extension!) and dynamically applying/modifying styles, possibly utilising the custom classes that the widget applies to its output, or the Container options for a user-defined id or class.
There is a button on the widget's "assist" -
[...] - that will provide a list of posts/pages whose content, or meta data (custom fields),
contains any CMW shortcode. Each entry is a link that opens the item in a new tab/window. The link's title gives a bit more information :
post type, id, whether the shortcode(s) are in content and/or meta data, and the shortcode(s) concerned.
This utility does not check things like text widgets, plugin-specific tables, theme-provided textareas, etc.
There is also an extension to the shortcode -
[cmwizard findme=1/] - that will output the same information, should you not be able to use
the "assist" (for some unknown reason). You may optionally provide a title attribute; any other attributes are ignored.
Note that output from this shortcode extension is restricted to users with edit_pages capability.
Requires: 3.6 or higher
Compatible up to: 4.1.1
Last Updated: 2014-12-17
Active Installs: 10,000+
3 of 6 support threads in the last two months have been resolved.
Got something to say? Need help?