Mai Engine v2.37.0
Changelog
2.37.0 (7/14/25)
- Changed: Bump minimum PHP version to 8.1.
- Changed: [Performance] The Genesis skip-links script is now deferred.
- Changed: Disable preloading of logo as sometimes it’s not used in time and throwing performance warnings.
- Changed: Update ACF to 6.4.2.
- Changed: Update the updater.
2.36.1 (4/28/25)
- Added: [Performance] Logo now has
fetchpriority="high"to go along with the eager loading already in place. - Added: Support the Page Header Image field on static blog page.
- Added: [Developers] New
mai_grid_block_wp_query_fields,mai_grid_block_wp_term_query_fields,mai_grid_block_display_fields, andmai_grid_block_layout_fieldsfilters on Mai Post/Term Grid blocks. - Added: [Developers] New
mai_page_header_imgfilter to filter the actual page header image markup. - Added: [Developers] New
mai_is_editor()helper function to know if you're in the block editor in PHP. - Changed: Update ACF to v6.4.0.1.
- Changed: [Performance] Update Kirki for better woff2 support.
- Changed: Some default transitions are now
.15sinstead of.3sin CSS.
2.36.0 (3/13/25)
- Added: Better support for the core Row block alignment and justification settings.
- Added: New
mai_termsshortcode to show terms from multiple taxonomies in the same list. - Added: [Developers] New
mai_grid_wp_query_defaultsandmai_grid_wp_term_query_defaultsfilters for Mai Post Grid and Mai Term Grid default query args. - Changed: Update ACF to 6.3.12.
- Changed: Nav menu search now uses the menu item label as the search input placeholder.
- Changed: Bring back final encoding when using PHP's
DOMDocument. - Fixed: Undefined variable warning when using the parent field via ACF.
2.35.1 (12/18/24)
- Fixed: Mai Term Grid saved taxonomies were occasionally not loading when the editor was first loaded.
- Fixed: Dynamic field choice queries are more stable in Mai Post Grid and Mai Term Grid.
- Fixed: Outline buttons were not the same height as standard buttons since WP changed the button's container class names.
- Fixed: Update all docs links to go to the correct url at https://help.bizbudding.com.
- Fixed: [WooCommerce] Checkout block sticky elements were covering the checkout fields on mobile.
2.35.0 (12/5/24)
- Added: [WooCommerce] Better compatibility with WooCommerce Cart and Checkout blocks.
- Added: [FacetWP] Now allow FacetWP on a single Mai Post Grid instance by adding
facetwp-templateclass to the block. - Added: New
currentvalue can be used foridandpost_typeparameters inmai_contentshortcode. - Added: New
--button-outline-widthcustom prop to more consistently override outline button styles. - Added: Prior
—viewport-widthproperty is now included again. - Changed: Reusable Blocks are now Synced Patterns to stay aligned with WP terminology.
- Changed: Update ACF to 6.3.11.
- Changed: Update Gulp to 5.0.0.
- Changed: Removed legacy genesis-accessibility attribute for 404-page.
- Changed: More through and simpler encoding handling with PHP's
DOMDocument. - Changed: Better handling of post exclusion when using Mai Post Grid.
- Changed: Using
100svhinstead of100dvhfor body height. - Changed: Now using less specific
:has()for CSS class checks. - Changed: Add transient caching to classic editor styles from customizer.
- Changed: Tweak order of processing in
mai_get_processed_content(). - Changed: Sticky header is now disabled in landscape mode on mobile.
- Changed: CSS is now on
:focus-visibleinstead of:focusbetter visual handling of non-keyboard enabled focus. - Changed: CSS grid now uses
minmax()instead of1frin some scenarios to prevent grid blowout. - Changed: [Performance] More efficient
get_terms()queries when we only needidandname. - Changed: [Performance] Only run ACF field filters in the admin, when loading field data dynamically.
- Changed: Disable preloading of featured and page header images. This was often causing more issues than it was helping.
- Changed: Convert
DOMDocumenttoWP_HTML_Tag_Processorfor Mai custom attributes. - Changed: Convert
DOMDocumenttoWP_HTML_Tag_Processorfor WooCommerce button classes. - Changed: Check if post type exists after
mai_grid_post_typesfilter. - Changed: Validate ACF fields that don't use
field_as the field key prefix. - Changed: Added prefixes for our ACF field groups that didn't have one.
- Changed: Update the updater.
- Fixed: Social links gap when inside Mai Columns.
- Fixed: Full aligned blocks did not always display correctly in the editor, particularly when nested, and/or when the content alignment was left or right.
- Fixed: Wide aligned blocks were sometimes cut off in the editor.
- Fixed: Mai Divider was not showing full width when inside Group/Cover block with content aligned left/right.
- Fixed: Comments had unexpected list margin in some scenarios.
- Fixed: The has-z-index-2 wasn't applying the correct z-index of 2.
- Fixed: Search block was not centering correctly in some scenarios, when set to be center aligned.
- Fixed: Author description not always showing correctly on the author archive.
- Fixed: Invalid markup in page header when a category/term has no intro text.
- Fixed: Site title was not always white when using a dark transparent header.
- Fixed: Menu toggle text color was not styed correctly when screen-reader-text class is removed.
- Fixed: Accent color being applied unexpectedly on select fields in some browsers, looking at you Safari.
- Fixed: Select field now sets min-height instead of height.
- Fixed: Removed the "remove global styles" setting to maintain compatibility with WP and fix "Missing Dependencies" error.
2.34.1 (4/18/24)
- Changed: Order of processing in
mai_get_processed_content()to matchget_the_block_template_html()function in WP core. - Fixed: The Setup Wizard missing steps for some users.
2.34.0 (4/9/24)
- Added: Support for the new "Mai Side Hustle" theme.
- Added: New "Alternate" typography/font setting.
- Added: New "Alternate" block style option on Paragraph and Heading blocks, to use the new "Alternate" font settings in the Customizer.
- Added: New "Oval" divider option. Props Jo Waltham.
- Added: New XXL title size option in Customizer content archive settings and Mai Post/Term Grid title size block settings.
- Added: New Custom Content 2 setting for Customizer Single/Archive COntent settings and Mai Post/Term Grid blocks.
- Added: Better default styling for the core Query block.
- Added: [Developers] New
has-line-height-1, has-line-height-xs,has-line-height-sm, andhas-line-height-md` helper classes to override default line-height values. - Added: [Developers] New
mai_has_dark_background_firstfilter for custom handling of dark transparent header background. - Added: [Developers] Override WP Recipe Maker buttons/styles for better theme integration with
mai_enable_wprm_supportfilter (false by default). Basic styling support is still always loaded. - Added: [Developers] New
--button-outline-widthcss custom property to override the button border width without overriding other border styles. - Changed: Minor list styling tweaks on front end and in the editor.
- Changed: Tightened up default body line-height as well as specific areas like archive/grid excerpts, breadcrumbs, and more.
- Changed: Exclude Gravity Forms and WP Forms field labels from default styling so their forms are more consistently styled.
- Changed: [WooCommerce] Better styling for order details/meta and quantity input.
- Changed: [LearnDash] Better styling for deeper visual integration with the theme/settings.
- Changed: Update ACF to 6.2.9.
- Changed: More z-index tweaks so overlap and stacking is more natural and expected.
- Changed: Allow shortcodes, etc. in single content excerpt.
- Changed: Mai Divider now only uses -.5px to handle the slight gap sometimes caused by pixel rounding in some browsers.
- Changed: Better handling of input placeholder color.
- Changed: Update the updater.
- Fixed: Mai Columns was wrapping unexpectedly, more often in the editor.
- Fixed: Logo not inverting on the login page when using the setting to force the logo to white on dark backgrounds.
- Fixed: Better styling of the Search block, including when using the width settings.
- Fixed: Some logic from the setup wizard was running outside of the setup wizard itself.
- Fixed: The icon field picker on various blocks was showing SVG markup instead of the actual icon.
- Fixed: Alignment settings on Embed blocks not working correctly.
- Fixed: Better handling of non-existent taxonomies in Mai Post/Term Grid blocks. This was causing some issues when an instance of the block was configured with a taxonomy that was no longer registered, typically by deactivating a plugin that registered a custom taxonomy.
- Fixed: Inline highlights when using link color as the color setting.
- Fixed: Competing filter-hover declarations in CSS. Now developers only need to use
--menu-item-name-filter-hovercustom property in CSS to remove the brightness dimming of menu items with a dark header. - Fixed: Better spacing/styling of LearnDash content by adding
entry-contentclass to theld-tab-contentdiv. - Fixed: Better handling of dark/transparent header when registered gradients are used in config.php.
- Fixed: Using square brackets in the post title was breaking
aria-labelin Mai Post/Term Grid. - Fixed: The
display_post_statesfilter adding "Active" Content Area was running on the front end unnecessarily.
2.33.1 (2/7/24)
- Added: [Developers] Add entry-grid order to the editor CSS.
- Added: New
has-z-index-2helper class along with the existinghas-z-index-1,has-z-index-0, andhas-z-index--1classes. - Changed: Update ACF to 6.2.6.1.
- Fixed: The
font_sizeparam on[mai_menu]shortcode was not working correctly for custom values. - Fixed: Negative margin on nested elements was not overlapping correctly in some configurations.
- Fixed: Unwanted vertical scroll on ACF top tabs in the block editor.
2.33.0 (1/30/24)
- Added: New setting to force the logo to white on dark backgrounds (dark header or transparent header background). Find the setting in Customizer > Theme Settings > Site Header.
- Added: [Developers] New
mai_before_entryandmai_after_entryaction hooks. - Added: [Developers] New
mai_get_index()function to increment and reset an index/count based on context string. - Changed: Adds CSS order/index to Mai Post/Term Grid entries.
- Fixed: Escapes
aria-labelattribute in entry titles, so HTML in the editor title field won't break the markup.
2.32.2 (1/19/24)
- Fixed: Even more efficient JS to change no-js to js class on the body. In some instances, this class change was not firing.
2.32.1 (1/19/24)
- Fixed: Encoded special characters were displayed on the front end in some configurations.
2.32.0 (1/18/24)
- Added: Better support for WP Recipe Maker. Recipe buttons now inherit styling from Mai.
- Changed: Update ACF to 6.2.5.
- Changed: Simplified inline script to toggle no-js to js body class if JS is enabled in the browser.
- Fixed: Clean up confusing notices from ACF.
- Fixed: Remove unnecessary encoding in PHP's DOMDocument which was unintentionally encoding some special characters from non-English languages.
2.31.3 (1/8/24)
- Fixed: Added back updater icon functions.
2.31.2 (1/8/24)
- Changed: Now Load core getter functions immediately instead of
after_setup_theme. - Fixed: Cover block overlay was not rendering correctly when using Link as the overlay color.
2.31.1 (12/28/23)
- Added: Better PHP 8.2 compatibility.
- Changed: Element stacking via z-index is now less aggressive by default. This fixes some edge-case scenarios where floating elements are behind other elements on the page.
- Changed: Converts has-link-background-color to has-links-background-color to fix WP 6.4 compatibility issue. This was causing some color choices to remove the background color from the element.
- Changed: Only apply hidden-{break} and hidden-{break}-down/up classes on the front end. These classes were causing elements to be hidden in the editor.
- Changed: Better compatibility with the latest version of Mai Archive Pages plugin.
- Changed: CSS styling consistencies for Latest Posts block.
- Fixed: Latest Posts block now correctly shows the "Read more" link.
2.31.0 (11/28/23)
- Added: PHP 8.2 compatibility.
- Added: ACF sidebar metaboxes now match WordPress core styling.
- Changed: Update ACF to 6.2.4.
- Changed: Converts has-link-color to has-links-color to fix WP 6.4 compatibility issue. This was causing some color choices to force text to the Mai link color value.
... see plugin file for full changelog