=== MediaHaven - Video Gallery & HLS Player YouTube & TikTok ===
Contributors: wpninjadevs, jilani53
Tags: video gallery, youtube feed, tiktok feed, hls streaming, cdn
Requires at least: 5.9.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.6.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Commercial link: https://mediahaven.io/pricing/?ref=1

Auto HLS video streaming, Bunny CDN & responsive video galleries for WordPress. YouTube & TikTok feeds, secure streaming — free to start.

== Description ==

Is your WordPress site struggling under the weight of heavy video files?
Are your videos buffering, your server bills climbing, and your page
speed scores dropping?

**MediaHaven** solves all of that — with automatic HLS video streaming,
Bunny Cloud CDN offloading, and a powerful video gallery builder that
supports YouTube, TikTok, Vimeo, and 10+ more video sources.

**A free WordPress video plugin with automatic secure HLS
conversion built in — no manual encoding, no extra tools.**

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

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

## 🎬 Why MediaHaven is Different ##

Most video gallery plugins just embed videos. MediaHaven goes further —
it **hosts, secures, and delivers** your videos through a global CDN
with automatic HLS conversion, so every visitor gets smooth, buffer-free
playback regardless of their device or connection speed.

✅ One-click Sync to Bunny Stream — auto HLS conversion, free
✅ Secure signed URL delivery — videos can't be hotlinked or downloaded
✅ Bunny Cloud CDN integration — global delivery, zero server load
✅ 10+ video sources in one gallery — YouTube, TikTok, Vimeo and more
✅ SEO-ready with schema.org markup and WCAG accessibility built in

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

### ☁️ 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 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

### 📝 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:

| Key | Action |
|-----|--------|
| `Space` | Play / Pause |
| `F` | Toggle fullscreen |
| `M` | Mute / Unmute |
| `←` | Rewind 5 seconds |
| `→` | Fast-forward 5 seconds |
| `↑` | Volume up 10% |
| `↓` | Volume down 10% |
| `0–9` | Jump to % of video |

## 💎 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)

### ☁️ 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/)

### 💰 Shoppable Video & VAST Advertising — Turn Views Into Sales (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

🛍️ **Shoppable video for WooCommerce** — show clickable product cards
   inside videos at the exact moment viewers are most engaged
🛍️ **FluentCart & SureCart compatible** — works with modern WordPress
   eCommerce solutions out of the box
💥 **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/mhpro-video/custom-vast-video-advertising-pro-dynamic-positions-for-image-video-text-ads/)

## 🆓 Free vs 💎 Pro — What's the Difference ##

| Feature | Free | Pro |
|---------|------|-----|
| Bunny Stream CDN (video) | ✅ | ✅ |
| Auto HLS video conversion | ✅ | ✅ |
| Adaptive bitrate streaming | ✅ | ✅ |
| Secure signed URL delivery | ✅ | ✅ |
| Setup Wizard | ✅ | ✅ |
| 10+ video sources | ✅ | ✅ |
| Grid, Carousel, Multi-row layouts | ✅ | ✅ |
| Schema.org SEO markup | ✅ | ✅ |
| YouTube Feed AJAX Load More | ✅ | ✅ |
| Video view counter | ✅ | ✅ |
| AJAX like/dislike | ✅ | ✅ |
| Export & Import | ✅ | ✅ |
| Bunny Storage — all media offload | ❌ | ✅ |
| Ajax Live Filter | ❌ | ✅ |
| Drag & Drop layout builder | ❌ | ✅ |
| Custom player styles | ❌ | ✅ |
| Video chapters | ❌ | ✅ |
| Dynamic subtitles | ❌ | ✅ |
| VAST video ads | ❌ | ✅ |
| Shoppable video engine | ❌ | ✅ |
| Player & Gallery Unlimited Styles | ❌ | ✅ |
| WebP image conversion | ❌ | ✅ |
| Header right button | ❌ | ✅ |
| Priority support | ❌ | ✅ |

## 🌐 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** — turn product demos,
   unboxing clips, and review videos into shoppable moments.
   Fast-loading galleries that won't crush your hosting — with
   Pro VAST ads for direct in-video sales.
📣 **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.

📩 [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 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/mhpro-video/custom-vast-video-advertising-pro-dynamic-positions-for-image-video-text-ads/)

= 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.6.9 - Jun 16, 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
* 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 - Jul 28, 2025 =
* 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 - Jul 27, 2025 =
* Initial release of MediaHaven.
