Features

User Interface Features

Activity List

Layout:

• Sidebar list view
• Activity items with user avatars
• Action badges
• Relative timestamps
• Click to view details

Display Information:

• User avatar and name
• Action type badge
• Object type and ID
• Relative time (e.g., "2 hours ago")
• Visual indicators

Selection:

• Single selection
• Multiple selection
• Range selection (Shift+click)
• Select all visible

Activity Details Panel

Information Displayed:

• User information (avatar, name, email if permitted)
• Action details (type, object, timestamp)
• Before/after comparison
• Technical details (IP, user agent, metadata)

Change Comparison:

• Old values display
• New values display
• Side-by-side comparison
• Highlighted differences

Filtering System

Action Filter:

• Filter by action type
• Dropdown selection
• All actions option
• Specific action types

Object Type Filter:

• Filter by object type
• Post, user, comment, plugin, etc.
• All types option
• Multiple types support

User Filter:

• Filter by specific user
• User search/select
• All users option
• User avatar display

Date Range Filter:

• Date from picker
• Date to picker
• Calendar selection
• Range validation

Search:

• Full-text search
• Searches all fields
• Real-time results
• Case-insensitive

Sorting Options

Sort By:

• Date (created_at)
• User (user_id)
• Action (action)
• Object Type (object_type)

Sort Direction:

• Ascending (oldest first)
• Descending (newest first)
• Toggle functionality

Pagination

Features:

• Page navigation
• Items per page (default: 30)
• Total page count
• Item count display
• Previous/Next buttons

Tracked Actions Details

Post Actions

Created:

• Logs when new post/page created
• Stores title and status
• Includes post type metadata
• Skips auto-drafts and revisions

Updated:

• Logs content changes
• Logs title changes
• Logs status changes
• Only logs changed fields
• Skips if no changes

Deleted:

• Logs permanent deletion
• Stores title and status before deletion
• Includes post type metadata

Trashed:

• Logs move to trash
• Stores status change
• Includes post type metadata

Restored:

• Logs restore from trash
• Stores status change
• Includes post type metadata

User Actions

Created:

• Logs new user registration
• Stores username, email, display name
• Includes user metadata

Updated:

• Logs profile updates
• Logs email changes
• Logs display name changes
• Only logs changed fields

Deleted:

• Logs user deletion
• Stores user ID
• Minimal information (user already deleted)

Role Changed:

• Logs role changes
• Stores old and new roles
• Includes role change metadata

Comment Actions

Created:

• Logs new comment
• Stores author and status
• Includes post ID metadata

Updated:

• Logs comment content changes
• Truncates content to 100 chars
• Includes post ID metadata

Deleted:

• Logs comment deletion
• Stores author and post ID
• Includes post ID metadata

Status Changed:

• Logs status changes
• Stores old and new status
• Includes post ID metadata

Plugin Actions

Activated:

• Logs plugin activation
• Stores plugin file name
• Includes network-wide status

Deactivated:

• Logs plugin deactivation
• Stores plugin file name
• Includes network-wide status

Installed:

• Logs plugin installation
• Stores plugin identifier
• Includes installation metadata

Deleted:

• Logs plugin deletion
• Stores plugin file name
• Only logs if deletion successful

Settings Actions

Option Updated:

• Logs WordPress option updates
• Filters out spam options (cron, transients)
• Focuses on uiXpress and theme options
• Stores old and new values

Media Actions

Uploaded:

• Logs media upload
• Stores title, filename, MIME type
• Includes attachment metadata

Deleted:

• Logs media deletion
• Stores title and filename
• Includes attachment metadata

Authentication Actions

Login:

• Logs user login
• Stores username
• Includes user ID

Logout:

• Logs user logout
• Stores user ID
• Minimal information

Security Features Details

Data Sanitization

Sensitive Field Detection:

• Password fields
• API key fields
• Secret fields
• Token fields
• Private key fields

Redaction Process:

• Scans all data recursively
• Detects sensitive field names
• Replaces with [REDACTED]
• Preserves data structure

Access Control

Capability Checks:

• manage_options - Required to view logs
• list_users - Required to view user emails
• Automatic capability checking
• Error messages for unauthorized access

Privacy Features

Email Visibility:

• Only visible to users with list_users capability
• GDPR compliance
• Privacy-focused design
• Configurable visibility

IP Address Handling:

• Supports proxy headers
• Cloudflare support
• X-Forwarded-For support
• X-Real-IP support
• Validates IP addresses

Performance Features

Batch Insert System

Queue Management:

• Logs queued in memory
• Batch insert every 30 seconds
• Flush on WordPress shutdown
• Reduces database load

Benefits:

• Improved performance
• Reduced database connections
• Better scalability
• Lower server load

Database Optimization

Indexes:

• User ID index
• Action index
• Object type index
• Object ID index
• Timestamp index
• Composite indexes

Query Optimization:

• Efficient WHERE clauses
• Proper index usage
• Pagination support
• Optimized joins

Cleanup System

Automatic Cleanup:

• Scheduled daily cleanup
• Based on retention period
• Configurable toggle
• Efficient deletion queries

Manual Cleanup:

• API endpoint for manual cleanup
• Returns deleted count
• Useful for maintenance
• Immediate execution

Settings Configuration Details

Enable Activity Logger

Functionality:

• Toggle to enable/disable
• Creates database table when enabled
• Unschedules cron jobs when disabled
• No license required

Table Creation:

• Automatic on enable
• Checks if table exists
• Creates if needed
• Uses WordPress dbDelta

Retention Period

Configuration:

• Number input (1-365 days)
• Default: 90 days
• Used for automatic cleanup
• Manual cleanup also uses this

Use Cases:

• Compliance requirements
• Storage management
• Performance optimization
• Audit trail needs

Log Level

Options:

• All Actions: Log everything
• Important Only: Critical actions only

Important Actions:

• Deletions
• Trashing
• Restorations
• Activations
• Deactivations
• Installations
• Uninstallations
• Role changes
• Permission changes

Benefits of Important Only:

• Reduced database size
• Better performance
• Focus on critical actions
• Less log noise

Auto Cleanup

Functionality:

• Automatic deletion of old logs
• Based on retention period
• Scheduled daily
• Configurable toggle

Benefits:

• Prevents database bloat
• Automatic maintenance
• Storage optimization
• Performance improvement

API Features

REST API Endpoints

Get Logs:

• Pagination support
• Filtering support
• Search support
• Sorting support
• Enhanced user data

Get Single Log:

• Detailed log entry
• Enhanced user data
• Full metadata
• Error handling

Get Statistics:

• Total count
• Action breakdown
• Object type breakdown
• Top users
• Date range filtering

Manual Cleanup:

• Trigger cleanup manually
• Returns deleted count
• Success/error handling
• Useful for maintenance

Response Format

Standard Response:

• JSON format
• Enhanced user data
• Pagination headers
• Error handling

User Data Enhancement:

• User name
• User email (if permitted)
• User avatar
• User ID

Best Practices

Configuration

Recommended Settings:

• Enable for production sites
• Use "Important Only" for performance
• Set retention based on needs
• Enable auto cleanup

Monitoring

Regular Reviews:

• Check logs weekly
• Monitor for suspicious activity
• Review role changes
• Check plugin activations

Maintenance

Database Management:

• Monitor table size
• Run manual cleanup if needed
• Check index performance
• Optimize if necessary

Security

Security Monitoring:

• Review login/logout events
• Check IP addresses
• Monitor role changes
• Review deletions