SmoothPreview

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.

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.

1.0.0

• Initial public release on WordPress.org.