=== ProductReels – Shoppable Video Reels for WooCommerce ===
Contributors: bestwpexpert
Tags: shoppable video, product video, woocommerce video, video reels, video carousel
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Shoppable video reels for WooCommerce: product video carousels, sliders, stories and floating popups. Tag products and add to cart from the video.

== Description ==

**ProductReels turns your WooCommerce product videos into shoppable video reels.**

Show product demos, customer UGC, reviews and unboxings as a video carousel, story bubbles, a video grid or a floating popup. Shoppers open a reel in a fullscreen, swipeable player and add the tagged product to the cart without leaving the video.

**100% free.** No Pro version, no license key, no locked features.

**[▶ Try the live demo](https://playground.wordpress.net/?blueprint-url=https://wordpress.org/plugins/wp-json/plugins/v1/plugin/productreels/blueprint.json)** in your browser. It opens a demo store with sample products and reels. No sign-up needed.

= Key features =

* **Shoppable videos**: tag WooCommerce products in any reel, or add your own call-to-action buttons.
* **Add to cart from the video**: product cards with price, rating and variations, plus Add to cart or Direct Checkout.
* **5 layouts, 2 shapes**: carousel, grid, marquee, stacked cards and floating popup, as rectangles or round story bubbles.
* **Live visual editor**: see every change on desktop, tablet and mobile before you publish.
* **Video analytics**: views, clicks and click rate for every widget, reel and button.
* **Any video source**: Media Library, MP4 or WebM links, YouTube Shorts and Vimeo.
* **Place it anywhere**: shortcode, Gutenberg block or Elementor widget.
* **Fast**: scripts load only on pages with a reel, and videos lazy-load.

= Layouts for every page =

* **Product page carousel**: a sliding row of reels on your product pages.
* **Homepage reel slider**: your best videos on the homepage, shop or landing pages.
* **Story-style reels**: round video bubbles for categories, collections and new arrivals.
* **Video grid**: many reels at once for lookbooks and gallery pages.
* **Marquee**: an endless, auto-scrolling ribbon of reels that pauses on hover.
* **Stacked cards**: reels shown as a layered card stack.
* **Floating popup**: a small reel in the corner that appears on load, after a delay or on scroll.

= Visual editor with live preview =

Choose a layout and shape, then work through simple steps: Reels, Layout, Look, Player, Product card, Advanced and Place it. The preview uses the same code as your store, so what you see is what shoppers get. Build a widget once and reuse it on any page.

= Fullscreen shoppable player =

Shoppers swipe, scroll or use the keyboard to move between videos. Each reel shows its product cards, and a product panel with images, variations and the buy button. The player has a seek bar, volume control and loop, and the browser back button closes it.

= Analytics that show what sells =

See total views, clicks, click rate and your top reels, plus clicks on every product and button. A view counts after one second of real playback and is limited per visitor, so the numbers stay honest.

= Fast, accessible and private =

* Loads only where a widget appears. The player, YouTube and Vimeo scripts load only when needed.
* No jQuery and no extra copy of React.
* Keyboard support, screen reader labels, reduced motion and right-to-left languages.
* Translation-ready.
* No visitor data is sent to us, and IP addresses are never stored.
* Works with any theme. Works without WooCommerce too (product tagging needs WooCommerce).

= External services =

ProductReels sends no data about your site or visitors to ProductReels servers. Third-party services are contacted only when you use videos hosted by them.

**Vimeo**: when an administrator adds a Vimeo URL, ProductReels requests the video's poster and duration from `https://vimeo.com/api/oembed.json` (only that URL is sent). When a visitor opens a Vimeo reel, the player SDK loads from `https://player.vimeo.com/api/player.js`, with Do Not Track enabled where supported. [Terms](https://vimeo.com/terms), [Privacy](https://vimeo.com/privacy).

**YouTube**: YouTube thumbnails load from `https://img.youtube.com/vi/...`. When a visitor opens a YouTube reel, the IFrame Player API loads from `https://www.youtube.com/iframe_api`. [Terms](https://www.youtube.com/t/terms), [Privacy](https://policies.google.com/privacy).

Neither SDK loads until a visitor opens a reel from that provider. Media Library and self-hosted videos use no third-party service. The `productreels_allow_provider_lookup` filter turns off the Vimeo lookup.

= Source code and credits =

Readable source is included in `admin/src`, `public/src`, `block/src` and `src/shared`. See `README.md` to build and `THIRD-PARTY-NOTICES.txt` for licenses.

Credits: Inter typeface by Rasmus Andersson (SIL OFL 1.1, admin only), Lucide icons (ISC), dnd-kit (MIT).

== Installation ==

= Requirements =

* WordPress 6.6 or newer and PHP 7.4 or newer.
* WooCommerce 7.0 or newer for product tagging and add to cart (optional).

= Install from your dashboard =

1. Go to **Plugins > Add New Plugin**.
2. Search for **ProductReels**.
3. Click **Install Now**, then **Activate**.

= Install manually =

1. Download the plugin zip from this page.
2. Go to **Plugins > Add New Plugin > Upload Plugin** and choose the zip.
3. Click **Install Now**, then **Activate**.

= Create your first reel widget =

1. Go to **ProductReels > Reels** and click **Add reel**. Add a video, then tag a product or add a button.
2. Go to **ProductReels > Widgets** and click **Create widget**. Choose a layout and add your reels.
3. Customize the look in the editor and click **Save widget**.
4. Open the **Place it** step and add the widget to any page:
    * Shortcode: `[productreels id="1"]`
    * Gutenberg: add the **ProductReels** block.
    * Elementor: add the **ProductReels** widget.

== Frequently Asked Questions ==

= What is a shoppable video? =

A video linked to the products in it. Shoppers watch a reel, see the tagged WooCommerce products and add them to the cart without leaving the video.

= How do I add a video to a WooCommerce product page? =

Create a carousel or story widget and place it on the product page with the shortcode, block or Elementor widget. You can also use the floating popup.

= Can I make Instagram-style stories or TikTok-style reels? =

Yes. Use the circle shape for story bubbles. Every reel opens in a vertical, swipeable fullscreen player.

= Can I import videos from TikTok or Instagram? =

Not directly. Upload videos you own as MP4 files, or use YouTube Shorts, Vimeo or any MP4/WebM URL.

= Is ProductReels really free? =

Yes. Every feature is free, with no Pro version or license key.

= Will it slow down my store? =

No. Scripts load only on pages with a widget, the player loads when first opened and videos lazy-load.

= Does it work with Elementor, Gutenberg and my theme? =

Yes. It includes a Gutenberg block and an Elementor widget, and the shortcode works in any theme.

= Does it work without WooCommerce? =

Yes. Video reels, galleries, CTA buttons and analytics work on any WordPress site. Product tagging and add to cart need WooCommerce.

= What happens to my data if I uninstall? =

Data is kept by default. To remove everything when deleting the plugin, turn on **Delete all data on uninstall** in **ProductReels → Settings**.

== Screenshots ==

1. Widgets overview dashboard showing total views, clicks, click rate, reels in use, top reels, and widget list.
2. Detailed widget statistics with views, clicks, click rate, top-performing reels, and product button performance.
3. Drag-and-drop reel management with live preview while building a carousel widget.
4. Carousel layout showing swipeable product reels with product cards and navigation arrows.
5. Stories layout with social-style circular reel bubbles for quick browsing.
6. Grid layout showing multiple reels at once for gallery and lookbook pages.
7. Marquee layout with an endless scrolling ribbon of shoppable video reels.
8. Stacked card layout for showcasing reels in an eye-catching layered format.
9. Popup layout with a floating reel that appears in the corner of the page.

== Changelog ==

= 1.1.0 =
* New: Redesigned admin with clearer Widgets, Reels and Settings screens.
* New: Step-by-step widget editor with live desktop, tablet and mobile preview.
* New: Pick a reel's cover by scrubbing through its frames.
* New: Drag-and-drop video upload with progress.
* New: Reel filters (tagged products, buttons, unused) and bulk delete.
* New: Top reels and "reels in use" on the Widgets screen.
* New: Product search by name or SKU.
* New: Live widget preview inside the block editor.
* New: Product panel in the player with images, options and buy button.
* Improved: Refreshed reels, product cards and player. Saved styles are kept.
* Improved: Keyboard access, screen reader support, RTL and reduced motion.
* Fixed: Player label translations now load.
* Fixed: Stacked layout on narrow phones.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.1.0 =
Redesigned admin and refreshed storefront. Your reels, widgets, statistics and settings are kept.
