=== Broken Image Fallback ===
Contributors: nikunj8866
Tags: broken images, missing images, fallback, woocommerce, wordpress images
Requires at least: 5.6
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically replace broken or missing images with a custom fallback image. Works with WordPress and WooCommerce.

== Description ==

**Broken Image Fallback** is a lightweight WordPress plugin that automatically detects broken or missing images and replaces them with a default fallback image.

Whether you're **migrating a site**, moving WooCommerce products, or dealing with deleted/missing files, this plugin ensures your WordPress site always looks professional without broken image icons.

**Common Use Cases:**
* CDN outages or slow loading
* Deleted or moved image files  
* Third-party image sources going offline
* User-generated content with broken links
* Product images in WooCommerce stores
* **Site migrations (moving posts, products, or content from another site where images may no longer exist)**

**Key Features:**
* Automatic broken image detection and replacement
* No impact on page load speed (loads asynchronously after page is ready)
* Works with lazy loading plugins
* Simple admin interface for configuration
* Compatible with all WordPress themes and major plugins

**Who This Plugin Helps:**
* E-commerce stores with product catalogs
* News and media sites with many images  
* Business websites that need reliable image display
* Agencies managing multiple client sites
* Any WordPress site that loads external images
* **Website owners migrating content from one WordPress site to another**

= Free Features =
* **Basic Image Replacement** - Replace broken images with your chosen fallback image
* **Performance Optimized** - Loads asynchronously, no impact on page speed
* **Lazy Loading Compatible** - Works with popular lazy loading plugins
* **Simple Configuration** - Easy admin interface, upload fallback image via media library
* **Mobile Responsive** - Works on all devices and screen sizes

= Pro Features =
Upgrade to [Broken Image Fallback Pro](https://checkout.freemius.com/plugin/20451/plan/33980/licenses/1/) to unlock advanced functionality:  
* Advanced fallback methods (styled alt text, combination mode, hide broken images)
* WooCommerce integration (galleries, variations, cart thumbnails, catalog protection)
* WordPress integration (featured image fallback, Gutenberg compatibility, CPT support)
* Visual enhancements (fade-in animation, custom CSS, transitions)
* Priority email support and updates

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/broken-image-fallback/` or install via WordPress admin
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Navigate to the 'Image Fallback' menu in your WordPress admin
4. Upload your fallback image and configure settings
5. Save changes - your site is now protected from broken images

== Frequently Asked Questions ==

= Does this slow down my website? =

No. The plugin is designed to have zero impact on page load speed. The JavaScript loads asynchronously after your page content is fully loaded.

= Will it work with my theme and other plugins? =

Yes. The plugin is designed to work with all WordPress themes and is compatible with popular plugins including lazy loading, caching, and page builder plugins.

= Can I use my own fallback image? =

Yes. You can upload any image through the WordPress media library or enter a custom URL.

= Does it work with WooCommerce? =

The free version works with basic WooCommerce images. The Pro version includes enhanced WooCommerce support for product galleries, variations, and shopping features.

= What's the difference between the free and Pro versions? =

The free version provides basic broken image replacement. The Pro version adds advanced fallback methods, WooCommerce integration, WordPress-specific features, visual effects, and priority support.

= Can I use this plugin when migrating my site? =

Yes, it helps prevent broken images when moving posts, products, or content from another site.

= Do you offer a trial? =

We do not offer a free trial. However, all Pro purchases are backed by a 14-day refund policy if you encounter a bug or problem that cannot be resolved by our support team.

= How do I upgrade to Pro? =

You can upgrade to **Broken Image Fallback Pro** directly from the plugin's settings page in your WordPress dashboard or by visiting this link:  
[Upgrade to Pro](https://checkout.freemius.com/plugin/20451/plan/33980/licenses/1/)

After purchase, you will receive the Pro version in your email. Simply download it from the email and install it on your WordPress site to unlock the Pro features.

== Changelog ==

= 1.0.0 =
* Initial release
* Automatic broken image detection and replacement
* Performance-optimized asynchronous loading
* Admin configuration interface
* WooCommerce compatibility
* Lazy loading plugin compatibility
* Mobile responsive design

== Upgrade Notice ==

= 1.0.0 =
Initial release of Broken Image Fallback. Install to automatically handle broken images on your WordPress site.