PHPackages                             bonny/wordpress-simple-history - 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. [Logging & Monitoring](/categories/logging)
4. /
5. bonny/wordpress-simple-history

ActiveWordpress-plugin[Logging & Monitoring](/categories/logging)

bonny/wordpress-simple-history
==============================

View recent changes made within WordPress, directly on your dashboard or on a separate page.

5.24.1(1mo ago)3156.9k↓33.3%75[2 PRs](https://github.com/bonny/WordPress-Simple-History/pulls)GPL-2.0-or-laterPHPPHP ^7.4|^8.0CI passing

Since May 31Pushed 1mo ago12 watchersCompare

[ Source](https://github.com/bonny/WordPress-Simple-History)[ Packagist](https://packagist.org/packages/bonny/wordpress-simple-history)[ Docs](https://simple-history.com/)[ Fund](https://simple-history.com/sponsor/)[ GitHub Sponsors](https://github.com/bonny)[ RSS](/packages/bonny-wordpress-simple-history/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (46)Versions (112)Used By (0)

[![Simple History logo](./css/simple-history-logo.png)](./css/simple-history-logo.png)
======================================================================================

[](#)

[![Plugin rating: 5 stars](https://camo.githubusercontent.com/aa5e5b5de0ddf490e82812f272fb4f786b4e814e7859ee27d4ccdc137f4577a4/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f722f73696d706c652d686973746f72792e7376673f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/aa5e5b5de0ddf490e82812f272fb4f786b4e814e7859ee27d4ccdc137f4577a4/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f722f73696d706c652d686973746f72792e7376673f7374796c653d666f722d7468652d6261646765) [![Number of active installs: over 100K](https://camo.githubusercontent.com/1b5e4e89dd846a8a885b9b2e992a3162d4d52ad5666bb94816750ec61cae5ef6/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f696e7374616c6c732f73696d706c652d686973746f72793f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/1b5e4e89dd846a8a885b9b2e992a3162d4d52ad5666bb94816750ec61cae5ef6/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f696e7374616c6c732f73696d706c652d686973746f72793f7374796c653d666f722d7468652d6261646765) [![Number of monthly downloads](https://camo.githubusercontent.com/f304b27f49621ec160061b8c97a575de4568c6a9c9df9756528d7d4b743f3a25/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f646d2f73696d706c652d686973746f72793f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/f304b27f49621ec160061b8c97a575de4568c6a9c9df9756528d7d4b743f3a25/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f646d2f73696d706c652d686973746f72793f7374796c653d666f722d7468652d6261646765)

**A WordPress activity log for what matters.**

Simple History is a WordPress audit log plugin that logs various things that occur in WordPress and then presents those events in a very nice GUI.
It's great way to view user activity and keep an eye on what the admin users of a website are doing.

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

[](#installation)

Download from [WordPress.org](https://wordpress.org/plugins/simple-history/) and activate.

Usage
-----

[](#usage)

### Viewing history events

[](#viewing-history-events)

This screenshot show the user activity feed:

- It has an active **filter/search in use**:
    - only show changes performed by a specific user
    - it only shows event that are of type post and pages and media (i.e. images & other uploads)
- A thumbnail is shown for the image that is uploaded

[![Simple History screenshot](.wordpress-org/screenshot-1.png)](.wordpress-org/screenshot-1.png)

### Events with different severity

[](#events-with-different-severity)

Simple History uses the log levels specified in the [PHP PSR-3 standard](https://www.php-fig.org/psr/psr-3/).

### Quick diff lets you see what's changed

[](#quick-diff-lets-you-see-whats-changed)

[![Simple History screenshot](.wordpress-org/screenshot-2.png)](.wordpress-org/screenshot-2.png)

### Events have context with extra details

[](#events-have-context-with-extra-details)

Each logged event can include useful rich formatted extra information. For example: a plugin install can contain author info and a the url to the plugin, and an uploaded image can contain a thumbnail of the image.

[![Simple History screenshot](.wordpress-org/screenshot-3.png)](.wordpress-org/screenshot-3.png)

Premium Add-on
--------------

[](#premium-add-on)

[Simple History Premium](https://simple-history.com/add-ons/premium) adds:

- **Log Retention** – Set retention policies (30d to forever)
- **Export** – CSV/JSON export of filtered results
- **Stats Dashboard** – Visual summaries of activity trends
- **Custom Events** – Manually log important changes via GUI
- **Stealth Mode GUI** – Control visibility per user (code-free)
- **Sticky Events** – Pin important events to top
- **Ad-Free** – Remove promotional content

[View details](https://simple-history.com/add-ons/premium)

*The free version is fully functional and will remain free. Premium exists to fund ongoing development and provide pro features for agencies/enterprises.*

Plugin API
----------

[](#plugin-api)

Developers can easily log their own things using a simple API:

```