=== WBN Image Optimizer - WebP, AVIF & Scanner ===
Contributors: webnest
Donate link: https://webnest.co.il/
Tags: image optimization, webp, avif, compress images, image scanner
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.1.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Optimize images with WebP/AVIF conversion, resize, and compression. 100 free optimizations included.

== Description ==

Optimize images with WebP/AVIF conversion, resize, and compression. Includes unused image scanner and automatic backups. 100 free optimizations included.

**Key Features:**
* WebP/AVIF conversion (60-80% smaller files)
* Smart presets for products, banners, galleries, thumbnails
* Unused image scanner to free storage space
* Automatic backups with one-click restore
* Bulk operations with progress tracking
* Quality control and resize options

**Why Choose This Plugin:**
* 100 lifetime optimizations (not monthly resets)
* Free scanner included (most competitors charge)
* Modern formats (WebP & AVIF)
* All processing on your server (privacy-first)
* Works with WooCommerce, page builders, and all themes

**Pro Version:**
Upgrade for 120 optimizations/month, multi-site licensing, priority support, and advanced features. [Learn more →](https://webnest.co.il/product/wbn-image-optimizer-pro/)

== Installation ==

= Automatic Installation =

1. Navigate to **Plugins > Add New** in WordPress admin
2. Search for "WBN Image Optimizer"
3. Click **Install Now** on the WBN Image Optimizer plugin
4. Click **Activate** once installation completes
5. Access via **Image Optimizer** in your admin sidebar

= Manual Installation =

1. Download the plugin ZIP file
2. Navigate to **Plugins > Add New > Upload Plugin**
3. Choose the downloaded ZIP file
4. Click **Install Now**
5. Click **Activate Plugin**

= Quick Start Guide =

**Optimize Your First Images**
1. Go to **Image Optimizer > Optimize**
2. Click **Select Images** from Media Library
3. Choose images to optimize
4. Select a Smart Preset or customize manually
5. Click **Optimize Selected Images**
6. Done - automatic backups created

**Scan for Unused Images**
1. Go to **Image Optimizer > Scanner**
2. Click **Scan for Unused Images**
3. Review results with thumbnails
4. Select images to remove
5. Click **Delete Selected**
6. Confirm deletion
7. Storage space freed

== Frequently Asked Questions ==

= Is this plugin truly free? =

Yes. You receive 100 lifetime optimizations plus unlimited Scanner usage - completely free, forever. No credit card required, no trial period. The Pro version exists for users needing higher monthly quotas or multi-site licensing.

= How is this different from other image optimizers? =

Three key differences:
1. **Free Scanner** - Only free plugin with unused image detection
2. **Lifetime Quota** - 100 optimizations forever, not monthly resets
3. **Modern Formats** - Both WebP and AVIF in free version

= Are my original images safe? =

Completely safe. Every optimization creates an automatic backup before processing. You can restore any image to its exact original state with one click from the Media Library. Zero risk to your content.

= What is the difference between WebP and AVIF? =

**WebP** - 95%+ browser support, 60-70% smaller files. Best for compatibility.

**AVIF** - Up to 80% size reduction, ~85% browser support. Best for maximum compression.

WordPress automatically provides fallbacks for older browsers with both formats.

= How does the Unused Image Scanner work? =

Scans your Media Library and finds images not used anywhere on your site (posts, pages, WooCommerce, galleries, widgets, etc.). You review results and manually delete. All deletions include automatic backups.

= Can I optimize previously uploaded images? =

Yes. WBN Image Optimizer works with all Media Library images regardless of upload date. Perfect for existing sites with thousands of legacy images.

= Will this work with my theme? =

Yes. Works with all WordPress themes, WooCommerce, page builders (Elementor, Beaver Builder, Divi), ACF, WPML, and multisite networks.

= Does this work with WooCommerce? =

Yes. The Products preset (1200×1600px) is optimized for WooCommerce, maintaining zoom quality while reducing file size by 50-70%.

= What happens when I reach 100 optimizations? =

The Scanner remains free forever. For more optimizations, upgrade to Pro (120/month) or use other tools. The plugin continues working normally.

= Can I restore images after optimization? =

Yes, instantly. Every optimized image has a "Restore Original" button in Media Library. One click restores the exact original file - dimensions, quality, format, metadata. Backups are permanent unless manually deleted.

= Will optimization slow down my site? =

No. Optimization happens in admin only. Visitors see 40-60% faster page loads with optimized images. Zero frontend impact.

= What are the system requirements? =

WordPress 5.0+, PHP 7.4+ (PHP 8.0+ recommended), GD or Imagick library. Works on all hosting types - no special configuration needed.

= Is this compatible with WordPress Multisite? =

Yes. Each site gets 100 lifetime optimizations and its own Scanner. Works independently per site.

= How do I upgrade to Pro? =

Visit [webnest.co.il/product/wbn-image-optimizer-pro/](https://webnest.co.il/product/wbn-image-optimizer-pro/)

After purchase, you receive a license key via email. Enter it in **Image Optimizer > Settings** and click "Activate License". Pro features unlock immediately with no data loss.

= Do you offer refunds? =

Yes. 30-day money-back guarantee on all Pro plans. Contact us within 30 days for a full refund, no questions asked.

= Where can I get support? =

Free: [Support Forum](https://wordpress.org/support/plugin/wbn-image-optimizer-lite/) | [Documentation](https://webnest.co.il/docs/)

Pro: Direct email (same-day response), priority tickets, phone/video support

== Screenshots ==

1. Dashboard overview with statistics and quota tracking
2. Optimization interface with Smart Presets
3. Unused Image Scanner with grid view
4. Manual controls for advanced users
5. Bulk operations with progress tracking

== Changelog ==

= 2.1.7 - January 27, 2026 =
* Added: Enhanced progress bar with real-time statistics (processed, success, failed, remaining, bytes saved, success rate)
* Added: Help tooltips for Quality, Output Format, and Resize Mode settings
* Improved: Visual feedback during optimization with detailed stats grid
* Improved: Progress statistics auto-hide after completion
* Fixed: All UI text converted to English (was mixed Hebrew/English)
* Fixed: Scanner colors changed from green to WordPress blue
* Fixed: Optimize button now works with both form submission and direct click
* Fixed: Image selection reading from hidden input field
* Improved: Scanner logic - added checks for Gutenberg blocks, ACF fields, widget images, and image URLs in content
* Improved: Gallery layout - grid with 180px min-width and 20px gap

= 2.1.5 - January 27, 2026 =
* Fixed: Critical bug - optimize_single() method visibility changed to public
* Fixed: Missing quota tracking options in activation hook
* Fixed: Missing cache invalidation hooks for media library changes
* Added: Adaptive quality optimization - automatically reduces quality if file isn't smaller
* Added: Advanced batch processing with timeout handling (60s for optimize, 120s for scan)
* Added: Retry logic for failed operations (up to 2 retries)
* Added: Pause/Resume functionality for batch operations
* Added: Scanner caching system (1 hour TTL) for improved performance
* Improved: Enhanced error handling with WP_Error objects in backup/restore
* Improved: Better error messages and user feedback in AJAX responses
* Improved: Security enhancements - input validation and sanitization
* Improved: Backup/restore reliability with verification checks
* Improved: Quota exceeded handling with clear upsell messaging
* Improved: Scanner UI with better visual feedback and statistics

= 2.1.4 - December 26, 2024 =
* Fixed: Tags reduced to 5 as per WordPress.org requirements
* Fixed: Removed duplicate tags, combined to single 'image scanner' tag
* Improved: Cleaner readme without emoji characters


= 2.1.3 - December 23, 2024 =
* Fixed: Scanner fully functional with working AJAX handlers
* Fixed: Scanner interface displays correctly
* Fixed: Delete and Deselect buttons appear after scan
* Fixed: All upgrade URLs corrected
* Fixed: Tags reduced to 5 per WordPress requirements
* Improved: Enhanced error handling in AJAX responses
* Improved: Better user feedback during operations

= 2.1.2 - December 23, 2024 =
* Changed: 100 lifetime optimizations (from 20/month)
* Added: Unused Image Scanner in Lite version
* Fixed: Critical bug with incorrect class name
* Fixed: Corrected meta key prefixes
* Improved: Lifetime quota management system
* Improved: Clearer upgrade messaging
* Updated: Documentation for new features

= 2.1.1 - December 15, 2024 =
* Fixed: PHP syntax errors in optimization functions
* Fixed: JavaScript AJAX functionality
* Fixed: Nonce verification issues
* Fixed: Dashboard statistics display
* Improved: Code consistency and naming
* Improved: Error handling and logging
* Added: WordPress 6.4+ support

= 2.1.0 - December 10, 2024 =
* Added: WebP conversion support
* Added: AVIF conversion support
* Added: Four Smart Presets
* Added: Automatic backup system
* Added: Bulk operations
* Added: Manual control panel
* Improved: Modern admin interface
* Improved: Media Library integration

= 2.0.0 - December 1, 2024 =
* Complete rewrite with modern architecture
* Added: Professional admin dashboard
* Added: Real-time progress tracking
* Improved: Performance and reliability
* Improved: User experience

= 1.0.0 - November 15, 2024 =
* Initial release
* Basic image optimization
* WebP conversion
* Simple admin interface

== Upgrade Notice ==

= 2.1.3 =
Scanner fully operational with critical AJAX fixes. All features working perfectly. Recommended upgrade for all users.

= 2.1.2 =
Major update: 100 lifetime optimizations and Scanner now in Lite version. Highly recommended upgrade.

= 2.1.1 =
Critical bug fixes for AJAX and PHP errors. Update immediately if experiencing issues.

== Advanced Usage ==

**For Developers:**
Action hooks: `wbio_lite_before_optimize`, `wbio_lite_after_optimize`, `wbio_lite_before_delete`, `wbio_lite_after_delete`
Filter hooks: `wbio_lite_optimization_settings`, `wbio_lite_scanner_check_usage`, `wbio_lite_backup_directory`
WP-CLI: `wp wbio optimize --all`, `wp wbio scan`, `wp wbio restore <id>`, `wp wbio quota`

**For Agencies:**
Pro version includes white-label options, client reporting, and bulk licensing. Contact hello@webnest.co.il for partnerships.

== Privacy & Compliance ==

**Privacy-First:**
* No data collection or tracking
* No external API calls
* All processing on your server
* Backups stored locally
* Full GDPR compliance

== Credits ==

Developed by [WebNest](https://webnest.co.il/)
License: GPLv2 or later

Built with WordPress Media Library APIs, GD/Imagick processing, and modern PHP standards.

Developed in Israel