{"id":19496,"date":"2012-08-17T00:13:58","date_gmt":"2012-08-17T00:13:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/list-custom-taxonomy-widget\/"},"modified":"2024-07-13T01:39:08","modified_gmt":"2024-07-13T01:39:08","slug":"list-custom-taxonomy-widget","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/list-custom-taxonomy-widget\/","author":9362879,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"4.2","stable_tag":"4.2","tested":"6.6.5","requires":"3.3","requires_php":"","requires_plugins":null,"header_name":"List Custom Taxonomy Widget","header_author":"Nick Halsey","header_description":"","assets_banners_color":"","last_updated":"2024-07-13 01:39:08","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/celloexpressions.com\/plugins\/list-custom-taxonomy-widget","header_author_uri":"http:\/\/celloexpressions.com\/","rating":4.7,"author_block_rating":0,"active_installs":9000,"downloads":119345,"num_ratings":21,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"celloexpressions","date":"2012-08-17 00:18:01"},"2.0":{"tag":"2.0","author":"celloexpressions","date":"2012-09-11 06:58:12"},"3.0":{"tag":"3.0","author":"celloexpressions","date":"2012-12-12 06:06:42"},"3.1":{"tag":"3.1","author":"celloexpressions","date":"2013-01-25 02:59:39"},"3.1.1":{"tag":"3.1.1","author":"celloexpressions","date":"2013-01-25 05:43:57"},"3.2":{"tag":"3.2","author":"celloexpressions","date":"2013-03-06 08:15:25"},"3.2.1":{"tag":"3.2.1","author":"celloexpressions","date":"2013-03-06 23:18:58"},"3.3":{"tag":"3.3","author":"celloexpressions","date":"2013-09-04 04:19:18"},"4.0":{"tag":"4.0","author":"celloexpressions","date":"2015-12-28 03:27:28"},"4.1":{"tag":"4.1","author":"celloexpressions","date":"2023-09-17 23:34:13"},"4.2":{"tag":"4.2","author":"celloexpressions","date":"2024-07-13 01:39:08"}},"upgrade_notice":{"4.1":"<ul>\n<li>Add support for selective refresh in the customizer, available in WordPress 4.5.<\/li>\n<\/ul>"},"ratings":{"1":0,"2":1,"3":0,"4":4,"5":16},"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":1225454,"resolution":false,"location":"assets","locale":false}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","2.0","3.0","3.1","3.1.1","3.2","3.2.1","3.3","4.0","4.1","4.2"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[89,40670,92,168,162],"plugin_category":[43,57],"plugin_contributors":[78639],"plugin_business_model":[],"class_list":["post-19496","plugin","type-plugin","status-publish","hentry","plugin_tags-category","plugin_tags-custom-tax","plugin_tags-custom-taxonomy","plugin_tags-sidebar","plugin_tags-widget","plugin_category-customization","plugin_category-taxonomy","plugin_contributors-celloexpressions","plugin_committers-celloexpressions"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/list-custom-taxonomy-widget\/assets\/icon.svg?rev=1225454","icon":"https:\/\/ps.w.org\/list-custom-taxonomy-widget\/assets\/icon.svg?rev=1225454","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>The List Custom Taxonomy Widget is a quick and easy way to display custom taxonomies. Simply choose the taxonomy name you want to display from an auto-populated list. You can also set a title to display for the widget. Multiple list custom taxonomy widgets can be added to the same and other sidebars as well. There are several display options (including as a dropdown), and it generally behaves similarly to the built-in categories widget but with the addition of custom taxonomies.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Take the easy route and install through the wordpress plugin installer OR<\/li>\n<li>Download the .zip file and upload the unzipped folder to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Add the widget to your sidebar(s) in the Customizer to live-preview the options before publishing.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='can%20i%20show%20custom%20taxonomies%20in%20a%20%5Bpage%2Fheader%2Fnon-widget-area%5D'><h3>Can I Show Custom Taxonomies in a [Page\/Header\/non-widget-area]<\/h3><\/dt>\n<dd><p>I'll save you the hassle of downloading the plugin and digging through its source code. Just use the <code>wp_list_categories()<\/code> function in your theme (or plugin) to display custom taxonomies as a list, and use <code>wp_dropdown_categories<\/code> for a dropdown (this one does require some supplementary html). This plugin is essentially a widget UI shell for these functions. If you want to use the plugin's code for it, go right ahead, but it really does just widgetize those functions.<\/p><\/dd>\n<dt id='where%27s%20the%20settings%20page%3F'><h3>Where's the settings page?<\/h3><\/dt>\n<dd><p>There is no (need for a) settings page. Simply go to Appearance -&gt; Customize -&gt; Widgets, select the widget area where you want to add the widget, and add the List Custom Taxonomy widget.<\/p><\/dd>\n<dt id='can%20i%20do%20___%3F'><h3>Can I Do ___?<\/h3><\/dt>\n<dd><p>If you'd like to do something outside of the configuration options of this plugin, look at the <a href=\"http:\/\/codex.wordpress.org\/Template_Tags\/wp_list_categories\">WordPress Codex documentation on the function this plugin implements, wp_list categories<\/a>. If this function can do it, the plugin can do it with minor edits, just look in list-custom-taxonomy-widget.php in the plugin editor.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>4.2<\/h4>\n\n<ul>\n<li>Fix default extended options display.<\/li>\n<li>Add additional escaping and sanitization.<\/li>\n<\/ul>\n\n<h4>4.1<\/h4>\n\n<ul>\n<li>Add support for selective refresh in the customizer, available in WordPress 4.5.<\/li>\n<\/ul>\n\n<h4>4.0<\/h4>\n\n<ul>\n<li>Add option to show empty terms.<\/li>\n<li>Fix PHP strict standards warnings, present since WordPress 3.7.<\/li>\n<li>Fix broken navigation when displaying as a dropdown, and explicitly prevent built-in taxonomies from being displayed as dropdowns (they don't work).<\/li>\n<li>Fix compatibility with deprecated widget constructors in WordPress 4.3.<\/li>\n<li>Fix persistently-open options actually being accessible after initial configuration.<\/li>\n<\/ul>\n\n<h4>3.3<\/h4>\n\n<ul>\n<li>Fixed bug where dropdown input 404d unless it was the built-in category taxonomy; dropdown option should work properly now<\/li>\n<li>Plugin is WordPress 3.6 compatible<\/li>\n<\/ul>\n\n<h4>3.2.1<\/h4>\n\n<ul>\n<li>Added classes\/ids and containers to widgets to alow easier selecting with CSS and JavaScript<\/li>\n<\/ul>\n\n<h4>3.2<\/h4>\n\n<ul>\n<li>Added ability to display categories with dropdown (and go button) instead of as a list (the default), find it at the bottom of the \"more options\" section'<\/li>\n<li>Improved documentation<\/li>\n<\/ul>\n\n<h4>3.1.1<\/h4>\n\n<ul>\n<li>For some reason, I have no idea why, the line that executed the \"exclude\" capability was commented out. Update fixes the bug.<\/li>\n<\/ul>\n\n<h4>3.1<\/h4>\n\n<ul>\n<li>Fixed major bug where \"categories\" was displayed first, with everything else as a child, for many users<\/li>\n<li>Updated readme<\/li>\n<\/ul>\n\n<h4>3.0<\/h4>\n\n<ul>\n<li>Confirmed compatibility with WordPress 3.5<\/li>\n<li>Added many new features. Click the more options button to view all of the available configuration options. Features include:<\/li>\n<li>Order by count, id, slug, name, or term group; ascending or descending<\/li>\n<li>Exclude categories by id<\/li>\n<li>Only show children of a particular category (useful for nested\/hierarchical category systems)<\/li>\n<li>Detailed configuration options are hidden by default<\/li>\n<\/ul>\n\n<h4>2.0<\/h4>\n\n<ul>\n<li>Available Taxonomies are now listed in a automatically, so it isn't necessary to go searching for the taxonomy's name<\/li>\n<li>Ability to show count (or hide it)<\/li>\n<li>Ability to specify to display hierarchically (like in builtin categories widget)<\/li>\n<li>Confirmed Wordpress 3.4.2 compatibility<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>First publicly available version of the plugin.<\/li>\n<li>Compatible with Wordpress 3.3.0 through 3.4.1<\/li>\n<\/ul>","raw_excerpt":"The List Custom Taxonomy Widget is a quick and easy way to display custom taxonomies. Simply choose the taxonomy name you want to display from an auto &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/19496","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=19496"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/celloexpressions"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=19496"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=19496"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=19496"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=19496"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=19496"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=19496"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}