Custom Query Fields

Extend your site's querying and sorting functionality using custom field values.

Author:Julian Lannigan (profile at wordpress.org)
WordPress version required:3.0
WordPress version tested:3.1.4
Plugin version:0.1.2b
Added to WordPress repository:08-05-2011
Last updated:10-05-2011
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:0
Rated by:0
Plugin URI:http://wordpress.org/extend/plugins/custom-qu...
Total downloads:2 834
Active installs:10+
plugin download
Click to start download

THIS PLUGIN IS IN HEAVY DEVELOPMENT!

Extend your site's querying and sorting functionality using custom field values.

The following function registers queryable fields.

register_custom_queryable_field($fieldName, $options);

Simple Example:

register_custom_queryable_field('city');

(The above registers the custom field 'city' to be searchable using query variables)

http://www.yoursite.com/?city=Anahiem

(displays posts which have a meta key 'city' and a value of 'Anahiem')

Advanced Example:

register_custom_queryable_field("price", array("dataType"=>"numeric"));

(The above registers the custom field "price" to be searchable as a number using query variables)

http://www.yoursite.com/?price=500

(displays posts which have a meta key 'price' and a exact value of '500')

http://www.yoursite.com/?price_min=200&price_max=800&order_by=price

(displays posts, sorted by 'price', which have a meta key 'price' and a value between '200' and '800')

Available Options:

  • dataType
    • text (default)
    • numeric (receive min/max query variables, see above example)
  • order
    • If the user uses the "order_by" query variable then this option determines the order. Available options are "ASC" and "DESC"(default)
  • compare
    • Compare method for text types. Defaults to '='. Recommend 'LIKE'

There is a "order_by" query var made available. This is used by adding &order_by=price to the URL. In this instance, the query would sort based on the "price" field only.

Note: This plugin does not alter any queries when in the backend.


FAQ
ChangeLog