WordPress.org

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
• 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
• 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

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.