Query Multiple Taxonomies

Contributors: scribu
Tags: drill-down, query, widget, navigation, taxonomy
Requires at least: 3.2
Tested up to: 3.5
Stable tag: 1.6.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Filter posts through multiple taxonomies.

Description

This plugin lets you do faceted search using multiple custom taxonomies.

It has a drill-down widget with multiple display modes.

Said widget is easily customizable via template files (no PHP knowledge required).

Sponsors

• Bill Nanson
• Matthew Porter

No Support

I do not offer any support for this plugin (free or paid).

Please consider using an alternative plugin.

Links: Documentation | Plugin News | Author's Site

Screenshots

1. Lists mode
2. Checkboxes mode
3. Dropdowns mode
4. Widget configuration

How can I order the taxonomies in the widget?

Just drag them around.

How do I define a custom taxonomy?

Try the Simple Taxonomies plugin.

Is there a template tag I can use instead of widgets?

You can use the_widget(), like so:

the_widget('Taxonomy_Drill_Down_Widget', array( 'title' => '', 'mode' => 'dropdowns', 'taxonomies' => array( 'post_tag', 'color' ) // list of taxonomy names ));

'mode' can be one of 'lists' or 'dropdowns'

How can I customize the display?

The template hierarchy for multitax queries is taxonomy.php -> archive.php -> index.php.

If you need to get specific, you can use the is_multitax() conditional tag, which works similarly to is_tax():

is_multitax() -> true if more than one taxonomy was queried.

is_multitax( array('tax_a', 'tax_b') ) -> true if both tax_a and tax_b were queried.

How can I customize the display even further?

Copy any file from the templates directory into a directory called qmt-templates in your theme and modify it at will.

For example to change the checkbox mode display,

copy

wp-content/plugins/query-multiple-taxonomies/templates/checkboxes.html

to

wp-content/themes/YOUR-THEME/qmt-templates/checkboxes.html

and change it however you want.

Changelog

1.6.3 (next)

• fixed parent term post count. props wxyjp
• fixed term name enconding issue
• added French translation. props flameboy

1.6.2

• {{count}} tag improvements. props tiagoalves83 and jprberlin
• added {{any-text}} tag. props jprberlin
• updated to Mustache 1.0.0

1.6.1

• fixed activation error
• fixed error in PHP 5.4

1.6

• added checkbox mode
• added {{count}} tag. props khakulov
• added Ukranian translation. props Jurko Chervony
• more info

1.5.1

• fixed issue with custom post types

1.5

• easy customization, using Mustache templates
• bring back wp_title filtering
• fix qmt_get_query() not working with the 'AND' tax_query operator
• more info

1.4

• WordPress 3.1 compatibility (native taxonomy handling)
• sortable taxonomy list
• widget not affected by non-active taxonomies anymore
• dropdowns display hierarchical taxonomies correctly
• more info

1.3.2

• fixed URL problems

1.3.1

• dropdowns displays hierarchical taxonomies correctly
• various bugfixes

1.3

• multiple taxonomies per widget
• introduced dropdowns mode
• is_multitax() accepts a list of taxonomies to check
• fixed a lot of query errors
• more info

1.2.3

• fixed problems with custom menus
• fixed a problem with categories

1.2.2

• fixed fatal error
• reverted is_multitax() to previous behaviour

1.2.1

• fixed issue when site url isn't the same as the wp url
• fixed issue when doing a single taxonomy query

1.2

• fewer queries
• custom post type support
• load correct template for single category|tag|term archives
• more info

1.1.1

• better title generation
• add ro_RO l10n

1.1

• allow ?tax=foo+bar (AND) queries
• add taxonomy drill-down widget
• more info

1.0

• initial release
• more info