=== 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.1.3
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, Wistia, or self-hosted HTML5 videos 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, Vimeo, Wistia, or self-hosted HTML5 video files.
- **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 ==

- **8 Premium Video Blocks**: Includes advanced blocks such as Video Slider, Carousel, Playlist Gallery, and Masonry Video Grid.
- **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, Vimeo, Wistia, and self-hosted HTML5 videos (Pro).

= 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.


== Changelog ==

= 1.1.3 - 21 May 2026 =
* Fixed: Prefixed the generic 'admin-post' script handles with plugin-specific prefix.
* Security: Fixed directory guideline issues.

= 1.1.2 - 10 May 2026 =
* Compliance: Standardized text domain to match plugin slug.
* Compliance: Added human-readable source code link.
* Compliance: Removed prohibited trialware file access restrictions.
* Security: Added sanitization and escaping to settings and shortcodes.
* Security: Added ABSPATH checks to all PHP files.
* Maintenance: Updated Plyr.js to the latest stable version.

= 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.