=== 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.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Professional image optimization with WebP/AVIF conversion and industry-first FREE Unused Image Scanner. 100 lifetime optimizations included.

== Description ==

Transform your WordPress site's performance with **WBN Image Optimizer** - the only free plugin combining advanced image optimization with intelligent unused image detection.

= Why Choose WBN Image Optimizer =

**Industry-First Free Scanner**
Find and remove images consuming storage but not displayed anywhere on your site. No other free plugin offers this capability.

**Transparent Pricing**
100 lifetime optimizations - not 20/month that resets. No pressure tactics, no hidden costs. Simple and honest.

**Modern Format Support**
Convert images to WebP (60-70% smaller) or AVIF (up to 80% smaller) while maintaining visual quality that satisfies both users and search engines.

**Professional-Grade Safety**
Every optimization includes automatic backup. Restore any image to its original state with one click - zero risk to your content.

= Core Features =

**Unused Image Scanner**
Intelligent detection of images consuming storage without being displayed:
* Featured images and thumbnails
* WooCommerce product galleries and variations
* Gallery shortcodes and image blocks
* Post and page content
* Site icons, logos, and widgets
* Custom post types and ACF fields

**Smart Optimization Presets**
Four professionally-tuned configurations:
* **Products (1200×1600px)** - WooCommerce-optimized with detail preservation, WebP format, Quality 82
* **Banners (1920×1080px)** - Hero images with maximum AVIF compression, Quality 75
* **Gallery (1600×1600px)** - Balanced quality for photo galleries, WebP format, Quality 80
* **Thumbnails (400×400px)** - Crisp small images at minimal file size, WebP format, Quality 85

**Advanced Format Conversion**
* WebP with 95%+ browser support
* AVIF for cutting-edge compression (up to 80% reduction)
* Automatic fallbacks for older browsers
* Original format preservation option

**Enterprise-Level Safety**
* Automatic backup before every optimization
* One-click restore to original files
* Non-destructive processing
* No external API dependencies
* 100% on-server processing

**Flexible Control**
* Bulk operations for efficiency
* Manual dimension control (width/height)
* Quality slider (1-100)
* Multiple fit modes (cover/contain/fill)
* Per-image format selection

= Performance Impact =

Real-world results from WBN Image Optimizer users:
* 40-60% reduction in page load time
* 50-80% smaller image file sizes
* 30-50% savings on bandwidth costs
* Improved SEO rankings from faster pages
* Enhanced user experience with instant image loading

= Ideal For =

**E-Commerce Stores**
Optimize product photos without losing detail. The Products preset maintains zoom quality while cutting file size in half.

**Content Publishers**
Speed up article loads with optimized featured images and inline photos. Better engagement, lower bounce rates.

**Photographers & Creative Agencies**
Compress galleries without visible quality loss. Showcase work beautifully while keeping bandwidth costs down.

**Web Development Professionals**
Clean up client sites with the Scanner. Remove orphaned images from old designs and migrations.

**Everyone Else**
Faster sites rank better, convert better, and cost less to host. WBN Image Optimizer makes optimization accessible to all skill levels.

= Technical Excellence =

**Privacy & Security**
* No data collection or tracking
* No external API calls
* All processing on your server
* GPL licensed open source
* Full GDPR compliance

**Broad Compatibility**
* Works with any WordPress theme
* WooCommerce product images
* Multisite networks
* Page builders (Elementor, Beaver Builder, Divi)
* Advanced Custom Fields (ACF)
* WPML multilingual sites

**System Requirements**
* WordPress 5.0 or higher
* PHP 7.4+ (PHP 8.0+ recommended)
* GD or Imagick library
* Standard WordPress hosting

= Pro Version =

Scale your optimization with Pro features:

**Higher Quotas**
* 120 optimizations per month (vs 100 lifetime)
* 150 Scanner deletions per month
* Never worry about running out

**Multi-Site Licensing**
* Up to 3 sites on one license
* Centralized license management
* Transfer between sites anytime

**Enhanced Features**
* Bulk operations with progress tracking
* Advanced compression algorithms
* PDF optimization support
* Automated optimization on upload

**Priority Support**
* Direct developer access
* Same-day response times
* Phone and video call support
* Custom feature requests

**Agency Features**
* White-label options
* Client reporting tools
* Bulk license packages
* Reseller opportunities

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

= Resources =

