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 | Custom Menu Wizard Widget |
Version | 3.1.2 |
Comparing to | |
See all releases |
Code changes from version 3.1.1 to 3.1.2
- custom-menu-wizard.css +0 -1
- custom-menu-wizard.php +6 -2
- 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.
|
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.
|
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,
|
5 |
Requires at least: 3.6
|
6 |
Tested up to: 4.0
|
7 |
-
Stable tag: 3.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
|
37 |
-
|
38 |
-
|
|
|
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 |
-
|
|
|
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 |
-
==
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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)
|
549 |
|
550 |
= container =
|
551 |
-
*string* : See widget's `Element` option, under [Container Section](http://wordpress.org/plugins/custom-menu-wizard/other_notes/#Container-Section)
|
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)
|
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)
|
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)
|
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)
|
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)
|
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 |
-
|
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.
|