=== Video Gallery Block ===
Contributors: bplugins, abuhayat, charlescormier, himur98
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: block, video gallery, youtube video gallery, vimeo video gallery, masonry video gallery
Requires at least: 6.5
Tested up to: 7.0
Stable tag: 1.4.0
Requires PHP: 7.4
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Display your videos as a gallery in a professional way

== Description ==

[Video Gallery Block](https://bplugins.com/products/video-gallery-block) is a lightweight WordPress video gallery plugin that lets you create responsive video galleries, grids, and lightbox popups directly inside the Gutenberg block editor.

**[Video Gallery Block](https://bplugins.com/products/video-gallery-block)** | **[Pricing](https://bplugins.com/products/video-gallery-block/pricing/)** | **[Support](https://bplugins.com/support/)** | **[Demo](https://bblockswp.com/demo/video-gallery)**

Display YouTube, Vimeo, self-hosted HTML5, or Wistia videos (supported in select Pro blocks) in clean and modern gallery layouts without writing any code. Organize videos using albums and filters, show them in responsive grids, and open videos in a smooth lightbox popup for a better viewing experience.

This Gutenberg video gallery block is perfect for creating video portfolios, testimonial sections, product video showcases, YouTube galleries, and Vimeo collections on any WordPress website.

=== Key Features – Free Version ===
The free version includes everything needed to build responsive video galleries in the Gutenberg editor.

- **Responsive Video Gallery Block**: Create video galleries with clean grid layouts that automatically adapt to desktop, tablet, and mobile screens.
- **Album & Filter System**: Organize videos into albums and allow visitors to filter videos by category.
- **Responsive Column Layouts**: Set different column numbers for Desktop, Tablet, and Mobile devices.
- **Multiple Video Sources**: Add videos from YouTube and Vimeo (Wistia & self-hosted HTML5 video files supported in Pro).
- **Custom Styling Controls**: Adjust gallery spacing, padding, borders, backgrounds, and shadows directly from the block settings.
- **Automatic or Custom Thumbnails**: Automatically generate thumbnails from videos or upload custom poster images.
- **Video Captions**: Add captions or titles to each video displayed in the gallery.
- **Lightbox Video Popup**: Play videos in an elegant popup lightbox for an immersive viewing experience.
- **Optimized Script Loading**: Scripts only load when the block is used, helping maintain site performance.
- **Translation Ready**: Fully compatible with multilingual websites.

=== Video Gallery Block Pro – Unlock Advanced Video Layouts ===
[Video Gallery Block Pro](https://bplugins.com/products/video-gallery-block/pricing/) extends the plugin with additional Gutenberg video blocks and advanced gallery layouts.

== Pro Features Include ==

- **31 Premium Video Blocks**: Includes advanced blocks such as Video Slider, Carousel, Playlist Gallery, Masonry Video Grid, Lightbox Video Gallery, Parallax Row Video Gallery, Slider Autoplay Video, Video Testimonial Section, Video Podcast Episodes, Video Stories, Video Shorts Reel, Video Showcase Wall, Video Curriculum Accordion, Video Hotspot Scene, Video Tabs Gallery, Video Scrollytelling Showcase, Video Timeline Gallery, Video Bento Grid, Video Comparison Gallery, Video Justified Gallery, Video Expanding Panels, Video Wall with Floating Player (PiP), Video Swipe Deck, Video Marquee Wall, Video Flip Cards Gallery, Video Map Gallery, Video Property Tour Gallery, Video Workout Planner, Video Wedding Story Gallery, Video Menu Showcase, and Video Feature Tour.
- **Masonry & Mixed Ratio Layouts**: Display videos in dynamic masonry galleries or mixed aspect ratio grids.
- **Video Sliders & Carousels**: Create interactive video sliders with autoplay and navigation controls.
- **Playlist Video Gallery**: Build organized video playlists with navigation and sequential playback.
- **Parallax Video Sections**: Add background video sections with parallax scrolling effects.
- **Advanced Typography & Overlays**: Customize titles, captions, and overlay effects for each video.
- **Custom Navigation & Player Controls**: Control slider navigation, autoplay behavior, and player interactions.
- **WooCommerce Video Product Carousel**: Show product videos in carousel layouts for WooCommerce stores.
- **Priority Support**: Get faster assistance and updates.

[Try the Video Gallery Block](https://bplugins.com/products/video-gallery-block/pricing/)  – Unlock all premium features now!

=== How to Use Video Gallery Block – Step-by-Step Guide ===

Getting started with the Video Gallery Block is quick and easy!

== Step-by-Step Instructions ==

== Insert the Video Gallery Block ==

- Open any Page or Post in the WordPress Block Editor (Gutenberg).
- Click the + (Add Block) button.
- Search for “Video Gallery Block.”
- Insert the block into your page.

== Add and Organize Videos ==

After inserting the block, configure the gallery using the block settings panel:

- Add video URLs from YouTube, Vimeo, or self-hosted sources.
- Create albums for filtering videos.
- Adjust column numbers and gallery layout.
- Customize gallery styling options.
- Enable or disable filter buttons.

== Using Premium Blocks ==
When you try to insert a Pro block (such as Video Slider or Parallax Row) while using the free version:

- A placeholder block will appear.
- The block includes a [Get Premium](https://bplugins.com/products/video-gallery-block/pricing/) button.
- You can remove the placeholder if you choose not to upgrade.

== Preview and Publish ==

Preview the page to see how your video gallery appears on different devices, then publish your page.

For installation help, see the Installation tab.

[Live Demo](https://bblockswp.com/demo/video-gallery) | [Get Video Gallery Block PRO](https://bplugins.com/products/video-gallery-block/pricing/)


= Feedback =

- Did you like this plugin? Dislike it? Do you have a feature request? [Please share your feedback with us](mailto:support@bplugins.com 'Send feedback')


### Check Out The Parent Plugin of This Plugin-

[**B Blocks**](https://bblockswp.com) – A blocks collection and page building tool for Gutenberg.


= Related Plugins =

Other plugins by our team:

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**Html5 Audio Player**](https://bplugins.com/products/html5-audio-player/) – Listen audios with awesome visuals.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) – Embed 3D models and 3D products with interaction.

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) – Show posts and custom posts in different layouts.


== Source Code ==

The non-minified source code for this plugin is available on our public repository:
[GitHub Repository](https://github.com/bPlugins/video-gallery-block-free)

== Third-Party Libraries ==

= bpl-tools =
* Source / GitHub: https://github.com/bPlugins/bpl-tools
* License: GPL-2.0-or-later – https://www.gnu.org/licenses/gpl-2.0.html
* Purpose: Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* External Services: The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: https://github.com/bPlugins/bpl-tools#external-requests--why-they-are-made

= Freemius Lite SDK =
* **Source:** [https://bplugins.com/](https://bplugins.com/)
* **GitHub:** [https://github.com/bPlugins/freemius-lite-sdk](https://github.com/bPlugins/freemius-lite-sdk)
* **License:** GPL-2.0-or-later – [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html)
* **Purpose:** Provides an opt-in consent form for usage tracking and analytics to help improve the plugin. No data is sent before explicit user consent.
* **External Services:** Communicates with `api.bplugins.com` (activation events) and `wp.freemius.com` (opt-in processing) only after user opt-in. See [bPlugins Privacy Policy](https://bplugins.com/privacy-policy) and [Freemius Privacy Policy](https://freemius.com/privacy/).

= Isotope =
* Source / Website: https://isotope.metafizzy.co/
* License: GPL-3.0 – https://isotope.metafizzy.co/license.html
* Purpose: Layout library to filter and sort video gallery items.

= Plyr =
* Source / GitHub: https://github.com/sampotts/plyr
* License: MIT – https://github.com/sampotts/plyr/blob/master/LICENSE.md
* Purpose: Media player control wrapper for YouTube, Vimeo, and self-hosted HTML5 video files.

= Fancybox =
* Source / Website: https://fancyapps.com/fancybox/
* License: GPL-3.0 – https://fancyapps.com/license/
* Purpose: Lightbox library used to pop up and play videos when clicked in the gallery layout.


== Installation ==

= From Gutenberg Editor =

1. Open the block editor.
2. Click Add Block (+).
3. Search for "Video Gallery Block".
4. Insert the block.

= Upload Plugin =

1. Download the plugin ZIP file.
2. Go to Plugins → Add New → Upload Plugin.
3. Upload `video-gallery-block.zip`.
4. Click Install Now and activate.

= Manual Installation =

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin from the Plugins menu.


== Development ==

This plugin uses modern JavaScript (React/ES6) compiled via Webpack.
To compile the source code, please follow these steps:
1. Clone the repository: `git clone https://github.com/bPlugins/video-gallery-block-free.git`
2. Navigate to the plugin directory: `cd video-gallery-block-free`
3. Install dependencies: `npm install`
4. Compile the production assets: `npm run build`


== Frequently Asked Questions ==

= Is Video Gallery Block free? =
Yes. The free version includes albums, filters, captions, thumbnails, and basic styling. A Pro version is available with advanced features.

= What extra features are included in Pro? =
Pro unlocks sliders, carousels, advanced layouts, typography controls, and additional video sources.

= Does it work with any WordPress theme? =
Yes. It is compatible with all modern WordPress themes.

= Can I customize the gallery design? =
Yes. Free users can customize layout and basic styling. Pro users get advanced design controls.

= Can I create multiple video galleries? =
Yes. You can create unlimited galleries across your site.

= Is it mobile-friendly? =
Yes. The gallery is fully responsive.

= Can I use my own video files? =
Yes. You can use YouTube and Vimeo in the free version. Self-hosted HTML5 and Wistia video sources are supported in select Pro layouts.

= How do I get support? =
Free users can use the WordPress.org support forum.  
Pro users receive priority email support.


== Screenshots ==

1. Video Gallery Block – Default Layout.
2. Video Testimonial Section.
3. Parallax Video Gallery.
4. Video Slider.
5. Autoplay Video Slider.
6. Lightbox Video Gallery.
7. Masonry Video Grid.
8. Video Playlist Gallery.
9. Video Carousel.
10. Gutenberg Block Settings.
11. Classic Shortcode Generator.
12. Video Shorts Reel.
13. Video Showcase Wall.
14. Video Curriculum Accordion.
15. Video Hotspot Scene.
16. Video Tabs Gallery.
17. Video Scrollytelling Showcase.
18. Video Timeline Gallery.
19. Video Bento Grid.
20. Video Comparison Gallery.
21. Video Justified Gallery.
22. Video Expanding Panels.
23. Video Wall with Floating Player (PiP).
24. Video Swipe Deck.
25. Video Marquee Wall.
26. Video Flip Cards Gallery.
27. Video Map Gallery.
28. Video Stories.
29. Video Podcast Episodes.
30. Video Property Tour Gallery.
31. Video Workout Planner.
32. Video Wedding Story Gallery.
33. Video Menu Showcase.
34. Video Feature Tour.


== Changelog ==

= 1.4.0 - 18 June 2026 =
* Added 23 new premium blocks including Video Shorts Reel, Video Showcase Wall, Video Curriculum Accordion, Video Hotspot Scene, Video Tabs Gallery, Video Scrollytelling Showcase, Video Timeline Gallery, Video Bento Grid, Video Comparison Gallery, Video Justified Gallery, Video Expanding Panels, Video Wall with Floating Player (PiP), Video Swipe Deck, Video Marquee Wall, Video Flip Cards Gallery, Video Map Gallery, Video Stories, Video Podcast Episodes, Video Property Tour Gallery, Video Workout Planner, Video Wedding Story Gallery, Video Menu Showcase, and Video Feature Tour.
* Introduced a redesigned admin dashboard with an improved user experience.
* Performance: Greatly improved page performance when several video blocks are used on the same page.
* Performance: Videos no longer load data in the background — they now load only when played (on hover or click), reducing bandwidth and CPU usage and keeping scrolling smooth.
* Parallax Row Video Gallery: Fixed scroll stuttering by switching the parallax effect to GPU-accelerated, requestAnimationFrame-based updates and rendering posters instead of video elements until played.
* Video Carousel Gallery: Cards now show a poster image and load the video only on hover; off-screen videos are fully released.
* Video Slider: Now uses click-to-play, so videos no longer stream in the background.
* Video Testimonial Section: Idle cards render lightweight poster images instead of video elements, and card heights are now consistent.
* Video Playlist Gallery: Up Next durations now load lazily, and fixed an issue where selecting a video from the playlist did not start playing.
* Minor fixes and styling updates.

= 1.1.2 - 10 May 2026 =
* Compliance updates and security enhancements for directory guidelines.

= 1.1.1 - 12 Aug 2025 =
* Fixed minor issues.
* Added 8 new block styles.
* Added new shortcode styles.
* Added new dashboard.

= 1.1.0 - 30 Jan 2025 =
* Updated Fancybox library to v5.

= 1.0.8 - 27 Nov 2024 =
* Added option to hide the "All" album filter.

= 1.0.7 - 27 Nov 2024 =
* Added custom label option for common filter.

= 1.0.6 =
* Added gallery shadow options.

= 1.0.5 =
* Improved vertical video height handling.

= 1.0.4 =
* Added video captions.
* Prevented loading scripts when block is not used.

= 1.0.3 =
* Added translation support.

= 1.0.2 =
* Fixed add/remove video issues.

= 1.0.1 =
* Automatic video thumbnail generation.

= 1.0.0 =
* Initial release.