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,
        '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 – A tool to create blocks, patterns or variations easily for your site directly on the Block Editor.
• Meta Field Block – A block to display a meta field or an ACF field as a block. It can also be used in the Query Loop block.
• Block Enhancements – A plugin to add more useful features to blocks like icons, box-shadow, transform, hover style etc.
• Icon Separator – A tiny block just like the core/separator block but with the ability to add an icon to it.
• SVG Block – A block to insert inline SVG images easily and safely. It also bundles with more than 3000 icons and some common non-rectangular dividers.
• Counting Number Block – A block to display a number that has the number-counting effect.
• Breadcrumb Block – A simple breadcrumb trail block that supports JSON-LD structured data.

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

Screenshots

Categories