Custom Menu Wizard Widget

This plugin is a boosted version of the WordPress "Custom Menu" widget. It provides full control over most of the parameters available when calling WP's wp_nav_menu() function, as well as providing pre-filtering of the menu items in order to be able to select a specific portion of the custom menu. It also automatically adds a couple of custom classes. And there's a shortcode that enables you to include the widget's output in your content. Important! This plugin provides nothing - zip, zilch, nada, bupkis - in the way of frontend styling! The appearance of any final output is down to you and your theme, so if you're just looking for something to re-style a menu then I'm sorry but this plugin won't do that! Features include:

• Display an entire menu, just a branch of it, just certain level(s) of it, or even just specific items from it!
• Select a branch based on a specific menu item, or the current menu item (currently displayed page)
• Specify a relative or absolute level to start at, and the number of levels to output
• Include ancestor item(s) in the output, with or without siblings
• Exclude certain menu items, or levels of items
• Make the output conditional upon the current menu item being found in different stages of the filter selection process
• Automatically add cmw-level-N and cmw-has-submenu classes to output menu items
• Allow the widget title to be entered but not output, or to be set from the current menu item or selected branch item
• Select hierarchical or flat output, both options still abiding by the specified number of levels to output
• Specify custom class(es) for the widget block, the menu container, and the menu itself
• Modify the link's output with additional HTML around the link's text and/or the link element itself
• Use Ordered Lists (OL) for the top and/or sub levels instead of Unordered Lists (UL)
• Shortcode, [cmwizard], available to run the widget from within content
• Shortcode can reference a widget instance, making maintenance of multiple occurences of the same (or very similar) shortcode a lot easier
• Interactive "assist" to help with the widget settings and/or shortcode definition
• Utility to find posts containing this plugin's shortcode
• Specify an alternative configuration to use under certain conditions (dual-scenario capability)

Current documentation for the Widget Options can be found under Other Notes. The associated Shortcode Attributes are documented under Installation.

You may find that the documentation here is truncated, so I have reproduced the readme.txt as cmw-doc.html. This file is also now included in the plugin download, and is linked to from the Custom Menu Wizard entry on the admin Plugins page. My apologies if this causes - or has caused - any confusion.

