WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Taxonomy List Shortcode

The Taxonomy List Shortcode plugin adds a shortcode to your WordPress installation which enables you to display multiple unordered lists containing ev

The Taxonomy List Shortcode plugin adds a shortcode to your WordPress installation which enables you to display multiple unordered lists containing every term of a given taxonomy.

Usage Adding [taxonomy-list] to your post content will render a set of three unordered lists containing all terms of a given taxonomy. Custom css will be printed in a style tag to the head of every page view. If this is unacceptable to you, you may turn it off by using the checkbox labeled "Enable CSS" under the "Taxonomy" section of "Settings" in the Administration Panels.

Supported Parameters

  1. tax To define the taxonomy that you would like to list terms from, you will need to specifiy the name of the taxonomy in the tax parameter: [taxonomy-list tax="category"]. In an "out-of-the-box" installation of WordPress, the following taxonomies will be recognized: post_tag, category, and link_category. If you have defined custom taxonomies through use of a plugin or your own hacker-skillz, you can use the name of this taonomy as well: [taxonomy-list tax="fishy-squiggles"]. If the taxonomy cannot be located, due to a spelling error or missing code, the [taxonomy-list] shortcode will return an empty string.

  2. cols To define the number of columns that the [taxonomy-list] shortcode generates, you will want to use the cols parameter. This parameter will accept an integer from 1 - 5. If this parameter is left empty, or a value outside of it's range is defined, it will default to three columns. Example: [taxonomy-list tax="category" cols="4"].

  3. color Use this to define the color of the text. The color passed should be in hexidecimal notation (ff0000) or short hand (f00) Please do not include the hash character (#).

  4. background Use this to define the color of the background. The color passed should be in hexidecimal notation (ff0000) or short hand (f00) Please do not include the hash character (#).

  5. show_counts (bool) If you would like to disable the counts from displaying after your term name, set this parameter to 0. Default value is 1.

  6. NEW! per_page (int) Using this parameter enables paging for your term list. It accepts a numerical value from 1 to "your hearts desire". It is suggested that this feature only be activated on pages that display a list of terms from a single taxonomy. No need to worry, if you have 2 or more lists of terms on a page and you add the per_page parameter to both shortcodes, your site will not break. Please refrain from using this parameter on shortcodes within posts.

Examples

  1. Post Tags (default) [taxonomy-list] - Display a three column, list of Post Tags in alphetbetical order. Although this is the default usage, it is synonymous with [taxonomy-list tax="post_tag" cols="3"].

  2. Post Categories [taxonomy-list tax='category'] - Display a three column, unordered list of Post Categories.

  3. Link Categories [taxonomy-list tax='link_category'] - Display a three column, unordered list of Link Categories. Special note: it is rather pointless to use link categories do to the fact that WordPress does not support front-end display of individual links.

  4. Custom Taxonomy [taxonomy-list tax="fishy-squiggles"] - Display a three column, unordered list of the custom taxonomy "fishy-squiggles".

  5. Two Columns [taxonomy-list cols="2"] - Display a two, horizontally-aligned unordered lists of Post Tags.

  6. Five Columns (maximum) [taxonomy-list cols="5"] - Display a 5, horizontally-aligned unordered lists of Post Tags.

  7. Custom Taxonomy with 5 Columns [taxonomy-list tax="fishy-squiggles" cols="5"] - Display 5, horizontally-aligned unordered lists of the custom taxonomy "fishy-squiggles".

Notes on post status

  • Terms containing published, password protected posts will be shown in the list.
  • Terms containing only private, scheduled, draft or posts pending review will not be displayed in the list.

The XHTML + CSS was Tested in the Following User Agents

  • Windows XP: Internet Explorer 6
  • Windows XP: FireFox 3.5.3
  • Windows XP: FireFox 3.6.3
  • Windows XP: Opera 9.26
  • Windows XP: Safari 4.0.3

This Plugin has been tested with the Following WordPress Themes

Requires: 2.8.6 or higher
Compatible up to: 3.0-RC3
Last Updated: 2010-6-14
Downloads: 4,286

Ratings

4 stars
4.7 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,1,1 100,1,1
100,3,3
67,3,2
100,1,1
100,1,1
100,1,1
0,1,0
100,1,1