=== Enhanced YouTube Embed === Contributors: stevepuddick Tags: block, youtube, video, embed, responsive Tested up to: 6.9 Requires at least: 6.8 Requires PHP: 7.4 Plugin URI: https://wordpress.org/plugins/enhanced-youtube-embed/ Stable tag: 2.0.0 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html Enhanced YouTube embed block with comprehensive controls for playback, player settings, closed captions, and privacy. == Description == Enhanced YouTube Embed is a powerful block that extends the core WordPress YouTube embed block with extensive customization options and advanced features. Built on WordPress's native embed architecture, this plugin provides all the functionality of the core YouTube block plus comprehensive controls for playback, player appearance, closed captions, and privacy that aren't available in the standard block. **NEW in 1.0.0**: Complete rebuild using the official React.js block framework with improved performance, modern UI, and enhanced functionality. Features: * **Block Transforms**: Convert between Enhanced YouTube Embed and core YouTube embed blocks * **Easy URL Input**: Simply paste a YouTube URL to embed videos * **Responsive Embeds**: Automatically maintains 16:9 aspect ratio on all devices * **Live Preview**: See your embedded video in real-time while editing with all settings applied * **Caption Support**: Add rich-text captions to your embedded videos * **Smart Validation**: Intelligent start/end time validation prevents invalid ranges **Playback Settings:** * Auto-play videos on page load * Loop videos continuously * Mute videos by default * Set custom start and end times with smart validation * Control video playback timing **Player Controls:** * Hide/show player controls * Disable fullscreen mode * Plays inline on iOS devices * Customize player appearance **Player Appearance:** * Show only same-channel related videos (YouTube no longer allows completely hiding related videos) **Closed Captions & Language:** * Display closed captions by default * Set preferred caption language * Customize interface language * Full ISO 639-1 language support **Privacy:** * Privacy Enhanced Mode using youtube-nocookie.com * Reduced tracking before video playback (may help with GDPR compliance) The block integrates seamlessly with the WordPress block editor and follows WordPress coding standards and best practices. == Installation == 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 3. Use the block editor to add a "Enhanced YouTube Embed" block to your posts or pages 4. Paste a YouTube URL and customize settings in the block sidebar == Frequently Asked Questions == = What YouTube URL formats are supported? = The plugin supports all standard YouTube URL formats including: * https://www.youtube.com/watch?v=VIDEO_ID * https://youtu.be/VIDEO_ID * https://www.youtube.com/embed/VIDEO_ID * https://m.youtube.com/watch?v=VIDEO_ID = Can I auto-play videos? = Yes, enable the "Auto Play" option in the Playback Settings panel in the block sidebar. = How do I set a video to start at a specific time? = Use the "Start Time (seconds)" field in the Playback Settings panel to specify when the video should begin playing. = What is Privacy Enhanced Mode? = Privacy Enhanced Mode uses the youtube-nocookie.com domain, which may not track users until they actually play the video, providing better privacy protection. = Can I customize the player controls? = Yes, the Player Controls panel allows you to hide controls, disable fullscreen, mute audio, and control iOS playback behavior. = Can I convert between this block and the core YouTube embed? = Yes! Version 1.0.0 includes bidirectional block transforms. Simply use the block toolbar to transform between Enhanced YouTube Embed and the core YouTube embed block. = How do I enable closed captions? = In the Closed Captions & Language panel, enable "Display Closed Captions by Default" and optionally set your preferred caption language using an ISO 639-1 two-letter code. == Screenshots == 1. Enhanced YouTube Embed block with URL input 2. Comprehensive sidebar settings panels 3. Playback settings including auto-play and timing controls 4. Player controls and customization options 5. Player appearance - only show related videos from same channel 6. Closed captions and language settings 7. Privacy Enhanced Mode toggle 8. Select block == Changelog == = 1.0.0 = * **MAJOR UPDATE**: Complete rebuild using official React.js block framework * **Breaking Change**: Not backwards compatible with previous versions * **New**: Block transforms - convert to/from core YouTube embed block * **New**: Mute option for videos * **New**: Plays inline setting for iOS devicesdde * **New**: Smart start/end time validation * **Improved**: Settings now apply to editor preview in real-time * **Improved**: Interactive overlay behavior matches core blocks * **Improved**: Responsive toggle functionality with proper class management * **Updated**: Removed deprecated YouTube parameters (annotations, modest branding) * **Updated**: Related videos setting now accurately reflects YouTube's behavior (same-channel only) * **Updated**: Icon changed from red to gold for better visual distinction * **Fixed**: Width/height attributes now properly set when responsive mode is disabled * **Fixed**: Media settings panel structure matches core blocks = 0.1.0 = * Initial release * YouTube URL input and validation * Responsive embed with aspect ratio control * Live preview in editor * Caption support * Playback settings (auto-play, loop, start/end times) * Player controls (hide controls, disable fullscreen, hide annotations) * Related videos and branding options * Closed captions with language selection * Interface language customization * Privacy Enhanced Mode * Integration with WordPress core embed functionality == Upgrade Notice == = 1.0.0 = **IMPORTANT**: Version 1.0.0 is a complete rebuild and is not backwards compatible with previous versions. Existing blocks will need to be recreated. Please backup your content before updating. This version uses the modern React.js block framework for improved performance and functionality. = 0.1.0 = Initial release of Enhanced YouTube Embed with comprehensive customization options.