=== MediaHaven – Video Gallery, HLS Player & WooCommerce Product Videos ===
Contributors: wpninjadevs, jilani53
Tags: video gallery, woocommerce product video, hls player, youtube gallery, tiktok feed
Requires at least: 5.9.0
Tested up to: 7.0.1
Requires PHP: 7.4
Stable tag: 1.7.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Commercial link: https://mediahaven.io/pricing/?ref=1

Create responsive video galleries, WooCommerce product videos, and secure HLS streaming with YouTube, TikTok, Bunny Stream, and 10+ video sources.

== Description ==

Is your WordPress site or WooCommerce store struggling with video? Whether you're dealing with heavy video files, buffering playback, rising hosting costs, poor page speed, or looking for a better way to showcase product videos and video galleries, MediaHaven has you covered.

**MediaHaven** combines responsive video galleries, powerful video library management, WooCommerce product videos, secure HLS streaming, and support for YouTube, TikTok, Vimeo, Bunny Stream, self-hosted videos, and 10+ other video sources. Built-in smart asset loading, lazy loading, automatic image optimization, and YouTube API caching keep your website fast and responsive.

[youtube https://www.youtube.com/watch?v=a0ab5-qAN94]

[__👉 Live Demo__](https://demo.mediahaven.io/) | [__🛟 Support__](https://wordpress.org/support/plugin/mediahaven-lite/) | [__🔓 Unlock Pro Features__](https://mediahaven.io/)

## 🎬 Why MediaHaven is Different ##

Most WordPress video gallery plugins stop at embedding videos. **MediaHaven** goes further by helping you create, manage, stream, and showcase videos with built-in performance optimizations, WooCommerce integration, and support for 10+ video sources—all from a single plugin.

✅ Create responsive video galleries with 10+ video sources, including YouTube, TikTok, Vimeo, Bunny Stream, and self-hosted videos
✅ Display WooCommerce product videos in tabs or before and after the product summary
✅ One-click affordable [Bunny Stream](https://bunny.net/?ref=rciybk2b83) integration with automatic HLS conversion, adaptive streaming, and secure signed URL delivery to help protect premium video content
✅ Built-in lazy loading, smart asset loading, and automatic image optimization
✅ SEO-ready with Schema.org markup and WCAG accessibility support
✅ Global video delivery through Bunny Cloud CDN for fast, buffer-free playback
💎 Replace WooCommerce product gallery images with videos and create interactive shoppable experiences (Pro)

## 🆓 Free Features — Everything You Need to Get Started ##

### 🎨 Video Gallery Builder

✅ **Setup Wizard** — guided onboarding to get your first gallery live fast
✅ **10+ video sources** — YouTube, Vimeo, TikTok, Twitch, Wistia, Dailymotion, Rumble, Facebook, Instagram, LinkedIn, HLS, self-hosted
✅ **3 responsive layouts** — Grid, Carousel, and Multi-row Carousel
✅ **Unlimited shortcode builder** — create and embed as many galleries as you need
✅ **Single video page support** — built-in templates for individual video pages
✅ **AJAX Load More** — users load more videos without page reloads
✅ **Live M3U8 stream support** — embed and display live video streams
✅ **Built-in lazy loading** — images, videos, and iframes load only when needed

### 🚀 Performance & SEO

✅ **Schema.org structured data** — every gallery is search-engine ready
✅ **Semantic HTML5 markup** — WCAG-compliant accessibility built in
✅ **Smart asset loading** — plugin scripts load only where needed, per shortcode
✅ **Built-in image optimizer** — automatic compression with WebP support
✅ **Smart caching** — YouTube API data cached to reduce requests and load times
✅ **Auto video view counter** — tracks real views automatically
✅ **AJAX like/dislike system** — interactive engagement without page reloads
✅ **Export & import** — JSON and CSV support for easy gallery migration

### ☁️ Bunny Stream CDN — Automatic Secure HLS Video Hosting

Is your hosting getting crushed by video files? MediaHaven connects directly to [Bunny Stream](https://bunny.net/?ref=rciybk2b83) — the world's fastest video CDN — and automatically converts every video you sync into **secure, adaptive HLS format**

🎬 **One-click HLS conversion** — hit Sync and your video is automatically converted to secure adaptive HLS format on Bunny Stream. Full control over what gets offloaded and when.
📶 **Adaptive bitrate streaming** — quality adjusts in real-time to the viewer's connection — smooth even on 3G
🔒 **Encrypted HLS delivery** — signed URLs and token authentication block hotlinking and direct downloads
🌍 **Global CDN delivery** — zero buffering for viewers anywhere in the world
⚡ **Zero server load** — your hosting never serves a single video byte
🛠️ **One-click setup** — connect your [Bunny Stream](https://bunny.net/?ref=rciybk2b83) library in minutes, no coding needed

> Same streaming technology trusted by Netflix and Apple — free with
> MediaHaven.

### 📝 Video Subtitle Support

MediaHaven supports video subtitles for improved accessibility and SEO. Basic single-language subtitle support is available in the free version.

[__👉 Live Demo__](https://demo.mediahaven.io/mhpro-video/advanced-interactive-subtitles-to-enhance-every-video-playback/)

### ⌨️ Keyboard Shortcuts for Video Playback

Control videos without a mouse — perfect for accessibility and power users:

* Space          : Play or pause the video
* F              : Toggle fullscreen mode
* M              : Mute or unmute audio
* Left Arrow     : Rewind video by 5 seconds
* Right Arrow    : Fast-forward video by 5 seconds
* Up Arrow       : Increase volume by 10%
* Down Arrow     : Decrease volume by 10%
* 0–9            : Jump to a percentage of the video (0 = start, 9 = 90%)

## 💎 Pro Features — Built for Serious Video Publishers ##

Ready to take your video site to the next level? [__Upgrade to Pro →__](https://mediahaven.io/pricing/?ref=1)

### 🎥 WooCommerce Product Gallery Videos

Replace static WooCommerce product images with engaging videos and interactive shoppable experiences. Display videos directly inside the native WooCommerce product gallery so customers can watch product demos, tutorials, reviews, and unboxing videos without leaving the product page.

🛍️ Replace featured product images with videos
🖼️ Display videos alongside product gallery images
🎬 Support self-hosted, YouTube, Vimeo, HLS, Bunny Stream, and more
⚡ Theme-compatible WooCommerce gallery integration
▶️ Autoplay videos when selected
📱 Responsive and mobile-friendly
🛒 Interactive shoppable video overlays

Explore both **MediaHaven Lite** and **MediaHaven Pro** features on a live WooCommerce product page.

[__👉 View Live WooCommerce Demo__](https://demo.mediahaven.io/product/shirt-green/)

### 💰 WooCommerce Video Commerce & Shoppable Videos (Pro)

MediaHaven transforms your video gallery into a **shoppable video engine** — the same format driving billions in sales on TikTok Shop, Instagram, and YouTube Shopping, now built directly into WordPress.

Display clickable product cards, promotional banners, and video ads at any moment inside your videos — timed perfectly to match what viewers are watching.

#### 🛒 eCommerce & Shoppable Video

🛍️ **WooCommerce Product Videos** — Display engaging product videos in tabs, before the summary, after the Add to Cart button, or anywhere on the product page using WooCommerce hooks.
🎥 **WooCommerce Product Gallery Videos** — Replace static product images with interactive videos that customers can watch directly inside the product gallery.
🛒 **Interactive Shoppable Videos** — Add clickable product cards, live pricing, quantity selectors, variations, coupons, and Add to Cart buttons directly inside self-hosted product videos.
🛍️ **FluentCart & SureCart compatible** — works with modern WordPress eCommerce solutions
💥 **Boost instant sales** — link directly to product pages, checkout, or add-to-cart from inside any video
🎯 **Product showcase videos** — turn demo videos, unboxing clips, and tutorials into direct revenue drivers
📣 **Promotional banners inside video** — flash limited-time offers, discount codes, or seasonal deals at the perfect moment
🔗 **Clickable CTAs at any position** — drive traffic to any URL directly from your video content

#### 📺 VAST Video Advertising

💰 **Full VAST ad support** — display image, video, link, and text ads inside any video
📍 **9 ad positions** — top left, top center, top right, middle left, middle center, middle right, bottom left, bottom center, bottom right
⏱️ **Precise timing controls** — choose exactly when ads appear and for how long
🎨 **Full style controls** — match ads perfectly to your brand
🔇 **Ad audio mute option** — keep the viewing experience smooth
📊 **Built for revenue** — monetize your video library without sending users off-site

> 💡 **Think of it this way:** Every product demo video on your
> WooCommerce store becomes a shoppable moment. Every tutorial 
> becomes a sales funnel. MediaHaven Pro turns your video gallery 
> into your highest-converting sales channel.

> ⚠️ **Note:** VAST ads and shoppable video overlays work with
> self-hosted, HLS, and Bunny Stream videos. YouTube, TikTok,
> and other embedded platform videos use their own player and
> ad systems.

[__👉 Live Demo — Shoppable Video & VAST Ads__](https://demo.mediahaven.io/shoppable-video-for-ecommerce/)

### ☁️ Bunny Storage — Offload ALL Your Media (Pro)

Stop paying for expensive server storage. With [Bunny Storage](https://bunny.net/?ref=rciybk2b83) Pro, simply click Sync on any media file — images, audio, documents, and videos — and it is instantly offloaded to Bunny's global CDN.

🖼️ **Offload everything** — images, audio, documents, videos — one-click Sync moves any file to Bunny Cloud instantly
🌍 **Global CDN for all files** — every visitor gets fast delivery no matter where they are
💰 **Cut hosting costs dramatically** — stop paying for server storage that keeps growing
🔄 **Hands-free offloading** — files offload to Bunny Cloud the moment you upload them to WordPress
🛡️ **Secure delivery for all media** — token authentication protects every file type
📊 **Built for WooCommerce, membership sites & course platforms**
🚀 **Better Core Web Vitals** — faster media = higher Google rankings

### 🔄 Ajax Video Live Filter (Pro)

Let visitors instantly search and filter your video library without page reloads — by category, tag, author, duration, resolution, and more.

🔍 Live search as you type
🏷️ Filter by category, tag, author, duration, resolution, featured
📄 Pagination options — numbered, Load More, or Infinite Scroll
🎨 Fully customizable filter sidebar with style controls
🔗 SEO-friendly filter URLs

[__👉 Live Demo__](https://demo.mediahaven.io/ajax-live-filters?mhpro_sid=279)

### 🎨 Drag & Drop Layout Builder (Pro)

Full design control without touching a line of code:

🖱️ Drag & drop video card sections — media, title, meta, description
🖱️ Drag & drop single video page sections
🎨 Custom player styles — control bar, volume bar, progress bar, play button colors
🔤 Google Fonts support with full typography controls
🎨 Per-shortcode and global style overrides
🖼️ WebP image conversion for ultra-fast thumbnails

### ⏱️ Interactive Video Chapters (Pro)

Add clickable, structured chapters to any video — perfect for tutorials, online courses, and long-form content. Viewers jump to any moment instantly.

[__👉 Live Demo__](https://demo.mediahaven.io/mhpro-video/intelligent-video-chapters-for-seamless-navigation/)

### 📝 Unlock multi-language subtitles, precise timing (Pro) 
> controls, and full VTT format support [👉 Upgrade to Pro](https://mediahaven.io/pricing/?ref=1)

[__👉 Live Demo__](https://demo.mediahaven.io/mhpro-video/advanced-interactive-subtitles-to-enhance-every-video-playback/)

## 🌐 Who is MediaHaven For? ##

MediaHaven is built for anyone who takes video seriously on WordPress:

🎓 **Course creators & educators** — secure HLS video, chapters, and subtitles make your courses professional and accessible
🛒 **WooCommerce & eCommerce store owners** — Display product videos, replace product gallery images with videos, create shoppable video experiences, and increase conversions with interactive product demos.
📣 **Marketers & agencies** — build stunning YouTube & TikTok feed galleries for campaigns, embed shoppable product videos with clickable CTAs, and monetize self-hosted content with VAST ads
🎬 **YouTubers & content creators** — display your channel feed beautifully with real-time views and likes
🏢 **Membership site owners** — secure, non-downloadable video delivery with token authentication
🎙️ **Podcasters with video** — adaptive playback on every device and connection speed
🧑‍💻 **WordPress developers** — clean code, Gutenberg block, shortcode builder, and full page builder compatibility

## 💡 A Note from the Developer ##

MediaHaven is built for the long term. We are continuously improving performance, scalability, and features — with a data structure designed to stay compatible with modern WordPress standards and future technologies.

If you find a bug, have a feature request, or just want to say hello — we would love to hear from you.

MediaHaven integrates with Bunny.net for video hosting, streaming, and CDN delivery. If you sign up through one of our Bunny.net referral links, we may earn a commission at no additional cost to you. This helps support the continued development of MediaHaven.

📩 [assist.wpninjadevs@gmail.com](mailto:assist.wpninjadevs@gmail.com)

== Installation ==

1. Upload the plugin folder to the '/wp-content/plugins/mediahaven-lite/' directory.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Use the "MediaHaven Lite" menu in the admin sidebar to manage videos and settings.
4. Go to MediaHaven → Add New to create your first video gallery.
5. Copy the generated shortcode and paste it into any page, 
   post, or Gutenberg block.

== Frequently Asked Questions ==

= Is MediaHaven free? What do I get with the Pro version? =
MediaHaven Lite is completely free and includes powerful features to get you started — including automatic secure HLS video streaming, Bunny Stream CDN, YouTube & TikTok feeds, responsive gallery layouts, AJAX load more, video view counter, like/dislike system, and more.

The Pro version unlocks advanced features including:
- Bunny Storage — offload ALL media to Bunny Cloud CDN
- Ajax Live Filter with search, category, tag, and duration filtering
- Drag & Drop layout builder for video cards and single pages
- Shoppable video with VAST ads for self-hosted content
- Interactive video chapters
- Dynamic subtitles with multi-language support
- Custom player styles — colors, controls, progress bar
- WebP image conversion
- Priority support

[👉 See all Pro features and upgrade](https://mediahaven.io/)

= Can I add videos to my WooCommerce product gallery? =

Yes! MediaHaven Pro lets you replace static WooCommerce product images with engaging videos or display videos alongside existing gallery images.

You can also:

- Display videos inside the native WooCommerce gallery
- Replace featured product images with videos
- Assign different video galleries to different products
- Display galleries before or after the product summary
- Add videos inside custom WooCommerce hooks
- Turn product videos into interactive shoppable experiences

Perfect for:

- Product demonstrations
- Installation guides
- Unboxing videos
- Customer testimonials
- Product comparisons
- Fashion lookbooks

Explore both **MediaHaven Lite** and **MediaHaven Pro** features on a live WooCommerce product page.

[__👉 View Live WooCommerce Demo__](https://demo.mediahaven.io/product/shirt-green/)

= Can I embed YouTube, Vimeo and self-hosted videos? =
Absolutely. MediaHaven supports embedding videos from **YouTube, Vimeo, TikTok, Twitch, Wistia, Dailymotion, Rumble, Facebook, Instagram, LinkedIn, and self-hosted HLS streams**.

Self-hosted videos support all major formats including MP4, WebM, 
MOV, MKV, AVI, and HLS / M3U8 streams.

[👉 Take a look at the demo](https://demo.mediahaven.io/embedded-videos/)

= Can I display YouTube videos using my Channel ID or Playlist ID? =
Absolutely! You can effortlessly showcase unlimited YouTube videos from any Channel ID or Playlist ID. Enhance your display with **creator avatars, likes, and view counts** — all beautifully arranged in responsive **Grid, Carousel, or Multi-row Carousel** layouts.

For even more flexibility, you can load unlimited videos with a **"Load More"** button. The feed is lightning fast and smartly cached to reduce YouTube API usage.

Plus, you can add multiple YouTube API keys — the plugin will rotate them automatically to help avoid hitting usage limits.

[👉 Take a look at the demo](https://demo.mediahaven.io/youtube-feeds/)

= Does MediaHaven automatically convert my videos to HLS format? =
Yes — and this is one of MediaHaven's most powerful free features.

When you connect Bunny Stream and click Sync on any video, it is automatically converted to secure HLS (HTTP Live Streaming) format on Bunny Stream — no manual encoding or extra tools needed. You stay in full control of which videos get synced and when.

This means:
- 📶 **Adaptive bitrate** — video quality adjusts automatically to the viewer's internet speed, even on slow 3G connections
- 🔒 **Encrypted delivery** — videos can't be hotlinked, scraped, or downloaded directly
- 📱 **Universal playback** — works on every device and browser without plugins
- ⚡ **Zero buffering** — smooth playback for every viewer regardless of connection speed

No manual encoding, no extra tools — just hit Sync and it converts automatically. Completely free.

= How do I set up Bunny Stream for video CDN delivery? =
Setting up Bunny Stream with MediaHaven takes about 10 minutes and requires no technical experience.

1. Create a free account at [bunny.net](https://bunny.net/?ref=rciybk2b83)
2. Create a Stream Library and copy your API Key, Library ID, and CDN Hostname
3. Enable Token Authentication in your Bunny Stream library
4. Go to **MediaHaven → Settings → Storage & CDN**
5. Select **CDN** under Serve From
6. Select **Bunny Stream** as your Storage Provider
7. Enter your Bunny Stream credentials and enable Secure Stream Playback
8. Save Settings, upload a test video, then click Sync to push it to Bunny Stream or Storage

[👉 Full setup guide](https://mediahaven.io/docs/#/cleardocs/how-to-set-up-bunny-cloud-with-mediahaven)

= What is Bunny Storage and how is it different from Bunny Stream? =
Both are part of the Bunny.net CDN platform but serve different purposes:

**Bunny Stream (Free)**
- Handles video files only
- Automatically converts videos to secure HLS format
- Adaptive bitrate streaming built in
- Best for video-heavy WordPress sites

**Bunny Storage (Pro)**
- Offloads ALL media files — images, audio, documents, and videos
- No automatic HLS conversion — files served as-is from CDN
- Best for sites that want to offload their entire media library
- Dramatically reduces server storage costs

[👉 Upgrade to Pro for Bunny Storage](https://mediahaven.io/)

= Can I offload all my WordPress media files to Bunny Cloud? =
Yes — with the **Pro version** and Bunny Storage integration.

Once connected, every media file you upload and hit sync — images, audio, documents, and videos — is automatically offloaded to Bunny's global CDN. Your hosting server no longer stores or serves any media files, which means:

💰 Lower hosting costs — no more paying for growing server storage
🌍 Faster delivery globally — CDN serves files from the nearest location to each visitor
🚀 Better Core Web Vitals — faster media = higher Google rankings
🛡️ Secure delivery — token authentication protects all file types

[👉 Upgrade to Pro](https://mediahaven.io/)

= Can I use MediaHaven for shoppable video on my WooCommerce store? =
Yes! With MediaHaven Pro's VAST ad and overlay system, you can turn any self-hosted product video into a **shoppable video experience** — similar to TikTok Shop and Instagram Shopping, built directly into WordPress.

You can display:
- 🛍️ Clickable product cards inside videos
- 📣 Promotional banners with discount codes
- 🔗 Direct add-to-cart or product page links
- 💥 Timed CTAs that appear at the perfect moment in the video

Works with **WooCommerce, FluentCart, SureCart**, and any WordPress eCommerce platform.

> ⚠️ **Important:** Shoppable video and VAST ads work with 
> **self-hosted videos only** — including MP4, WebM, MOV, MKV, 
> AVI, HLS streams, and Bunny Stream videos. They are not 
> available for YouTube, TikTok, Vimeo, or other externally 
> embedded platform videos, as those platforms control their 
> own player and ad systems.

[👉 Live Demo](https://demo.mediahaven.io/shoppable-video-for-ecommerce/)

= Can I add video chapters to my videos? =
Yes — with MediaHaven Pro. Interactive Video Chapters let you divide any self-hosted or HLS video into structured, clickable sections. Viewers can jump to any chapter instantly — perfect for:

- 🎓 Online course modules and tutorials
- 📋 Long-form training and webinar recordings
- 🎬 Product demos with multiple sections
- 📰 Documentary or interview content

Chapters improve viewer engagement, watch time, and make your content more discoverable in search results.

[👉 Live Demo](https://demo.mediahaven.io/mhpro-video/intelligent-video-chapters-for-seamless-navigation/)

= Can I add subtitles to my videos? =
Yes — with MediaHaven Pro. Dynamic Video Subtitles let you add precise, timed subtitles to any video with full multi-language support.

Benefits include:
- ♿ **Accessibility** — WCAG-compliant for hearing-impaired viewers
- 🌍 **Global reach** — support multiple languages for international audiences
- 🔍 **SEO boost** — subtitle content is indexed by search engines
- 📈 **Higher engagement** — studies show subtitles increase average watch time significantly

[👉 Live Demo](https://demo.mediahaven.io/mhpro-video/advanced-interactive-subtitles-to-enhance-every-video-playback/)

= Does MediaHaven support live video streaming? =
Yes! MediaHaven supports **live video streaming in M3U8 / HLS format**. Simply add your live stream URL as the video source and it will play directly in the MediaHaven player — no third-party embed required.

Perfect for:
- 🎙️ Live webinars and events
- 📺 Live course broadcasts
- 🏟️ Live sports or event coverage
- 🎮 Live gaming streams via your own server

= Can I filter and search videos without page reloads? =
Yes — with the **Ajax Live Filter (Pro)**. Visitors can instantly search and filter your entire video library without any page reloads, using:

🔍 Live search as you type
🏷️ Filter by category, tag, author, duration, resolution
⭐ Filter by featured videos
📄 Pagination — numbered, Load More, or Infinite Scroll
🔗 SEO-friendly filter URLs for better search visibility

[👉 Live Demo](https://demo.mediahaven.io/ajax-live-filters?mhpro_sid=279)

= How fast is the MediaHaven video gallery plugin? =
MediaHaven was built from the ground up with performance in mind:

- ⚡ **Bunny Stream CDN** — videos served from the nearest global edge location to each viewer
- 🔄 **Smart asset loading** — plugin CSS and JS load only on pages where galleries exist
- 💤 **Built-in lazy loading** — images, videos, and iframes load only when they enter the viewport
- 🗄️ **Smart caching** — YouTube API data cached locally to reduce requests
- 🖼️ **Built-in image optimizer** — automatic compression and thumbnail optimization built in. WebP conversion available in Pro.
- 📦 **Clean optimized code** — no bloat, no unnecessary requests

= Is the plugin compatible with popular page builders? =
Yes! MediaHaven works seamlessly with all major page builders:

**Elementor, WPBakery, Divi Builder, Beaver Builder, Gutenberg, Bricks Builder, and more.**

Simply create your gallery using the Shortcode Builder, then insert the generated shortcode into any page builder's shortcode or text widget — no coding required.

= Can I export and import my video galleries? =
Yes. MediaHaven includes built-in Export & Import tools supporting both **JSON and CSV formats** — making it easy to:

- 📦 Migrate galleries between WordPress sites
- 💾 Back up your entire video library configuration
- 🔄 Duplicate gallery setups across multiple projects
- 📊 Bulk import large video libraries quickly

= What does "Seamless Image Optimization Built In" mean? =
MediaHaven automatically optimizes all video thumbnail images behind the scenes — no extra plugins or manual steps needed.

With the **Pro version**, the plugin can also automatically convert all thumbnails to the modern **WebP format**, which reduces file sizes by up to 35% without any quality loss — giving your site an additional speed and SEO boost.

🚀 **Result:** Faster page loads, improved Core Web Vitals, better SEO scores, and a smoother user experience — all handled automatically.

= How many video galleries can I create? =
Unlimited — there are no restrictions on the number of galleries you can create.

Each gallery can have its own layout, video source, styling, and shortcode. Create one gallery or a hundred — the plugin handles it all without any performance impact thanks to smart asset loading.

= Can I display a single video without title, description, or metadata? =
Yes, absolutely. Use the built-in display options to toggle off any elements — title, description, publish date, meta, author — showing only the video itself.

[👉 Take a look at the demo](https://demo.mediahaven.io/single-video-player/)

🎥 Perfect for **landing pages, hero sections**, or anywhere you want the video to speak for itself without distractions.

= Can I customize the video player to match my brand? =
Yes — with MediaHaven Pro. You have full control over every visual aspect of the player:

🎨 Custom colors for play button, control bar, volume, and progress bar
🖱️ Drag & drop video card layout — arrange media, title, meta, and description sections in any order
🔤 Google Fonts support with full typography controls
🎨 Per-shortcode and global style overrides

No coding needed — everything is point, click, and style.

= How do I create a YouTube API Key via Google Cloud? =
To use YouTube feeds in this plugin, you'll need a free YouTube Data API v3 key:

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Click **"Select a project"** → create a new one or use existing
3. Go to **APIs & Services → Library**
4. Search for **"YouTube Data API v3"** → click **Enable**
5. Go to **APIs & Services → Credentials**
6. Click **+ Create Credentials** → select **API key**
7. Copy your generated key

Paste it into **MediaHaven → Settings → API Settings** under YouTube API Key.

[👉 Full YouTube API setup guide](https://mediahaven.io/docs/#/cleardocs/create-youtube-api-key-via-google-cloud)

= Are YouTube channel videos cached for faster loading? =
Yes. The plugin stores a local copy of all YouTube API data, so video information loads instantly on repeat visits — reducing API requests and keeping your gallery fast even with large YouTube channel feeds.

You can also add multiple YouTube API keys and the plugin will rotate them automatically to avoid hitting usage limits.

= Can I display multiple galleries on the same page? =
Yes. You can display as many galleries as you need on a single page — each with different layouts, sources, and styles. Each gallery gets its own unique shortcode ID.

Thanks to smart asset loading, adding multiple galleries does not impact page performance.

= Will my video galleries work on mobile devices? =
Yes — all layouts are fully responsive and optimized for every screen size. Galleries automatically adapt to desktop, tablet, and mobile — with touch-friendly carousel navigation and fluid grid layouts.

= Is there a Gutenberg block available? =
Yes. MediaHaven includes a dynamic **Shortcode View Gutenberg block** with live preview — fully compatible with block-based themes and the full site editor. All plugin features and templates work seamlessly inside the Gutenberg block editor.

= What is MediaHaven and who is it for? =
MediaHaven is a high-performance WordPress video gallery plugin built for speed, security, and scalability. It combines automatic HLS video streaming, Bunny Cloud CDN offloading, and a powerful gallery builder supporting YouTube, TikTok, Vimeo, and 10+ video sources.

It is perfect for:
- 🎓 **Course creators & educators** — secure HLS video, chapters, subtitles, and protected delivery
- 🛒 **WooCommerce & eCommerce stores** — shoppable product videos with clickable CTAs and VAST ads
- 📣 **Marketers & agencies** — YouTube and TikTok feed galleries, Ajax filters, and video campaign tools
- 🎬 **YouTubers & content creators** — channel feed galleries with real-time views, likes, and Load More
- 🏢 **Membership site owners** — encrypted, non-downloadable video delivery with token authentication
- 🎙️ **Podcasters with video** — adaptive playback on every device and connection speed
- 🧑‍💻 **WordPress developers** — clean code, Gutenberg block, shortcode builder, and full page builder support

== Screenshots ==

1. Grid View Shortcode With Title & Meta
2. Default Grid View Style
3. Grid View Just Video Without Title, Meta & Description
4. Video Details Page Template
5. Ajax Video Live Filter (Pro)
6. Carousel View Default
7. Multi-rows Carousel Shortcode
8. Video Items With Custom Style (Pro)
9. YouTube Inline Play Responsive Video Gallery
10. YouTube Video Gallery With Thumbnail
11. YouTube Video Carousel
12. YouTube Gallery With Multi-rows Carousel
13. Single Responsive Video Player
14. Terms Grid and Carousel Overlay View (Pro)
15. Terms With Icon
16. Standard Terms
17. Shortcode Options
18. Single Page Basic Options
19. Single Page Video Source & Format Options
20. Global Styles
21. Setting Options
22. Bunny CDN Stream
23. Bunny CDN Storage
24. Export & Import

== Changelog ==

= 1.7.3 - Jul 12, 2026 =
* New: Added WooCommerce Product Videos to showcase video galleries on product pages.
* New: Display video galleries in Product Tabs, Before Summary, and After Summary.
* New: Assign video galleries to individual WooCommerce products.
* New: Turn WooCommerce product galleries into engaging video experiences. (Pro)
* New: Display videos alongside or in place of product gallery images. (Pro)
* New: Added interactive Shoppable Videos for WooCommerce products. (Pro)
* New: Added advanced WooCommerce placement options using native WooCommerce hooks. (Pro)
* New: Automatically assign video galleries by product category, tag, or across your entire store. (Pro)
* Improved: Enhanced WooCommerce compatibility and overall user experience.
* Improved: Faster WooCommerce gallery initialization and performance.
* Fixed: Minor bugs and UI improvements.

= 1.7.2 - Jul 1, 2026 =
* New: Added aspect ratio options for video playback, including 16:9, 4:3, 1:1, 4:5, 9:16, and 21:9.
* Improved: AJAX Live Filter performance for faster and smoother filtering. (Pro)
* Added: Shareable filter URLs for bookmarking and sharing filtered results. (Pro)
* Added: Sort videos by most viewed. (Pro)
* Improved: Checkbox and radio button styles in the AJAX Live Filter. (Pro)
* Improved: Cursor-based pagination for better performance with large video libraries. (Pro)
* Improved: Like/Dislike feature by replacing jQuery AJAX requests with the native Fetch API for better performance.
* Improved: YouTube feed "Load More" experience.
* Added: Loading spinner while fetching additional YouTube videos.
* Improved: YouTube feed loading performance and overall user experience.
* Improved: Overall styling and visual consistency.
* Fixed: Minor UI and layout issues.

= 1.7.1 - Jun 16, 2026 =
* Update: Readme file

= 1.6.9 - Jun 15, 2026 =
* Added: Bunny Stream integration for cloud video hosting
* Added: Bunny Storage integration for remote media storage (Pro)
* Added: Global CDN video delivery support
* Added: Storage & CDN settings panel
* Added: Local or CDN serving mode
* Added: Bunny Stream API and Library configuration
* Added: Secure video playback support
* Added: CDN token authentication support
* Added: Bunny Storage and CDN configuration options
* Improved: Video delivery performance and scalability
* Improved: Cloud video management experience
* Improved: Settings interface and workflow
* Unlock: Reorder Card Sections switch
* Fixed: Minor bugs and UI issues

= 1.6.8 - Apr 21, 2026 =
* Added: Frontend notice and setup guide when YouTube API key is missing
* Fixed: Select field styling issue in Setup Wizard
* Fixed: Table column shortcode styling issue
* Fixed: Setup Wizard button disappearing after navigating plugin menu
* Updated: YouTube API documentation URL
* Updated: YouTube API key field is now optional in Setup Wizard
* Improved: Form validation messages
* Improved: Removed “Views” link from Views (Shortcode)

= 1.6.7 - Apr 14, 2026 =
* Fix: Ensured compatibility with WordPress 6.9.4

= 1.6.6 - Apr 14, 2026 =
* New: Added compatibility support for WordPress 7.0
* New: Added upgrade button in MediaHaven submenu for quick access to premium features
* Fix: Fixed media field button styling issues
* Fix: Fixed icon field button styling inconsistencies
* Fix: Fixed permalink rewrite issue — no longer requires manual permalink flush
* Improved: Improved admin notice display timing and visibility behavior
* Improved: Optimized custom post type registration for better stability and initialization order

= 1.6.5 - Mar 15, 2026 =
* New: Added a video tutorial to the setup wizard to help you get started quickly.
* New: Added helpful plugin notices for better guidance.
* Improved: Plugin activation redirect experience for a smoother setup.
* Fixed: Resolved responsive issues with VAST ads. (Pro)
* Improved: Enhanced overall ad experience. (Pro)
* New: Added an Ad Button Label field to easily customize the button text. (Pro)
* Fixed: Resolved ad position conflicts between the main player and related videos on single video pages. (Pro)
* Fix: Style related issue

= 1.6.4 - Feb 23, 2026 =
* New: Added responsive grid columns for extra-small and extra-large devices.
* Improved: HTML markup for better structure and performance.
* Fixed: Layout, alignment, and responsive styling issues.
* Compatibility: Fully compatible with PHP 8.5.
* Improved: Grid system for smoother responsiveness across all screen sizes.
* Added: Extra-small and extra-large column controls for precise responsive layouts.
* Improved: Video card markup for better consistency and rendering.
* Enhanced: User experience when configuring responsive column settings.
* Added: Background database updater to ensure a smoother, uninterrupted user experience.
* Added: Support for a Header Right Button (available in the Pro version).

= 1.6.3 - Feb 1, 2026 =
* Fix: Updated plugin title to align with WordPress Directory guidelines.
* Improvement: Enhanced security by preventing direct access to PHP files.

= 1.6.2 - Jan 30, 2026 =
* New: Add license management option (Pro)
* New: Add ad title support (Pro)
* New: Add ad position options: top left, top center, top right, middle left, middle center, middle right, bottom left, bottom center, bottom right (Pro)
* New: Add ad audio mute option (Pro)
* New: Add dynamic z-index support and improve ad styles (Pro)
* New: Add clickable ads support (Pro)
* Improve: Wizard style and UI
* Improve: Improve text ad style and layout (Pro)
* Remove: Remove ad text field (Pro)
* Remove: Remove central hook from lookup table and AJAX handler (Pro)
* Fix: Ad and VTT files are now properly deleted when a video post is removed (Pro)

= 1.6.1 - Dec 16, 2025 =
* New Setup Wizard – Get started faster with a guided onboarding experience
* Hotkey Support for Video Player – Control playback easily using keyboard shortcuts
* Centralized Hooks Architecture – Cleaner, more maintainable, and developer-friendly codebase
* Enhanced Like/Dislike Icons – Improved visuals for better user interaction
* Refined Gutenberg Block Architecture – More scalable, efficient, and future-proof blocks
* Updated Admin Button Styles – Cleaner design and improved usability
* Improved Shortcode Copy UI – Easier and clearer shortcode copying experience
* Enhanced Textarea Field Styling – Better readability and a more consistent admin UI

= 1.6.0 - Nov 16, 2025 =
* Feature: 🎬 Interactive Video Chapters – Add clickable chapters for seamless navigation, enhancing engagement and SEO.
* Feature: 📝 Dynamic Video Subtitles – Add precise, timed subtitles with multi-language and SEO support.
* Feature: 💰 Flexible VAST Video Ads – Display image, video, and text ads at any position, with smart monetization controls.
* Feature: ⚡ Smart Assets Loading – Load plugin assets intelligently per shortcode, with CDN/server support, smart caching, and inline/external CSS support.
* Improve uninstall process – Clean all options, meta, database entries, cache, and other data when plugin is deleted.
* Fix YouTube API key input field issue.
* Add PHP variable prefixes – Updated all variables as per WordPress standards and new regulations.
* Improve regenerate lookup table functionality – Added prefixes to avoid future conflicts.
* Remove unnecessary files from Lite version – Clean and optimized plugin package.
* Improve Pro field style in Lite version – Better UI/UX consistency.
* General code improvements – Optimized, cleaned, and improved performance.
* Update: Improved performance and compatibility with WordPress latest version.
* Update: Minor bug fixes and stability improvements.
* Update: POT file updated for translations.

= 1.5.1 - Oct 4, 2025 =
* Update: POT file

= 1.5.0 - Oct 4, 2025 =
* New: Added Ajax generator for YouTube Channel ID using handler  
* Fix: Resolved extra "Load More" click issue when no items remain in terms load more
* Fix: Carousel conflicts with Elementor  
* Fix: Corrected carousel style inconsistencies  
* Fix: Addressed carousel blinking on initial page load  
* Fix: Resolved field dependency issue  
* Fix: PHP 7.4 warning issue
* New: Introduced database lookup columns for views, rating count, and rating sum  
* New: Added YouTube Subscribe button type field with subscriber count option  
* Improvement: Enhanced video schema for better SEO visibility  
* Improvement: Optimized REST API endpoint  
* Improvement: Refined header section markup
* New: Added cron manager to automatically update lookup table with views
* New: Ajax Live Filter options (Pro)
* New: Ajax Live Filter with SEO friendly slug (Pro)
* New: Added YouTube Subscribe button in the section header (Pro)  
* New: Introduced Ajax Live Filter (Pro)  
* New: Added cursor and offset based pagination options panel (Pro)  
* New: Introduced dedicated Filter Controls (Pro)  
* New: Added sidebar style and border customization options (Pro)  
* New: Introduced live search filter (Pro)  
* New: Introduced fully responsive video gallery with your chosen YouTube or self hosted videos. (Pro) 
* New: Added filtering by multiple categories, tags, authors, resolutions, featured videos, order (ascending/descending), and video duration (Pro)  
* New: Added flexible filter pagination – Numbered, Load More, and Infinite Scroll (Pro)  
* New: Introduced sortable filters with a lot of customization and show/hide controls (Pro)
* Improve: Code optimization 
* Improve: JS & CSS code

= 1.4.0 - Sep 3, 2025 =
* New: Term Grid View Layout
* New: Term Grid View Layout With Term Font Icon & Image Icon
* New: Term Grid View Layout With Overlay Style (Pro)
* New: Term Carousel Layout
* New: Term Carousel Layout With Term Font Icon & Image Icon
* New: Term Carousel Layout With Overlay
* New: Term Ajax Load More
* New: Term Ajax Infinity Load More
* New: Term icon field option with font icon and image icon
* New: Term background image upload option
* New: Term style option with color, hover color, background, hover background color (Pro)
* New: Term name style option with color and hover color (Pro)
* New: Term border style option with border width, style, color, hover color, radius (Pro)
* New: Add “Taxonomy” Feed Source
* New: Taxonomy Styles tab
* New: Taxonomy Style layouts option
* New: Style priority option (Pro)
* New: Term count option
* New: Term alignment option
* New: Add “Load More Type” option
* New: Add display all terms and only selected terms option
* New: Display only selected YouTube videos
* New: Display only selected self hosted videos
* New: Add term icon or image size option
* New: Term card each sections drag and drop support
* Improve: Plugin performance
* Fix: Video single page responsive issue
* Improve: Code optimization 
* Improve: JS & CSS code
* Improve: Video query
* Improve: Gutenberg block
* Improve: Plugin security

= 1.3.0 - Aug 8, 2025 =
* New: Add "Player Settings" tab ( Global & Local ). (Pro)
* New: Add player settings switch option.
* New: Add play/pause button style options ( color, hover color, background, hover background ).
* New: Add play/pause button border style.
* New: Add player control bar style.
* New: Add player control all buttons style.
* New: Add player volume style.
* New: Add player progress bar style.
* New: Add "Visual Order" tab. (Pro)
* New: Add drag and drop support for Card/Video item Sections ( media, title, meta, description ).
* New: Add switch option for each section to show/hide.
* New: Add "Media Controls" tab.
* New: Add Media Controls switch to active or inactive.
* New: Add multi unit ( rem, px, % ) supported for "Media Frame Height" option.
* New: Add "Video Poster Control" show/hide option.
* New: Add "Recommended Image Size" select option.
* New: Add poster "Image Custom Size" option. (Pro)
* New: Add poster image "Hard Crop" option as default Soft Crop.
* New: Add "Convert to WebP" option (Pro)
* New: Add "Image Quality" option.
* New: Add Gutenberg supported single page, archive page template.
* Improve: Improved Gutenberg "Shortcode View" block. 
* Improve: Improved Gutenberg block folder structure to support limitless blocks in the near future.
* New: Add "Single Page" tab. 
* New: Add single page each section drag & drop supported. (Pro)
* New: Add "Related Posts Shortcode" field to show related posts/videos.
* New: Add single page style options.
* New: Add single page typography options.
* Improve: Improved admin UI.
* New: Add template header & footer ( Gutenberg & Classic template supported )
* New: Add built-in image optimizer.
* New: Add live demo showcase.
* New: Add YouTube video display mode option.
* New: Add YouTube video inline play.
* New: Add YouTube live video support.
* New: Add option to clear all cached data.
* Improve: Improved video, image and media responsive.

= 1.2.0 =
* New: Add YouTube source.
* New: Add YouTube Channel ID field.
* New: Add YouTube Playlist ID field.
* New: Add YouTube Thumbnail field.
* New: Add YouTube Feeds Api field.
* New: Add modern layouts support like grid, carousel and multi-row carouse to show YouTube feed.
* Improve: Improved plugin UI.

= 1.0.0 =
* Initial release of MediaHaven.
