Changelog

Fixed

• Fixed InlineScriptRegistry orphaning all inline scripts on block editor pages where wp_print_scripts fires before admin_enqueue_scripts. The render() method now skips early wp_print_scripts calls when the registry is empty, preserving the admin_print_scripts hook as a fallback, and uses a $rendered flag to prevent double output.

Changed

• Changed Enqueue::enqueue_editor() to use enqueue_block_assets for editor styles so they load inside the block editor iframe (Block API v3+), while editor scripts remain on enqueue_block_editor_assets (parent page context)
• Changed Enqueue::enqueue_critical() to also enqueue critical styles and scripts inside the block editor iframe via enqueue_block_assets, ensuring critical assets (e.g. window._airfleet.elements.core) are available to view scripts rendered in the iframe

Fixed

• Fixed InlineScriptRegistry rendering inline scripts after enqueued scripts on frontend by hooking into wp_print_scripts (priority PHP_INT_MIN) instead of wp_head, ensuring inline variables are output before enqueued scripts within print_head_scripts

Fixed

• Fixed InlineScriptRegistry rendering inline scripts after enqueued scripts on admin pages by hooking into admin_print_scripts (priority 1) instead of admin_head, ensuring inline variables are output before print_head_scripts (priority 20)

Fixed

• Fixed priority for loading LocalJson and LocalJsonCategorized. Fixes issue with not loading all field groups.

Changed

• Changed airfleet/acf/local_json_cache/enabled to false by default
• Only setup loading for LocalJson and LocalJsonCategorized after all plugins are loaded. This ensures filter airfleet/acf/local_json_cache/enabled is respected if another plugin sets it

Fixed

• Fixed fatal error in Benchmark caused by missing return statement

Fixed

• Fixed unclosed bracket in Benchmark class

Fixed

• Fixed defined, function_exists, and function calls to explicitly refer to non-namespace for better scoper integration

Added

• Added Environment helpers (Helpers\Environment) - determine environment (local, staging, production)
• Added CacheManager utility class for working with cache
• Added Cacheable trait to easily access global CacheManager instance
• Added filter airfleet/cache/enabled to enable/disable cache
• Added filter airfleet/cache/expiration to set cache duration in seconds (0 to not expire)
• Added filter airfleet/cache/cache_dir_checks to enable/disable caching directory modification checks
• Added filter airfleet/cache/expiration_dir_check to set cache duration for directory modification checks in seconds (0 to not expire)
• Added filter airfleet/cache/manager to set cache manager
• Added action airfleet/cache/flush to clear the cache
• Added action airfleet/cache/hit that is triggered whenever cache is hit, but only if WP_DEBUG is enabled
• Added action airfleet/cache/miss that is triggered whenever there is a cache miss, but only if WP_DEBUG is enabled
• Added class Benchmark to setup 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.
• Added filter airfleet/benchmark/enabled to enable/disable performance benchmark
• Added filter airfleet/benchmark/log_to_error_log to enable/disable logging benchmark results to the error log. This is in addition to the HTML comment and dependent on benchmarking being enabled
• Added action airfleet/benchmark/start to start tracking a workload benchmark (must pass ID)
• Added action airfleet/benchmark/stop to stop tracking a workload benchmark (must pass ID)
• Added utility classes Timer and NestedTimerRegistry used for benchmarking

Changed

• LocalJsonLoadFromCache: Refactored to use Cacheable and improve cache invalidation when ACF Local JSON directory contents change
• LocalJsonCacheSettings: Automatically set default value for filter airfleet/cache/enabled based on environment (enabled for all except local)
• Renamed filter airfleet/framework/acf/local_json_cache/enabled to airfleet/acf/local_json_cache/enabled
• Renamed filter airfleet/framework/acf/local_json_cache/expiration to airfleet/acf/local_json_cache/expiration
• Renamed action airfleet/framework/acf/local_json_cache/invalidate to airfleet/acf/local_json_cache/invalidate

Fixed

• LocalJsonLoadFromCache: Fixed automatic cache invalidation when saving field groups

Added

• Added object caching for ACF Local JSON through Acf\LocalJson classes
• Added filter airfleet/framework/acf/local_json_cache/enabled to enable/disable cache for ACF Local JSON
• Added filter airfleet/framework/acf/local_json_cache/expiration to set cache duration in seconds for ACF Local JSON
• Added action airfleet/framework/acf/local_json_cache/invalidate to invalidate ACF Local JSON cache

Added

• Helpers\DisplayImplementation: Added is_string check in attributes() function to differentiate between regular string and callable functions as attribute value.

Added

• Added InlineScriptRegistry for handling inline scripts, instead of using wp_add_inline_script
• Added filter airfleet/framework/inline-script-registry/content to modify inline script content before output
• Added filter airfleet/framework/inline-script-registry/data-attributes to modify script data attributes before output
• Added filter airfleet/framework/inline-script-registry/deps to modify script dependencies before output

Added

• Added Remove button in Options\Fields\EncrypytedPasswordField field to change value only if user want to update the value.

Added

