Custom Taxonomies Menu Widget FAQ

This is the FAQ for the Custom Taxonomies Menu Widget plugin for WordPress. Links to other resources for this plugin can be found in the menu in the sidebar.

Current version of the plugin is: 1.3.1

Where can I get Support?

Further information about setting up and using the plugin can be found in the plugin's Configuration Guide.

If, having read the information linked to above, you cannot solve your issue, or if you find a bug, you can post a message on the plugin's Support Forum.

Support is provided in my free time but every effort will be made to respond to support queries as quickly as possible.

Can I Donate?

Yes, of course you can! You can find a link here. Thanks!

Terms Handling options

New widget control panel option in version 1.3.

This option determines how the plugin should treat new terms added to a taxonomy since the last time the widget options were Saved by the user. Best option for most users will be Auto top level / smart child. To replicate pre-1.3 behaviour, select Auto.

Auto

Any new Top Level or Child term created since last Save is:

  • automatically included in Menu
  • automatically shown as checked in the widget control panel

Manual

Any new Top Level or Child term created since last Save is:

  • not included in Menu
  • not shown as checked in the widget control panel

Note: User always has to open widget control panel to manually add terms to the Menu

Auto top level / smart child

Any new Top Level term created since last Save is:

  • automatically included in Menu
  • automatically shown as checked in the widget control panel

Any new Child term created since last Save is:

  • only included in Menu if its parent is already included
  • only shown as checked in widget control panel if its parent is checked

This means that a new child of a new top level term will be checked and included in Menu.

On Save, any checked child terms, whose parents have been unchecked in the widget control panel, will be automatically unchecked. In other words, to check a child term, you must also check its parent.

Manual top level / smart child

Any new Top Level term created since last Save is:

  • not included in Menu
  • not shown as checked in the widget control panel

Any new Child term created since last Save is:

  • only included in Menu if its parent is already included
  • only shown as checked in the widget control panel if its parent is checked

This means that a new child of a new top level term will not be checked and won't be included in Menu.

On Save, any checked child terms whose parents have been unchecked in control panel will be automatically unchecked. In other words, to check a child term, you must also check its parent.

To replicate pre-1.3 behaviour, select Auto. However, note that many users may find the new Auto top level / smart child option to be the better option.

Further information and examples can be found in the plugin's Configuration Guide.

Why does the widget panel re-check all terms that I've just unchecked?

If you uncheck all terms in a taxonomy (in the widget's control panel), all terms will be automatically checked on Save. This is intentional behaviour.

If you want to hide a taxonomy's terms, uncheck the taxonomy itself.

How to include builtin taxonomies

The Custom Taxonomies Menu Widget is designed to display "custom" taxonomies - hence the title. However, some users have been nagging me to include builtin taxonomies, ie Category and Tag.

In response to these nags, version 1.3 now provides the 'sgr_ctmw_taxonomies' filter which can be used to filter the $args sent to the get_taxonomies() function used by the plugin. The filter passes an array called $args.

License and Disclaimer

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The license for this software can be found here: http://www.gnu.org/licenses/gpl-2.0.html

Thanks for downloading the plugin. Enjoy!