Custom Product Video Gallery Widget
WooCommerce product video gallery plugin with Elementor widget, responsive carousel, shortcode support, and shop/category hover autoplay video.
by Osama Ahmed Qureshi · github.com/osamaahmedqureshi/custom-product-video-gallery-widget · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/osamaahmedqureshi/custom-product-video-gallery-widget/archive/refs/heads/main.zipA premium WooCommerce product video gallery plugin with Elementor widget support, shortcode output, product-edit video uploader, responsive single-product carousel, and shop/category product-card hover autoplay video.
Features
- WooCommerce product video gallery
- Elementor widget: Custom Product Video Gallery
- Product edit screen video uploader with drag-and-drop sorting
- Shortcode support
- Single product responsive carousel
- Desktop 3, tablet 2, mobile 1 carousel layout
- Infinite loop carousel for 3+ videos
- Static centered layout for exactly 2 videos
- Shop/category hover autoplay video using the first product video
- Legacy AH shortcode and meta key fallback
- Lightweight CSS and JavaScript assets
Requirements
- WordPress 5.8 or higher
- PHP 7.4 or higher
- WooCommerce installed and active
- Compatible with WooCommerce High-Performance Order Storage (HPOS)
- Elementor optional, only required for the Elementor widget
Installation
- Download the plugin ZIP from the GitHub Releases section.
- Go to WordPress Dashboard > Plugins > Add New > Upload Plugin.
- Upload
custom-product-video-gallery-widget-v1.1.6.zip. - Activate the plugin.
- Edit a WooCommerce product.
- Use the Custom Product Videos metabox to add/select video files from the Media Library.
- Clear cache/CDN/minify cache after updating.
Usage
Elementor Widget
Open an Elementor product template or page and add the Custom Product Video Gallery widget.
Available controls include:
- Product source: current product or custom product ID
- Layout: carousel or grid
- Arrows, dots, autoplay, and autoplay speed
- Responsive videos per row
- Video height, gap, object fit, border radius, arrow colors
Shortcode
[custom_product_video_gallery product_id="123" layout="carousel"]
Legacy shortcode remains supported:
[ah_product_video_gallery product_id="123" layout="carousel"]
Meta Keys
Primary meta key:
_custom_product_video_gallery_ids
Legacy fallback meta key:
_ah_product_video_gallery_ids
Display Rules
- 0 videos: no single gallery, no hover video.
- 1 video: no single product gallery; first video plays on shop/category hover.
- 2 videos: static centered layout; no forced carousel movement.
- 3+ videos: looping carousel; desktop 3, tablet 2, mobile 1.
Shop / Category Hover Video
Shop/category hover video is always enabled. The plugin uses the first saved product video as muted, looping, playsinline hover media.
This build keeps the working AH v1.0.5 hover strategy for Astra/WooCommerce compatibility.
Recommended Video Format
Use MP4 with H.264 video and AAC audio for best browser support.
Folder Structure
custom-product-video-gallery-widget/
├── assets/
│ ├── css/
│ │ ├── admin.css
│ │ └── frontend.css
│ └── js/
│ ├── admin.js
│ └── frontend.js
├── includes/
│ ├── admin.php
│ ├── elementor-widget.php
│ ├── frontend.php
│ └── helpers.php
├── screenshots/
├── CHANGELOG.md
├── LICENSE.txt
├── README.md
├── custom-product-video-gallery-widget.php
└── uninstall.php
Changelog
See CHANGELOG.md.
License
This plugin is licensed under the GPLv2 or later.