WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Multi-Column Taxonomy List

List your categories, tags, or custom taxonomies into multiple, customizable, columns.

Usage

Shortcode attributes

You can implement a new list by adding the shortcode [mctl] 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: [mctl taxonomy='post_tag' title='Tags']

  • taxonomy: The taxonomy to retrieve terms from
    • Valid values: category, post_tag, custom_taxonomy_name
    • Multiple values not allowed
    • Default: category
  • title: Sets the title of the list
    • Valid values: any string
    • Default: Categories
  • title_container: HTML element to wrap the title in
    • Valid values: any HTML element
    • Recommended values: h1, h2, h3, h4, h5, h6, p
    • Default: h3
  • columns: Sets the number of columns to use
    • Valid values: any integer
    • Default: 3
  • orderby: Sort terms by name, unique ID, slug, or the count of posts in that term
    • Valid values: name, id, slug, count
    • Default: name
  • order: Sort order for the terms (either ascending or descending)
    • Valid values: ASC, DESC
    • Default: ASC
  • alpha_grouping: Output the first letter of each alphabetical grouping
    • Valid values: 0, 1
    • Default: 0
  • show_count: Toggles the display of the current count of posts in each term. 0 is false/off and 1 is true/on
    • Valid values: 0, 1
    • Default: 0
  • exclude: Exclude one or more terms from the results.
    • Valid values: unique IDs, separated by commas. (ex: exclude='12,13,22')
    • Default: no default
  • parent: Get direct children of this term
    • Valid values: any integer
    • Multiple values not allowed
    • Default: no default
  • child_of: Get all descendents of this term
    • Valid values: any integer
    • Multiple values not allowed
    • Default: 0
  • rss: Turns the list into links to RSS feed of term. 0 is false/off and 1 is true/on
    • Valid values: 0, 1
    • Default: 0
  • rss_image: Use a custom image RSS image icon when rss is on.
    • Valid values: full URL to image
    • Default: /wp-includes/images/rss.png
  • number: Max number of terms to display
    • Valid values: any integer
    • Default: display all terms
  • like: Return terms that begin with this value
    • Valid values: any string
    • Default: no default
  • search: Return terms that contain the 'search' string
    • Valid values: any string
    • Default: no default

Template tag

Alternatively, you can implement a new list by adding the the template tag <?php multi_column_tax_list(); ?> 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: <?php multi_column_tax_list( 'taxonomy=post_tag&title=Tags' ); ?>

Refer to the above attributes for customizations.

Requires: 3.0 or higher
Compatible up to: 3.8.3
Last Updated: 2014-1-28
Downloads: 12,580

Ratings

4 stars
4.8 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1 100,1,1 100,2,2
100,1,1
100,1,1
100,3,3 100,3,3
100,1,1
100,5,5
50,2,1
75,4,3
100,1,1
100,1,1 100,2,2
100,1,1
0,1,0
100,1,1