README.md 3.17 KB
Newer Older
Erick Hitter's avatar
Erick Hitter committed
1 2 3 4 5 6
# WP Revisions Control #
**Contributors:** ethitter  
**Donate link:** https://ethitter.com/donate/  
**Tags:** revision, revisions, admin  
**Requires at least:** 3.6  
**Tested up to:** 5.2  
Erick Hitter's avatar
Erick Hitter committed
7
**Stable tag:** 1.3  
Erick Hitter's avatar
Erick Hitter committed
8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
**License:** GPLv2 or later  
**License URI:** http://www.gnu.org/licenses/gpl-2.0.html  

Control how many revisions are stored for each post type.

## Description ##

WordPress 3.6 allows users to control how many revisions are stored for each supported post type. No longer must you rely on the `WP_POST_REVISIONS` constant, which applied universally. This plugin provides an interface for this new functionality.

With this plugin enabled, simply visit **Settings > Writing** to specify the number of revisions retained for each post type.

Why is this helpful? Revisions are stored in the database, and if many are stored, can cause bloat. This bloat may lead to slower queries, which can have a noticeable performance impact. The value of these revisions also depends on what is being tracked. For example, I may want to store every revision of the posts I write, but only desire to keep the latest five versions of each page on my site. Starting in WordPress 3.6, this control is available. WordPress doesn’t provide a native interface to specify revisions quantities, so I wrote this quick plugin to do so.

Thanks to Maria Ramos at [WebHostingHub](http://www.webhostinghub.com/), the plugin is also available in Spanish. Many thanks to her for her efforts!

23
**Development is at https://git.ethitter.com/wp-plugins/wp-revisions-control.**
Erick Hitter's avatar
Erick Hitter committed
24 25 26 27 28 29 30 31 32 33 34 35 36 37

## Installation ##

1. Upload wp-revisions-control to /wp-content/plugins/.
2. Activate plugin through the WordPress Plugins menu.
3. Go to **Settings > Writing** and set the options under **WP Revisions Control**.

## Frequently Asked Questions ##

### Where do I change the plugin's settings? ###
Navigate to **Settings > Writing** in your WordPress Dashboard, and look for the **WP Revisions Control** section.

## Changelog ##

Erick Hitter's avatar
Erick Hitter committed
38
### 1.3 ###
39
* Add bulk actions to purge excess or all revisions.
Erick Hitter's avatar
Erick Hitter committed
40 41 42
* Introduce unit tests.
* Conform to coding standards.

Erick Hitter's avatar
Erick Hitter committed
43 44 45 46 47 48 49 50 51 52 53
### 1.2.1 ###
* Introduce Spanish translation thanks to Maria Ramos at [WebHostingHub](http://www.webhostinghub.com/).

### 1.2 ###
* Add post-level revision purging and limiting. For any post type that supports revisions, you can now limit the number of revisions retained at a post level.

### 1.0 ###
* Initial public release

## Upgrade Notice ##

54 55 56
### 1.3 ###
Introduces bulk actions for purging revisions, along with unit tests. The plugin also conforms to coding standards.

Erick Hitter's avatar
Erick Hitter committed
57 58 59 60 61 62 63 64 65 66 67 68 69 70
### 1.2.1 ###
Introduces Spanish translation thanks to Maria Ramos at [WebHostingHub](http://www.webhostinghub.com/).

### 1.2 ###
For any post type that supports revisions, you can now limit the number of revisions retained at a post level.

## Screenshots ##

### 1. The plugin's settings section, found under **Settings > Writing**. ###
![The plugin's settings section, found under **Settings > Writing**.](http://ps.w.org/wp-revisions-control/assets/screenshot-1.png)

### 2. The post-level controls provided in version 1.2. ###
![The post-level controls provided in version 1.2.](http://ps.w.org/wp-revisions-control/assets/screenshot-2.png)