Custom Query Fields

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.

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.

When will you have some FAQ’s?

Soon.

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.