Changelog

Added

• Added UpgradeAirfleetBlockVersion feature to dynamically upgrade the block API version to 3 for all Airfleet blocks
• Added ACF toggle (upgrade_block_api_version) and filter (airfleet/views/blocks/upgrade_api_version) to control Block API version 3 upgrade per-site

Changed

• Changed EnqueueFactory::enqueue_editor() to always use inline styles for block editor iframe compatibility
• Changed EnqueueFactory to route admin screen styles through enqueue_block_assets when in the block editor, so *.admin.entry.scss view styles reach the iframe

Added (new files)

• Added BlockEditorEnqueueStyle class to enqueue styles via enqueue_block_assets for block editor iframe support

Fixed

• Fixed fatal error Uncaught TypeError: array_merge(): Argument #1 must be of type array, string given that resulted from undefined variables for components without field groups

Added

• Added filter airfleet/views/dependencies/{view_slug}/{screen}/{type} to declare script dependencies for views
• Added filter airfleet/views/enqueue/scripts/inline/attributes to modify inline script attributes (type and other attributes). Receives params: $attributes (array with 'type' and 'attributes' keys), $handle, $source
• Added filter airfleet/views/enqueue/scripts/source/attributes to modify source script attributes (type and other attributes). Receives params: $attributes (array with 'type' and 'attributes' keys), $handle, $source, $version
• Added support for data-*-src attributes (e.g., data-airfleet-src) in source scripts. When a script has a data-*-src attribute, the src attribute is not output as the script source is handled via the data attribute
• Added view slug as data-af-view attribute to view context
• Added dependency information to inline scripts via data-dependencies attribute

Changed

• Breaking: Increased PHP version requirement to >=8.2
• 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
• Internal: Added .airfleet-license and .airfleet-visible

Changed

• Bump composer dependency airfleet/wordpress-framework to ^1.19.1

Fixed

• Fixed issue with not loading all field groups

Changed

• Changed setting "ACF Local JSON Cache" to disabled by default
• Bump composer dependency airfleet/wordpress-framework to ^1.19.0

Fixed

• Fixed errors related to Setup/Controller classes extending from other Setup/Controllers that were loaded in the wrong order.

Fixed

• Fixed error message "Updating failed. The response is not a valid JSON response." that appeared when editing blocks and benchmarking option was enabled.

Added

