Skip to content

khakulov/wp-query-multiple-taxonomies

 
 

Repository files navigation

=== Query Multiple Taxonomies ===
Contributors: scribu
Donate link: http://scribu.net/paypal
Tags: drill-down, query, widget, navigation, taxonomy
Requires at least: 3.1
Tested up to: 3.2
Stable tag: 1.5.1

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](http://burgundy-report.com)
* [Matthew Porter](http://porterinnovative.com)

Links: [**Wiki**](http://github.com/scribu/wp-query-multiple-taxonomies/wiki) | [Plugin News](http://scribu.net/wordpress/query-multiple-taxonomies) | [Author's Site](http://scribu.net)

== Screenshots ==

1. Drill-down navigation widgets
2. Drill-down widgets in the admin

== Frequently Asked Questions ==

= Error on activation: "Parse error: syntax error, unexpected T_CLASS..." =

Make sure your host is running PHP 5. Add this line to wp-config.php to check:

`var_dump(PHP_VERSION);`

= How do I define a custom taxonomy? =

Try the [Simple Taxonomies](http://wordpress.org/extend/plugins/simple-taxonomies) plugin.

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

You can use [the_widget()](http://codex.wordpress.org/Function_Reference/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

== Changelog ==

= 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](http://scribu.net/wordpress/query-multiple-taxonomies/qmt-1-5.html)

= 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](http://scribu.net/wordpress/query-multiple-taxonomies/qmt-1-4.html)

= 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](http://scribu.net/wordpress/query-multiple-taxonomies/qmt-1-3.html)

= 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](http://scribu.net/wordpress/query-multiple-taxonomies/qmt-1-2.html)

= 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](http://scribu.net/wordpress/query-multiple-taxonomies/qmt-1-1.html)

= 1.0 =
* initial release
* [more info](http://scribu.net/wordpress/query-multiple-taxonomies/qmt-1-0.html)