Custom Query Fields

Description

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)
https://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)
https://www.yoursite.com/?price=500
(displays posts which have a meta key ‘price’ and a exact value of ‘500’)
https://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.

Installation

1. Upload custom-query-fields directory to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. See Description on how to enable the custom variables.

FAQ

When will you have some FAQ’s?

Soon.

Reviews

Contributors & Developers

Changelog

0.1.2b

• Fixed some foreach bugs that threw warnings if no fields were registered.
• The plugin is now only using one global variable.
• Added backward compatibility with version 3.0.
• Improved code efficiency.
• Added enable and disable functions to allow you to apply custom field query to external query’s.

0.1.1b

• Added the ability to control whether the query altering function is run only once.
• Added the compare option to the registered fields. This compare is ignored for numeric comparisons.

0.1b

• Initial build.