{"id":20870296,"url":"https://github.com/bonny/wordpress-simple-history","last_synced_at":"2025-05-15T01:04:31.668Z","repository":{"id":8037303,"uuid":"9447334","full_name":"bonny/WordPress-Simple-History","owner":"bonny","description":"🔍🕵️‍♀️ WordPress audit log that track user changes in WordPress admin using a nice activity feed.","archived":false,"fork":false,"pushed_at":"2025-04-11T14:45:12.000Z","size":12186,"stargazers_count":312,"open_issues_count":42,"forks_count":71,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-11T15:30:56.252Z","etag":null,"topics":["activity","audit","feed","history","log","user-activity","wordpress"],"latest_commit_sha":null,"homepage":"https://simple-history.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bonny.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"bonny","custom":"https://www.paypal.me/eskapism"}},"created_at":"2013-04-15T11:39:08.000Z","updated_at":"2025-04-06T15:37:51.000Z","dependencies_parsed_at":"2023-10-02T07:59:38.198Z","dependency_job_id":"8e2e6da7-d0a8-4be6-9161-fbab85bca634","html_url":"https://github.com/bonny/WordPress-Simple-History","commit_stats":{"total_commits":2331,"total_committers":35,"mean_commits":66.6,"dds":0.06864006864006866,"last_synced_commit":"1cde9fb69a6c27c96693d6cb867d04adb7745b9d"},"previous_names":[],"tags_count":152,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonny%2FWordPress-Simple-History","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonny%2FWordPress-Simple-History/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonny%2FWordPress-Simple-History/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonny%2FWordPress-Simple-History/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bonny","download_url":"https://codeload.github.com/bonny/WordPress-Simple-History/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248787397,"owners_count":21161597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["activity","audit","feed","history","log","user-activity","wordpress"],"created_at":"2024-11-18T06:18:01.828Z","updated_at":"2025-04-13T21:32:53.716Z","avatar_url":"https://github.com/bonny.png","language":"PHP","funding_links":["https://github.com/sponsors/bonny","https://www.paypal.me/eskapism","https://www.paypal.com/paypalme/eskapism"],"categories":[],"sub_categories":[],"readme":"# \u003cimg height=\"50\"  src=\"./css/simple-history-logo.png\" alt=\"Simple History logo\"\u003e\n\n\u003cimg src=\"https://img.shields.io/wordpress/plugin/r/simple-history.svg?style=for-the-badge\" alt=\"Plugin rating: 5 stars\"\u003e \u003cimg src=\"https://img.shields.io/wordpress/plugin/installs/simple-history?style=for-the-badge\" alt=\"Number of active installs: over 100K\"\u003e \u003cimg src=\"https://img.shields.io/wordpress/plugin/dm/simple-history?style=for-the-badge\" alt=\"Number of monthly downloads\"\u003e\n\nA WordPress activity log for what matters\n\nSimple 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.  \nIt's great way to view user activity and keep an eye on what the admin users of a website are doing.\n\n## Installation\n\nDownload from [WordPress.org](https://wordpress.org/plugins/simple-history/) and activate.\n\n## Usage\n\n### Viewing history events\n\nThis screenshot show the user activity feed:\n\n- It has an active **filter/search in use**:\n  - only show changes performed by a specific user\n  - it only shows event that are of type post and pages and media (i.e. images \u0026 other uploads)\n- A thumbnail is shown for the image that is uploaded\n\n![Simple History screenshot](.wordpress-org/screenshot-1.png)\n\n### Events with different severity\n\nSimple History uses the log levels specified in the [PHP PSR-3 standard](https://www.php-fig.org/psr/psr-3/).\n\n### Quick diff lets you see what's changed\n\n![Simple History screenshot](.wordpress-org/screenshot-2.png)\n\n### Events have context with extra details\n\nEach 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.\n\n![Simple History screenshot](.wordpress-org/screenshot-3.png)\n\n## Plugin API\n\nDevelopers can easily log their own things using a simple API:\n\n```php\n\u003c?php\n\n// This is the easiest and safest way to add messages to the log\n// If the plugin is disabled this way will not generate in any error\napply_filters('simple_history_log', 'This is a logged message');\n\n// Or with some context and with log level debug:\napply_filters(\n\t'simple_history_log',\n\t'My message about something',\n\t[\n\t\t'debugThing' =\u003e $myThingThatIWantIncludedInTheLoggedEvent,\n\t\t'anotherThing' =\u003e $anotherThing\n\t],\n\t'debug'\n);\n\n// Or just debug a message quickly\napply_filters('simple_history_log_debug', 'My debug message');\n\n// You can also use functions/methods to add events to the log\nSimpleLogger()-\u003einfo(\"This is a message sent to the log\");\n\n// Add events of different severity\nSimpleLogger()-\u003einfo(\"User admin edited page 'About our company'\");\nSimpleLogger()-\u003ewarning(\"User 'Jessie' deleted user 'Kim'\");\nSimpleLogger()-\u003edebug(\"Ok, cron job is running!\");\n```\n\nYou will find more examples in the [examples.php](./examples/examples.php) file.\n\n## Development\n\n### Running tests\n\nSee the [README](./tests/readme.md) in `tests` directory.\n\n## Sponsors\n\nSupport the free version of Simple History by becoming a sponsor.\nYou can sponsor using [PayPal](https://www.paypal.com/paypalme/eskapism) or [becoming a GitHub Sponsor](https://github.com/sponsors/bonny).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonny%2Fwordpress-simple-history","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbonny%2Fwordpress-simple-history","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonny%2Fwordpress-simple-history/lists"}