=== JPD2 ===

Contributors:Shelob9
Donate link: http://JoshPress.net
Tags: transients, caching
Requires at least: 3.8
Tested up to: 3.8.1
Stable tag: 0.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html


A plugin Josh wrote a long time ago.

== Description ==
A plugin I wrote a while ago. Seemed like a good idea. Meh... Don't use this. Use [http://CalderaWP.com/downloads/caldera-forms](Caldera Forms) that's an awesome plugin.

== Installation ==

= Using The WordPress Dashboard =

1. Navigate to the 'Add New' in the plugins dashboard
2. Search for 'JPD2'
3. Click 'Install Now'
4. Activate the plugin on the Plugin dashboard

= Uploading in WordPress Dashboard =

1. Navigate to the 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `JPD2.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard

= Using FTP =

1. Download `JPD2.zip`
2. Extract the `JPD2` directory to your computer
3. Upload the `JPD2` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard

== Frequently Asked Questions ==

= What I So Awesome About Transient Cacheing? =
The [Transients API](http://codex.wordpress.org/Transients_API) creates temporary entries into your database. One great use is to store the result of complex queries, which allows WordPress to run one query--to get the transient--instead of many queries, and get the same results.

[This article](http://www.doitwithwp.com/introduction-transients-wordpress/) explains very well how that works. This plugin automates the process for you.

= Is It Safe To Call This Function In My Theme Or Plugin? =
The safest method would be to wrap the call in a check of function_exists().

For example code see: [https://gist.github.com/Shelob9/9425101#file-use_jpd2-php](https://gist.github.com/Shelob9/9425101#file-use_jpd2-php)

This way if the JPD2 plugin is not activated, WordPress will run WP_Query directly, instead of returning a fatal error, which would suck.

= How Long Does The Transient Last? =
The transient lasts up to the default transient expiration time, unless an expiration value is set with the $expire argument.

= How Do I Change The Default Transient Expiration Time? =
Two ways:

1. Define the JPD2_EXP constant in wp-config, or anytime before this plugin is loaded.
2. Use the 'JPD2_expire' action

The action, if used, will override the constant.

= How Do I Use A WP_User_Query or WP_Meta_Query? =
By default arguments are passed to WP_Query. You may use the $type argument. You can set it to 'wp_query', which is the default, 'wp_user_query', or 'wp_meta_query'.

= Why Is This Plugin Called JPD2? =
Because Star Wars.

== Screenshots ==

1. Example usage.

== Changelog ==

= 0.0.1 =
* The first version on WordPress.org.

= 0.0.2 =
* Readme change for better readability in FAQ
* Update plugin URI

== Upgrade Notice ==

Nothing to notice for now.