Skip to content

scribu/wp-query-multiple-taxonomies

Repository files navigation

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

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