=== Multi-column Tag Map === Contributors: tugbucket Tags: tags, lists, expandable, column, alphabetical, toggleable, site map, index, appendix, glossary Requires at least: 2.1 Tested up to: 3.2 Stable tag: 4.2 Multi-column Tag Map displays a columnized, alphabetical and expandable listing of all tags used in your site. == Description == Multi-column Tag Map display a columnized, alphabetical, expandable and toggleable listing of all tags used in your site. This makes it easier for visitors to quickly search for topics that might intrest them. = Features = * Alphabetically lists all tags used in the site * Display tags in one to five columns * The initial amount of tags from each letter can be limited * jQuery Show/Hide effect * jQuery toogle effect * Customizable "show more" link * Customizable "show less" link * Can show tags with no posts related to them * Can show tags belonging to private posts * Optionally list tags of peoples names last name first == Installation == Unzip the 'mcTagMap' folder into '/wp-content/plugins/' and activate the plug in the Wordpress admin area. = Hardcode Installation **deprecated since verion 4.0** = You can hardcode this into your themes' PHP files like so: `` `` `` This method is configurable in two ways. The first method uses the standard '&' dilemeter. This method does not allow for special characters (shown with default values). `` The second method uses the vertical pipe '|' as a dilemeter thus allowing the use of special characters: `` **NOTE:** As of version 4.0, only the shortcode installation will be supported. = Shortcode Installation = `[mctagmap columns="3" more="more »" hide="no" num_show="4" toggle="«" show_empty="yes" name_divider="|"]` = Defaults = * columns = 2 (possible values: 1-5) * hide = no (possible values: yes or no) * num_show = 5 * more = View more * toggle = no (possible values: 'YOUR TEXT' or no) * show_empty = no (possible values: yes or no) * name_divider = | = Explanation of options = * columns: This sets the number of columns to display your tags in. NOTE: if you have less letters than your set number of columns, the plug in will end up inserting an extra closing tag. this will mess up your layout. * hide: This tells the list of tags for each letter to cut the list off at the point specified in the 'num_show' option. * num_show: This tells the plug-in how many list items to show on page load. * more: This will be the text of the link to dispaly more links. Only visible if 'hide' is set to 'yes' and 'num_show' is less than the total number of tags shown in each list. * toggle: If set to anything except 'no', this will tell the 'more' link to become a toggle link. The text you set for 'toggle' will be the 'hide' link text. * show_empty: If set to 'yes', this will display tags in the lists that currently do not have posts associated with them. NOTE: If a post is set to private the tag will still show up in the list but, clicking the link will go to an empty archive unless the user is logged in. This is the same behavoir as clicking a tag link where there is no post to go to. This is not a bug. * name_divider: This allows for multi-word tags to be sorted by words other than the first word eg. "Edgar Allen Poe" would be sorted under the "E"s. If you write your tag "Edgar Allen | Poe" it will now produce "Poe, Edgar Allen" and be sorted with the "P"s. = Note = You must be using jQuery in order to use the show/hide feature == Frequently Asked Questions == = The plugin doesn't work correctly in [non-english] language, can you fix it? = Currently the plugin only works in english. If someone would like to help translate it into another language, it would be appreciated. = Does the plugin work in [insert theme name]? = mctagmap does nothing to the core functions of Wordpress. There should be no reason that a theme changes the default functions as to how Wordpress handles tags. Knowing that, there shouldn't be any reason why the plugin does not work in your theme. The CSS might get overwritten due the the hierarchy of your themes CSS but, that can be changed by editing the mctagmap.css in the plugins folder. == Screenshots == 1. Default view.`/trunk/screenshot-1.gif` 2. Four columns with hiding. `/trunk/screenshot-2.gif` == Changelog == * v1.2 - Updated the plugin PHP to correct the CSS path. * v1.3.1 - Fixed a conflict in jQuery for the show/hide to work. * v2.0 - Added shortcode functionality. * v2.1 - Fixed a sorting coflict with the defaults. * v2.2 - Fixed shorcode placement issue. * v3.0 - Added toggleability to the lists, the ability to show empty posts and the ability to use special characters in the links. * v4.0 - Deprecated hardcode support. Added name_divider shortcode option. * v4.0.1 - Typos * v4.1 - oops * v4.2 - Fixed function conflict and added to the FAQ