Title: DevFixture Option Revisions
Author: devfixture
Published: <strong>November 19, 2026</strong>
Last modified: November 19, 2026

---

Search plugins

![](https://ps.w.org/devfixture-option-revisions/assets/banner-772x250.png?rev=3811712)

![](https://ps.w.org/devfixture-option-revisions/assets/icon-256x256.png?rev=3811712)

# DevFixture Option Revisions

 By [devfixture](https://profiles.wordpress.org/devfixture/)

[Download](https://downloads.wordpress.org/plugin/devfixture-option-revisions.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/devfixture-option-revisions/#description)
 * [Reviews](https://wordpress.org/plugins/devfixture-option-revisions/#reviews)
 *  [Installation](https://wordpress.org/plugins/devfixture-option-revisions/#installation)
 * [Development](https://wordpress.org/plugins/devfixture-option-revisions/#developers)

 [Support](https://wordpress.org/support/plugin/devfixture-option-revisions/)

## Description

Option Revisions brings revision history to WordPress configuration. Choose options
under Tools  Option revisions, inspect recorded changes, compare any two revisions
or a revision against the current live value, and restore complete snapshots through
the WordPress Options API.

Built by DevFixture: https://devfixture.com/

 * Track only options explicitly selected in the Options tab.
 * Start and stop tracking without reloading the page or changing its filters. Protected
   and excluded options stay out of the browser.
 * Creation, updates, deletion, and explicitly labeled initial snapshots.
 * Native WordPress tables and pagination for options and tracked-option history,
   with search and sorting.
 * Field-level nested array comparisons, side-by-side or unified.
 * Separate live-state comparisons and discrepancy warnings.
 * Confirmation-bound restores, conflict detection, and reversible restoration records.
 * Protected core settings, nested sensitive-key redaction, and integrity verification.
 * Automatic retention by revision count and age.
 * No advertising, telemetry, external services, or frontend assets.

#### Security and privacy

History is stored in this site’s database, not sent elsewhere. Option history can
contain personal information or configuration secrets. Built-in name-based patterns
redact common sensitive keys before storing values. Detection is not comprehensive:
unusually named secrets, free-form strings, and personal data may remain. Select
only options that are safe and useful to retain. Restrict database and administrator
access and maintain independent backups.

Protected options cannot be tracked or restored. Redacted, incomplete, and unsupported
snapshots cannot be restored. The prior live state must also be fully capturable
before a restore can proceed. A change and its audit insert are separate operations;
partial failures are reported explicitly.

Snapshots carry a site-bound HMAC using WordPress authentication salts. Rotating
salts invalidates old snapshot integrity checks. This is tamper evidence, not encryption,
and does not defend against code running with the site’s full privileges.

#### Capture and type limitations

Only successful standard Options API operations are tracked. Direct SQL writes, 
external database changes, bypassed hooks, and changes predating tracking cannot
be reconstructed. Unknown sources are shown as Unknown; execution context is not
plugin attribution.

WordPress stores non-serialized scalar values as strings. API event snapshots preserve
types supplied by WordPress, while live reads and deletion baselines reflect database
types. The plugin does not invent a lost original scalar type. Restore verifies 
the database representation of the requested value. Existing autoload behavior is
retained on updates; recreated options are added without autoload.

Arrays preserve key types and order. Arbitrary objects are never instantiated by
snapshot decoding and are not restorable. Comparisons show an unsupported-value 
notice when necessary. There is no plugin-imposed snapshot byte limit. Structural
limits remain: 32 nesting levels and 5,000 nodes. Diff output is limited to 200 
fields and bounded previews.

Restoration checks live state immediately before calling the Options API and verifies
it afterward. This is optimistic concurrency, not a transaction or database lock
against every possible writer. Normal option sanitizers and callbacks still run 
and can reject or transform a requested value.

#### Multisite

Each site uses its own tables, configuration, permissions, and history. Network 
activation initializes sites lazily without bulk snapshots. Network-wide site_options
tracking is outside this version’s scope. Uninstall honors each site’s own deletion
policy.

## Installation

 1. Back up the database and verify on a staging site.
 2. Upload the devfixture-option-revisions directory to wp-content/plugins, or install
    the ZIP from Plugins  Add Plugin  Upload Plugin.
 3. Activate DevFixture Option Revisions.
 4. Open Tools  Option revisions  Options.
 5. Enable tracking for one eligible option. An optional initial snapshot captures 
    its current state.
 6. Change the option using its owning plugin or the Options API, then open its history.

Requires WordPress 6.2 and PHP 8.4 or later. The original full-suite test baseline
is WordPress 7.1.3, PHP 8.4.6, and MariaDB 10.8.8. No build step or production Composer
dependency is required.

## FAQ

### Will it recover settings changed before installation?

No. History begins when tracking is enabled. An initial snapshot is a baseline, 
not an earlier historical event.

### Does it identify which plugin changed an option?

No plugin is guessed from execution context. Source remains Unknown unless the operation
is an explicit restore performed by this plugin.

### Why is restore unavailable?

The option may be protected, the snapshot may be redacted, unsupported, incomplete,
or corrupted, or the current value cannot be fully preserved. The confirmation screen
explains the reason.

### Can I restore the value before a deletion?

Yes. Open Compare change for the deletion and choose Review restore of the before
state. The after state of a deletion intentionally represents absence.

### What happens when the selected state is already current?

No value is changed and no duplicate revision is added. The result explicitly says
no change was needed.

### Is cleanup immediate?

Automatic retention runs hourly, with at most 500 deleted rows and 20 visited option
names per batch. Low-traffic sites should run WP-Cron from a real scheduler.

### How do I choose tracked options?

Use Start tracking and Stop tracking in Options. The tracked filter and History 
index show current selections. Protected options and transients excluded by the 
transient setting are omitted from the list.

### Does automatic retention change the actual setting?

No. Retention only deletes older revision rows. It preserves tracking selections
and live options.

### What happens on deactivation and uninstall?

Deactivation preserves data. Uninstall preserves history by default. Enable Delete
data on uninstall in advance to remove this site’s plugin tables and settings. Preserved
data may contain sensitive configuration; remove it deliberately when no longer 
needed.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“DevFixture Option Revisions” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ devfixture ](https://profiles.wordpress.org/devfixture/)

[Translate “DevFixture Option Revisions” into your language.](https://translate.wordpress.org/projects/wp-plugins/devfixture-option-revisions)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/devfixture-option-revisions/),
check out the [SVN repository](https://plugins.svn.wordpress.org/devfixture-option-revisions/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/devfixture-option-revisions/)
by [RSS](https://plugins.trac.wordpress.org/log/devfixture-option-revisions/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial implementation of option revision tracking, comparisons, safe restoration,
   and bounded retention.
 * Native WordPress revision diffs with inline highlights and a Settings shortcut
   on the plugins list.
 * Align the activation requirement with the declared WordPress 6.2 minimum.

## Meta

 *  Version **1.0.0**
 *  Last updated **1 hour ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 8.4 or higher **
 * Tags
 * [history](https://wordpress.org/plugins/tags/history/)[options](https://wordpress.org/plugins/tags/options/)
   [restore](https://wordpress.org/plugins/tags/restore/)[revisions](https://wordpress.org/plugins/tags/revisions/)
   [settings](https://wordpress.org/plugins/tags/settings/)
 *  [Advanced View](https://wordpress.org/plugins/devfixture-option-revisions/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/devfixture-option-revisions/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/devfixture-option-revisions/reviews/)

## Contributors

 *   [ devfixture ](https://profiles.wordpress.org/devfixture/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/devfixture-option-revisions/)