superbig/craft-audit

Log adding/updating/deleting of elements

Audit plugin for Craft CMS 3.x

Audit log for Craft 4., _(*1)

, _(*2)

Note: This plugin costs $99.00 through the Craft Plugin Store when used in production., _(*3)

Screenshots

, _(*4)

, _(*5)

Requirements

This plugin requires Craft CMS 4.0.0 or later., _(*6)

Installation

To install the plugin, follow these instructions., _(*7)

1. Open your terminal and go to your Craft project:, _(*8)

   cd /path/to/project

2. Then tell Composer to load the plugin:, _(*9)

   composer require superbig/craft-audit

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Audit., _(*10)

Audit Overview

Audit automatically keeps an audit log for actions done by logged in users., _(*11)

Configuring Audit

<?php
return [
    // How many days to keep log entries around
    'pruneDays'          => 30,

    // Enable logging
    'enabled'            => true,

    // Toggle specific event types
    'logElementEvents'            => true,
    'logChildElementEvents'       => false,
    'logDraftEvents'              => false,
    'logPluginEvents'             => true,
    'logUserEvents'               => true,
    'logRouteEvents'              => true,


    // Prune old records when a admin is logged in
    'pruneRecordsOnAdminRequests'          => false,

    // Enable geolocation status
    'enabledGeolocation' => true,
    'maxmindLicenseKey' => '',

    // Where to save Maxmind DB files
    'dbPath' => '',
];

Using Audit

As long as the plugin is installed, it will log the following events automatically:, _(*12)

• Creating/saving/deleting elements (including users, Commerce product/variants etc.)
• Saving global sets
• Creating/saving/deleting routes
• Installing/uninstalling and enabling/disabling plugins
• Login/logout

More events like Commerce-specific event handling is planned., _(*13)

Geolocation

To enable geolocation lookup with the help of the MaxMind GeoLite2 databases, you first have to generate a license key., _(*14)

Add your MaxMind.com License Key obtained from the MaxMind.com account area., _(*15)

Clearing old records

You can prune records older than n days (configured by the pruneDays setting) either by using the console command ./craft audit/default/prune-logs or by a button on the Audit index screen., _(*16)

Credits

• Auditing icon by Ralf Schmitzer

Brought to you by Superbig, _(*17)