=== SmoothPreview ===
Contributors: sarfaraz23
Tags: placeholder, skeleton loader, dominant color, lazy load, woocommerce
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Zero-delay adaptive dominant color placeholders and 5-directional shimmer skeleton loading effects for WordPress & WooCommerce.

== Description ==

**SmoothPreview** brings modern app-style loading placeholders to your WordPress and WooCommerce media galleries.

Instead of displaying blank white boxes or causing sudden vertical jumps while images download, SmoothPreview calculates the photo's exact dominant RGB color and locks image aspect ratio server-side to guarantee **0 Cumulative Layout Shift (0 CLS)**.

= Key Features =
* 🎨 **Adaptive Dominant Color Extraction**: Instantly samples photo colors in less than 1 millisecond.
* ⬛ **Classic Light Grey Skeleton Box**: Clean minimal loading placeholder mode.
* ✨ **5 Shimmer Motion Directions**: Horizontal (LTR/RTL), Vertical (TTB/BTT), and Diagonal wave flashes.
* 📐 **0 Layout Shift (CLS Prevention)**: Hard-locks image container aspect ratios.
* 🛡️ **Admin Workflow Bypass**: Automatically bypasses preview effects while editing pages in WP Admin.
* 🌙 **Auto Dark Mode**: Detects visitor dark mode preferences automatically.
* ⚡ **Ultra Lightweight**: Zero external library dependencies, 100% PHP & CSS native.

== Installation ==

1. Upload the `smooth-preview` directory to `/wp-content/plugins/`.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Settings > SmoothPreview** to customize your preferred shimmer direction and placeholder style.

== Frequently Asked Questions ==

= Does SmoothPreview work with WooCommerce? =
Yes! SmoothPreview is 100% compatible with WooCommerce shop grids, product loops, and single product image galleries.

= Does this plugin slow down page speed? =
No. Dominant color extraction is cached in post metadata and runs in less than 1ms.

== Screenshots ==

1. SmoothPreview Settings Dashboard in WP Admin.
2. WooCommerce product grid with Adaptive Dominant Color placeholders.
3. Shimmer Skeleton Grid loading animation.

== Changelog ==

= 1.0.0 =
* Initial public release on WordPress.org.
