From 214942da263f1900cd3c20a04669a486810f446a Mon Sep 17 00:00:00 2001 From: Erick Hitter <ehitter@gmail.com> Date: Mon, 3 Mar 2014 22:33:47 -0800 Subject: [PATCH] Documentation! Fixes #4 --- README.md | 3 +-- object-cache.php | 6 ++++++ readme.txt | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 54 insertions(+), 2 deletions(-) create mode 100644 readme.txt diff --git a/README.md b/README.md index d1cb1a3..67a344c 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,7 @@ A WordPress object cache backend that implements all available methods using Red ### Connecting to Redis ### -By default, the plugin uses `127.0.0.1` and `6379` as the default host and port when creating a new client -instance; the default database of `0` is also used by default. Three constants are provided to override these default values. +By default, the plugin uses `127.0.0.1` and `6379` as the default host and port when creating a new client instance; the default database of `0` is also used. Three constants are provided to override these default values. Specify `WP_REDIS_BACKEND_HOST`, `WP_REDIS_BACKEND_PORT`, and `WP_REDIS_BACKEND_DB` to set the necessary, non-default connection values for your Redis instance. diff --git a/object-cache.php b/object-cache.php index e864ace..e0ab407 100644 --- a/object-cache.php +++ b/object-cache.php @@ -1,4 +1,10 @@ <?php +/** + * Plugin Name: Redis Object Cache + * Author: Eric Mann & Erick Hitter + * Version 1.0 + */ + /** * Adds a value to cache. * diff --git a/readme.txt b/readme.txt new file mode 100644 index 0000000..85f5602 --- /dev/null +++ b/readme.txt @@ -0,0 +1,47 @@ +=== Redis Object Cache === +Contributors: ericmann, ethitter +Tags: cache, object cache, redis +Requires at least: 3.0.1 +Tested up to: 3.9 +Stable tag: 1.0 +License: GPLv2 or later +License URI: http://www.gnu.org/licenses/gpl-2.0.html + +A persistent object cache powered by Redis. + +== Description == + +Object caching backend using Redis for persistent storage. Implements all methods specified by WordPress Core. Supports multisite. + +The plugin supports both the [Redis PECL module](http://pecl.php.net/package/redis) and the [Predis library](https://github.com/nrk/predis) to connect to Redis. + +**You must install the Redis server before using this plugin!** + +== Installation == + +1. Install and configure Redis. There is a good tutorial [here](http://www.saltwebsites.com/2012/install-redis-245-service-centos-6). +2. Install the [Redis PECL module](http://pecl.php.net/package/redis) or place the Predis library in the `/wp-content/predis` directory. +3. Add `object-cache.php` to the `wp-content` directory. It is a drop-in file, not a plugin, so it belongs in the `wp-content` directory, not the `plugins` directory. +4. By default, the script will connect to Redis at 127.0.0.1:6379. See the *Connecting to Redis* FAQ for further options. + +== Frequently Asked Questions == + += Connecting to Redis = + +By default, the plugin uses `127.0.0.1` and `6379` as the default host and port when creating a new client instance; the default database of `0` is also used. Three constants are provided to override these default values. + +Specify `WP_REDIS_BACKEND_HOST`, `WP_REDIS_BACKEND_PORT`, and `WP_REDIS_BACKEND_DB` to set the necessary, non-default connection values for your Redis instance. + += Prefixing Cache Keys = + +The constant `WP_CACHE_KEY_SALT` is provided to add a prefix to all cache keys used by the plugin. If running two single instances of WordPress from the same Redis instance, this constant could be used to avoid overlap in cache keys. Note that special handling is not needed for WordPress Multisite. + +== Changelog == + += 1.0 = +* Initial public release. + +== Upgrade Notice == + += 1.0 = +Initial public release. -- GitLab