Creates a list (bulleted, number, or custom) of non-hierarchical taxonomies as an alternative to the term (tag) cloud. Formerly known as Tag List Widg
Creates lists of non-hierarchical taxonomies (such as post tags
) as an alternative to term (tag) clouds. Multiple widgets can be used, each with its own set of options.
Numerous formatting options are provided, including maximum numbers of terms, term order, truncating of term names, and more. List styles are fully customizable, with built-in support for bulleted lists and numbered lists.
Using the taxonomy_list_widget
function, users can generate lists for use outside of the included widget.
Only use version 1.2 or higher with WordPress 4.2 and later releases. WordPress 4.2 changed how taxonomy information is stored in the database, which directly impacts this plugin’s include/exclude term functionality.
This plugin was formerly known as the Tag List Widget
. It was completely rewritten for version 1.0.
FAQ
What happened to the Tag List Widget plugin?
Since I first wrote the Tag Dropdown Widget plugin upon which this plugin is based (in November 2009), WordPress introduced custom taxonomies and, as more-fully discussed below, saw a new widgets API overtake its predecessor. As part of the widgets-API-related rewrite, I expanded the plugin to support non-hierarchical custom taxonomies, which necessitated a new name for the plugin.
Why did you rewrite the plugin?
When I first wrote the Tag Dropdown Widget plugin, which I later forked to create the Tag List Widget plugin, WordPress was amidst a change in how widgets were managed. I decided to utilize the old widget methods to ensure the greatest compatibility at the time. In the nearly two years since I released the first version of this plugin, the new widget system has been widely adopted, putting this plugin at a disadvantage. So, I rewrote the plugin to use the new widget API and added support for non-hierarchical taxonomies other than just post tags.
I upgraded to version 1.0 and all of my widgets disappeared. What happened?
As discussed above, WordPress’ widget system has changed drastically since I first released this plugin. To facilitate multiple uses of the same widget while allowing each to maintain its own set of options, the manner for storing widget options changed. As a result, there is no practical way to transition a widget’s options from version 0.3.1 to 1.0.
ChangeLog
1.3.2
1.3.1
1.3
- Update for WordPress 4.3 by removing PHP4-style widget constructor usage (https://make.wordpress.org/core/2015/07/02/deprecating-php4-style-constructors-in-wordpress-4-3/).
1.2
- Update for WordPress 4.2 to handle term splitting in the plugin’s include/exclude functionality. Details at https://make.wordpress.org/core/2015/02/16/taxonomy-term-splitting-in-4-2-a-developer-guide/.
1.1.2
- Correct problem in WordPress 3.3 and higher that resulted in an empty taxonomy dropdown.
- Remove all uses of PHP short tags.
1.1.1
- Allow empty title in widget options. If empty, the
taxonomy_list_widget_title
filter isn’t run.
1.1
- Provide control over link relationship (
dofollow
and nofollow
) in widget. This capability is still available via the taxonomy_list_widget_link_rel
filter.
1.0.1
- Fix fatal error in older WordPress versions resulting from PHP4 and PHP5 constructors existing in widget class.
1.0.0.2
- Fix bug in post count threshold that resulted in no terms being listed.
1.0.0.1
1.0
- Completely rewritten plugin to use WordPress’ newer Widgets API.
- Drop support for WordPress 2.7 and earlier.
- Add support for all public, non-hierarchical custom taxonomies, in addition to Post Tags.
- Introduce new, more flexible function for manually generating lists.
- Fixed persistent bugs in the include/exclude functionality.
- Widget admin is translation-ready.
0.3.1
- Replace id on list items with class.
0.3
- Reduced variables stored in database to two.
0.2
- Added function
TLW_direct