{"id":10829,"date":"2010-10-09T17:07:25","date_gmt":"2010-10-09T17:07:25","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/custom-taxonomies-menu-widget\/"},"modified":"2015-08-08T19:58:11","modified_gmt":"2015-08-08T19:58:11","slug":"custom-taxonomies-menu-widget","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/custom-taxonomies-menu-widget\/","author":1229986,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.4","stable_tag":"1.4","tested":"4.3.34","requires":"3.8","requires_php":"","requires_plugins":"","header_name":"Custom Taxonomies Menu Widget","header_author":"Ade Walker, Studiograsshopper","header_description":"","assets_banners_color":"498698","last_updated":"2015-08-08 19:58:11","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/www.studiograsshopper.ch\/custom-taxonomies-menu-widget\/","header_plugin_uri":"http:\/\/www.studiograsshopper.ch\/custom-taxonomies-menu-widget\/","header_author_uri":"http:\/\/www.studiograsshopper.ch","rating":4.5,"author_block_rating":0,"active_installs":1000,"downloads":42394,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.3":"<p>Version 1.3 introduces new options for determining how the plugin should treat new terms added to a taxonomy since the last time the widget options were Saved by the user. These &quot;Terms Handling&quot; options are set to &quot;Auto&quot; by default, which replicates the way prior versions of the plugin included new terms.<\/p>\n\n<p>Added &#039;sgr_ctmw_taxonomies&#039; 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. This allows you to add in built-in taxonomies if you wish to to do so.<\/p>","1.4":"<p>Plugin&#039;s class constructor now uses PHP5 style constructor (replacing the PHP4 constructor) in readiness for WP 4.3.<\/p>"},"ratings":{"1":0,"2":"1","3":0,"4":0,"5":"5"},"assets_icons":[],"assets_banners":{"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"481587","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.1.1","1.2","1.2.1","1.2.2","1.3","1.3.1","1.4"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":"1567473","resolution":"1","location":"plugin"}},"screenshots":{"1":"Custom Taxonomies Menu Widget control panel"}},"plugin_section":[],"plugin_tags":[4925,1865,91,162],"plugin_category":[43,57],"plugin_contributors":[78958],"plugin_business_model":[],"class_list":["post-10829","plugin","type-plugin","status-closed","hentry","plugin_tags-custom-taxonomies","plugin_tags-menu","plugin_tags-taxonomy","plugin_tags-widget","plugin_category-customization","plugin_category-taxonomy","plugin_contributors-studiograsshopper","plugin_committers-studiograsshopper"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/custom-taxonomies-menu-widget_498698.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/custom-taxonomies-menu-widget\/trunk\/screenshot-1.jpg?rev=1567473","caption":"Custom Taxonomies Menu Widget control panel"}],"raw_content":"<!--section=description-->\n<p>Creates a simple menu of your custom taxonomies and their associated terms, ideal for sidebars. Highly customisable via checkboxes to select which custom taxonomies and terms are displayed in the menu.<\/p>\n\n<strong>Key Features<\/strong>\n\n<ul>\n<li>Select which custom taxonomies to display<\/li>\n<li>Select which terms to display within the selected custom taxonomies<\/li>\n<li>Choose the order in which terms are displayed within the custom taxonomies (ID, name, count, etc)<\/li>\n<li>Choose whether to display the taxonomy name as a title<\/li>\n<li>Choose whether to display the list of terms as a hierarchy<\/li>\n<li>Choose whether to hide terms with no posts<\/li>\n<li>NEW - User options to control how to treat display of new terms added to a taxonomy<\/li>\n<\/ul>\n\n<strong>Further information<\/strong>\n\n<p>Comprehensive information on configuring and using the plugin can be found here:<\/p>\n\n<ul>\n<li><a href=\"http:\/\/www.studiograsshopper.ch\/custom-taxonomies-menu-widget\/configuration\/\">Configuration Guide<\/a><\/li>\n<li><a href=\"http:\/\/www.studiograsshopper.ch\/custom-taxonomies-menu-widget\/faq\/\">FAQ<\/a><\/li>\n<\/ul>\n\n<h3>Using the plugin<\/h3>\n\n<p>Go to your Dashboard &gt; Appearance &gt; Widgets page and drag the Custom Taxonomies Menu widget to your sidebar. Open the widget control panel and configure the options.<\/p>\n\n<!--section=installation-->\n<p>Either use the WordPress Plugin Installer (Dashboard &gt; Plugins &gt; Add New, then search for \"custom taxonomies menu widget\"), or manually as follows:<\/p>\n\n<ol>\n<li>Download the latest version of the plugin to your computer.<\/li>\n<li>Extract and upload the folder <em>custom-taxonomies-menu-widget<\/em> to your <em>\/wp-content\/plugins\/<\/em> directory. Please ensure that you do not rename any folder or filenames in the process.<\/li>\n<li>Activate the plugin in your Dashboard via the \"Plugins\" menu.<\/li>\n<li>Go to the Dashboard &gt; Appearance &gt; Widgets page, where you can now see the Custom Taxonomies Menu Widget in the available widgets, ready for use in any of your theme's widget areas.<\/li>\n<\/ol>\n\n<p>Note for WordPress Multisite users:<\/p>\n\n<ul>\n<li>Install the plugin in your <em>\/plugins\/<\/em> directory (do not install in the <em>\/mu-plugins\/<\/em> directory).<\/li>\n<li>In order for this plugin to be visible to Site Admins, the plugin has to be activated for each blog by the Network Admin.<\/li>\n<\/ul>\n\n<strong>Upgrading from a previous version<\/strong>\n\n<p>You can use the Wordpress Automatic Plugin upgrade link in the Dashboard Plugins menu to automatically upgrade the plugin.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Where can I get Support?<\/dt>\n<dd><p>Further information about setting up and using the plugin can be found in the plugin's <a href=\"http:\/\/www.studiograsshopper.ch\/custom-taxonomies-menu-widget\/configuration\/\">Configuration Guide<\/a>.<\/p>\n\n<p>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 <a href=\"http:\/\/wordpress.org\/support\/plugin\/custom-taxonomies-menu-widget\">Support Forum<\/a>.<\/p>\n\n<p>Support is provided in my free time but every effort will be made to respond to support queries as quickly as possible.<\/p><\/dd>\n<dt>Can I Donate?<\/dt>\n<dd><p>Yes, of course you can! You can find a link <a href=\"http:\/\/www.studiograsshopper.ch\/custom-taxonomies-menu-widget\/\">here<\/a>. Thanks!<\/p><\/dd>\n<dt>Terms Handling options<\/dt>\n<dd><p>New widget control panel option in version 1.3.<\/p>\n\n<p>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 <strong>Auto top level \/ smart child<\/strong>. To replicate pre-1.3 behaviour, select <strong>Auto<\/strong>.<\/p>\n\n<p><strong>Auto<\/strong><\/p>\n\n<p>Any new Top Level or Child term created since last Save is:<\/p>\n\n<ul>\n<li>automatically included in Menu<\/li>\n<li>automatically shown as checked in the widget control panel<\/li>\n<\/ul>\n\n<p><strong>Manual<\/strong><\/p>\n\n<p>Any new Top Level or Child term created since last Save is:<\/p>\n\n<ul>\n<li>not included in Menu<\/li>\n<li>not shown as checked in the widget control panel<\/li>\n<\/ul>\n\n<p>Note: User always has to open widget control panel to manually add terms to the Menu<\/p>\n\n<p><strong>Auto top level \/ smart child<\/strong><\/p>\n\n<p>Any new Top Level term created since last Save is:<\/p>\n\n<ul>\n<li>automatically included in Menu<\/li>\n<li>automatically shown as checked in the widget control panel<\/li>\n<\/ul>\n\n<p>Any new Child term created since last Save is:<\/p>\n\n<ul>\n<li>only included in Menu if its parent is already included<\/li>\n<li>only shown as checked in widget control panel if its parent is checked<\/li>\n<\/ul>\n\n<p>This means that a new child of a new top level term will be checked and included in Menu.<\/p>\n\n<p>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.<\/p>\n\n<p><strong>Manual top level \/ smart child<\/strong><\/p>\n\n<p>Any new Top Level term created since last Save is:<\/p>\n\n<ul>\n<li>not included in Menu<\/li>\n<li>not shown as checked in the widget control panel<\/li>\n<\/ul>\n\n<p>Any new Child term created since last Save is:<\/p>\n\n<ul>\n<li>only included in Menu if its parent is already included<\/li>\n<li>only shown as checked in the widget control panel if its parent is checked<\/li>\n<\/ul>\n\n<p>This means that a new child of a new top level term will not be checked and won't be included in Menu.<\/p>\n\n<p>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.<\/p>\n\n<p>To replicate pre-1.3 behaviour, select <strong>Auto<\/strong>. However, note that many users may find the new <strong>Auto top level \/ smart child<\/strong> option to be the better option.<\/p>\n\n<p>Further information and examples can be found in the plugin's <a href=\"http:\/\/www.studiograsshopper.ch\/custom-taxonomies-menu-widget\/configuration\/\">Configuration Guide<\/a>.<\/p><\/dd>\n<dt>Why does the widget panel re-check all terms that I've just unchecked?<\/dt>\n<dd><p>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.<\/p>\n\n<p>If you want to hide a taxonomy's terms, uncheck the taxonomy itself.<\/p><\/dd>\n<dt>How to include builtin taxonomies<\/dt>\n<dd><p>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.<\/p>\n\n<p>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.<\/p><\/dd>\n<dt>License and Disclaimer<\/dt>\n<dd><p>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\nthe Free Software Foundation.<\/p>\n\n<p>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.<\/p>\n\n<p>The license for this software can be found here: <a href=\"http:\/\/www.gnu.org\/licenses\/gpl-2.0.html\">http:\/\/www.gnu.org\/licenses\/gpl-2.0.html<\/a><\/p>\n\n<p>Thanks for downloading the plugin.  Enjoy!<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.4<\/h4>\n\n<ul>\n<li>Released 8 August 2015<\/li>\n<li>Enhance: Replaced PHP4 class constructor with PHP5 style constructor, in readiness for WP 4.3<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Released 16 December 2013<\/li>\n<li>Enhance: WP 3.8 minimum version required<\/li>\n<li>Bug fix: Tweaked admin CSS to fix new-look WP 3.8 Dashboard styles<\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li>Released 6 May 2013<\/li>\n<li>Enhance: Added new control panel options for Terms Handling, which determine how the plugin should treat new terms added to a taxonomy since the last time the widget options were Saved by the user<\/li>\n<li>Enhance: Major re-write to integrate options and to treat new terms added to a taxonomy since last Save<\/li>\n<li>Enhance: SGR_CTMW_DOMAIN deprecated<\/li>\n<li>Bug fix: Changed textdomain to string 'sgr-ctmw', no longer Constant<\/li>\n<li>Bug fix: Improved sanitisation\/validation when widget options are saved<\/li>\n<\/ul>\n\n<h4>1.2.2<\/h4>\n\n<ul>\n<li>Readme.txt updated 1 April 2013<\/li>\n<li>Released 1 January 2012<\/li>\n<li>Bug fix: Fixed PHP data type error<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Released 29 December 2011<\/li>\n<li>Bug fix: Fixed PHP error on upgrade with $known_terms returning NULL<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Released 28 December 2011<\/li>\n<li>Bug fix: Now ignores taxonomies with no terms<\/li>\n<li>Bug fix: Fixed missing internationalisation for strings in the widget form<\/li>\n<li>Bug fix: Enqueues admin CSS properly now<\/li>\n<li>Enhance: Upped minimum WP version requirement to 3.2 - upgrade!<\/li>\n<li>Enhance: Widget sub-class now uses PHP5 constructor<\/li>\n<li>Enhance: Widget control form made wider, less scrolling required for long taxonomy checklist<\/li>\n<li>Enhance: Added activation hook function for WP version check, deprecated SGR_CTMW_WP_VERSION_REQ constant<\/li>\n<li>Enhance: sgr_ctmw_wp_version_check() deprecated<\/li>\n<li>Enhance: sgr_ctmw_admin_notices() deprecated<\/li>\n<li>Enhance: Added SGR_CTMW_HOME for plugin's homepage url on studiograsshopper<\/li>\n<li>Enhance: Plugin files reorganised, sgr-ctmw-admin-core.php no longer used<\/li>\n<li>Feature: 'hide_empty' options added, to allow display of empty terms in the menu<\/li>\n<li>Feature: New terms are now automatically added to menu, and 'checked' in the widget form<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Released 1 March 2011<\/li>\n<li>Bug fix: Removed debug code form sgr_ctmw_wp_version_check() function<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Released 4 November 2010<\/li>\n<li>Feature: Added option to hide Taxonomy title<\/li>\n<li>Feature: Added option to select whether or not to display terms as a hierarchy<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Public release 9 October 2010<\/li>\n<\/ul>","raw_excerpt":"Creates a simple menu of your custom taxonomies and their associated terms, ideal for sidebars. Highly customisable via widget control panel.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/10829","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=10829"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/studiograsshopper"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=10829"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=10829"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=10829"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=10829"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=10829"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=10829"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}