Custom Menu Wizard Widget - Version 3.1.2

Version Description

  • modified the readme : documentation for the Shortcode Parameters has been moved to the Installation page (to avoid being truncated)
Download this release

Release Info

Developer wizzud
Plugin Icon 128x128 Custom Menu Wizard Widget
Version 3.1.2
Comparing to
See all releases

Code changes from version 3.1.1 to 3.1.2

Files changed (3) hide show
  1. custom-menu-wizard.css +0 -1
  2. custom-menu-wizard.php +6 -2
  3. readme.txt +54 -43
custom-menu-wizard.css CHANGED
@@ -1,6 +1,5 @@
1
  /**
2
  * custom-menu-wizard.css
3
- * Version: 3.0.0
4
  */
5
  /*widget admin style...*/
6
  .widget-custom-menu-wizard-onchange {line-height:1.5; margin:0 0 0.5em;}
1
  /**
2
  * custom-menu-wizard.css
 
3
  */
4
  /*widget admin style...*/
5
  .widget-custom-menu-wizard-onchange {line-height:1.5; margin:0 0 0.5em;}
custom-menu-wizard.php CHANGED
@@ -3,13 +3,17 @@
3
  * Plugin Name: Custom Menu Wizard
4
  * Plugin URI: http://wordpress.org/plugins/custom-menu-wizard/
5
  * Description: Show any part of a custom menu in a Widget, or in content using a Shortcode. Customise the output with extra classes or html; filter by current menu item or a specific item; set a depth, show the parent(s), change the list style, etc. Use the included emulator to assist with the filter settings.
6
- * Version: 3.1.1
7
  * Author: Roger Barrett
8
  * Author URI: http://www.wizzud.com/
9
  * License: GPL2+
10
  */
11
  defined( 'ABSPATH' ) or exit();
12
  /*
 
 
 
 
13
  * v3.1.1 change log
14
  * - fixed bug : only show the allow_all_root setting in the shortcode equivalent if the primary filter is by branch
15
  * - added work-around for occasions when a theme causes de-registration of the widget which prevents the shortcode working in content
@@ -143,7 +147,7 @@ if( !class_exists( 'Custom_Menu_Wizard_Plugin' ) ){
143
  //declare the main plugin class...
144
  class Custom_Menu_Wizard_Plugin {
145
 
146
- public static $version = '3.1.1';
147
  public static $script_handle = 'custom-menu-wizard-plugin-script';
148
  public static $widget_class = 'Custom_Menu_Wizard_Widget';
149
  protected static $instance;
3
  * Plugin Name: Custom Menu Wizard
4
  * Plugin URI: http://wordpress.org/plugins/custom-menu-wizard/
5
  * Description: Show any part of a custom menu in a Widget, or in content using a Shortcode. Customise the output with extra classes or html; filter by current menu item or a specific item; set a depth, show the parent(s), change the list style, etc. Use the included emulator to assist with the filter settings.
6
+ * Version: 3.1.2
7
  * Author: Roger Barrett
8
  * Author URI: http://www.wizzud.com/
9
  * License: GPL2+
10
  */
11
  defined( 'ABSPATH' ) or exit();
