=== Tag Dropdown Widget === Contributors: ethitter Donate link: http://www.ethitter.com/plugins/tag-dropdown-widget/ Tags: tag, tags, sidebar, widget, widgets, dropdown, drop down Requires at least: 2.5 Tested up to: 3.0.1 Stable tag: 1.7 Displays tags in a dropdown menu with numerous display options to tailor the output to your theme. == Description == Creates a dropdown list of tags as an alternative to the tag cloud. Widget provides numerous options to tailor the output to fit your site. Dropdown function can also be called directly for use in non-widget themes using `` where `$args` is an array of function arguments. == Installation == 1. Upload tag-dropdown-widget.php to /wp-content/plugins/. 2. Activate plugin through the WordPress Plugins menu. 3. Activate widget from the Appearance > Widgets menu in WordPress. (In earlier versions, Widgets are found under the Presentation menu.) 4. Set display options from the widget's administration panel. == Frequently Asked Questions == = If my theme does not support widgets, can I still use the plugin? = If not using a widget-enabled theme, insert the function `` where the dropdown should appear, specifying `$args` as an array of arguments, valid entries for which are as follows: * limit - numeric value signifying the maximum length of any tag name. * count - set to true or "on" to display the number of posts associated with each tag. * incexc - set to "exclude" to omit tags whose ids are passed as the exclude parameter; set to "include" to limit dropdown to only those tags whose ids are passed as the exclude parameter. * exclude - comma-separated list of tag ids to either include or exclude, based on the incexc parameter. * orderby - set to "name" to list tags by name, set to "count" to organize by post count. * order - set to "ASC" for ascending order, set to "DESC" for descending order. * show - numeric value specifying the maximum number of tags to show. * countgt - numeric value specifying the number of posts a tag must have for it to appear in the dropdown list. Note that if this argument is used in conjunction with the number argument, fewer tags than are specified by number may be returned. * hide_empty - set to 0 to include tags that have no posts associated with them. * cutoff - text used to indicate that a tag name has been trimmed, per the limit argument; defaults to an ellipsis. = What happened to the makeTagDropdown() and TDW_direct() functions? = To implement additional features via the function, version 1.7 introduces the `generateTagDropdown` function. For compatibility purposes, the `makeTagDropdown` and `TDW_direct` functions are still present, but they do not provide the features available with the new function. = If the function is called directly, can tags be excluded? = To exclude tags when using the `generateTagDropdown` function, specify a comma-separated list of tag ids the exclude parameter of the function's arguments array, and specify "exclude" as the argument array's incexc parameter. = If the function is called directly, can I display post counts? = See the first FAQ for more information. = Where do I obtain a tag's id for use with the inclusion or exclusion options? = Tag ids can be obtained in a variety of ways. The easiest is to visit your site's Post Tags page and, while hovering over the tag's name, looking at your browser's status bar. At the very end of the address shown in the status bar, the tag id will follow the text "tag_ID." You can also obtain the tag id by clicking the edit link below any tag's name in the Post Tags page. Next, look at your browser's address bar. At the very end of the address, the tag id will follow the text "tag_ID." = I'd like more control over the tags shown in the dropdown. Is this possible? = This plugin relies on WordPress' `get_tags` function (http://codex.wordpress.org/Function_Reference/get_tags). To modify the arguments passed to this function, use the `TagDropdown_get_tags` filter to specify any of the arguments discussed in the Codex page for `get_tags`. == Changelog == = 1.7 = * Replaced `TDW_direct` and `makeTagDropdown` with `generateTagDropdown`. * Recoded entire plugin to simplify and clean up overall functionality. * Switched exclude functionality to use tag ids rather than tag slugs. * Added numerous additional options to the widget panel based on user response, as detailed below. * Added the ability to specify the indicator shown when a tag name is trimmed. * Added the ability to limit the number of tags shown. * Added the ability to specify the minimum number of posts a given tag must be associated with before it will show in the dropdown. * Added options for specifying the order tags are displayed in. * Added the ability to specify a list of tags to include in the dropdown, expanding on the existing ability to exclude certain tags. * Added the option to display tags which aren't associated with any posts. * Added the `TagDropdown_get_tags` filter to provide advanced users the ability to modify the arguments passed to WordPress' `get_tags` function. Using this filter, the trimming, trimming indicator, and count display settings are still obeyed. = 1.6 = * Add `TDW_direct` function. * Add count and exclusion options to new direct-implementation function (`TDW_direct`). * Corrects two XHTML validation errors. = 1.5.2 = * Unloads tag exclusion list upon deactivation. = 1.5.1 = * Moved plugin pages to ethitter.com. = 1.5 = * Added option to display number of posts within each tag. = 1.4 = * Added option to exclude tags based on comma-separated list of slugs. = 1.3 = * Rewrote certain widget elements for compatibility back to version 2.3. = 1.2 = * Added function to remove plugin settings when deactivated. = 1.1 = * Added the ability to trim tag names when calling the function directly. == Upgrade Notice == = 1.7 = This is a major revision to the Tag Dropdown Widget. Before upgrading, please be aware that both `TDW_direct` and `makeTagDropdown` are deprecated functions that will be eliminated in version 2 of this plugin. Additionally, tags can no longer be excluded based on slug. See changelog for full details. = 1.6 = Replaces `makeTagDropdown` with `TDW_direct` function, adds post count and exclusion options to direct-implementation function. `makeTagDropdown` function retained for backwards compatibility, but will be phased out in a future release. Corrects two XHTML validation errors.