FireGento_AdminMonitoring

The admin monitoring allows an shop owner to log almost every activity in the backend.

Facts

Version: check config.xml
Extension on GitHub

Builds

Branch: master
Branch: develop

Description

The admin monitoring allows an shop owner to log almost every activity in the backend. The goal is to monitor all changes in the backend and show them in a nice view so that a shop owner can monitor who changed what, e.g. logged in to the admin account, saved a product, deleted a customer, e.g.

BE CAREFUL

This extension writes a lot of data into the database and we exclude only a few core classes. If you have many writes in the backend, please have a look into this to avoid a full hard disk!

There are currently several ways if you can exclude e.g. specific models, admin routes, field names from logging data to the database:

Exclude all changes from a specific object (e.g. Mage_Index_Model_Event)
Exclude all changes from a specific admin route (e.g. admin_sales_order_create_loadBlock)
Exclude specific objects from specific admin routes (e.g. Mage_CatalogRule_Model_Flag from admin_promo_catalog_save)
Exclude specific field names from every object (e.g. created_at, updated_at)

There is a basic adminmonitoring.xml file located in the "etc" folder of this extension with the following default excludes:

<?xml version="1.0"?>
<config>
    <adminmonitoring>
        <excludes>
            <object_types>
                <Mage_Index_Model_Event/>
                <Mage_Admin_Model_User/>
                <Enterprise_Logging_Model_Event_Changes/>
                <Enterprise_Logging_Model_Event/>
                <!-- omit infinite loops -->
                <FireGento_AdminMonitoring_Model_History/>
            </object_types>
            <fields>
                <created_at/>
                <updated_at/>
                <create_time/>
                <update_time/>
                <low_stock_date/>
            </fields>
            <admin_routes>
                <admin_sales_order_create_index/>
                <admin_sales_order_create_loadBlock/>
                <admin_sales_order_create_save/>
                <admin_sales_order_invoice_save/>
                <admin_sales_order_shipment_save/>
                <admin_sales_order_creditmemo_save/>
                <admin_sales_order_create_reorder/>
                <admin_promo_catalog_save>
                    <Mage_CatalogRule_Model_Flag/>
                </admin_promo_catalog_save>
            </admin_routes>
        </excludes>
    </adminmonitoring>
</config>

Third party integration

Events for model_save_after and model_delete_after are observed and changes automatically logged, if not excluded as described above. So even third party models will be logged and can be even better integrated by link to their adminhtml edit form. To do this observe the event firegento_adminmonitoring_rowurl and see Firegento_AdminMonitoring_Model_RowUrl_Product for an catalog_product implementation which can be adapted for your custom models.

If you want to log your own events just dispatch the event firegento_adminmonitoring_log and pass your custom data:

Mage::dispatchEvent(
    'firegento_adminmonitoring_log',
    array(
        'object_id'    => $objectId,
        'object_type'  => $objectType,
        'content'      => $content, // as json
        'content_diff' => $contentDiff, // as json
        'action'       => $action, // see Firegento_AdminMonitoring_Helper_Data for possible ACTION constants
    )
);

If you want to exclude some more fields, admin routes, object types just create a custom adminmonitoring.xml file in your custom module and add the necessary values in the same structure like in the default adminmonitoring.xml file of this extension.

Requirements

PHP >= 5.3.0 (or even 5.0 as long as spl is activated)
PHP >= 5.5.0: json extension

Compatibility

Magento CE >= 1.6
Magento EE >= 1.12

Installation Instructions

Install the extension by copying all the extension files into your document root.
Clear the cache, logout from the admin panel and then login again.
You can now configure the extenion via System -> Configuration -> Advanced -> Admin -> Admin Monitoring
You can view all logging entries in System -> Configuration -> Admin Monitoring

Uninstallation

Remove all extension files from your Magento installation
Run the following sql script in your database:

DROP TABLE 'firegento_adminmonitoring_history';

Please remove all integration for the admin monitoring in your custom modules.

Support

If you have any issues with this extension, open an issue on GitHub.

Contribution

Any contribution is highly appreciated. The best way to contribute code is to open a pull request on GitHub.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Fabian Blechschmidt} 💻	_{Rouven Alexander Rieker} 💻	_{Michael Ryvlin} 💻	_Carmen 💻	_{Jan Papenbrock} 💻	_Daniel 💻	_{Roman Hutterer} 💻
_{Peter Jaap Blaakmeer} 💻	_{Milan Davídek} 💻	_{michael-sauerwald} 💻	_dimajanzen 💻	_{Kevin Krieger} 📖