Changelog

Fixed

• Fixed afterLoaded throwing Uncaught TypeError: Cannot read properties of null (reading 'dataset') when the iframe video is not inside a .afc-video container; now guards against a missing parent before accessing dataset.playMuted.

Fixed

• Fixed onIframeMessage throwing a SyntaxError when the iframe posts a message with an already-parsed object (e.g. YouTube API); now checks typeof eventObject.data === "string" before calling JSON.parse(), and falls back to using the object directly

Fixed

• Fixed iframe videos inside lazy-loaded modals getting their src set to undefined because BaseIframeVideo.load() assumed data-src always existed; now guards against missing data-src so LazyLoader-set src is preserved.
• Fixed setupPreloadOnInteraction not detecting lazy-loaded iframes inside modals that use data-airfleet-src instead of data-src.

Added

• Added setupPreloadOnInteraction logic to preload lazy-loaded iframe videos (Vimeo, YouTube) on user interaction, preserving gesture context for unmute.
• Added running mute/unmute state override in afterLoaded in base class for all iframe videos.
• Added data-muted attribute to YouTube video template to support mute state override.
• Added component elements-components-video-unmute-button (display a custom unmute button for iOS Safari when video is not muted and autoplay is disabled; option to set custom text label)
• Added filter airfleet/elements/video-unmute-button/default_label (set default text label for the video unmute button - "Tap to unmute" by default)
• Added partial elements-partials-video-muted-icon (render a muted speaker icon for the unmute button)
• Added a global option to set the default label for the unmute button (default is "Tap to unmute")
• elements-components-video: Added show_unmute_button and unmute_button_label properties
• elements-components-video-overlay: Added rendering of the unmute button component

Fixed

• Fixed a bug where videos sometimes played hidden behind the poster due to race condition.
• Fixed videos incorrectly auto-playing when re-entering viewport if autoplay was "Disabled"; playback now resumes only if previously playing.
• Fixed self-hosted videos not autoplaying in Chrome when set to "in-view" by passing the autoplay attribute; added error handling for play() promise rejections.

Fixed

• Fixed deprecated warning parse_str(): Passing null to parameter #1

Changed

• elements-components-video-overlay: Added loading spinner animation styles for the afc-video--state-loading modifier class

Changed

• Breaking: Added new dependency - Airfleet Framework plugin - and removed scoped framework composer package
• Added plugin dependencies in main plugin file (Requires Plugins metadata field)
• Internal: Increased Node.js version requirement to >=24
• Internal: Bump npm dependency @airfleet/wordpress-dev to ^4.0.0
• Internal: Bump composer dependency airfleet/wordpress-dev to ^4.0.0
• Internal: Switched package manager to Bun
• Internal: Updated linters and development tools
• Internal: Updated configuration for development tools
• Internal: Moved configuration sections from package.json to dedicated config files
• Internal: Updated browserslist configuration
• Internal: Updated package.json scripts to use Airfleet CLI
• Internal: Updated README.md to remove Getting Started and Documentation sections
• Internal: Updated Plugin URI metadata field in main plugin file
• Internal: Updated GitHub workflows
• Migrated from @import to @use in SCSS

Added

• Added support for rewinding videos through event airfleet-video-rewind-request for all video type implementations (Wistia, Vimeo, YouTube, HTML5)

Changed

• Added support for additional Vimeo URL parameters including airplay, ask_ai, audio_track, and others

Changed

• Extend elements-components-video-file controller with elements-partials-video-file
• Extend elements-components-video-vimeo controller with elements-partials-video-vimeo
• Extend elements-components-video-wistia controller with elements-partials-video-wistia
• Extend elements-components-video-youtube controller with elements-partials-video-youtube

Changed

• Added support for forced previews by using helper $_should_show_preview() (requires latest Elements - Core plugin)
• Updated block editor preview text with more contextual information
• Used filter airfleet/elements/exclude_non_editor_scripts to exclude non-editor scripts when force previews are enabled

Fixed

• Fixed PHP warning in VimeoUrlParser when parsing Vimeo URLs

Fixed

• Updated the parsing of YouTube URLs to support shorts URLs

Fixed

• Fixed issue where assets could be incorrectly enqueued from non-dist folder

Changed

• Changed url format in video-wistia.entry.js //fast.wistia.com/assets/external/E-v1.js -> https://fast.wistia.com/assets/external/E-v1.js . This fixes issue with CookieYes plugin.

Fixed

• Fixed user events restoration. After userInteractionService highjacked user event, they needed to be properly restores and replayed - added code for that.

Changed

• Added support for loading background videos only after user interaction, even when videos are in viewport on page load (new option "Require User Interaction for Lazy-load")

Added

• Added support for muting/unmuting videos through events airfleet-video-mute-request and airfleet-video-unmute-request
• elements-components-video: Added CSS modifier class afc-video--state-muted/afc-video--state-unmuted indicating the status of the muted state

Changed

• Internal: Added .airfleet-license and .airfleet-visible

Added

• Added ability to initialize videos added through AJAX
• Added JS event airfleet-video-dynamic-init (Notifies when new video is added to page with AJAX)

Fixed

