Description
Pkart Product Secondary Image Hover displays the first image from a WooCommerce product’s gallery when visitors hover over the product image.
The plugin is designed for WooCommerce product listing pages, including WooCommerce Product Collection blocks and classic WooCommerce product loops.
It provides a simple CSS-based hover effect without requiring JavaScript or a configuration page.
The plugin does not modify the product image gallery on single-product pages.
Features
- Display the first product gallery image on hover.
- Supports WooCommerce Product Collection blocks.
- Supports classic WooCommerce product loops.
- Uses the WooCommerce thumbnail image size.
- CSS-only hover effect.
- No JavaScript required.
- No shortcode required.
- No settings page required.
- Automatically skips products without gallery images.
- Does not modify single-product pages.
- Lightweight frontend implementation.
- Uses the product-secondary-image CSS class for customization.
How It Works
When a product has at least one gallery image, Pkart Product Secondary Image Hover adds the first gallery image as a secondary image in the product listing.
When a visitor moves the mouse over the product image, the secondary gallery image becomes visible using a CSS transition.
The plugin works automatically after activation.
No additional configuration is required.
Customization
The secondary image uses the following CSS class:
‘product-secondary-image’
You can use this class to customize the hover image transition and appearance.
Privacy
Pkart Product Secondary Image Hover does not collect, store, or transmit personal data.
The plugin does not connect to any external service.
Requirements
WordPress 6.7 or later
WooCommerce
PHP 8.1 or later
Screenshots
Installation
Method 1: WordPress Admin
- Make sure WooCommerce is installed and activated.
- Upload the plugin ZIP file through Plugins > Add New Plugin > Upload Plugin.
- Install the plugin.
- Activate Pkart Product Secondary Image Hover.
- Visit your WooCommerce shop or product archive.
- Hover over a product image that has a gallery image.
Method 2: Manual Installation
- Extract the plugin ZIP file.
- Upload the plugin folder to: /wp-content/plugins/
- Log in to the WordPress dashboard.
- Go to Plugins Installed Plugins.
- Locate “Pkart Product Secondary Image Hover”.
- Click Activate.
The first gallery image will appear when hovering over the product image.
No additional CSS configuration is required.
FAQ
-
Does the plugin require WooCommerce?
-
Yes. Pkart Product Secondary Image Hover requires WooCommerce.
-
Does the plugin work with WooCommerce Product Collection blocks?
-
Yes. The plugin supports WooCommerce Product Collection blocks.
-
Does the plugin work with classic WooCommerce product loops?
-
Yes. The plugin supports classic WooCommerce product loops.
-
Does it work on single-product pages?
-
No. The plugin is intended for product listing and archive pages and does not modify the single-product image gallery.
-
Which image is displayed on hover?
-
The first image from the product’s WooCommerce gallery is displayed.
-
What happens if a product has no gallery image?
-
The product’s main image remains unchanged. No secondary image is added.
-
Does the plugin use JavaScript?
-
No. The hover effect is handled entirely with CSS.
-
Do I need to configure the plugin?
-
No. The plugin works automatically after activation.
-
Can I customize the hover effect?
-
Yes. The secondary image uses the product-secondary-image CSS class. You can customize its appearance and transition using your theme’s CSS.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Pkart Product Secondary Image Hover” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Pkart Product Secondary Image Hover” 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 release.
- Displays the first product gallery image as a secondary image on hover.
- Supports classic WooCommerce product loops.
- Supports the WooCommerce Product Collection block.
- CSS-based hover effect (no JavaScript required).
- Adds the
product-secondary-imageCSS class for custom styling. - Accessible secondary image markup.
- Compatible with WooCommerce product thumbnails.
- Disabled on single-product pages.