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
- Back up the database and verify on a staging site.
- Upload the devfixture-option-revisions directory to wp-content/plugins, or install the ZIP from Plugins Add Plugin Upload Plugin.
- Activate DevFixture Option Revisions.
- Open Tools Option revisions Options.
- Enable tracking for one eligible option. An optional initial snapshot captures its current state.
- 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.
-
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.
ContributorsTranslate “DevFixture Option Revisions” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by 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.
