>
Download This Plugin | |
Download Elegant Themes | |
Name | Taxonomy List Shortcode |
Version | 0.9.1 |
Author | Michael Fields |
Rating | 100 |
Last updated | 2010-06-14 11:53:00 |
Downloads |
4492
|
Download Plugins Speed Test plugin for Wordpress |
Home page PageSpeed score has been degraded by 0%, while Post page PageSpeed score has been degraded by 0%
Taxonomy List Shortcode plugin added 1 kB of resources to the Home page and 1 kB of resources to the sample Post page.
Taxonomy List Shortcode plugin added 0 new host(s) to the Home page and 0 new host(s) to the sample Post page.
Great! Taxonomy List Shortcode plugin ads no tables to your Wordpress blog database.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
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.
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"]
.
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 (#).
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 (#).
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
.
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
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"]
.
Post Categories [taxonomy-list tax='category']
- Display a three column, unordered list of Post Categories.
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.
Custom Taxonomy [taxonomy-list tax="fishy-squiggles"]
- Display a three column, unordered list of the custom taxonomy "fishy-squiggles".
Two Columns [taxonomy-list cols="2"]
- Display a two, horizontally-aligned unordered lists of Post Tags.
Five Columns (maximum) [taxonomy-list cols="5"]
- Display a 5, horizontally-aligned unordered lists of Post Tags.
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
The XHTML + CSS was Tested in the Following User Agents
This Plugin has been tested with the Following WordPress Themes