=== Stintlief WebP Converter ===
Contributors: stintlief
Donate link: https://buymeacoffee.com/stintlief
Tags: webp, images, performance, optimization, converter
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically convert uploaded images to optimized WebP format with safe fallbacks, optional backups, and easy restoration.

== Description ==

Stintlief WebP Converter automatically converts uploaded JPEG, PNG, and GIF images to the modern WebP format, providing significant file size reductions while maintaining visual quality. The plugin includes smart features to ensure safety and reversibility.

= Key Features =

* **Automatic Conversion**: Converts images to WebP on upload without manual intervention
* **Smart Size Comparison**: Only keeps WebP if it's smaller than the original (configurable)
* **Safe Backups**: Optional automatic backup of original files for easy restoration
* **One-Click Restore**: Restore original images from attachment edit screen
* **Animated GIF Protection**: Automatically skips animated GIFs to preserve animation
* **Configurable Settings**: Control max dimensions, compression quality, and behavior
* **No External Services**: All processing happens on your server - no data sent elsewhere
* **Performance Boost**: WebP images are typically 25-35% smaller than JPEG/PNG

= Privacy & Data Handling =

This plugin does not:
* Send any data to external servers
* Store personal user information
* Track users or create logs (except standard WordPress debug logs when WP_DEBUG is enabled)
* Use cookies or external APIs

Backup files (if enabled) are stored locally on your server in the uploads directory and are not publicly exposed unless explicitly accessed.

= Supported Image Formats =

* JPEG (.jpg, .jpeg)
* PNG (.png)
* GIF (.gif) - static only, animated GIFs are preserved
* HEIC/HEIF (if server supports)

= Requirements =

Your server must have one of the following:
* Imagick extension with WebP support
* GD extension with WebP support

The plugin will display a notice if WebP support is not available.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/stintlief-webp-converter/`, or install through WordPress plugins screen
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to Settings → Media to configure conversion options
4. Enable "Convert uploaded images to WebP" checkbox
5. Adjust settings as needed (defaults are recommended)
6. Upload images and they will automatically convert

== Frequently Asked Questions ==

= Will this plugin convert my existing images? =

Currently, the plugin only converts images as they are uploaded. Bulk conversion of existing media library images will be added in a future version.

= What happens if WebP is larger than the original? =

By default, the plugin keeps the original file if the WebP version is larger. You can force WebP conversion regardless of size using the "Force WebP" option (not recommended).

= Can I restore the original image after conversion? =

Yes! If you enabled "Keep a backup" (enabled by default), you can restore the original from the attachment edit screen using the "Restore original file" button.

= Will this affect my site's images in posts and pages? =

WordPress automatically uses the converted WebP files. If you restore an original, WordPress will regenerate thumbnails and update references.

= What about browser compatibility? =

Modern browsers (Chrome, Firefox, Edge, Safari 14+) support WebP. Older browsers fall back to WordPress's standard image handling. The plugin doesn't modify HTML markup.

= Does this work with other optimization plugins? =

Yes, this plugin focuses only on WebP conversion and works alongside caching and CDN plugins. Apply this plugin's conversion first, then use other optimization tools.

= Are animated GIFs supported? =

Animated GIFs are automatically detected and skipped to preserve their animation. They will not be converted to static WebP images.

= Where are backups stored? =

Backups are stored in the same directory as the original file with `.stwp-backup` added to the filename. For example: `image.stwp-backup.jpg`

= What happens when I uninstall the plugin? =

Settings are removed, but converted images and backups remain on your server. This prevents accidental data loss. You can manually remove backup files if desired.

== Screenshots ==

1. Settings page in Media settings showing all configuration options
2. Restore button on attachment edit screen for converted WebP images
3. Admin notice showing plugin status and WebP support detection

== Changelog ==
= 1.1.0 - 2026-01-02 =
* Added option to force WebP conversion regardless of size
* Improved backup file naming for better clarity
* Minor bug fixes and performance improvements

= 1.0.0 - 2025-12-26 =
* Initial release
* Automatic WebP conversion on image upload
* Smart size comparison with fallback to original
* Optional backup and restoration system
* Animated GIF detection and preservation
* Configurable dimensions and quality settings
* WebP support detection and admin notices
* Full internationalization support

== Upgrade Notice ==

= 1.0.0 =
Initial release of Stintlief WebP Converter. Enjoy automatic WebP conversion with safe backups!

== Privacy Policy ==

This plugin does not collect, store, or transmit any personal data. All image processing happens locally on your WordPress server. Backup files (if enabled) are stored in your uploads directory and are not shared or transmitted to external services.

If you have privacy requirements, you can disable the backup feature in Settings → Media.

== Credits ==

Developed by Stintlief Technologies with a focus on performance, safety, and WordPress best practices.
