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
- Upload the
smooth-previewdirectory to/wp-content/plugins/. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- Go to Settings > SmoothPreview to customize your preferred shimmer direction and placeholder style.
FAQ
-
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.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“SmoothPreview” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “SmoothPreview” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial public release on WordPress.org.
