WordPress.org

Plugin Directory

Better YouTube Block – A better way to embed YouTube videos, shorts, playlists

Better YouTube Block – A better way to embed YouTube videos, shorts, playlists

描述

The default embed block for YouTube videos sucks. It slows down your site. The more videos on the page the more it slow. This single-block plugin fixes that.

Why this block is better than the default one:

  • Instead of loading the entire iframe, only the video thumbnail is loaded, resulting in significant performance improvements
  • Ability to play multiple different videos as a custom playlist or input a playlist ID to play the whole playlist
  • Ability to use a custom image as the video thumbnail
  • Ability to set a custom aspect ratio value for displaying any kind of YouTube videos
  • Ability to loop continuously once it finishes playing
  • Ability to show related videos from the same channel as the initial video
  • Automatically load the video title as the caption
  • The same UI as the default core/embed, and you can use the video title as the caption of the block with one click
  • It can be transformed from/to the core embed block.
  • Automatically convert all default core embed YouTube blocks to this block with one line of code.

This plugin also provides a PHP API for developers to render a YouTube video URL as this block; or to automatically transform core/embed YouTube videos into this block.

The simplest example is:

    better_youtube_embed_block_render_block( ['url' => 'https://youtu.be/paSXmpHU9K4'] );

The example with all the parameters is:

    better_youtube_embed_block_render_block(
      [
        'url'               => 'https://youtu.be/paSXmpHU9K4',
        'aspectRatio'       => '16/9',
        'isMaxResThumbnail' => false,
        'thumbnailFormat'   => 'jpg',
        'caption'           => 'My awesome video',
        'customThumbnail'   => 'https://example.com/bg.jpg',
        'settings'          => ['loop' => 1, 'rel' => 0],
        'echo'              => false,
      ]
    );

To automatically transform all core/embed YouTube videos on your site to this block, you need to put the following code to the wp-config.php file or your theme/plugin:

    define('BYEB_SPEED_UP_YOUTUBE_VIDEOS', true);

or

    add_filter( 'byeb_speed_up_youtube_videos', '__return_true' );

On iOS, browsers like Safari and Chrome require two clicks to play videos. If you want to allow users to play videos with a single click, you need to add the following code to the wp-config.php file or your theme/plugin:

    define('BYEB_FORCE_IFRAME_ON_UNSUPPORTED_BROWSERS', true);

Please check out this page to see how fast it helps. The page contains around 30 embedded YouTube videos but they don’t slow down the page.

If this plugin is useful for you, please do a quick review and rate it on WordPress.org to help us spread the word. I would very much appreciate it.

Please check out my other plugins if you’re interested:

  • Content Blocks Builder – This plugin turns the Block Editor into a powerful page builder by allowing you to create blocks, variations, and patterns directly in the Block Editor without needing a code editor.
  • Meta Field Block – A block to display custom fields as blocks on the front end. It supports custom fields for posts, terms, users, and setting fields. It can also be used in the Query Loop block.
  • SVG Block – A block to display SVG images as blocks. Useful for images, icons, dividers, and buttons. It allows you to upload SVG images and load them into the icon library.
  • Icon separator – A tiny block just like the core/separator block but with the ability to add an icon.
  • Breadcrumb Block – A simple breadcrumb trail block that supports JSON-LD structured data and is compatible with WooCommerce.
  • Block Enhancements – Adds practical features to blocks like icons, box shadows, transforms, etc.
  • Counting Number Block – A block to display numbers with a counting effect

The plugin is developed using @wordpress/create-block.

屏幕截图

  • Block edit screen

  • Block settings

区块

该插件提供了 1 个区块.

  • Better YouTube Block – A better way to embed YouTube video, short, playlist Embed YouTube videos without slowing down your site.

安装

  1. Upload the plugin files to the /wp-content/plugins directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress

常见问题

What problem does this plugin solve?

It provides a better solution to embed YouTube videos than the default one.

Who needs this plugin?

Anyone can use this plugin.

评价

2025 年 11 月 28 日 1 回复
default embed block for YouTube videos sucks YouTube Block – A better way to embed YouTube videos, shorts, playlists – Cool plugin
2025 年 8 月 17 日 1 回复
Very easy to use and the php api function to add a block is great. I use it via a custom shortcode.
2025 年 3 月 23 日 1 回复
This one is essential if you have YouTube videos on your block site. Super simple and effective.
2025 年 3 月 4 日 1 回复
I’ve tried 10+ similar plugins to do similar things for youtube videos, but to put it simply, by far and large this was the best one.
2024 年 11 月 26 日 1 回复
Your plugin is a little gem. You’re a genius. Thanks a lot.
阅读所有16条评价

贡献者及开发者

「Better YouTube Block – A better way to embed YouTube videos, shorts, playlists」是开源软件。 以下人员对此插件做出了贡献。

贡献者

「Better YouTube Block – A better way to embed YouTube videos, shorts, playlists」插件已被翻译至 3 种本地化语言。 感谢所有译者为本插件所做的贡献。

帮助将「Better YouTube Block – A better way to embed YouTube videos, shorts, playlists」翻译成简体中文。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

1.1.4

Release Date – 06 January 2026

  • Added – Block binding support for the url and caption attributes.
  • Improved – Handling of the frontend script when hosts or cache plugins defer or delay it.

1.1.3

Release Date – 21 July 2025

  • Added – Support for loading WebP thumbnails to reduce file size.

1.1.2

Release Date – 06 January 2025

  • Fixed – The captions of old YouTube videos are not converted to this block when automatically transforming core/embed to this block.
  • Updated – Requires at least WordPress version 6.5

1.1.1

Release Date – 09 November 2024

  • Fixed – a CSS conflict between the play button and button styles in some themes

1.1.0

Release Date – 23 August 2024

  • Added – Play multiple videos or the whole playlist
  • Added – Loop continuously once it finishes playing
  • Added – Show related videos from the same channel
  • Added – Allow rendering embeded frame when browsers require click two times to play videos
  • Updated – Requires at least WordPress version 6.3

1.0.5

Release Date – 15 June 2024

  • Added – Support custom thumbnail for videos
  • Added – Allow editing media settings in the contentOnly mode
  • Updated – Change the ‘Requires at least’ to 6.0
  • Added – Support clientNavigation interactivity

1.0.4

Release Date – 23 February 2024

  • Added – Add a PHP API for developers to render a YouTube video URL as this block
  • Added – A new option to load high-resolution image
  • Added – Add the ability to render all core/embed for YouTube videos as this block

1.0.3

Release Date – 05 January 2024

  • Added – Custom aspect ratio
  • Added – Margin support feature

1.0.2

Release Date – 11 August 2023

  • DEV – Update to apiVersion 3
  • DEV – Change i18 texts for translation

1.0.1

Release Date – 21 April 2023

  • DEV – Add keywords to the block

1.0.0

  • Release Date – 23 November 2022*