=== Sentinel - WordPress Activity Logger ===
Contributors: jpsnt
Tags: logging, monitoring, security, activity, audit, tracking
Requires at least: 5.0
Tested up to: 6.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sentinel is a comprehensive activity logger for WordPress that goes beyond basic logging. Track user actions, detect security incidents, monitor system performance, and view detailed reports—all without hitting a paywall.

== Description ==

Sentinel is a powerful WordPress activity logging and monitoring plugin designed to provide comprehensive visibility into your website's activities. Whether you're running a community site, e-commerce platform, or corporate website, Sentinel helps you track, monitor, and analyze user actions and system events.

== Key Features ==

* Comprehensive logging – Track user logins, content changes, admin actions, and system events
* Real-time monitoring – View events as they happen with detailed data
* Security focus – Detect suspicious activities, failed login attempts, and system changes
* Performance optimized – Efficient batch processing and automatic cleanup
* Developer friendly – Easy API for extending functionality
* Admin interface – Clean, intuitive UI for reviewing logs
* Export capabilities – Download logs for compliance or analysis
* Customizable – Control event types and log retention policies

== Use Cases ==

* Community sites – Monitor user engagement, moderation actions, and profile changes
* E-commerce – Track order updates, inventory edits, and customer account changes
* Corporate sites – Maintain audit trails for compliance and internal oversight
* Multi-author blogs – View editorial activity, publishing logs, and content revisions
* Security monitoring – Detect brute force attempts, privilege escalations, and plugin changes

== Technical Features ==

* WordPress coding standards compliant
* Hooks and filters for extensibility
* Optimized database queries with proper indexing
* Automatic log rotation and cleanup
* REST API support for external integrations
* Multisite compatible

== Installation ==

1. Upload the `sentinel` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure the plugin settings in the 'Sentinel' admin menu
4. Start monitoring your site's activities

== Frequently Asked Questions ==

= What events does Sentinel log by default? =

Sentinel logs a wide range of events including:
- User authentication (login, logout, failed attempts)
- Content creation, editing, and deletion
- Admin actions and system changes
- Plugin and theme activations
- Media uploads and changes
- Custom events via API

= How does Sentinel handle performance? =

Sentinel is designed with performance in mind:
- Batch processing for high-volume events
- Efficient database queries with proper indexing
- Automatic cleanup of old logs
- Configurable retention policies
- Minimal impact on site performance

= Can I add custom events? =

Custom event registration is available in Sentinel Pro.

= Is Sentinel compatible with multisite? =

Yes, Sentinel is fully compatible with WordPress multisite installations and can be network-activated.

== Screenshots ==

1. Main admin dashboard showing recent activities
2. Detailed log viewer with filtering options
3. Settings page for configuration
4. Export functionality for external analysis

== Changelog ==

= 1.0.0 =
* Initial release
* Core logging functionality
* Admin interface
* Event registry system
* Hook integration
* Cleanup and maintenance features