• background-video-youtube: Fixed return sddefault thumbnail if maxresdefault thumbnail doesn't exist.
• video-youtube: Fixed return sddefault thumbnail if maxresdefault thumbnail doesn't exist.

Changed

• Updated components to add support for airfleet/elements/empty/$slug filter

Fixed

• BaseIframeVideo: Removed extra check of Id match from iframe message. This will prevent GTM conflict with youtube.

Added

• Added component elements-components-video-play-button (render video button; option to set custom text label)
• Added filter airfleet/elements/video-play-button/default_label (set default text label for the video play button - empty by default)
• Added partial elements-partials-video-play-icon (render play icon for video button)

Changed

• BREAKING! elements-components-video-overlay: updated to include elements-components-video-play-button and updated styling
• BREAKING! elements-components-video-overlay: updated HTML structure and classes

Fixed

• elements-partials-video-wistia: prevents momentary height increase on init/loading state

Changed

• elements-components-background-video: added Airfleet tabs
• elements-components-video: added Airfleet tabs
• Excluded video components from having responsive options

Fixed

• elements-components-video: fixed editor preview image size and border radius
• elements-components-video: hide insert video source button when not empty
• elements-components-video: added support for seamless flexible content design

Changed

• elements-components-video: added CSS modifier class afc-video--controls-on/afc-video--controls-off indicating the status of the video controls
• elements-components-video-overlay: hide video overlay button when video is playing and has controls enabled

Changed

• Updated video components with new property show_preview

Fixed

• Added missing preview_size and preview_text to video components

Changed

• Updated video components to display placeholder image in editor when no video is selected
• Updated video components with new properties preview_size and preview_text (set size and text for placeholder image)

Changed

• elements-components-video-vimeo: set default aspect ratio to 16/9
• elements-components-video-youtube: set default aspect ratio to 16/9
• elements-components-background-video-vimeo: set default sizer to fullscreen cover
• elements-components-background-video-youtube: set default sizer to fullscreen cover

Changed

• BREAKING! elements-components-video-overlay: updated defaults style options to "Default" (Show play button), "None", and added CSS variables

Fixed

• Removed iframe border for YouTube and Vimeo videos

Added

• Added partial view elements-partials-video-vimeo (render a Vimeo video)
• Added partial view elements-partials-video-youtube (render a YouTube video)
• Added component view elements-components-video-vimeo (render a Vimeo video source)
• Added component view elements-components-video-youtube (render a YouTube video source)
• Added elements-components-video-vimeo to flexible component elements-video-source
• Added elements-components-video-youtube to flexible component elements-video-source
• Added video events: airfleet-video-loading
• Added a global option to set maximum file size for videos (default is 3 MB)
• Video Poster: added option to control poster visibility (hide on load, hide on play, keep in background)

Changed

• Added more modifier classes to elements-components-video

Fixed

• Fixed size of Wistia video placeholder when lazy-loading on play click

Added

• Added component view elements-components-video (render a video)
• Added flexible component elements-video-source (represents a type of video source)
• Added partial view elements-partials-video-file (render a video file)
• Added partial view elements-partials-video-wistia (render a Wistia video)
• Added component view elements-components-video-file (render a video file source)
• Added component view elements-components-video-wistia (render a Wistia video source)
• Added elements-components-video-file to flexible component elements-video-source
• Added elements-components-video-wistia to flexible component elements-video-source
• Added filter airfleet/elements/video/load_margin (set the margin for lazy-loading video when they are set to load when entering the viewport)
• Added filter airfleet/elements/video/play_margin (set the margin for auto-play/pause video when option is enabled)
• Renamed filter from airfleet/elements/background-video/video_load_margin to airfleet/elements/background-video/load_margin
• Renamed filter from airfleet/elements/background-video/video_play_margin to airfleet/elements/background-video/play_margin
• Added component view elements-components-video-overlay (display an overlay on top of a video, with style option to show a play button)
• Added filter airfleet/elements/video/overlay/style (set the style options for the video overlay)
• Added component view elements-components-video-poster (display a custom or default poster for the video)
• Added video events: airfleet-video-playing, airfleet-video-paused, airfleet-video-ended
• Renamed video event from airfleet-video-load-done to airfleet-video-loaded

Changed

• Improved reliability for video integrations

Added

• Added component view elements-components-background-video (render a video background)
• Added elements-components-background-video to flexible component elements-background
• Added flexible component elements-background-video-source (represents a type of video background source)
• Added component view elements-components-background-video-file (render a video file background)
• Added component view elements-components-background-video-vimeo (render a Vimeo video background)
• Added component view elements-components-background-video-youtube (render a YouTube video background)
• Added component view elements-components-background-video-wistia (render a YouTube video background)
• Added elements-components-background-video-file to flexible component elements-background-video-source
• Added elements-components-background-video-vimeo to flexible component elements-background-video-source
• Added elements-components-background-video-youtube to flexible component elements-background-video-source
• Added elements-components-background-video-wistia to flexible component elements-background-video-source
• Added video events: airfleet-video-load-request, airfleet-video-load-done, airfleet-video-play-request, airfleet-video-pause-request
• Added filter airfleet/elements/video/default_poster (set the default poster for a video)