uiXpress
Activity Logger

Features

Detailed documentation of all activity logger features and capabilities.

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