Introducing Revisions 0.2.5 — A New Version History Plugin for Geeklog
- Saturday, October 17 2026 @ 10:00 pm EDT
- Contributed by: ::Ben
- Views: 398
I'm pleased to introduce Revisions 0.2.5, the first public pre-release of a new content versioning plugin for Geeklog.
The idea is simple: when you update a page, wouldn't it be useful to keep its previous version, compare the changes, and recover the original content if needed?
This initial version demonstrates that concept with automatic version tracking for Static Pages, a revision history interface, and a safe visual preview of archived content. The plugin is available for testing and feedback from the Geeklog community.
How Does Revisions Work?
Once installed, Revisions automatically starts tracking eligible Static Pages. There is no need to select individual pages or manually activate tracking for each one.
When a tracked page is modified and saved through the supported Geeklog save process, its previous editorial content is stored in the revision history.
Administrators can then browse pages with archived revisions, select an earlier version, and examine the changes.
Features Available in 0.2.5
- Automatic tracking: Existing eligible Static Pages are initialized during installation or upgrade.
- Version history: Previous versions are stored in dedicated database tables.
- Per-page revision numbering: Each page has its own revision sequence, starting at version #1.
- Content comparison: Compare archived and current titles, meta descriptions, and HTML content.
- Visual preview: View archived HTML in an isolated preview without executing scripts or Geeklog autotags.
- HTML source recovery: Copy an earlier version's original HTML and reuse it manually in the Static Pages editor.
- Administrative interface: Browse revision history, find pages with previous versions, and inspect individual changes.
A Foundation for Future Content Recovery
Revisions is still an experimental plugin. Version 0.2.5 focuses on demonstrating the history and comparison features.
Automatic restoration is not yet available. For now, administrators can recover archived HTML manually through the Static Pages editor.
Future development will focus on safe restoration, improved handling of concurrent edits, and extending revision history to Geeklog stories and potentially other content types.
This pre-release does not support PHP-based or template-based Static Pages, and it cannot reconstruct changes made before tracking was initialized. It should not be treated as a replacement for regular database and file backups.
Download and Compatibility
Revisions 0.2.5 requires Geeklog 2.2.2 or later and PHP 5.6.40 or later.
The plugin has been tested on a Geeklog 2.2.2 installation, and GitHub Actions checks its PHP syntax with PHP 5.6, 8.1, and 8.3.
Revisions official GitHub repository
As this is a pre-release, testing on a development installation with a database backup is recommended.
Feedback Welcome
This is an early step toward bringing content version history and recovery capabilities to Geeklog.
I'd be interested in hearing from other Geeklog users and developers. Does this approach meet your needs? Which content types should be supported next? What would make revision history most useful in your daily workflow?
Please share your suggestions, report issues, or contribute through the GitHub issue tracker.
Thanks to everyone helping improve Geeklog!