• Added @wpengine.local to is_airfleet_email list (affects is_airfleet_user function).

Fixed

• Helpers\Screen: Fixed is_editing_acf causing Undefined array key ID warnings while editing some blocks.

Changed

• SettingsLink: changed default base url to options-general.php from admin.php. This affects the settings link in the Plugins page for both core option pages and ACF option pages. This should make the URLs consistent with the menu entries.

Fixed

• Helpers\Screen: Fixed in_block_editor and in_block_editor_admin which could give wrong results under certain circumstances

Added

• Helpers\String: added utilities kebabToPascal and kebabToTitle

Changed

• Helpers\Screen: performance improvements for is_editing_acf, in_block_editor, and in_block_editor_admin

Changed

• Helpers\Screen: added cache for is_editing_acf and in_block_editor

Fixed

• Fixed required field validation when it is hidden (field is not visible but still required)

Fixed

• Fixed screen detection utilities in_block_editor_ajax, in_block_editor, and screen (due to change in ACF or WP, in_block_editor_ajax was not detecting correctly)

Changed

• Options Wizard now also supports Field object instances or custom class names to instance set in the type property

Fixed

• Fixed PHP warnings related to Screen helpers in_block_editor_ajax() and in_block_editor()

Changed

• LocalJsonByLocationParam and LocalJsonCustomFilenameByLocationParam now accept optional argument to specify operators to match

• Added wysiwyg options field type (wysiwyg input)

Added

• Added Options\Tabs\LazyOptionsTab (pass a callable to get options Group that is only called when used)
• Added Options\Pages\LazyOptionsPage (options page that uses LazyOptionsTab)

Changed

• Updated description field for Section to allow using links

Added

• Added hidden options field type (hidden input)
• Added image options field type (file upload)

Fixed

• Fixed options page not appearing under Settings menu and option tabs not working for multi-sites

Fixed

• ACF\LocalJson - fixed warning when reading non-ACF local JSON files

Added

• Added Acf\LocalJsonCustomFilename - syncs ACF JSON from a custom path and saves to a specific filename
• Added Acf\LocalJsonCustomFilenameByLocationParam - syncs ACF local JSON for groups with a specific param value in the location rules and saves to specific filename
• Added Acf\LocalJsonCustomFilenameCustomTemplate - syncs ACF local JSON for custom page templates and saves to custom filename

Changed

• Acf\LocalJson - now syncs deletion regardless of filename (previously only synced deletion if file was named group_*.json)

Added

• Added Acf\LocalJsonCategorized - syncs ACF JSON from a custom path, using natural filenames and different sub-folders based on ACF type

Changed

• BREAKING: updated AcfSettingsOptionsSubPage, AcfToolsOptionsSubPage, AcfAirfleetOptionsSubPage, AcfSettingsLink to use plugin slug instead of ACF generated slug

Added

• Added Plugin\AcfSettingsOptionsSubPage - add ACF options sub-page under core "Settings" menu based on plugin config
• Added Plugin\AcfToolsOptionsSubPage - add ACF options sub-page under core "Tools" menu based on plugin config

Changed

• Updated MenuTabsPage to support "tools" menu type

Added

• Added Helpers\Display::attributes and Helpers\Display::data_attributes - render attributes for HTML elements
• Added Acf\LocalJsonByLocationParam - sync local JSON for groups that match a specific location rule
• Added Acf\LocalJsonCustomTemplate - sync local JSON for a specific custom page template

Added

• Added Strings helper (Helpers\Strings) - convert between different cases

Added

• Added ACF options feature classes (Acf\OptionsPage, Acf\OptionsSubPage, Acf\AirfleetOptionsSubPage)
• Added Plugin\AcfAirfleetOptionsSubPage - add ACF options sub-page under Airfleet menu based on plugin config
• Added Plugin\AcfSettingsLink - add settings link on Plugins admin table for ACF options sub-page based on plugin config

Changed

• Added login styles/scripts support to Assets\Enqueue

Added

• Added enqueue utilities (Assets\Enqueue)
• Added inline script and variables utilities (Assets\InlineScript, Assets\ScriptVariables, Assets\FrontendVariables, Assets\EditorVariables, Assets\AdminVariables, Assets\CriticalVariables)
• Added utility to add plugin action links on the Plugins table page (Plugin\ActionLinks)
• Added utility to add plugin settings link on the Plugins table page (Plugin\SettingsLink)
• Added Airfleet helper (Helpers\Airfleet) - detect Airfleet Starter Theme, Airfleet users, and post types/taxonomies
• Added Screen helper (Helpers\Screen) - detect current screen and post type
• Added Assets helper (Helpers\Assets) - get asset URL and get manifest
• Added Display helper (Helpers\Display) - pretty print, dump, and render reusable blocks
• Added plugin feature utilities (Features\PluginFeature, Features\BasePluginFeature and Features\PluginFeatures) - extra plugin specific hooks compared to Feature (activation, deactivation, uninstall)
• Added Hooks helper (Helper\Hooks) - remove class filter/action
• Added Acf\LocalJson utility

Added

• Created package
• Added Options utilities
• Added Features classes