=== TR Pixel Engine – Image Optimization | WebP Conversion ===
Contributors: taqadasurrehman
Tags: webp, optimization, image compression, speed, performance
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Boost site speed by automatically converting images to WebP. Features a unique visual comparison dashboard and bulk optimizer.

== Description ==

TR Pixel Engine – Image Optimization | WebP Conversion is the ultimate lightweight solution for modernizing your WordPress media library. It automatically converts your JPEG and PNG images to the next-gen **WebP** format, which is smaller, faster, and supported by all modern browsers.

Start connecting with the author:
*   [LinkedIn](https://www.linkedin.com/in/taqadasurrehman/)
*   [Facebook](https://www.facebook.com/taqadas.urrehman)

This is not just another converter; it features a **Visual Comparison Dashboard** that lets you see the quality difference in real-time, ensuring you get the best performance without sacrificing aesthetics.

### Why You Need This Plugin?
Images often account for the bulk of downloaded bytes on a web page. By optimizing images, you can:
*   **Improve Page Load Speed:** Faster sites rank better on Google.
*   **Boost SEO:** WebP is a Google-recommended format for Core Web Vitals.
*   **Save Bandwidth & Storage:** Smaller files mean less data usage.
*   **Enhance User Experience:** Nobody likes waiting for images to load.

### main Features

#### Visual Quality Comparison (Unique!)
Not sure if compression will ruin your images? Our exclusive **Before/After Slider** lets you visually compare the original image against the optimized WebP version directly in your dashboard. Prove to yourself that quality is maintained!

#### Automatic Conversion on Upload
Forget manual work. The plugin hooks into the WordPress upload process and automatically converts every new image to WebP instantly.

#### Bulk Optimizer
Have thousands of existing images? Our robust **Bulk Converter** processes your entire library in the background. It features a real-time progress bar, skip logic for already optimized files, and error reporting.

#### Modern & Adaptive Dashboard
We believe admin tools should be beautiful. The plugin features a **Pro UI** built with:
*   **Data-at-a-glance:** See total images, converted count, and storage savings instantly.
*   **Donut Charts:** Visual representation of your library's optimization status.
*   **Toast Notifications:** Non-intrusive alerts for successful operations.
*   **Responsive Design:** Fully functional on mobile and tablet devices.

#### Smart & Custom Settings
*   **Smart Auto Quality:** Automatically applies the best compression ratio (82% for JPEG, 80% for PNG) for the perfect balance of size and quality.
*   **Custom Control:** Want more aggressive compression? Use the slider to set your custom quality (1-100).
*   **Safe Mode (Default):** Keeps your original images safe.
*   **Forced Cleanup:** Option to automatically delete original files to save server space (use with caution!).

#### Compatibility & Tech
*   **Dual Engine Support:** Works with both **Imagick** and **GD** libraries. The plugin automatically detects the best available driver on your server.
*   **Zero Configuration:** Install, activate, and it works. No complex API keys or cloud server registrations required.

== Installation ==

1.  **Upload:** Upload the `tr-pixel-engine` folder to the `/wp-content/plugins/` directory.
2.  **Activate:** Activate the plugin through the 'Plugins' menu in WordPress.
3.  **Check:** Go to the **Auto WebP** menu to view your dashboard.
4.  **Optimize:**
    *   For existing images, click **Start Bulk Conversion** on the dashboard.
    *   For new images, simply upload them to your Media Library as usual.

== Frequently Asked Questions ==

= Will this break my site? =
No. WebP is supported by all modern browsers (Chrome, Firefox, Safari, Edge). The plugin generates standard WebP files that replace your heavy JPEGs/PNGs.

= Does it delete my original images? =
**By default, NO.** Your original JPEG and PNG files remain untouched as a backup.
*   If you want to save server space, you can enable the **"Delete original images"** option in the Settings tab. **Warning:** This action is irreversible.

= How do I revert changes? =
If you kept the original images (default setting), simply deactivate the plugin. To remove the WebP files, you may need to regenerate thumbnails using a "Regenerate Thumbnails" plugin, which will restore the usage of your original JPEGs/PNGs.

= What if my server doesn't support WebP? =
The plugin includes a built-in check. If your server is missing the necessary PHP modules (Imagick or GD with WebP support), a warning will appear on the dashboard. Contact your hosting provider to enable them.

= Can I choose which images to convert? =
Currently, the plugin operates globally on the Media Library. You can filter by file type (JPEG vs PNG) in the dashboard to see what's taking up space.

== Screenshots ==

1.  **Dashboard Overview:** View detailed stats, optimization score, and the unique Visual Comparison Slider.
2.  **Settings Panel:** Configure quality, batch size, and file deletion preferences.
3.  **Bulk Process:** Watch the real-time progress bar as your library is optimized.

== Changelog ==

= 1.0.0 =
*   **Initial release.**
*   Added automatic WebP conversion on upload.
*   Added bulk optimizer for existing media library.
*   Introduced "Visual Comparison Slider" for quality assurance.
*   Implemented "Smart Auto" and "Custom Manual" quality modes.
*   Designed a modern, responsive admin dashboard with toast notifications.