12
  /*
13
+ * v3.1.2 change log
14
+ * - modification of the readme to avoid WordPress truncating documentation under Other Notes
15
+ * No code changes.
16
+ *
17
  * v3.1.1 change log
18
  * - fixed bug : only show the allow_all_root setting in the shortcode equivalent if the primary filter is by branch
19
  * - added work-around for occasions when a theme causes de-registration of the widget which prevents the shortcode working in content
147
  //declare the main plugin class...
148
  class Custom_Menu_Wizard_Plugin {
149
 
150
+ public static $version = '3.1.2';
151
  public static $script_handle = 'custom-menu-wizard-plugin-script';
152
  public static $widget_class = 'Custom_Menu_Wizard_Widget';
153
  protected static $instance;
readme.txt CHANGED
@@ -1,10 +1,10 @@
1
  === Custom Menu Wizard Widget ===
2
  Contributors: wizzud
3
  Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=KP2LVCBXNCEB4
4
- Tags: menu,widget,widgets,navigation,nav,custom menus,custom menu,partial menu,current item,current page,menu level,menu branch,menu shortcode,menu widget,advanced,enhanced
5
  Requires at least: 3.6
6
  Tested up to: 4.0
7
- Stable tag: 3.1.1
8
  License: GPLv2 or Later
9
 
10
  Show branches or levels of your menu in a widget, or in content using a shortcode, with full customisation.
@@ -33,9 +33,10 @@ Features include:
33
  * Utility to find posts containing this plugin's shortcode
34
  * **NEW** Specify an alternative configuration to use under certain conditions (dual-scenario capability)
35
 
36
- Current documentation for the [Widget Options](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#WIDGET-OPTIONS),
37
- and the associated [Shortcode Parameters](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#SHORTCODE-PARAMETERS),
38
- can be found under [Other Notes](http://wordpress.org/plugins/custom-menu-wizard/other_notes/).
 
39
 
40
  **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
41
  there are probably a couple of very common scenarios:
@@ -77,7 +78,8 @@ or [here](http://www.wizzud.com/v210-readme.html).*
77
  There are quite a few options, which makes the widget settings box very long. I have therefore grouped most of the options into
78
  collapsible logical sections (with remembered state once saved).
79
 
80
- Note that certain options may be enabled/disabled depending on your choice of primary, and possibly secondary, filters.
 
81
 
82
  ***Always Visible***
83
 
@@ -381,7 +383,7 @@ as the Current Item.
381
 
382
  Text or HTML that will be placed immediately after each menu item's link text.
383
 
384
- == Alternative Section ===
385
 
386
  This is new at v3.1.0 and provides a limited dual-scenario capability, based on a couple of conditions. For example, let's say you
387
  want to show the Current Item and its immediate children, *but* if there isn't a Current Item then you want to show the top 2 levels
@@ -406,10 +408,25 @@ scenario, and add an Alternative setting for when no Current Item can be determi
406
  should have kicked in but couldn't due to an error in the alternative settings) so please take note of it, because the Assist
407
  *cannot* be used to modify the Alternative settings, only the primary ones.
408
 
409
- A bit more information about the Alternative is available
410
  in [this article](http://www.wizzud.com/2014/10/03/custom-menu-wizard-wordpress-plugin-version-3-1/).
411
 
412
- == SHORTCODE PARAMETERS ==
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
413
 
414
  *NB. Version 2 documentation is [here](http://plugins.svn.wordpress.org/custom-menu-wizard/tags/3.0.0/v210-readme.html#Shortcode-Parameters).*
415
 
@@ -448,7 +465,7 @@ that has menu items attached to it, and use that.
448
  = start_at =
449
  *string* : This is only relevant to a `Branch` filter, and consists of a signed or unsigned integer that indicates either a relative
450
  (to the selected branch item) or absolute level to start your output at (ref. the widget's `Starting at` option under *Secondary Filter*,
451
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above).
452
  By default the starting level for output is the branch item's level. A relative level is indicated by a signed (ie. preceded by
453
  a "+" or "-") integer, eg. `start_at="+1"`, while an absolute level is unsigned, eg. `start_at="1"`. Some examples :
454
 
@@ -464,33 +481,33 @@ in an item is at or above the selected branch item (relatively or absolutely).
464
  Setting `start_mode="level"` forces the widget to use not only the resultant starting item
465
  and its relevant descendants, but also all that item's siblings *and their descendants*
466
  (ref. the widget's `Level` radio option under *Secondary Filter*,
467
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above).
468
 
469
  = allow_all_root =
470
  *switch, off by default, 1 to enable* : See widget's `Allow all Root Items` option, under *Secondary Filter*,
471
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above.
472
 
473
  = depth =
474
  *integer, default 0 (unlimited)* : See widget's `For Depth` option, under *Secondary Filter*,
475
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above.
476
 
477
  = depth_rel_current =
478
  *switch, off by default, 1 to enable* : See widget's `Relative to Current Item` option, under *Secondary Filter*,
479
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above.
480
 
481
  = ancestors =
482
  *integer, default 0 (off)* : Sets an absolute level (positive integer), or a relative number of levels (negative integer), for which
483
  the ancestors of the `Branch` filter item should be included. See widget's `Branch Ancestors` option, under *Inclusions*,
484
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above. (only relevant to a `Branch` filter)
485
 
486
  = ancestor_siblings =
487
  *integer, default 0 (off)* : Sets an absolute level (positive integer), or a relative number of levels (negative integer), for which
488
  the siblings of ancestors of the `Branch` filter item should be included. See widget's `... with Siblings` option, under *Inclusions*,
489
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above. (only relevant to a `Branch` filter)
490
 
491
  = siblings =
492
  *switch, off by default, 1 to enable* : See widget's `Branch Siblings` option, under *Inclusions*,
493
- [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above. (only relevant to a `Branch` filter)
494
 
495
  = include_level =
496
  *string* : A level (1, 2, 3, etc), optionally followed by a "+" or "-" to include all subsequent (lower) or prior (higher)
@@ -510,11 +527,11 @@ and "2+" would exclude all items at level 2 or greater.
510
 
511
  = contains_current =
512
  *string* : Accepted values : "menu", "primary", "secondary", "inclusions", or "output". See widget's *Qualifier* options,
513
- under [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section) above,
514
  for an explanation of the respective settings.
515
 
516
  = fallback =
517
- *string* : There are 2 main options for the *"If Current Item has no children"* fallback (ref. [Fallbacks Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Fallbacks-Section) above)...
518
 
519
  * *"parent"* : Sets the widget's `Starting at` Fallback option to "-1 (parent)"
520
  * *"current"* : Sets the widget's `Starting at` Fallback option to "the Current Item"
@@ -528,13 +545,13 @@ same as "current,1,+siblings", and "2,parent" is the same as "parent,2", etc.
528
 
529
  = fallback_ci_parent =
530
  *switch, off by default, 1 to enable* : See widget's *"If no Current Item can be found"* fallback in the
531
- [Fallbacks Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Fallbacks-Section) above.
532
 
533
  = flat_output =
534
- *switch, off by default, 1 to enable* : See widget's `Flat` option, under [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section) above.
535
 
536
  = title_from =
537
- *string* : Supply one or more (by separating them with a comma, eg. `title_from="branch,current"`) of the following (ref. the widget's `Set Title from` options, under [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section) above)...
538
 
539
  * *"current"* : enables the widget's *Current Item* `Set Title from` option
540
  * *"current-root"* : enables the widget's *...or its Root* option that relates to the `Current Item` `Set Title from` option
@@ -542,25 +559,25 @@ same as "current,1,+siblings", and "2,parent" is the same as "parent,2", etc.
542
  * *"branch-root"* : enables the widget's *...or its Root* option that relates to the `Branch` `Set Title from` option
543
 
544
  = ol_root =
545
- *switch, off by default, 1 to enable* : See widget's `Top Level` option, under *Change UL to OL* in the [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section) above.
546
 
547
  = ol_sub =
548
- *switch, off by default, 1 to enable* : See widget's `Sub-Levels` option, under *Change UL to OL* in the [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section) above.
549
 
550
  = container =
551
- *string* : See widget's `Element` option, under [Container Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Container-Section) above.
552
 
553
  = container_id =
554
- *string* : See widget's `Unique ID` option, under [Container Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Container-Section) above.
555
 
556
  = container_class =
557
- *string* : See widget's `Class` option, under [Container Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Container-Section) above.
558
 
559
  = menu_class =
560
- *string* : See widget's `Menu Class` option, under [Classes Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Classes-Section) above.
561
 
562
  = widget_class =
563
- *string* : See widget's `Widget Class` option, under [Classes Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Classes-Section) above.
564
 
565
  = wrap_link =
566
  *string* : This is an optional tag name (eg. "div", "p", "span") that, if provided, will be made into HTML start/end tags
@@ -574,7 +591,7 @@ Please note that the shortcode usage - a simple tag name - is much more restrict
574
 
575
  = alternative =
576
  *string* : This is 2 settings separated by a comma, reflecting the `On condition` options under the
577
- [Alternative Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Alternative-Section) above.
578
  Possible values are:
579
 
580
  * One of "current", "no-current" or "no-output" : the condition to test for
@@ -620,7 +637,7 @@ from any widget's "assist".
620
 
621
  Example : `[cmwizard findme=1 title="Posts containing a CMW shortcode..."/]`
622
 
623
- == Shortcode Examples ==
624
 
625
  * Show the entire "main" menu
626
 
@@ -652,18 +669,6 @@ Example : `[cmwizard findme=1 title="Posts containing a CMW shortcode..."/]`
652
  [cmwizard menu=main title="Main Menu"]title="Nearest and Dearest!" branch=current depth=2 siblings=1[/cmwizard]
653
  `
654
 
655
- == Installation ==
656
-
657
- 1. EITHER Upload the zip package via 'Plugins > Add New > Upload' in your WP Admin
658
-
659
- OR Extract the zip package and upload `custom-menu-wizard` folder to the `/wp-content/plugins/` directory
660
-
661
- 1. Activate the plugin through the 'Plugins' menu in your WP Admin
662
-
663
- The widget will now be available in the 'Widgets' admin page.
664
- 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.
665
- Alternatively, you can use the shortcode in your content.
666
-
667
  == Frequently Asked Questions ==
668
  If you have a question or problem that is not covered here, please use the [integrated Support forum](http://wordpress.org/support/plugin/custom-menu-wizard).
669
 
@@ -769,6 +774,9 @@ Note that output from this shortcode extension is restricted to users with edit_
769
 
770
  == Changelog ==
771
 
 
 
 
772
  = 3.1.1 =
773
  * bugfix : only show the allow_all_root setting in the shortcode equivalent if the primary filter is by branch
774
  * addition : work-around for when a theme inadvertently(!) de-registers the widget, which then prevents the shortcode working
@@ -899,6 +907,9 @@ Note that output from this shortcode extension is restricted to users with edit_
899
 
900
  == Upgrade Notice ==
901
 
 
 
 
902
  = 3.1.1 =
903
  Added a work-around for when a theme inadvertently(!) de-registers the widget, which then prevents the shortcode working.
904
  Fixed a trivial bug where the allow_all_root setting was being unnecessarily shown in the widget's shortcode equivalent.
1
  === Custom Menu Wizard Widget ===
2
  Contributors: wizzud
3
  Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=KP2LVCBXNCEB4
4
+ Tags: menu,widget,navigation,custom menu,partial menu,current item,current page,menu level,menu branch,menu shortcode,menu widget,advanced,enhanced
5
  Requires at least: 3.6
6
  Tested up to: 4.0
7
+ Stable tag: 3.1.2
8
  License: GPLv2 or Later
9
 
10
  Show branches or levels of your menu in a widget, or in content using a shortcode, with full customisation.
33
  * Utility to find posts containing this plugin's shortcode
34
  * **NEW** Specify an alternative configuration to use under certain conditions (dual-scenario capability)
35
 
36
+ Current documentation for the **Widget Options** can be found
37
+ under [Other Notes](http://wordpress.org/plugins/custom-menu-wizard/other_notes/).
38
+ The associated **Shortcode Parameters** are documented
39
+ under [Installation](http://wordpress.org/plugins/custom-menu-wizard/installation/) (too much text to fit all on one page!).
40
 
41
  **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
42
  there are probably a couple of very common scenarios:
78
  There are quite a few options, which makes the widget settings box very long. I have therefore grouped most of the options into
79
  collapsible logical sections (with remembered state once saved).
80
 
81
+ The associated **SHORTCODE PARAMETERS** are documented
82
+ under [Installation](http://wordpress.org/plugins/custom-menu-wizard/installation/).
83
 
84
  ***Always Visible***
85
 
383
 
384
  Text or HTML that will be placed immediately after each menu item's link text.
385
 
386
+ == Alternative Section ==
387
 
388
  This is new at v3.1.0 and provides a limited dual-scenario capability, based on a couple of conditions. For example, let's say you
389
  want to show the Current Item and its immediate children, *but* if there isn't a Current Item then you want to show the top 2 levels
408
  should have kicked in but couldn't due to an error in the alternative settings) so please take note of it, because the Assist
409
  *cannot* be used to modify the Alternative settings, only the primary ones.
410
 
411
+ A bit more information about the **Alternative** is available
412
  in [this article](http://www.wizzud.com/2014/10/03/custom-menu-wizard-wordpress-plugin-version-3-1/).
413
 
414
+ == Installation ==
415
+
416
+ 1. EITHER Upload the zip package via 'Plugins > Add New > Upload' in your WP Admin
417
+
418
+ OR Extract the zip package and upload `custom-menu-wizard` folder to the `/wp-content/plugins/` directory
419
+
420
+ 1. Activate the plugin through the 'Plugins' menu in your WP Admin
421
+
422
+ The widget will now be available in the 'Widgets' admin page.
423
+ 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.
424
+ Alternatively, you can use the shortcode in your content.
425
+
426
+ Current documentation for the **Widget Options** can be found
427
+ under [Other Notes](http://wordpress.org/plugins/custom-menu-wizard/other_notes/).
428
+
429
+ = SHORTCODE PARAMETERS =
430
 
431
  *NB. Version 2 documentation is [here](http://plugins.svn.wordpress.org/custom-menu-wizard/tags/3.0.0/v210-readme.html#Shortcode-Parameters).*
432
 
465
  = start_at =
466
  *string* : This is only relevant to a `Branch` filter, and consists of a signed or unsigned integer that indicates either a relative
467
  (to the selected branch item) or absolute level to start your output at (ref. the widget's `Starting at` option under *Secondary Filter*,
468
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section)).
469
  By default the starting level for output is the branch item's level. A relative level is indicated by a signed (ie. preceded by
470
  a "+" or "-") integer, eg. `start_at="+1"`, while an absolute level is unsigned, eg. `start_at="1"`. Some examples :
471
 
481
  Setting `start_mode="level"` forces the widget to use not only the resultant starting item
482
  and its relevant descendants, but also all that item's siblings *and their descendants*
483
  (ref. the widget's `Level` radio option under *Secondary Filter*,
484
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section)).
485
 
486
  = allow_all_root =
487
  *switch, off by default, 1 to enable* : See widget's `Allow all Root Items` option, under *Secondary Filter*,
488
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section).
489
 
490
  = depth =
491
  *integer, default 0 (unlimited)* : See widget's `For Depth` option, under *Secondary Filter*,
492
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section).
493
 
494
  = depth_rel_current =
495
  *switch, off by default, 1 to enable* : See widget's `Relative to Current Item` option, under *Secondary Filter*,
496
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section).
497
 
498
  = ancestors =
499
  *integer, default 0 (off)* : Sets an absolute level (positive integer), or a relative number of levels (negative integer), for which
500
  the ancestors of the `Branch` filter item should be included. See widget's `Branch Ancestors` option, under *Inclusions*,
501
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section). (only relevant to a `Branch` filter)
502
 
503
  = ancestor_siblings =
504
  *integer, default 0 (off)* : Sets an absolute level (positive integer), or a relative number of levels (negative integer), for which
505
  the siblings of ancestors of the `Branch` filter item should be included. See widget's `... with Siblings` option, under *Inclusions*,
506
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section). (only relevant to a `Branch` filter)
507
 
508
  = siblings =
509
  *switch, off by default, 1 to enable* : See widget's `Branch Siblings` option, under *Inclusions*,
510
+ [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section). (only relevant to a `Branch` filter)
511
 
512
  = include_level =
513
  *string* : A level (1, 2, 3, etc), optionally followed by a "+" or "-" to include all subsequent (lower) or prior (higher)
527
 
528
  = contains_current =
529
  *string* : Accepted values : "menu", "primary", "secondary", "inclusions", or "output". See widget's *Qualifier* options,
530
+ under [Filters Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Filters-Section),
531
  for an explanation of the respective settings.
532
 
533
  = fallback =
534
+ *string* : There are 2 main options for the *"If Current Item has no children"* fallback (ref. [Fallbacks Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Fallbacks-Section))...
535
 
536
  * *"parent"* : Sets the widget's `Starting at` Fallback option to "-1 (parent)"
537
  * *"current"* : Sets the widget's `Starting at` Fallback option to "the Current Item"
545
 
546
  = fallback_ci_parent =
547
  *switch, off by default, 1 to enable* : See widget's *"If no Current Item can be found"* fallback in the
548
+ [Fallbacks Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Fallbacks-Section).
549
 
550
  = flat_output =
551
+ *switch, off by default, 1 to enable* : See widget's `Flat` option, under [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section).
552
 
553
  = title_from =
554
+ *string* : Supply one or more (by separating them with a comma, eg. `title_from="branch,current"`) of the following (ref. the widget's `Set Title from` options, under [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section))...
555
 
556
  * *"current"* : enables the widget's *Current Item* `Set Title from` option
557
  * *"current-root"* : enables the widget's *...or its Root* option that relates to the `Current Item` `Set Title from` option
559
  * *"branch-root"* : enables the widget's *...or its Root* option that relates to the `Branch` `Set Title from` option
560
 
561
  = ol_root =
562
+ *switch, off by default, 1 to enable* : See widget's `Top Level` option, under *Change UL to OL* in the [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section).
563
 
564
  = ol_sub =
565
+ *switch, off by default, 1 to enable* : See widget's `Sub-Levels` option, under *Change UL to OL* in the [Output Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Output-Section).
566
 
567
  = container =
568
+ *string* : See widget's `Element` option, under [Container Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Container-Section).
569
 
570
  = container_id =
571
+ *string* : See widget's `Unique ID` option, under [Container Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Container-Section).
572
 
573
  = container_class =
574
+ *string* : See widget's `Class` option, under [Container Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Container-Section).
575
 
576
  = menu_class =
577
+ *string* : See widget's `Menu Class` option, under [Classes Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Classes-Section).
578
 
579
  = widget_class =
580
+ *string* : See widget's `Widget Class` option, under [Classes Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Classes-Section).
581
 
582
  = wrap_link =
583
  *string* : This is an optional tag name (eg. "div", "p", "span") that, if provided, will be made into HTML start/end tags
591
 
592
  = alternative =
593
  *string* : This is 2 settings separated by a comma, reflecting the `On condition` options under the
594
+ [Alternative Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Alternative-Section).
595
  Possible values are:
596
 
597
  * One of "current", "no-current" or "no-output" : the condition to test for
637
 
638
  Example : `[cmwizard findme=1 title="Posts containing a CMW shortcode..."/]`
639
 
640
+ = SHORTCODE EXAMPLES =
641
 
642
  * Show the entire "main" menu
643
 
669
  [cmwizard menu=main title="Main Menu"]title="Nearest and Dearest!" branch=current depth=2 siblings=1[/cmwizard]
670
  `
671
 
 
 
 
 
 
 
 
 
 
 
 
 
672
  == Frequently Asked Questions ==
673
  If you have a question or problem that is not covered here, please use the [integrated Support forum](http://wordpress.org/support/plugin/custom-menu-wizard).
674
 
774
 
775
  == Changelog ==
776
 
777
+ = 3.1.2 =
778
+ * modified the readme : documentation for the Shortcode Parameters has been moved to the Installation page (to avoid being truncated)
779
+
780
  = 3.1.1 =
781
  * bugfix : only show the allow_all_root setting in the shortcode equivalent if the primary filter is by branch
782
  * addition : work-around for when a theme inadvertently(!) de-registers the widget, which then prevents the shortcode working
907
 
908
  == Upgrade Notice ==
909
 
910
+ = 3.1.2 =
911
+ No code changes, just moved the readme's Shortcode Parameters documentation onto the Installation page (to avoid being truncated).
912
+
913
  = 3.1.1 =
914
  Added a work-around for when a theme inadvertently(!) de-registers the widget, which then prevents the shortcode working.
915
  Fixed a trivial bug where the allow_all_root setting was being unnecessarily shown in the widget's shortcode equivalent.