* [Complete Documentation](https://webnest.co.il/docs/wbn-image-optimizer/)
* [Video Tutorials](https://webnest.co.il/tutorials/)
* [Support Forum](https://wordpress.org/support/plugin/wbn-image-optimizer-lite/)
* [Feature Requests](https://webnest.co.il/feature-requests/)

== 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 differentiators:
1. **Unique Scanner** - Only free plugin with unused image detection
2. **Honest Quota** - 100 lifetime optimizations, not deceptive monthly resets
3. **Modern Formats** - Both WebP and AVIF support in free version

Most competitors charge for the Scanner, limit format options, or use misleading quota systems.

= 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** - Developed by Google, 95%+ browser support. Typically 60-70% smaller than JPEG with equivalent visual quality. Safe choice for all sites.

**AVIF** - Next-generation format with up to 80% size reduction. Browser support currently ~85% and growing. WordPress automatically provides fallbacks for older browsers.

**Recommendation**: Use WebP for maximum compatibility, AVIF for maximum compression. Both are safe - WordPress handles unsupported browsers automatically.

= How does the Unused Image Scanner work? =

The Scanner performs comprehensive analysis of your Media Library against site content:

**Detection Methods**
* Database queries for featured image assignments
* WooCommerce product gallery attachments
* Gallery shortcodes and image block references
* Post and page content image URLs
* Site icon and custom logo settings
* Widget image assignments
* Theme customizer images

**Safety Features**
The Scanner never deletes automatically. You review all results and manually select which images to remove. 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. The plugin integrates directly with WordPress's native Media Library. Compatible with all themes and confirmed working with:
* WooCommerce and variations
* Elementor, Beaver Builder, Divi
* Advanced Custom Fields (ACF)
* WPML and multilingual sites
* WP All Import
* Multisite networks

= Does this work with WooCommerce? =

Absolutely. The **Products (1200×1600)** preset is specifically tuned for WooCommerce product images, maintaining detail for zoom functionality while optimizing file size. Store owners typically see 40-60% faster product page loads.

= What happens when I reach 100 optimizations? =

You've used your lifetime allocation. Three options:
1. **Continue using Scanner** - Unlimited and always free
2. **Optimize manually** with other tools
3. **Upgrade to Pro** for 120/month

The plugin continues working normally. The Scanner remains fully functional forever.

= 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 occurs in the admin dashboard, not on the frontend. Visitors never wait for processing.

**Visitor Experience**
* 40-60% faster page loads
* Instant image rendering
* Lower bandwidth consumption
* Better mobile performance

**Admin Experience**
* Brief processing time during optimization
* Zero frontend impact

= What are the system requirements? =

**Minimum**
* PHP 7.4 or higher
* WordPress 5.0+
* GD or Imagick image library

**Recommended**
* PHP 8.0+ for optimal performance
* Modern hosting (SiteGround, WP Engine, Kinsta)
* 128MB+ PHP memory limit for bulk operations

Works on shared hosting, VPS, and dedicated servers. No special configuration required.

= Is this compatible with WordPress Multisite? =

Yes. Each site receives independent quota:
* 100 lifetime optimizations per site
* Separate Scanner per Media Library
* Network admin monitoring
* Individual site admin control

= 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 Version**
* [Support Forum](https://wordpress.org/support/plugin/wbn-image-optimizer-lite/)
* [Documentation](https://webnest.co.il/docs/)
* [Video Tutorials](https://webnest.co.il/tutorials/)

**Pro Version**
* Direct email support (same-day response)
* Priority ticket system
* Phone and video call support
* Dedicated account manager (Agency plans)

== 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.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**

`// Before optimization
do_action('wbio_lite_before_optimize', $image_id);

// After optimization
do_action('wbio_lite_after_optimize', $image_id, $result);

// Before deletion
do_action('wbio_lite_before_delete', $image_ids);

// After deletion
do_action('wbio_lite_after_delete', $image_ids, $count);`

**Filter Hooks**

`// Modify settings
apply_filters('wbio_lite_optimization_settings', $settings);

// Custom Scanner logic
apply_filters('wbio_lite_scanner_check_usage', $is_used, $image_id);

// Alter backup directory
apply_filters('wbio_lite_backup_directory', $directory);`

**WP-CLI Commands**

`# Optimize all images
wp wbio optimize --all

# Run Scanner
wp wbio scan

# Restore image
wp wbio restore <image-id>

# Check quota
wp wbio quota`

= For Agencies =

**White-Label Customization**
Available in Pro - replace branding with your agency details.

**Client Reporting**
Generate PDF reports showing optimization results and performance improvements.

**Bulk Licensing**
Discounted rates for multiple client sites.

Contact hello@webnest.co.il for partnership opportunities.

== Privacy & Compliance ==

**What We Do NOT Collect**
* Personal information
* Email addresses (except support requests)
* Usage analytics or statistics
* Site visitor data
* Image content or metadata

**What We Do**
* Process images locally on your server
* Store backups in WordPress uploads folder
* Use WordPress nonce system for security
* Keep all data within your installation

**Third-Party Services**
None. Zero external API calls. All processing on your server.

**GDPR Compliance**
Fully compliant - no personal data collected or transmitted.

== Credits ==

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

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

Developed in Israel