• Added object caching to views registration service (the process of finding all views and related resources and registering them)
• Added object caching to the registration of assets with WordPress (ACF blocks, block patterns, custom page templates, template hierarchy)
• Added object caching to the setup process of enqueueing resources
• Added object caching for inline scripts and styles
• Added object caching for avoiding undefined variables
• Added options to control cache: clear cache, enable/disable general cache, enqueue file contents strategy, ACF Local JSON cache, ACF Add-ons cache, cache expiration, enable/disable directory checks cache, directory checks expiration.
• Added basic cache stats to the options page
• Added filter airfleet/views/enqueue/contents/strategy to set the caching strategy for file contents used in inline enqueue. Valid values are: discovery (cache on discovery), demand (cache on demand), static (don't cache).
• Added a benchmarking feature. When enabled, an HTML comment will be printed at the end of the page with the amount of time in milliseconds it took to run certain features. The comment is only displayed for authenticated users.

Changed

• Instantiation of Setup classes now only happens after views registration is done, right before initialization of the setup classes (this allows Setup classes to inherit from other Setup classes that only registered after)
• Added lightweight static caching in key places (setup actions, enqueue screen detection, views rendering, enqueue discovery, inline enqueue, enqueue registry)
• Bump airfleet/wordpress-framework to 1.18.3
• Debugger: Now only runs in admin context
• Debugger: Consolidated error notices for undefined classes
• Debugger: Refactored code for improved performance
• Internal: Refactored registration service to separate between discovery phase (costly, can be cached) from setup phase
• Options: Moved Versions tab lower in the Views settings
• Updated filter "airfleet/views/enqueue/{$view_slug}/{$screen}/{$type}" - added params $view_slug, $screen, $type

Changed

• Changed default values for Views default enqueue options and updated Values for that option to with postfix - (Default)

Added

• Added filter airfleet/views/can_render to control view rendering based on access restrictions (e.g., for blocks hidden from anonymous users)

Fixed

• Fixed when head_inline enqueue scripts were hanging in the air due to wp_head already firing before they were enqueued.

Added

• Added $_history helper (an array that provides contextual information about the views history rendered so far)
• Added $_view_history helper (an array that provides contextual information about the current view being rendered and its parents)
• Added $_parents helper (an array that provides contextual information about the parents of the current view being rendered)
• Added $_parent helper (an array that provides contextual information about the immediate parent of the current view being rendered)

Changed

• Updated views history to include each views data and child index (enriches $history param for filters airfleet/views/context and airfleet/views/enqueue/{$slug}/method)

Added

• Added an option (enabled by default) to prevent missing Controller and Setup classes from causing a fatal error in the admin backend. When the option is enabled, an admin notice will be displayed for each undefined class with information where it is called

Changed

• Bump airfleet/wordpress-framework to 1.15.0

Added

• Added filter airfleet/views/enqueue/scripts/critical/inline/data-attributes to customize data attributes for critical view scripts

Fixed

• Fixed issue with Head/Footer Inline enqueue methods not always firing.
• Fixed assets paths in inline styles enqueue.
• Fixed JS error for scripts loaded inline after/before (e.g. && being escaped to &&).

Fixed

• Fixed frontend assets being enqueued in editor sometimes
• Bump airfleet/wordpress-framework to 1.11.1

Changed

• Bump airfleet/wordpress-framework to 1.11.0 (performance improvements and string helpers)
• Small performance improvements related to view registration string conversion and avoid undefined variable feature

Fixed

• Fixed frontend/critical assets being enqueued in editor and editor assets not being enqueued when block is first added on a page

Added

• Added view versioning support (create sub-folders within a view folder for each version, e.g. "v1", "v2", "v3")
• Added filter airfleet/views/version/{$slug} - set view version to load (e.g. "default", "v1", "v2", "v3")
• Added filter airfleet/views/versions/{$slug} - all available versions for a specific view
• Added filter airfleet/views/versions - all views and related versions
• Added message in options with available versions for views that have multiple versions

Fixed

• Fixed Block/Component tab custom groups not saved to view folder

Changed

• Fix version number

Added

• Added enqueue styles options: Head (default), Head Async, Head Inline, Head Preload, View Async, View Inline, Footer, Footer Inline
• Added enqueue scripts options: Footer (default), Footer (Async), Footer (Inline), Head, Head Defer, Head Inline, View Async After, View Defer After, View Inline After, View Inline Before
• Added enqueue styles options to force a different enqueue method for first blocks on a page
• Added action airfleet/views/enqueue_after/{$slug} - trigger enqueue for a view after the view is rendered
• Added 1st param to action airfleet/views/enqueue/{$slug} to indicate which enqueue method to use
• Added 3rd param to action airfleet/views/context - rendering information for current view (array with keys: slug, index, parents)
• Added 4th param to action airfleet/views/context - rendering history for all views
• Added filter airfleet/views/enqueue/{$slug}/method - filter enqueue method for a view

Fixed

• Set correct empty value type for undefined ACF fields that are set to have multiple values (e.g. select with multiple choices)

Added

• Automatically set empty values for block/component undefined fields to avoid undefined variable warnings

Fixed

• Fixed block ID attribute not being set (native "Advanced > HTML Anchor" setting)
• Fixed block CSS classes set in editor not being added (native "Advanced > Additional CSS Class(es)" & block styles settings)

Fixed

• Fixed unrelated blocks not getting registered when one of the blocks lacks JSON metadata file

Fixed

• Skip block patterns registration when enqueue_only flag is set

Added

• Added Block Patterns registration
• Added Create "Airfleet" pattern category setting
• Added Add Views blocks to "Airfleet" category by default setting
• Added filter airfleet/views/patterns/properties (filter pattern properties; refer to https://developer.wordpress.org/reference/classes/wp_block_patterns_registry/register/)

Added

• Added API Function airfleet_view_start: Starts an instance to initiate a render for a view
• Added API Function airfleet_view_end: Ends the view render instance started by airfleet_view_start
• Added API Function airfleet_view_to_string: Renders a single view into an HTML string and returns the result
• Added API Function airfleet_views_to_string: Renders one or more views into an HTML string and returns the result

Added

• id attribute is now set for blocks based on the value of the anchor that the user sets in the block editor

Changed

• ACF Local JSON files for blocks, components, and custom templates are now saved with filename format {slug}.acf-group.json (other formats are still supported for loading/re-saving/deleting)

Changed

• BREAKING: the block editor now only enqueues no-suffix or .editor styles/scripts (previously, if you created .frontend or .critical they would also be enqueued for the block editor)

Fixed

• Fixed issue when passing null data to view render

Fixed

• Fixed empty view folders causing other views not to load

Changed

• airfleet/views/config filter: added an optional param enqueue (defaults to true) - whether to enqueue styles/scripts
• airfleet/views/config filter: added an optional param enqueue_only (defaults to false, except for /dist folders where it defaults to true) - only enqueue styles/scripts and do nothing else

Fixed

• Fixed PHP template rendering when path contains more than one "."

Changed

• airfleet/views/config filter: added an optional param sync_local_json (defaults to true, except for /dist folders where it defaults to false)

Fixed

• Fixed issue where ACF custom fields would not be synced properly if dist folder had higher priority than normal folder

Added

• Added support for slots using new helpers $_view_start and $_view_end (print slot using $_slot)
• Added $_slot helper to ensure the variable always exists
• Added support for named slots using new helpers $_slot_start and $_slot_end (this allows to insert any HTML/PHP into a variable inside a view)

Added

• Added view helper $_view_to_string: render one or more views to a string

Fixed

• Fixed ACF blocks setup error caused by empty fields

Changed

• Set composer vendor-scoped autoloader-suffix based on plugin name

Removed

• BREAKING: removed filter airfleet/views/context/{$slug} (use airfleet/views/context instead)

Changed

• Updated function airfleet_views_render() and helper $_view() to support a variable number of data arrays (arrays are merged together)

Removed

• BREAKING: removed helper $_asset_url (migrated to Airfleet Elements - Core)
• BREAKING: removed helper $_attrs (migrated to Airfleet Elements - Core)
• BREAKING: removed helper $_data_attrs (migrated to Airfleet Elements - Core)
• BREAKING: removed helper $_dump (migrated to Airfleet Elements - Core)
• BREAKING: removed helper $_in_block_editor (migrated to Airfleet Elements - Core)
• BREAKING: removed helper $_reusable_block (migrated to Airfleet Elements - Core)
• BREAKING: removed helper $_val (migrated to Airfleet Elements - Core)
• BREAKING: removed helper $class (migrated to Airfleet Elements - Core)

Added

• Added view helper $_view: render a view

Changed

• BREAKING: removed ACF location "Airfleet Views Block" (migrated to ACF Add-ons plugin)
• Changed menu location to appear under Settings

Changed

• Added a proxy for WP hierarchy templates and custom page templates (necessary for other rendering engines like Blade)
• Added filter 'airfleet/views/proxy' - filter proxy data

Fixed

• Fixed ACF JSON file not being saved to view folder for custom page templates

Added

• Added action 'airfleet/views/register' - runs after each single view is registered

Added

• Added ACF blocks registration
• Added filter "airfleet/views/blocks/{$slug}/json" - get block.json path for specific block
• Added a custom ACF location to target Views blocks
• Added option for creating "Airfleet" block category
• Added option for adding blocks to "Airfleet" block category by default
• Added view helper $class: ensures $class variable is always set

Fixed

• Fixed an issue where frontend resources would not be enqueued in block editor preview

Added

• Added components registration
• Added custom page templates registration
• Added WordPress hierarchy templates registration
• Added view helper $_in_block_editor: check if inside the block editor
• Added view helper $_reusable_block: render a reusable block
• Added view helper $_asset_url: get the compiled URL to an asset
• Added view helper $_attrs: render attributes for HTML element
• Added view helper $_data_attrs: render data attributes for HTML element

Changed

• Views can now have a prefix. Prefix can be passed in filter "airfleet/views/config"

Added

• Added enqueue functionality for views: create files view-name.{$screen}.{$extension} (e.g. view-name.admin.css) in the view folder (screens can be critical, frontend, admin, editor; extension can be css, js, entry.css, entry.js)
• Added filter "airfleet/views/enqueue/{$view_slug}/{$screen}/{$type}" - filters the files for enqueue
• Added filter "airfleet/views/enqueue/override/{$view_slug}/{$screen}/{$type}" - determines if parent enqueues will be overridden
• Added action "airfleet/views/enqueue/{$slug}" - trigger enqueue for a view

Added

• Added filter "airfleet/views/config" for registering views configurations from plugins/theme
• Added Setup functionality for views: create class ViewNameSetup.php in view folder and extend from Airfleet\Plugins\Views\View\ViewSetup
• Added Controller functionality for views: create class ViewNameController.php in view folder and extend from Airfleet\Plugins\Views\View\ViewController
• Added Template functionality for views: create file view-name.php in view folder and render it how you want (context will be available as variables in the template)
• Added function airfleet_views_render( string $slug, $data = [] ) to render a view
• Added view helper $_ctrl to access view Controller
• Added view helper $_dump( ...$vars ) to dump variable information
• Added view helper $_val( $key, $default ) to get a data variable or return the default value
• Added action "airfleet/views/setup" - runs after views are registered
• Added action "airfleet/views/render/{$slug}" - trigger rendering for a specific view
• Added action "airfleet/views/template/render" - trigger rendering using a specific template
• Added filter "airfleet/views" - filters all the registered views
• Added filter "airfleet/views/{$type}" - filters the registered views of a specific type (e.g. partials, components, blocks)
• Added filter "airfleet/views/template/{$slug}" - filters the template path for a specific view
• Added filter "airfleet/views/context" - filters the context for all views
• Added filter "airfleet/views/context/{$slug}" - filters the context for a specific view
• Added filter "airfleet/views/setup/{$slug}" - filters the setup objects for a specific view
• Added filter "airfleet/views/controller/{$slug}" - filters the controller class name for a specific view