{"id":12880,"date":"2011-04-12T18:23:39","date_gmt":"2011-04-12T18:23:39","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/multi-column-taxonomy-list\/"},"modified":"2014-01-28T16:14:01","modified_gmt":"2014-01-28T16:14:01","slug":"multi-column-taxonomy-list","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/multi-column-taxonomy-list\/","author":2644232,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.5","stable_tag":"1.5","tested":"3.7.41","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"Multi-Column Taxonomy List","header_author":"Matthew Muro","header_description":"","assets_banners_color":"","last_updated":"2014-01-28 16:14:01","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&business=G87A9UN9CLPH4&lc=US&item_name=MCTL%20&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted","header_plugin_uri":"","header_author_uri":"http:\/\/matthewmuro.com","rating":5,"author_block_rating":0,"active_installs":400,"downloads":21892,"num_ratings":15,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.5":"<p>Fix bug where get_term_link may return an error<\/p>","1.4":"<p>Add alphabetical grouping option. Add &#039;child_of&#039; and &#039;search&#039; parameters. See Usage Notes<\/p>","1.3":"<p>Added a new shortcode to create lists that only begin with a certain value.<\/p>","1.2":"<p>Fix bug causing extra closing <code>ul<\/code> to be output. Added a new shortcode to limit the number of terms being output.<\/p>","1.1":"<p>Added ability to show only items from a particular parent. Also, turn the list into links to the RSS feeds.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":15},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.3","1.4","1.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"598591","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"598591","resolution":"2","location":"assets"}},"screenshots":{"1":"List of categories and tags added to a Page via shortcode","2":"List of category RSS feeds"}},"plugin_section":[],"plugin_tags":[610,89,90,609,91],"plugin_category":[43,57],"plugin_contributors":[78000],"plugin_business_model":[],"class_list":["post-12880","plugin","type-plugin","status-closed","hentry","plugin_tags-categories","plugin_tags-category","plugin_tags-tag","plugin_tags-tags","plugin_tags-taxonomy","plugin_category-customization","plugin_category-taxonomy","plugin_contributors-mmuro","plugin_committers-mmuro"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/multi-column-taxonomy-list.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/multi-column-taxonomy-list\/assets\/screenshot-1.png?rev=598591","caption":"List of categories and tags added to a Page via shortcode"},{"src":"https:\/\/ps.w.org\/multi-column-taxonomy-list\/assets\/screenshot-2.png?rev=598591","caption":"List of category RSS feeds"}],"raw_content":"<!--section=description-->\n<p><em>Multi-Column Taxonomy List<\/em> is a plugin that allows you to list your categories, tags, or custom taxonomies into multiple columns.<\/p>\n\n<p>This plugin is great to use on custom archives index pages to display all categories, tags, and custom taxonomies on a single page. You can also turn the list into links to the RSS feeds for your taxonomies.<\/p>\n\n<h3>Usage<\/h3>\n\n<h4>Shortcode attributes<\/h4>\n\n<p>You can implement a new list by adding the shortcode <code>[mctl]<\/code> to the content of a page.  By default, it will output the categories into three columns with a heading of Categories.  You can customize the output using attributes in the following format: <code>[mctl taxonomy='post_tag' title='Tags']<\/code><\/p>\n\n<ul>\n<li><strong>taxonomy<\/strong>: The taxonomy to retrieve terms from\n\n<ul>\n<li>Valid values: <code>category<\/code>, <code>post_tag<\/code>, <code>custom_taxonomy_name<\/code><\/li>\n<li>Multiple values not allowed<\/li>\n<li>Default: <code>category<\/code><\/li>\n<\/ul><\/li>\n<li><strong>title<\/strong>: Sets the title of the list\n\n<ul>\n<li>Valid values: any string<\/li>\n<li>Default: <code>Categories<\/code><\/li>\n<\/ul><\/li>\n<li><strong>title_container<\/strong>: HTML element to wrap the title in\n\n<ul>\n<li>Valid values: any HTML element<\/li>\n<li>Recommended values: <code>h1<\/code>, <code>h2<\/code>, <code>h3<\/code>, <code>h4<\/code>, <code>h5<\/code>, <code>h6<\/code>, <code>p<\/code><\/li>\n<li>Default: <code>h3<\/code><\/li>\n<\/ul><\/li>\n<li><strong>columns<\/strong>: Sets the number of columns to use\n\n<ul>\n<li>Valid values: any integer<\/li>\n<li>Default: <code>3<\/code><\/li>\n<\/ul><\/li>\n<li><strong>orderby<\/strong>: Sort terms by name, unique ID, slug, or the count of posts in that term\n\n<ul>\n<li>Valid values: <code>name<\/code>, <code>id<\/code>, <code>slug<\/code>, <code>count<\/code><\/li>\n<li>Default: <code>name<\/code><\/li>\n<\/ul><\/li>\n<li><strong>order<\/strong>: Sort order for the terms (either ascending or descending)\n\n<ul>\n<li>Valid values: <code>ASC<\/code>, <code>DESC<\/code><\/li>\n<li>Default: <code>ASC<\/code><\/li>\n<\/ul><\/li>\n<li><strong>alpha_grouping<\/strong>: Output the first letter of each alphabetical grouping\n\n<ul>\n<li>Valid values: <code>0<\/code>, <code>1<\/code><\/li>\n<li>Default: <code>0<\/code><\/li>\n<\/ul><\/li>\n<li><strong>show_count<\/strong>: Toggles the display of the current count of posts in each term. <code>0<\/code> is false\/off and <code>1<\/code> is true\/on\n\n<ul>\n<li>Valid values: <code>0<\/code>, <code>1<\/code><\/li>\n<li>Default: <code>0<\/code><\/li>\n<\/ul><\/li>\n<li><strong>exclude<\/strong>: Exclude one or more terms from the results.\n\n<ul>\n<li>Valid values: unique IDs, separated by commas. (ex: <code>exclude='12,13,22'<\/code>)<\/li>\n<li>Default: no default<\/li>\n<\/ul><\/li>\n<li><strong>parent<\/strong>: Get direct children of this term\n\n<ul>\n<li>Valid values: any integer<\/li>\n<li>Multiple values not allowed<\/li>\n<li>Default: no default<\/li>\n<\/ul><\/li>\n<li><strong>child_of<\/strong>: Get all descendents of this term\n\n<ul>\n<li>Valid values: any integer<\/li>\n<li>Multiple values not allowed<\/li>\n<li>Default: <code>0<\/code><\/li>\n<\/ul><\/li>\n<li><strong>rss<\/strong>: Turns the list into links to RSS feed of term. <code>0<\/code> is false\/off and <code>1<\/code> is true\/on\n\n<ul>\n<li>Valid values: <code>0<\/code>, <code>1<\/code><\/li>\n<li>Default: <code>0<\/code><\/li>\n<\/ul><\/li>\n<li><strong>rss_image<\/strong>: Use a custom image RSS image icon when <code>rss<\/code> is on.\n\n<ul>\n<li>Valid values: full URL to image<\/li>\n<li>Default: <code>\/wp-includes\/images\/rss.png<\/code><\/li>\n<\/ul><\/li>\n<li><strong>number<\/strong>: Max number of terms to display\n\n<ul>\n<li>Valid values: any integer<\/li>\n<li>Default: display all terms<\/li>\n<\/ul><\/li>\n<li><strong>like<\/strong>: Return terms that begin with this value\n\n<ul>\n<li>Valid values: any string<\/li>\n<li>Default: no default<\/li>\n<\/ul><\/li>\n<li><strong>search<\/strong>: Return terms that contain the 'search' string\n\n<ul>\n<li>Valid values: any string<\/li>\n<li>Default: no default<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>Template tag<\/h4>\n\n<p>Alternatively, you can implement a new list by adding the the template tag <code>&lt;?php multi_column_tax_list(); ?&gt;<\/code> anywhere in the code of your theme. Just like the shortcode, by default it will output the categories into three columns with a heading of Categories.  You can customize the output using a string of parameters in the following format: <code>&lt;?php multi_column_tax_list( 'taxonomy=post_tag&amp;title=Tags' ); ?&gt;<\/code><\/p>\n\n<p>Refer to the above attributes for customizations.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload <code>multi-column-taxonomy-list<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Create a new page and add the shortcode <code>[mctl]<\/code> to the content.<\/li>\n<\/ol>\n\n<p>Alternatively, you can add <code>&lt;?php multi_column_tax_list(); ?&gt;<\/code> anywhere in your theme.<\/p>\n\n<p>See the Usage section for more examples and a list of parameters.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Does this work with custom taxonomies I have created?<\/dt>\n<dd><p>Yes! To use your custom taxonomy that you have registered with <code>register_taxonomy<\/code>, simply add the <code>taxonomy=custom_taxonomy_name<\/code> attribute.<\/p><\/dd>\n<dt>I'm not seeing any output with my custom taxonomy<\/dt>\n<dd><p>If you are having problems seeing any output with your custom taxonomy, it's usually one of two things:<\/p>\n\n<ol>\n<li>You set <code>public =&gt; false<\/code> when you registered the taxonomy.  It needs to be true: <code>public =&gt; true<\/code><\/li>\n<li>There are no posts assigned to that taxonomy.<\/li>\n<\/ol><\/dd>\n<dt>How do I customize the CSS?<\/dt>\n<dd><p>If you want to customize the appearance of the lists using your own CSS, here's how to do it:<\/p>\n\n<ol>\n<li>Add this code to your theme's <code>functions.php<\/code> file: <code>add_filter( 'mctl_css', '__return_false' );<\/code><\/li>\n<li>Copy everything from <code>css\/multi-column-taxonomy-list.css<\/code> into your theme's <code>style.css<\/code><\/li>\n<li>Change the CSS properties in your theme's <code>style.css<\/code> as needed<\/li>\n<\/ol><\/dd>\n<dt>How do I display my terms with an alphabetical grouping?<\/dt>\n<dd><p>All you need to do is add the following property to the shortcode: <code>alpha_grouping=1<\/code><\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p><strong>Version 1.5 - Jan 28, 2014<\/strong><\/p>\n\n<ul>\n<li>Fix bug where get_term_link may return an error<\/li>\n<\/ul>\n\n<p><strong>Version 1.4 - May 28, 2013<\/strong><\/p>\n\n<ul>\n<li>Add alphabetical grouping option<\/li>\n<li>Add 'child_of' and 'search' parameters<\/li>\n<li>Fix bug where variables were not initially set<\/li>\n<\/ul>\n\n<p><strong>Version 1.3 - Sep 28, 2011<\/strong><\/p>\n\n<ul>\n<li>Add new shortcode attribute: like. Display items that begin with a certain value.<\/li>\n<\/ul>\n\n<p><strong>Version 1.2 - Jul 13, 2011<\/strong><\/p>\n\n<ul>\n<li>Fix bug causing extra closing <code>ul<\/code> to output<\/li>\n<li>Add new shortcode attribute: number<\/li>\n<\/ul>\n\n<p><strong>Version 1.1 - May 4, 2011<\/strong><\/p>\n\n<ul>\n<li>Add new shortcode attributes: parent, rss, and rss_image<\/li>\n<\/ul>\n\n<p><strong>Version 1.0 - Apr 12, 2011<\/strong><\/p>\n\n<ul>\n<li>Plugin launch!<\/li>\n<\/ul>","raw_excerpt":"List your categories, tags, or custom taxonomies into multiple, customizable, columns.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/12880","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=12880"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mmuro"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=12880"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=12880"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=12880"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=12880"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=12880"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=12880"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}