Professional module for PrestaShop store administrators

This module is designed for professional store administrators who want to have a complete overview of the history of changes to all settings and fields in the PrestaShop store admin panel.

The module complements the standard PrestaShop log with ultra-precise information about all actions performed, including information about the values before and after saving all the values that can be changed in the store's admin panel.

The module handles huge amounts of data and efficiently saves them in a 4-level fallback system: Redis → Memory → RAM → File

Features

• 4-level fallback system: Redis → Memory → RAM → File
• Logging of administrative actions: adding, editing, deleting objects
• API action logging: identify API keys
• Admin interface: view and filter logs
• Automatic migration: cron scripts to process logs
• Efficiency: minimal impact on store performance

Automatic logging

• Objects: Product, Category, Order, Customer, etc.
• Modules: installation/uninstallation
• Configuration: changes to store settings
• API: calls with key identification

Logging architecture

If any system is disabled or unavailable, the module will automatically jump to the next level.

1. Redis (highest performance, recommended)
   • RPUSH of logs to the activity_log queue
   • Asynchronous processing by cron
2. MySQL Memory Table (high performance)
   • Ps_activity_log_buffer table (ENGINE=MEMORY)
   • Fast RAM operations
3. In-memory Buffer (medium performance)
   • PHP table in memory throughout the request
   • Flush at the end of execution(shutdown)
4. NDJSON (fallback) file
   • Writing to var/logs/activity_fallback.ndjson
   • Migration by cron to database

Log structure

{ "action": "create|update|delete|config|install|uninstall", "object_type": "Product", "object_id": 123, "employee_id": 1, "api_key": "Bearer xyz...", "context": "{ "controller": "AdminProducts", "object_name": "Test Product", "product_reference": "REF123", "product_active": "1", "changed_fields": "update_detected", "update_timestamp": "2024-01-01 12:00:00", "ip_address": "192.168.1.1", "user_agent": "Mozilla/5.0..." }", "created_at": "2024-01-01 12:00:00" }

Extended context for different objects

• Product: product_reference, product_active
• Category: category_active, parent_category
• Order: order_state, order_total
• Customer: customer_email, customer_active
• Module: module_name, module_version, module_author, module_display_name

Tracking Changes Before/After

The module automatically tracks changes at the field level using Before/After hooks:

• Hooks Before: hookActionObjectUpdateBefore, hookActionObjectDeleteBefore
• Hooks After: hookActionObjectUpdateAfter, hookActionObjectDeleteAfter
• ObjectModel definitions: uses $definition['fields'] for precise tracking
• Change detection: Compares values before and after modification

Example of field changes context:

{ "field_changes": { "name": { "from": "old product name", "to": "New Product Name" }, "price": { "from": 19.99, "to": 29.99 }, "active": { "from": 0, "to": 1 } } }

cd modules/pshowlogger vendor/bin/phpunit