=== LiKoToN Debug Logs ===
Contributors: likoton
Tags: logs, debug, developer, tools, php
Requires at least: 6.0
Tested up to: 7.1
Stable tag: 1.2.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0-standalone.html

A lightweight debugging plugin that collects PHP, WordPress, REST API and login logs with filters, dark mode, infinite scroll and CSV export.

== Description ==

LiKoToN Debug Logs is a lightweight, modern debugging plugin for WordPress that automatically collects:

- PHP errors and warnings  
- WordPress errors (`wp_error_added`)  
- REST API requests (route, method, params)  
- User login events  
- Custom logs via `Likoton_Debug_Logs_Logger::log()`  

It includes a clean log viewer with:

- AJAX live filtering  
- Infinite scroll  
- Client-side sorting  
- Search, level, source and time filters  
- Color-coded badges  
- Dark mode  
- CSV export (with UTC and local timestamps)  
- Automatic cleanup based on retention settings  

Perfect for developers, administrators and anyone who needs a clear view of what happens inside WordPress.

---

## Features

### Log Collection
- PHP errors & warnings  
- WordPress errors (`wp_error_added`)  
- REST API requests (route, method, params)  
- User login events  
- Custom logs via `Likoton_Debug_Logs_Logger::log()`  

### Logs Viewer
- AJAX live filtering  
- Infinite scroll  
- Search, level, source, time 
- Client-side sorting  
- Color-coded badges  
- Responsive table  

### Dark Mode
- WordPress 7-style toggle  
- Applies to all plugin pages  

### Settings
- Dark mode  
- Log retention (30m → 1 month)  
- Capability required to view logs  
- Auto-save via AJAX with toast notification  
- Selectable log levels (only enabled levels are shown in the viewer)  

### Automatic Cleanup
- WP-Cron based  
- Configurable retention  
- Table optimization  

### Export
- Export all logs to CSV  
- Includes `created_at_utc` and `created_at_local`  
- Secured with nonce & capability check  

---

## Installation

### From WordPress Dashboard
1. Upload the plugin ZIP  
2. Activate **LiKoToN Debug Logs**  
3. Go to **LiKoToN Debug Logs → Logs**

### Manual Installation
1. Upload folder `likoton-debug-logs` to `/wp-content/plugins/`  
2. Activate plugin  
3. Logs appear in the main admin menu  

---

## Supported log levels (PSR-3 + extended PHP levels):

- debug,
- info,
- notice,
- warning,
- error,
- critical,
- alert,
- emergency,
- deprecated,
- user_deprecated,
- strict,
- parse,
- core_error,
- core_warning,
- compile_error,
- compile_warning,
- recoverable_error,
- user_error,
- user_warning,
- user_notice

## FAQ

**Does this slow down my site?**

No, logs are stored in a dedicated table and inserted efficiently.

**Can I export logs?**

Yes, via the Export logs (CSV) button.

**Can I restrict access?**

Yes, choose the required capability in Settings.

**Multisite support?**

Yes, each site has its own logs table.

== Screenshots ==

1. Logs tab
2. Logs tab in dark mode
3. Settings in dark mode

## Changelog ##

1.2.0
- A date range selection filter has been added

1.1.0
- Persistent table sort order
- Per-level colors in the Log Levels settings control
- Configurable source badge colors via REST API

1.0.0
- Initial release
- PHP/WP/REST/login logging
- AJAX filters
- Infinite scroll
- Dark mode
- CSV export (UTC + local time)
- Automatic cleanup
- Capability control
- Selectable log levels