This package is abandoned and no longer maintained. No replacement package was suggested.

Audit Log Plugin for Craft CMS

0.7.1 2016-10-31 08:20 UTC

README

Plugin that allows you to log adding/updating/deleting of categories/entries/users.

Features:

  • Log Entries, Users and Categories
  • View exact details on what fields have changed
  • View who changed what on what page
  • Export an Audit Log CSV
  • Search, filter and use date ranges to find log entries
  • Has hooks that you can use to extend this plugin
    • registerAuditLogSources
    • getAuditLogTableAttributeHtml
    • defineAvailableTableAttributes
    • modifyAuditLogSortableAttributes
  • Has events that you can listen to
    • auditLog.onElementChanged

Important: The plugin's folder should be named "auditlog"

Deprecated

With the release of Craft 3 on 4-4-2018, this plugin has been deprecated. You can still use this with Craft 2 but you are encouraged to use (and develop) a Craft 3 version. At this moment, I have no plans to do so.

Development

Run this from your Craft installation to test your changes to this plugin before submitting a Pull Request

phpunit --bootstrap craft/app/tests/bootstrap.php --configuration craft/plugins/auditlog/phpunit.xml.dist --coverage-text craft/plugins/auditlog/tests

Changelog

0.7.1

  • Fix comparing of non-existing attribute before, closing issue #15

0.7.0

  • Added Craft 2.5 compatibility
  • Refactored plugin for better readability, quality and testability
  • All service code is now fully covered by unit tests

0.6.2

  • Fixed a bug where the date range didn't fully work
  • Fixed criteria attributes not fully working

0.6.1

  • Added a registerAuditLogSources hook to provide custom sources/criteria
  • Fixed Audit Log not being able to fetch a specific log item
  • Added a MIT license

0.6.0

  • Added the ability to control logging per element type
  • Performance fixes - works much smoother now by fully utilizing ElementType API

0.5.0

  • Added "onElementChanged" event so you can check if a saved element really changed
    • This event will also generate a diff between the before and after state of an element
  • Fix errors that could occur when saving entries and categories anonymously
  • Clean up arrays before showing, making them more readable

0.4.2

  • Fixed source not being selected in CSV download

0.4.1

  • Added CSRF protection for CSV downloads (thanks to Marion Newlevant)

0.4.0

  • Added the ability to download a csv of the log
  • Log more readable info, like Category Title & Group, Section Name and User Groups
  • Improved searching
  • Fixed date ranges not being accurate
  • Added a modifyAuditLogSortableAttributes hook

0.3.0

  • Removed ability to clear log - you can uninstall the plugin to do this
  • Added a date range selector
  • Made sorting work
  • Added modifyAuditLogTableAttributes and getAuditLogTableAttributeHtml hooks

Warning! This version is updated for Craft 2.3 and does NOT work on Craft 2.2

0.2.8

  • Fixed a bug where the user couldn't be shown in some cases

0.2.7

  • Fixed origin url in some cases

0.2.6

  • Better object parsing

0.2.5

  • Also parse logged objects to string
  • Also log user id when registrating

0.2.4

  • Also save section id for entry logs

0.2.3

  • Fixed a bug where the plugin didn't work on PHP 5.3

0.2.2

  • Added the ability to clear the log
  • Better fieldtype parsing
  • You can now easily go to origin
  • ID (and for Entries, Title) are also stored now

0.2.1

  • Fix "changes" url in CP - Thanks to Tim Kelty
  • Avoid Twig errors on array value - Thanks to Tim Kelty

0.2.0

  • Transformed AuditLog into an ElementType for easier sorting, filtering, searching and pagination

0.1.0

  • Initial push to GitHub