=== Circulux Product Video ===

Contributors: ahsangadit, viablecube
Donate link: https://viablecube.com/docs/circulux-product-video
Tags: woocommerce, product-gallery, youtube, wordpress-media-library, product-video
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add YouTube & MP4 videos to your WooCommerce product gallery. Create engaging product pages with a responsive video + image slider.
== Description ==

**Circulux Product Video** adds video support to WooCommerce product galleries. You can use YouTube URLs, videos from the WordPress Media Library, and HTML5 video formats (MP4, WebM, Ogg).

https://youtu.be/FkI3QbfByfI

### What This Plugin Does

*   **YouTube Integration:** Paste a YouTube URL in the product video field.
*   **WordPress Media Library Support:** Select a video from your existing media library.
*   **HTML5 Video (MP4, WebM, Ogg):** Use self-hosted video files.
*   **Manual Playback:** Videos start when the user clicks play.
*   **Thumbnail Layouts:** Thumbnails are shown as a grid or slider based on item count.

== Basic Features (Included Free) ==

01. **Universal Video Support:** Embed YouTube or select videos from your WordPress Media Library.
02. **HTML5 Power:** Full support for MP4, WebM, and Ogg formats directly on your product pages.
03. **Carousel Slider:** Responsive slider with touch navigation and transitions.
04. **Mixed Media Gallery:** Combine images and videos in a single, unified slider experience.
05. **Thumbnail Layout Logic:** Uses a grid for fewer items and a slider for larger galleries.
06. **Responsive Layout:** Designed to work across mobile, tablet, and desktop screens.
07. **Customizable UI:** Control arrow styles, colors, layouts (Vertical/Horizontal), and more.
08. **Frontend Assets:** Includes only the assets needed for gallery features.
09. **HPOS Compatible:** Compatible with WooCommerce High-Performance Order Storage.
10. **RTL Support:** Full support for Right-to-Left languages.

== Installation ==

### Automatic Installation

1. Go to **WordPress Admin** → **Plugins** → **Add New**.
2. Search for "Circulux Product Video".
3. Click **Install Now** and then **Activate**.

### Manual Installation

1. Download the plugin zip file.
2. Go to **WordPress Admin** → **Plugins** → **Add New** → **Upload Plugin**.
3. Choose the zip file and click **Install Now**.
4. Activate the plugin.

== Frequently Asked Questions ==

= Does this work with my theme? =
It works with WooCommerce-compatible themes. If your theme follows standard WooCommerce templates and hooks, it should work correctly.

= How do I add a video? =
Edit a product, open the **Product Video** meta box, choose a video type, and add your video URL or select a media file. Save/update the product to apply changes.

= Is there a limit on videos? =
This version supports one primary video per product gallery.

= Can I customize the gallery appearance? =
Yes. Settings are available under **Products** → **Circulax Video** for layout, arrows, thumbnails, lightbox, and zoom options.

== Screenshots ==

1. General settings: defaults for video type, gallery behavior, and core options.
2. Arrow settings: customize prev/next controls, style, and visibility.
3. Thumbnail settings: thumbnail strip or grid, sizing, and interaction.
4. Display settings: lightbox, zoom, and how media appears on the product page.
5. Product editor: Product Video meta box — add YouTube, Media Library, or HTML5 video.
6. Storefront gallery: video slides mixed with product images in the main gallery.
7. Gallery thumbnails: video shown as a selectable thumbnail alongside images.
8. Playback: inline video with native controls when the customer chooses to play.
9. Responsive layout: gallery and controls adapt on phones and tablets.

== Support & Feedback ==

We'd love to hear your feedback and suggestions!  

📩 Email: [ahsan.amin334@gmail.com](mailto:ahsan.amin334@gmail.com)  

== Third Party Libraries/Resources ==

This plugin uses the following third-party libraries:

1. [Swiper.js](https://swiperjs.com/) - MIT License
2. [Fancybox](https://fancyapps.com/fancybox/) - Used for optional lightbox support.
3. [jQuery Zoom](https://github.com/jackmoore/zoom) - Used for optional image magnification.

When you add YouTube videos to a product, the plugin embeds content from [YouTube](https://www.youtube.com/) and may load the YouTube iframe API (https://www.youtube.com/iframe_api). YouTube is a service of Google; see [YouTube's Terms of Service](https://www.youtube.com/t/terms) and [Google Privacy Policy](https://policies.google.com/privacy).

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.