PHPackages                             thomhines/kirby-revisions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. thomhines/kirby-revisions

ActiveKirby-plugin[Utility & Helpers](/categories/utility)

thomhines/kirby-revisions
=========================

Kirby Panel draft revision snapshots with load and retention controls

1.1.0(1mo ago)17341[1 issues](https://github.com/thomhines/kirby-revisions/issues)MITPHP

Since Apr 14Pushed 1mo agoCompare

[ Source](https://github.com/thomhines/kirby-revisions)[ Packagist](https://packagist.org/packages/thomhines/kirby-revisions)[ Docs](https://github.com/thomhines/kirby-revisions)[ RSS](/packages/thomhines-kirby-revisions/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

Kirby Revisions
===============

[](#kirby-revisions)

Save, preview, and restore page revisions from the Kirby Panel.

`kirby-revisions` adds a `Revisions` button in the Panel for pages and site settings. Editors can save snapshots, browse older ones, and load a previous snapshot back into the current draft without publishing it live.

Requirements
------------

[](#requirements)

- Kirby `5.x`
- PHP `8.2+`

What it does
------------

[](#what-it-does)

- Adds a `Revisions` drawer in the Panel UI
- Lets editors save a revision on demand (with optional label)
- Creates revisions during publish/save flow
- Lets editors load an older revision into the current draft
- Lets editors preview a selected revision in a new browser tab
- Lets editors add/edit labels for easier revision scanning
- Optionally allows deleting old revisions
- Keeps revision history trimmed automatically (based on `max`)

Installation
------------

[](#installation)

### Option 1: Drop in the plugin folder

[](#option-1-drop-in-the-plugin-folder)

Place this plugin at:

`site/plugins/kirby-revisions`

### Option 2: Composer

[](#option-2-composer)

```
composer require thomhines/kirby-revisions
```

### Option 3: Git submodule

[](#option-3-git-submodule)

```
git submodule add https://github.com/thomhines/kirby-revisions.git site/plugins/kirby-revisions
```

Quick start
-----------

[](#quick-start)

Install it and open the Panel on any page (or Site view). You will see a `Revisions` button that opens the revisions drawer.

The plugin works out of the box with sensible defaults.

If you want to customize behavior, add options in `site/config/config.php`:

```