Logger for Statamic is an addon for Statamic 4 that automatically starts logging your users actions, and provides you with a human-friendly and readable daily log viewer - like an audit trail for the actions that are happening on your site.
But it's so much more than just boring ol' logs.
Logger for Statamic makes logs that are made for humans - your users of the Statamic Control Panel. With messages displayed in the Statamic Control Panel based on event-specific Blade templates, Logger for Statamic makes logging informative and friendly, with insane extensibility to tick those unique needs of your admin team, your site and all of its events.
What does it do?
There are two parts to Logger for Statamic - writing log entries, and reading them back for your users.
All logs are daily, with a customisable retention period - maybe you want 7 days of logs, maybe you need 30. Logger for Statamic takes care of this for you.
Writing
Logger for Statamic comes ready for use, subscribing to a number of core events for Statamic and Laravel, including saving of Entries and Collections, updating Users, and even logins, logouts and failed login attempts.
But it doesn't stop there: Logger for Statamic is extensible, and is ready for you to subscribe to your app's own events.
We've written thorough documentation to help you get up and running with writing your own Logger for Statamic event listeners.
Reading
Within the Statamic Control Panel, Logger for Statamic can be found under Utilities, and allows you to view a daily log file.
But it's not just viewing the log file - they're not particularly user friendly, especially for non-technical people - Logger for Statamic presents its logs human-first.
Each event listener can have its own template - simply written as a Blade template - allowing you to customise the output to meet the needs of your users and your data.
Maybe you need a simple output of what happened... or maybe you want to start tracking changes to show before/after states. Logger for Statamic helps you do both.
Who is Logger for Statamic made for?
Logger for Statamic is made for sites that require a live audit log of actions within their Statamic-based site. Even if your site has custom-build Laravel functionality with its own events, you can subscribe Logger for Statamic to these too.
Getting started
Logger for Statamic is easy to install using Composer – if you’re a developer already, you’ll know what this means. After installation, publish the config file and you’re good to go!
Don't forget to check out the list of events that Logger for Statamic is listening for by default.
If you need simple logging, you can tweak the config to meet your needs, and you're all good to go.
If you need to extend existing listeners, or write your own, there's a whole section in the docs to help you write your own event listeners.
How to get Logger for Statamic
The Logger for Statamic addon can be installed using Composer, with full installation and configuration details on the docs site, with the source code available on Github.
Logger for Statamic is a commercial addon. You can use it for free while in development, but requires a license to use on a live site. You can buy a license on the Statamic Marketplace.
If you find this addon useful, we’d love to hear from you!
Marty Friedel
Marty has a background in Computer and Information Science, software development, web development, multimedia and web accessibility, and is Mity Digital’s resident nerd.
Outside of his programming work, Marty is a keen landscape photographer, and also teaches Les Mills group fitness classes.