Please, do not be put off by the number of options available! I suspect (and I admit that I'm guessing!) that for the majority of users there are probably a couple of very common scenarios:

1. Show an entire menu...
2. Drag a new Custom Menu Wizard widget into the sidebar, and give it a title (if you want one)
3. Select the menu you wish to use (if it's not already selected)
4. Save the widget!
5. Equivalent shortcode resembles...

[cmwizard menu=N title="Your Title"/] 1. Show the current menu item, plus any descendants... * Drag a new Custom Menu Wizard widget into the sidebar, and give it a title (if you want one) * Select the menu you wish to use (if it's not already selected) * Open the FILTERS section : * under Primary Filter, click on the Branch radio * Save the widget! * Equivalent shortcode resembles... [cmwizard menu=N title="Your Title" branch=current/] 1. Show just the descendants of the current menu item (if there are any)... * Drag a new Custom Menu Wizard widget into the sidebar, and give it a title (if you want one) * Select the menu you wish to use (if it's not already selected) * Open the FILTERS section : * under Primary Filter, click on the Branch radio * under Secondary Filter, set Starting at to "+1 (children)" * Save the widget! * Equivalent shortcode resembles... [cmwizard menu=N title="Your Title" branch=current start_at="+1"/] 1. Always show the top level items, but when the menu contains the current item then also show that current item, with its ancestors and immediate children... * Drag a new Custom Menu Wizard widget into the sidebar, and give it a title (if you want one) * Select the menu you wish to use (if it's not already selected) * Open the FILTERS section : * under Primary Filter, click on the Branch radio * under Secondary Filter, set Depth to "2 levels" (ie. current item plus immediate children) * under Inclusions, set Branch Ancestors to "to level 1 (root)", and set Level to "1" * Open the ALTERNATIVE section : * set On condition to "Current Item is NOT in..." and "Menu" (the 2nd dropdown) * in the Then switch settings to textarea, type in "[cmwizard depth=1/]" (without the quotes!) * Save the widget! * Equivalent shortcode resembles... [cmwizard menu=N branch=current depth=2 ancestors=1 include_level="1" alternative="no-current,menu"]depth=1[/cmwizard] If you like this widget (or if you don't?), please consider taking a moment or two to give it a Review : it helps others, and gives me valuable feedback. Documentation for version 2 of the widget can be found here or here.

1. EITHER Upload the zip package via 'Plugins > Add New > Upload' in your WP Admin

OR Extract the zip package and upload custom-menu-wizard folder to the /wp-content/plugins/ directory 1. Activate the plugin through the 'Plugins' menu in your WP Admin The widget will now be available in the 'Widgets' admin page. As long as you already have at least one Custom Menu defined, you can add the new widget to a sidebar and configure it however you want. Alternatively, you can use the shortcode in your content. Current documentation for the Widget Options can be found under Other Notes. SHORTCODE ATTRIBUTES The shortcode is [cmwizard]. Most of the attributes reflect the options available to the widget, but some have been simplified for easier use in the shortcode format. If there are no menu items as a result of the filtering, then there will be no output from the shortcode. The simplest way to build a shortcode is to use a widget : as you set options, the equivalent shortcode is displayed at the base of the widget (v3+) and the base of the "assist". The widget itself need not be assigned to a widget area, so you can construct your shortcode using a widget in the Inactive Widgets area if you have no need for an active one. Note that as long as you are not using the widget=N attribute, then you don't need to save the widget itself : just copy-paste the shortcode when you are happy with it. widget integer : !NEW! from v3.1.5, the shortcode will accept a widget=N attribute which will load an existing widget instance. The shortcode - resembling [cmwizard widget=N/], where N is an integer - is provided at the base of each widget, below the widget's "equivalent" shortcode. It will look for the instance in all active sidebars, and the Inactive Widgets area. You can prevent inspection of the Inactive Widgets area by adding an inactive=0 attribute. It will not look in any other Inactive Sidebar... area unless you specifically tell it to do so by adding an orphaned=1 attribute. Using this attribute reduces the shortcode length, and may cut down on maintenance where you have the same shortcode in a number of places ... as long as you are prepared to keep the widget instance (even if it's in the Inactive Widgets area). You can override the widget instance's settings by supplying any of the other standard shortcode attributes. Note that you can't use this attribute as part of an Alternative setting (it is simply ignored). title string : The output's Title, which may be overridden by title_from. Note that there is no shortcode equivalent of the widget's Hide option for the title. menu string or integer : Accepts a menu name or id. If not provided, the shortcode will attempt to find the first menu (alphabetically) that has menu items attached to it, and use that. level integer : Sets the Level filter to the specified (greater than zero) value. Defaults to 1, and is ignored if either branch or items is specified. branch string or integer : If not empty then Branch is set as the primary filter, with the branch item being set from the assigned value:

• If numeric, it is taken as being the id of a menu item.
• If set to either "current" or "current-item" then the Branch item is set to "Current Item".
• If any other string, it is taken to be the title of a menu item (within the selected menu). The widget will look for the first caseless title match, so specifying branch="my menu item" will match against a menu item with the title "My Menu Item".

items string : Comma-separated list of meu item ids, where an id can optionally be followed by a '+' to include all its descendants (eg. "23+"). Takes priority over branch. start_at string : This is only relevant to a Branch filter, and consists of a signed or unsigned integer that indicates either a relative (to the selected branch item) or absolute level to start your output at (ref. the widget's Starting at option under Secondary Filter, Filters Section). By default the starting level for output is the branch item's level. A relative level is indicated by a signed (ie. preceded by a "+" or "-") integer, eg. start_at="+1", while an absolute level is unsigned, eg. start_at="1". Some examples :

• start_at="+1" : (relative) start at the branch item's level + 1 (also accepts start_at="children")
• start_at="-1" : (relative) start at the branch item's level - 1 (also accepts start_at="parent")
• start_at="-2" : (relative) would be the "grandparent" level
• start_at="1" : (absolute) start at the root item of the selected branch (also accepts start_at="root")
• start_at="2" : (absolute) start at one level below root (still within the selected branch)

start_mode string : This has only one accepted value - "level" - and is only applicable for a Branch filter whose start_at setting returns in an item that is at or above the selected branch item (relatively or absolutely). Setting start_mode="level" forces the widget to use not only the resultant starting item and its relevant descendants, but also all that item's siblings and their descendants (ref. the widget's Level radio option under Secondary Filter, Filters Section). allow_all_root switch, off by default, 1 to enable : See widget's Allow all Root Items option, under Secondary Filter, Filters Section. depth integer, default 0 (unlimited) : See widget's For Depth option, under Secondary Filter, Filters Section. depth_rel_current switch, off by default, 1 to enable : See widget's Relative to Current Item option, under Secondary Filter, Filters Section. ancestors integer, default 0 (off) : Sets an absolute level (positive integer), or a relative number of levels (negative integer), for which the ancestors of the Branch filter item should be included. See widget's Branch Ancestors option, under Inclusions, Filters Section. (only relevant to a Branch filter) ancestor_siblings integer, default 0 (off) : Sets an absolute level (positive integer), or a relative number of levels (negative integer), for which the siblings of ancestors of the Branch filter item should be included. See widget's ... with Siblings option, under Inclusions, Filters Section. (only relevant to a Branch filter) siblings switch, off by default, 1 to enable : See widget's Branch Siblings option, under Inclusions, Filters Section. (only relevant to a Branch filter) include_level string : A level (1, 2, 3, etc), optionally followed by a "+" or "-" to include all subsequent (lower) or prior (higher) levels respectively. For example :

• include_level="2" : include all items at level 2
• include_level="2-" : include all level 1 and level 2 items
• include_level="2+" : include all items at level 2 or greater.

Note that prior to v3.0.4, this was include_root (a switch), which only included the root level : include_root=1 is still accepted, even though now deprecated, and is equivalent to setting include_level="1". However, if include_level is specified then it takes precedence. exclude string : Comma-separated list of meu item ids, where an id can optionally be followed by a '+' to include all its descendants (eg. "23+"). exclude_level string : A level (1, 2, 3, etc), optionally followed by a "+" or "-" to exclude all subsequent (lower) or prior (higher) levels respectively. See the examples for include_level above. contains_current string : Accepted values : "menu", "primary", "secondary", "inclusions", or "output". See widget's Qualifier options, under Filters Section, for an explanation of the respective settings. fallback string : This enables the widget's If Current Item has no children fallback (ref. Fallbacks Section)...

• "parent" : Sets the widget's Fallback option to "Start at : -1 (parent)"
• "current" : Sets the widget's Fallback option to "Start at : the Current Item"
• "quit" : Sets the widget's Fallback option to "No output!"

The first two values can be further qualified by appending a comma and a digit, eg. fallback="current,1" or fallback="parent,2", which will also set the widget's For Depth fallback option to the value of the digit(s). Optionally, "+siblings" can also be used (comma-separated, with or without a depth digit) to indicate that siblings of the "parent" or "current" fallback item should also be included. The order of the comma-separated values is not important, so fallback="current,+siblings,1" is the same as fallback="current,1,+siblings", and fallback="2,parent" is the same as fallback="parent,2", etc. fallback_ci_parent switch, off by default, 1 to enable : See widget's If no Current Item can be found entry in the Fallbacks Section. fallback_ci_lifo switch, off by default, 1 to enable : See widget's If more than 1 possible Current Item entry in the Fallbacks Section. flat_output switch, off by default, 1 to enable : See widget's Flat option, under Output Section. title_from string : Supply a "current" and/or a "branch" item (comma-separated), corresponding to the 2 selects in the widget's Set Title from options, under Output Section.

• "current" : take the title from the Current Item
• "currentN" : take the title from an ancestor of the Current Item, where N is the literal level of the ancestor, eg. "current2" would be the Current Item's ancestor that sits at level 2
• "current-N" : take the title from an ancestor of the Current Item, where N is the number of levels above the current item, eg. "current-2" would be the Current Item's grand-parent
• "current-root" : equivalent to "current1"; takes the title from the Current Item's root-level ancestor
• "current-parent" : equivalent to "current-1"; takes the title from the Current Item's parent

All the above are also available for the Branch Item, eg. "branch", "branch1", "branch-2", etc. As an example, title_from="current-1,branch" will take the title from either the Current Item's parent - if there is a Current Item found in the menu - or the Primary Filter's Branch setting if there isn't a Current Item available. title_linked switch, off by default, 1 to enable : Makes the title into a link if the title comes from one of the title_from options. ol_root switch, off by default, 1 to enable : See widget's Top Level option, under Change UL to OL in the Output Section. ol_sub switch, off by default, 1 to enable : See widget's Sub-Levels option, under Change UL to OL in the Output Section. container string : See widget's Element option, under Container Section. container_id string : See widget's Unique ID option, under Container Section. container_class string : See widget's Class option, under Container Section. menu_class string : See widget's Menu Class option, under Classes Section. widget_class string : See widget's Widget Class option, under Classes Section. wrap_link string : This is an optional tag name (eg. "div", "p", "span") that, if provided, will be made into HTML start/end tags and sent through to the widget as its Before the Link and After the Link options (ref. Links Section). Please note that the shortcode usage - a simple tag name - is much more restrictive than the widget's options, which allow HTML. wrap_link_text string : This is an optional tag name (eg. "span", "em", "strong") that, if provided, will be made into HTML start/end tags and sent through to the widget as its Before the Link Text and After the Link Text options (ref. Links Section). Please note that the shortcode usage - a simple tag name - is much more restrictive than the widget's options, which allow HTML. alternative string : This is 2 settings separated by a comma, reflecting the On condition options under the Alternative Section. Possible values are:

• One of "current", "no-current" or "no-output" : the condition to test for
• One of "menu", "primary", "secondary", "inclusions", or "output" : the stage at which to test the condition

Eg. alternative="no-current,inclusions" would test for the absence of a Current Item in the filtered menu items, having completed the Inclusions stage, and attempt to switch to the Alternative settings. The actual Alternative settings - a cut-down shortcode - are placed as content between the shortcodes start and end tags, and this is the only time that the use of a self-terminating shortcode is not sufficient. When specifiying the Alternative settings, do not include the square brackets, otherwise WordPress will interpret it as a nested shortcode! For example, to set a primary configuration of "show Current Branch plus any kids", with an Alternative of "show top 2 levels" if no current item can be found anywhere in the menu... [cmwizard menu=NN branch=current alternative="no-current,menu"]depth=2[/cmwizard] Alternatively, you could switch it around and say the primary configuration is "show top 2 levels", with an Alternative of "show Current Branch plus kids" if a current item can be found within the menu... [cmwizard menu=NN depth=2 alternative="current,menu"]branch=current[/cmwizard] Note that Alternative (eg. "branch=current") does not require a menu option, because you can't change the menu so the primary configuration's setting is always used. As ever, the best way to construct a full shortcode, including an alternative, is to use the Assist : Use one instance of the CMW widget to build your Alternative settings, copy the equivalent shortcode into the Alternative option of a second instance of the CMW widget, and then continue configuring that second instance to be your primary configuration; your final shortcode can simply be lifted from the second instance! A bit more information about the Alternative option is available in this article. title_tag string : An optional tag name (eg. "h1", "h3", etc) to replace the default "h2" used to enclose the widget title. Please note that this attribute has no equivalent in the widget options, because it only applies when a widget is instantiated via a shortcode. findme switch, off by default, 1 to enable : This is a utility intended for editors only, and output is restricted to those with edit_pages capability. If enabled it will return a list of posts that contain a CMW shortcode. If findme is set, the only other attribute that is taken any notice of is title, which will be output (if supplied) as an H3 in front of the list. Example : [cmwizard findme=1 title="Posts containing a CMW shortcode..."/] Note that the information provided by this utility is also available from any widget's "assist". SHORTCODE EXAMPLES

• Show the entire "main" menu

[cmwizard menu=main/] * Show the children of the current menu item within the "main" menu, for unlimited depth, setting the widget title from the current menu item [cmwizard menu=main branch=current start_at=children title_from=current/] * From the "animals" menu, show all the items immediately below "Small Dogs", plus "Small Dogs" and its sibling items, as ordered lists [cmwizard menu="animals" branch="small dogs" depth=2 include="siblings" ol_root=1 ol_sub=1/] * From the "animals" menu, show the entire "Small Animals" branch, with the sole exception of the "Small Animals" item itself, whenever "Small Animals" or one of its descendants is the current menu item [cmwizard menu="animals" branch="small animals" start_at=children contains_current=primary/] * Show the entire "main" menu entitled "Main Menu" unless there's a current menu item, in which case show the current menu item, its siblings and its immediate children, and entitle it "Nearest and Dearest!" [cmwizard menu=main title="Main Menu" alternative="current,menu"]title="Nearest and Dearest!" branch=current depth=2 siblings=1[/cmwizard]

3.3.1

• bugfix : try to prevent other plugins lowering the z-index value of UI dialog
• bugfix : corrected a 'count()' typo in the walker class when checking for multiple Current Item candidates
• verified for WordPress 4.9.4

3.3.0

• change : minimum WordPress version is now 3.9! (because require .dashicons-before, as part of needing to dump jQuery UI theme)
• bugfix : ! Possible Breaker ! fixed incorrect determination of current item when a "current menu item" has a duplicate of itself as an ancestor (hopefully rare). There is a (very slight) chance that this may affect your displayed menu : if it does, toggle the Fallback option for If more than 1 possible Current Item, and I apologise for not catching the problem earlier
• change : dumped jQuery UI's Smoothness theme for WordPress's own CSS, to work around styling issues with WP4.5
• change : removed the hide_empty option (only relevant pre WP3.6) entirely
• change : remove support for Widget Customizer plugin (part of core from WP3.9)
• change : localized all text used by assist, to reduce byte footprint of the widget
• add : in customizer, if there are no menus, link to the customizer's menus panel
• add : opt in to customizer selective refresh for widgets (WP4.5)
• bugfix : correction to regexps that sanitize the alternative
• bugfix : corrected some problems with the assist dialog's auto-sizing, particularly after dragging
• tweak : squidged the widget form a bit, to reduce byte footprint of the widget
• tweak : included screenshots in html version of documentation

3.2.6

• addition : add cmw-current-item class to the menu item that CMW is using as 'current item'

3.2.5

• addition : add cmw-menu-item-had-children class to any menu item that originally had children, regardless of whether it still does when output

3.2.4

• bugfix : improve handling of dynamically-generated items, by pre-sorting into menu_order order and coping with negative item ids
• documentation : updated FAQs

3.2.3

• tweak : minor updates to documentation, and verified for WordPress v4.4

3.2.2

• bugfix : fixed initial widget display when adding new widget instance in the customizer

3.2.1

• bugfix : missing echo statement for the update message

3.2.0

• internationalization

3.1.5

• addition : expanded Title From to allow absolute ancestor levels (besides root) and relative ancestor levels
• addition : added a fallback option to switch determination of Current Item from first-found to last-found
• addition : added a shortcode attribute that loads an existing widget instance : [cmwizard widget=N/]
• documentation : updated, and provided an html version in the plugin download

3.1.4

• bugfix : in shortcode processing, any supplied Alternative settings weren't being used. thanks corrideat
• bugfix : prevent texturization of shortcode's content, for when it is being used with an Alternative setting
• addition : the ability to make a title into a link when the title has been set from a menu item

3.1.3

• tweak : minor change to css for the assist when running under the Customizer (WordPress 4.1)

3.1.2

• modified the readme : documentation for the Shortcode Attributes has been moved to the Installation page (to avoid being truncated)

3.1.1

• bugfix : only show the allow_all_root setting in the shortcode equivalent if the primary filter is by branch
• addition : work-around for when a theme inadvertently(!) de-registers the widget, which then prevents the shortcode working

3.1.0

• addition : new Alternative section which takes a cmwizard shortcode and conditionally applies it as an entirely new widget configuration
• addition : new fallback switch which enables an item marked as current_item_parent to be used as current item when no other current item is found
• bugfix : updated the determination of current item so that a paged (?paged=2, etc) Home page still shows Home page as being current
• bugfix : fixed code introduced in v3.0.4 that prevented CMW script loading on the customizer page - when the Widget Customizer plugin is loaded - for WordPress v3.8 and below
• bugfix : stop disabling selected fields based on other settings, because this caused the customizer to wipe values that may have been still required

3.0.4

• bugfix : corrected the display of the "No Current Item!" warning in the "assist"
• bugfix : corrected the enabling/disabling of a couple of fields in the widget form, and tweaked the indentation for better responsiveness
• bugfix : corrected the options setup when in accessibility mode with javascript enabled
• addition : added a warning about the accuracy of the shortcode when javascript is disabled
• addition : extended the All Root Items inclusion to be a selectable number of levels (as per the Exclusions by Level)

3.0.3

• bugfix : removed all occurrences of "Plugin " followed by "Name" from everywhere except the main plugin file to avoid update() reporting Invalid Header when activating straight from installation (rather than from the Plugins page)
• tweak : eliminate the over-use of get_title() when determining the widget title
• tweak : added self-terminating forward slash to generated shortcodes
• change : prepare for WordPress v4 (avoid use of deprecated functions)

3.0.2

• bugfix : the shortcode display on new instances of the widget (in admin) did not initially reflect the automatically-selected menu

3.0.1

• bugfix : changed the determination of pre-existing legacy widgets versus brand new widget instances, to get round problems encountered when other plugins utilise the widget_form_callback filter to inject fields into a widget
• addition : added a couple of filters

3.0.0

• ! Rewrite, and Change of Approach ! The widget has had a major rewrite! The Children of filter has been replaced with a Branch filter, with a subsequent shift in focus for the secondary filter options, from the children's level (0, 1 or more items) up to the branch level (a single item!). This should provide a more intuitive interface, and is definitely easier to code for. However, it only affects new instances of the widget; v2 instances are still fully supported.

Please also note that the shortcode tag for v3 has changed to [cmwizard], with a revised set of attributes. The old shortcode tag is still supported, but only with the v2 attribute set, and only providing v2 functionality, ie. it is the shortcode tag that determines which widget version to use, and the appropriate attribute set for that version. There is no automatic upgrade of widget settings from v2 to v3! I suggest bringing up the "assist" for the existing v2 widget, running it side-by-side with the "assist" of a new instance of the widget, and using them to the compare the desired outputs. I would also strongly recommend that you put your old widgets into the inactive area until you are completely happy with their new replacements. If you are upgrading from version 2, and you would like a bit more information, this article might help. * change : the minmum requirement for WordPress is v3.6 * addition : more options for requiring that the "current" menu item be present at some point in the filter process * addition : Branch filter levels can be either relative (to the selected Branch item) or absolute (within the menu structure) * addition : menu items can now be excluded from the final output, either explicitly by id (optionally including descendants), or by level * addition : the ids of Items can be set to include all descendants * addition : the inclusion of branch ancestors, and optionally their siblings, can be set by absolute level or relative number of levels * addition : the widget title can now be automatically set from the root level item of the Branch item or current menu item * addition : the shortcode for a widget's current settings is now also displayed at the base of the widget (as well as at the base of the "assist") * addition : "title_tag" has been added to the shortcode options, enabling the default H2 to be changed without having to resort to coding a filter * addition : as an alternative to using the "assist", "findme" has been addded to the shortcode options to aid editors with the location of posts containing a CMW shortcode ([cmwizard findme=1]) * This release includes an upgrade to v2.1.0 for all existing version 2 widgets/shortcodes - please read the v2.1.0 changes below. 2.1.0 (incorporated into v3.0.0 release)

• change : the minmum requirement for WordPress is v3.6
• bugfix : handle duplicate menu item ids which were causing elements to be ignored
• bugfix : fix IE8 levels indentation in the "assist"
• bugfix : the "assist" is now "fixed" position (toggle-able back to absolute), mainly to get around a bug in jQuery UI draggable
• remove : take out the automatic selection of shortcode text (inconsistent cross-browser, so just triple click as usual; paste-as-text if possible!)
• addition : in the "assist", provide collapsible options for those larger menus
• addition : added utility to the "assist" enabling posts containing a CMW shortcode to be located
• change : in the "assist", swap the menu Items checkboxes for clickable Ticks
• change : in the "assist", tweak styling and make more responsive to re-sizing
• change : made compatible with Widget Customizer
• Note : there is no separate release available for this version!

2.0.6

• change : modified determination of current item to cope better with multiple occurences (still first-found, but within prioritised groups)
• change : display of the upgrade notice in the plugins list has been replaced with a simple request to read the changelog before upgrading

2.0.5

• bugfix : prevent PHP warnings of Undefined index/offset

2.0.4

• bugfix : clearing the container field failed to remove the container from the output
• addition : in the "assist", added automatic selection of the shortcode text when it is clicked
• addition : remove WordPress's menu-item-has-children class (introduced in v3.7) when the filtered item no longer has children
• change : tweaked styles and javascript in admin for WordPress v3.8

2.0.3

• bugfix : missing global when enqueuing scripts and styles for admin

2.0.2

• bugfix : the Include Ancestors option was not automatically including the Parent
• bugfix : the "assist" was incorrectly calculating Depth Relative to Current Item when the current menu item was outside the scope of the Filtered items
• behaviour change : only recognise the first "current" item found (used to allow subsequent "current" items to override any already encountered)

2.0.1

• bugfix : an incorrect test for a specific-items filter prevented show-all producing any output

2.0.0

• ! Possible Breaker ! The calculation of Start Level has been made consistent across the Show all and Children of filters : if you previously had a setup where you were filtering for the children of an item at level 2, with start level set to 4, there would have been no output because the immediate children (at level 3) were outside the start level. Now, there will be output, starting with the grand-children (at level 4).
• ! Possible Breaker ! There is now deemed to be an artificial "root" item above the level 1 items, which mean that a Children of filter set to "Current Parent Item" or "Current Root Item" will no longer fail for a top-level "current menu item". If you have the "no ancestor" fallback set then this change will have no impact (but you may now want to consider turning the fallback off?); if you don't currently use the "no ancestor" fallback, then where there was previously no output there will now be some!
• added new option : Items, a comma- or space-delimited list of menu item ids, as an alternative Filter
• added new option : Depth Relative to Current Item to the Filter section (depth_rel_current=1 in the shortcode)
• added new option : Must Contain Current Item to the Output section (contains_current=1 in the shortcode)
• changed the widget's "demo" facility to "assist" and brought it into WordPress admin, with full interactivity with the widget
• refactored code

1.2.2

• bugfix : fallback for Current Item with no children was failing because the parent's children weren't being picked out correctly

1.2.1

• added some extra custom classes, when applicable : cmw-fellback-to-current & cmw-fellback-to-parent (on outer UL/OL) and cmw-the-included-parent, cmw-an-included-parent-sibling & cmw-an-included-ancestor (on relevant LIs)
• corrected 'show all from start level 1' processing so that custom classes get applied and 'Title from "Current" Item' works (regardless of filter settings)
• changed the defaults for new widgets such that only the Filter section is open by default; all the others are collapsed
• in demo.html, added output of the shortcode applicable to the selections made
• in demo.html, added a link to the documentation page
• corrected 2 of the shortcode examples in the readme.txt, and made emulator (demo) available from the readme

1.2.0

• added custom_menu_wizard shortcode, to run the widget from within content
• moved the 'no ancestor' fallback into new Fallback collapsible section, and added a fallback for Current Item with no children
• added an option allowing setting of title from current menu item's title
• fixed a bug with optgroups/options made available for the 'Children of' selector after the widget has been saved (also affected disabled fields and styling)
• don't include menus with no items
• updated demo.html

1.1.0

• added 'Current Root Item' and 'Current Parent Item' to the Children of filter
• added Fallback to Current Item option, with subsidiary options for overriding a couple of Output options, as a means to enable Current Root & Current Parent to match a Current Item at root level
• added an Output option to include both the parent item and the parent's siblings (for a successful Children of filter)
• added max-width style (100%) to the Children of SELECT in the widget options
• added widget version to the admin js enqueuer
• ignore/disable Hide Empty option for WP >= v3.6 (wp_nav_menu() now does it automatically)
• included a stand-alone helper/demo html page
• rebuilt the Children of SELECT in the widget options to cope with IE's lack of OPTGROUP/OPTION styling
• moved the setting of 'disabled' attributes on INPUTs/SELECTs from PHP into javascript

1.0.0

• Initial release