=== Video Player Block ===
Contributors: bplugins, abuhayat, himur98
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: block, video embed, any video play, video play, Gutenberg block
Requires at least: 6.5
Tested up to: 7.0
Stable tag: 2.0.0
Requires PHP: 7.4
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Embed and play videos easily in the Gutenberg editor with a customizable and responsive Video Player Block for WordPress.

== Description ==

Video Player Block is a powerful and versatile WordPress plugin that lets you embed and play videos with style. Beyond the standard HTML5 player, it offers support for industry-leading engines like **React Video Player**, **Video.js**, and **Vidstack**, plus a full suite of Pro blocks — **Video Gallery**, **Playlist**, **Lightbox**, **Reels**, **Comparison**, **Testimonial Card**, and **Transcript** — making it the ultimate tool for professional video sites.

Whether you are showcasing YouTube, Vimeo, self-hosted MP4s, or external media from services like Amazon S3 or BunnyCDN, this plugin provides a clean, responsive, and highly customizable video experience directly within the Gutenberg editor.

**[Video Player Block](https://bplugins.com/products/video-player-block/)** | **[Documentation](https://bplugins.com/docs/video-player-block/)** | **[Demos](https://bblockswp.com/demo/video-player-block-all-demos/)**

=== Key Features – Free Version ===
- **Default HTML5 Video Player:** A clean, lightweight, and responsive player for standard self-hosted MP4, WebM, and OGG formats.

- **YouTube & Vimeo Native Support:** Easily embed and play YouTube and Vimeo videos within the customizable player skin.

- **Native Gutenberg Block:** Add videos directly from the WordPress editor with a dedicated, easy-to-use block.

- **Fully Responsive Design:** Automatically adjusts the video player for seamless viewing on desktops, tablets, and mobile devices.

- **Customizable Player Controls:** Easily show or hide basic player controls like play, volume, and fullscreen.

- **Rewind & Fast-Forward Buttons:** Toggle dedicated seek backward and seek forward buttons on the player.

- **Player Restart Button:** Add a dedicated button to easily restart the video from the beginning.

- **Download Button Toggle:** Easily enable or disable the video download option for your viewers.

- **Picture-in-Picture & AirPlay:** Toggle PiP and AirPlay options directly from the settings panel.

- **Shortcode Generator:** Generate and insert video players anywhere using shortcodes for maximum flexibility.

- **Poster Image Selection:** Choose and display custom video poster images directly from the WordPress media library.

- **Autoplay & Mute Options:** Control video behavior on page load with simple toggle settings.

- **Lightweight & Fast:** Built for performance to ensure your pages stay fast and user-friendly.

- **Unlimited Video Players:** Add multiple video players anywhere on your website without any restrictions.

- **Cross-Browser & iOS Friendly:** Fully compatible with Chrome, Firefox, Safari, Edge, and mobile devices (iPhone/Android).

=== Pro Version – Unlock Professional Video Power ===
The Pro version adds advanced player engines, streaming support, and deep customization for professional video websites.

== What's New in PRO? ==

= Advanced Player Engines & Blocks =

- **React Video Player Engine:** Access a cutting-edge player with complete customization based on React and Media Chrome.

- **Video.js Player Support:** Deliver industry-standard, high-compatibility media player layouts for professional websites.

- **Vidstack Player Engine:** Experience a premium, state-of-the-art player layout optimized for high performance.

= Pro Video Blocks =

- **Video Gallery:** Showcase multiple videos in grid, masonry, carousel, and bento layouts with category filters and an integrated lightbox player.

- **Video Playlist:** Pair a video player with a clickable episode queue featuring chapters, auto-advance, watched-state persistence, and Netflix/YouTube-style sequential viewing.

- **Video Lightbox:** Add a click-to-play trigger (thumbnail, button, or play-icon overlay) that opens any supported video in a responsive modal, deferring heavy player assets until the visitor opts in.

- **Video Reels:** Build a vertical, swipe-driven short-form video feed (TikTok / Instagram Reels / YouTube Shorts style) for any post, page, or template.

- **Video Comparison:** Reveal a draggable before/after slider that synchronously plays two videos side-by-side in real time.

- **Video Testimonial Card:** Create conversion-focused social-proof cards pairing a customer photo, attributed quote, star rating, and an inline-playable video clip.

- **Video Transcript:** Display a synchronized, clickable transcript alongside any video so viewers can jump to any moment and search engines can index the spoken content.

= Streaming, Sources & Styling =

- **HLS (.m3u8) Streaming:** Support for professional HLS streaming to deliver high-quality video efficiently.

- **DASH (.mpd) Streaming:** Support for professional MPEG-DASH streaming to deliver modern adaptive video.

- **Mux Video Integration:** Custom integration with Mux video servers for high-performance direct playback.

- **External Video Sources:** Support for Amazon S3, DigitalOcean Spaces, BunnyCDN, and other external hosting services.

- **Custom Aspect Ratios:** Change player layouts dynamically between 16:9, 4:3, 21:9, and custom dimensions.

- **Glassmorphism UI Controls:** Apply stunning blur and glassmorphic styling effects to player control backdrops.

- **Advanced Shadow & Borders:** Configure custom player box shadows, border styles, and inner/outer border radius.

- **Multiple Subtitle Support:** Add multilingual subtitle tracks (VTT) for global accessibility.

- **Playback Speed Control:** Custom granular playback speed options (0.5x to 2.0x) for professional viewers.

- **Lazy Loading & Preloading:** Defer video loading until visible in viewport to maximize Core Web Vitals.

- **Google Cast & Chromecast:** Wirelessly stream video content from the browser player to any Chromecast-enabled TV.

Try the Pro Version – Unlock the full potential of your video content today!

=== How to Use – Step-by-Step Setup ===
Getting started is easy!

1. Install and activate the Video Player Block plugin.
2. Open the Gutenberg editor.
3. Search for “Video Player Block”.
4. Add the block to your post or page.
5. Upload or select a video.
6. Customize the player settings from the right sidebar.
7. Publish the page and enjoy your responsive video player.

For installation help click on Installation Tab

[Live Demo](https://bblockswp.com/demo/video-player-block-all-demos/) | [Upgrade to Pro](https://bplugins.com/products/video-player-block-pro/)

=== Perfect For ===
- Video tutorials
- Online courses
- Product demonstrations
- Marketing videos
- Educational websites
- Portfolio websites
- Media websites
- Podcast video episodes
- Membership platforms

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

### Check out our other WordPress Plugins-

[**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.



== Third-Party Libraries ==

This plugin uses the following third-party libraries:

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


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


= Video Player Block by B Plugins =
* **Source:** [https://github.com/bPlugins/video-player-block-free]
* **License:** GPL-2.0-or-later – [https://www.gnu.org/licenses/gpl-2.0.html]
* **Purpose:** A Gutenberg block for embedding and playing videos with support for YouTube, Vimeo, and self-hosted HTML5 video files. Includes customizable controls, responsiveness, and various playback options.


== Build Process ==

This plugin uses a build process to generate the production assets (JS/CSS) located in the `build/` directory. The human-readable source code is available in the `src/` directory.

To build the plugin from source:
1. Clone the repository: https://github.com/bPlugins/video-player-block-free
2. Install dependencies: `npm install`
3. Run the build command: `npm run build`

Build Tools Used: Webpack, Babel, PostCSS.


== Installation ==

= From Gutenberg Editor: =
1. Go to the WordPress Block/Gutenberg Editor
2. Search For **Video Player Block**
3. Click on the **Video Player Block** to add the block

= Download & Upload: =
1. Download the **Video Player Block** plugin (*.zip file*)
2. In your admin area, go to the Plugins menu and click on **Add New**
3. Click on **Upload Plugin** and choose the **`video-player-block.zip`** file and click on **Install Now**
4. Activate the plugin and Enjoy!

= Manually: =
1. Download and upload the **Video Player** plugin to the **`/wp-content/plugins/`** directory
2. Activate the plugin through the Plugins menu in WordPress

== Frequently Asked Questions ==

= How do I install this plugin? =

You can install as other regular WordPress plugins. No different way. Please see on installation tab.

= What Video type can I play? =

You can play MP4, OGG, YouTube, and Vimeo video files.

= Does it support YouTube or Vimeo? =

Yes, the Video Player Block fully supports YouTube and Vimeo. Simply paste the video URL, and the block will automatically handle the embedding using the integrated player engine for a consistent and professional experience.

= How many players I can publish on my site? =

You can publish unlimited videos, there are no limits. 

= Will this plugin work/compatible with the theme I use? =

This plugin is compatible with most themes. But, unfortunately, we cannot check it with all third-party themes (especially paid ones) for compatibility, therefore there are cases when this plugin does not work with a third-party theme. We constantly check this plugin for compatibility with third-party themes. If we find that this plugin is incompatible with a third-party theme, and if we can fix it on our part, we release an update of our plugin to fix the problem.

If you find a conflict between our plugin and a third-party theme, please let us know and we will definitely release an update of our plugin to fix the problem.
 
= Will this plugin work/compatible with other plugins that I use? =

This plugin is compatible with most plugins. But, unfortunately, we cannot check it with all third-party plugins (especially paid ones) for compatibility, therefore there are cases when this plugin does not work with a third-party plugin. We constantly check this plugin for compatibility with third-party plugins. If we find that this plugin is incompatible with a third-party plugin, and if we can fix it on our part, we release an update of our plugin to fix the problem.

If you find a conflict between our plugin and a third-party plugin, please let us know and we will definitely release an update of our plugin to fix the problem.

= Where can I get support? =

You can post your questions on the [support forum here](https://wordpress.org/support/plugin/video-player-block/)

== Shortcodes ==

This plugin provides a shortcode to embed a saved Video Player anywhere in classic content, widgets, or page builders that do not support Gutenberg blocks.

`[video_player id="123"]`

Replace `123` with the ID of the Video Player post you have created via the **Video Player** custom post type menu.

== Screenshots ==

1. Video Player
2. Settings
3. Videojs Player
4. Vidstack Player
5. React Video Player
6. Video Gallery
7. Video Playlist
8. Video Lightbox
9. Video Reels
10. Video Comparison
11. Video Testimonial Card
12. Video Transcript

== Changelog ==

= 2.0.0 - 10 Jun 2026 =
* Add 7 new Pro video blocks: Video Gallery, Video Playlist, Video Lightbox, Video Reels, Video Comparison, Video Testimonial Card, and Video Transcript
* Add HLS (.m3u8) and DASH (.mpd) streaming support
* Add Mux video integration and external source support (Amazon S3, DigitalOcean Spaces, BunnyCDN)
* Add lazy loading, preloading, and Google Cast / Chromecast support
* Improve player styling: custom aspect ratios, glassmorphism controls, advanced shadow and border options
* General performance improvements and bug fixes

= 1.0.6 - 20 Nov 2024 =
* Fix multiple render issue
* Add 3 new advanced video player blocks (React, Video.js, Vidstack)
* Fix build error

= 1.0.5 - 8 Jan 2024 =
* Fix autoplay

= 1.0.4 - 1 Oct 2023 =
* Not loading the assets where the block is not added

= 1.0.3 - 1 Aug 2023 =
* Add translate feature

= 1.0.2 - 1 Jun 2023 =
* Reduce PHP Code.
* Performance Improvement

= 1.0.1 - 1 Apr 2023 =
* Reduce PHP Code.

= 1.0.0 - 1 Feb 2023 =
* Initial Release.