'array', 'sanitize_callback' => 'bw_youtube_embed_sanitize_settings', 'default' => array( 'acf_field' => 'youtube_link' ), ) ); add_settings_section( 'bw_youtube_embed_main_section', '', '__return_false', 'bw-youtube-embed' ); add_settings_field( 'bw_youtube_acf_field', 'ACF Field Name', 'bw_youtube_embed_render_acf_field', 'bw-youtube-embed', 'bw_youtube_embed_main_section' ); } add_action( 'admin_init', 'bw_youtube_embed_register_settings' ); /** * Sanitize callback. */ function bw_youtube_embed_sanitize_settings( $input ) { $output = array(); $output['acf_field'] = isset( $input['acf_field'] ) ? sanitize_text_field( $input['acf_field'] ) : 'youtube_link'; return $output; } /** * Render the ACF field name input. */ function bw_youtube_embed_render_acf_field() { $options = get_option( 'bw_youtube_embed_settings', array() ); $value = isset( $options['acf_field'] ) ? esc_attr( $options['acf_field'] ) : 'youtube_link'; ?>

Enter the ACF field name that contains the YouTube URL. Default: youtube_link

BW YouTube Embed Config

About This Plugin

BW YouTube Embed provides a Gutenberg block that automatically displays a YouTube video stored in an ACF (Advanced Custom Fields) field. The video is rendered with a responsive 16:9 aspect ratio so it looks correct at any screen size.

How to Use

  1. Create an ACF field (type: URL or Text) on the post type where you want YouTube videos. By default the plugin looks for a field named youtube_link. You can change this in the setting below.
  2. Add the YouTube URL to that field on any post/page. Supported formats: https://www.youtube.com/watch?v=XXXXX, https://youtu.be/XXXXX, https://www.youtube.com/embed/XXXXX, https://www.youtube.com/shorts/XXXXX
  3. Insert the block in the Gutenberg editor — search for “BW YouTube Embed” in the block inserter. The block will automatically pull the video from the ACF field and display it on the front end.

Using in a Kadence Query Loop

To display videos in a grid (e.g. a Videos archive page), add the BW YouTube Embed block inside a Kadence Query Loop card template. The block reads the ACF field from each post in the loop automatically — no shortcode or custom code needed.

Shortcode

This plugin also registers the [bw_youtube] shortcode for use in classic editor pages, widgets, or anywhere shortcodes are supported. It uses the same ACF field setting and renders with the same responsive 16:9 aspect ratio as the Gutenberg block.

Simply place [bw_youtube] in your content — no attributes needed. It automatically reads the ACF field from the current post.

Note: If the child theme also has a [bw_youtube] shortcode registered, remove it from the child theme’s functions.php to avoid conflicts.

Settings

]+)/', $youtube_url, $matches ) ) { $video_id = $matches[1]; } if ( $video_id ) { $embed_url = 'https://www.youtube.com/embed/' . rawurlencode( $video_id ); return '
'; } // No video — fall back to featured image. if ( has_post_thumbnail( $post_id ) ) { return '
' . get_the_post_thumbnail( $post_id, 'large', array( 'class' => 'bw-youtube-block__featured-img' ) ) . '
'; } return ''; } add_shortcode( 'bw_youtube', 'bw_youtube_shortcode_handler' ); /** * Enqueue the block front-end styles on pages that use the shortcode too. */ function bw_youtube_shortcode_styles() { global $post; if ( is_a( $post, 'WP_Post' ) && has_shortcode( $post->post_content, 'bw_youtube' ) ) { wp_enqueue_style( 'bw-youtube-block-style', plugin_dir_url( __FILE__ ) . 'blocks/bw-youtube/style.css', array(), '1.1.0' ); } } add_action( 'wp_enqueue_scripts', 'bw_youtube_shortcode_styles' ); /* ---------------------------------------------------------------- * Block registration * -------------------------------------------------------------- */ function bw_youtube_embed_register_block() { register_block_type( plugin_dir_path( __FILE__ ) . 'blocks/bw-youtube' ); } add_action( 'init', 'bw_youtube_embed_register_block' );