Documentation
Docs

Changelog

1.2.9

  • Fix server-side registration of ska/text block.
  • The “Default” variant can now be renamed to transfer the current value(s) to another variant such as sm or hover.
  • Declared interactivity clientNavigation support for blocks.
  • Clear Cache Enabler cache when updating options.
  • Added admin dashboard widget for quick editing dynamic content.
  • Update Query Filters to apply to all publicly queryable post types.
  • Added option to target variables to root, body and parent, added option to duplicate variables.
  • Fix search results offering presets in contexts they can’t be inserted.
  • Cache and load Tailwind preflight from a CSS file by default.
  • Query filters can now apply to main query.
  • Image block can now render a low-res placeholder background.
  • Image block and Background block support can now pre-load images in head.
  • Add Query ID to sideloader.
  • Block option panels now remember whether they’re collapsed or not.
  • Added “Repeater” appender.

1.2.8

  • Update Tailwind properties.
  • Ensure all media queries are rendered later than other queries.
  • Added fix for WPML translation replacing some characters with wpml_curved and encoded_tag_closed.

1.2.7

  • Update packages.
  • Update Tailwind to 4.1.4, better compatibility with Safari 15.
  • Revert HEX colors to oklch colors with %.
  • Moved Tailwind colors back to static theme (as CSS variables rather than inline reference) so they can utilize new polyfills.

1.2.6

  • Use HEX colors by default for better browser support.

1.2.5

  • Added error messages when LightningCSS fails to initialize.
  • Enqueue inline styles using wp_enqueue_style and wp_add_inline_style.
  • Added info about External services to readme.

1.2.4

  • Changes to build system.

1.2.3

  • Update to Tailwind 4.0.9.

1.2.2

  • Remove legacy migrations, Tailwind 3.

1.2.1

  • Dynamic link values, such as #ska-link--front-page can now be used as blocks’ custom attribute values.
  • Try: experimental variant modifiers (> and ^) that can be used within selectors. In a selector [&>.a]:[&>.b] adding a class hover:text-red would produce [&>.a]:[&>.b]:hover:text-red meaning that red text would be applied when hovering .b, but prepending the variant with < ([&>.a]:hover:[&>.b]:text-red. Prepending ^ moves the variant to the top.
  • Added ska_blocks_user_dynamic_link filter for modifying dynamic link output server-side.
  • Added AI support to Tailwind block via OpenRouter.

1.2

  • Use Tailwind 4.
  • Use LightningCSS instead of PostCSS.
  • Presets and variations now use plugin options rather than custom post types.
  • Added support for inset-ring, inset-shadow, font-stretch.
  • Added support for rotate/scale/translate in 3D space.
  • Added support for perspective, perspective origin, backface visibility, transition behavior.
  • Added support for transition behavior.
  • Added support for container queries.
  • Added missing support for margin/padding/inset/etc inline-start/end.
  • Added experimental support for linear/conic/radial gradients.
  • Functionality moved to theme: formats, template select, toolbar, device preview, grouping with element block.
  • Move important modifier ! to the end, not the beginning.
  • Gallery block images now have a simpler image class alongside the wp-block-ska-gallery__image class.
  • Experimental: use native CSS nesting for sandboxing blocks’ CSS, with a toggle in Advanced Inspector Controls.
  • Primary/secondary/plain colors light and dark variants now use values derived with color-mix by default.
  • Menu block now supports anchor, custom class name and attributes.
  • Menu block can now render WC Layered Nav widget and active filters.
  • Classes can be now moved to the parent block directly, without specifying a selector.
  • Image block now has role options.
  • Added Query filters for WC product categories, Sample blog posts and Sample testimonials.
  • Slider block with “Controls outside” option now renders wrapper in the block editor not just front end.
  • Added utility function ska_blocks_preset($slug) which loads preset’s CSS and returns its’ class name.

1.1.4

  • Permissions and capabilities management.
  • Condition block now uses a whitelist for callable PHP functions.
  • Fix variations not persisting for server-side registered blocks.

1.1.3

  • Increase editor: variant specificity.
  • Added “Cover” option for Image block which effectively applies w-full h-full object-cover rounded-[inherit] aspect-[inherit] to a wrapped image.
  • Menu block can now render Taxonomies.
  • Menu block can now render as an Accordion.
  • Gallery block with lazyloading enabled can specify how many images from the start to load eagerly.
  • Language switcher block uses available languages in the editor.
  • Transforming Post title block to Post data block now retains the HTML heading tag.
  • Updated device preview button styles to be more subtle and have a larger hitbox.
  • Added “Cut selector” menu item for selectors.
  • Added editor-selected variant which should be used in combination with editor variant, e.g. hidden editor:editor-selected:block.
  • Try default grid place-items-center size-6 for Icon block instead of w-6 h-auto.
  • Fix updating Font size arbitrary value when no line height is selected.
  • Added a select for selecting a page template quickly.
  • Automatically order screen variants from smallest to largest when adding them.

1.1.2

  • Lightbox block now works with core Gallery and Image blocks.
  • Added option to lazyload images in Gallery block.
  • Updated available Google fonts.
  • Fixed bug with wrong class names generated for variables in nested selectors.
  • Code block now supports displaying a header, language label and copy button.
  • Compatible core blocks now retain Tailwind attributes when transforming from one block to another.
  • Added ability to wrap blocks in a Lightbox block by using a transform.
  • Adding a selector now navigates to it automatically.
  • Render custom class names in block label for Element and Text blocks.
  • Transforming Heading block to Text block now retains the tag name.
  • Added option to disable block appender for Element, Conditions, Condition, Slider, Slide and Lightbox blocks.
  • Fix Post data block not rendering in template editor.
  • Make front page active in the menu block in the editor.
  • Featured image block can now optionally override image ID from post meta.
  • Deprecated QueryOverrides in favor of QueryFilters.
  • Added style caching.
  • Remove ska-blocks related attributes from WC blocks HTML markup.
  • Added “Placeholder” setting to “ska/text” block.
  • Added generic block setting to not render the block on the front end.
  • Added generic block setting to hide the block in the editor when it’s not selected.

1.1.1

  • Defer Google fonts by default with an option to not defer.
  • Added option to swap Google Fonts URLs with Bunny Fonts.
  • Fix warning when displaying an image with a lightbox when the media file has been deleted.

1.2.9

  • Added “Tooltip” preset and option to enable loading tooltip styles.
  • Added “Links” preset which is intended to style plain links in content.
  • Added “Price” preset for styling WC product prices in various locations.
  • Conditions block now allows functions that start with ska_condition_ without having to whitelist them in the theme options.
  • Added option to dequeue jquery-migrate script.
  • Added “Single grouped product” preset which is only loaded on single product page when the product is a grouped product.
  • Fix “Load more” button not keeping query vars.
  • Fix loading of some inline scripts so that the main script can remain deferred.
  • Variable product single product page: don’t render SKU: N/A when no variations have a SKU.
  • Removed deprecated [ska-langs] shortcode (use Language switcher block).
  • Fix Language switcher button aria-label text.
  • Added “Hook” block which allows to render the block content at a specific action or filter.
  • Added some compatibility for WooCommerce PayPal payments plugin.
  • Clear Cache Enabler cache when updating options.
  • Update Accordion module’s scrollIntoView to account for scroll-margin-top and toggle height.
  • Added var(--gutter) to Tailwind spacing scale.
  • Fix Swiper breakpoints config when using slidesPerView and spaceBetween with breakpoints that don’t overlap.
  • Theme presets that haven’t been modified are no longer stored in the database and can receive changes with theme updates.
  • Added “Blog home” (home.html) template.
  • Removed no longer needed “Disable duotone” option.
  • Added image reset styles.
  • Append global styles to ska-blocks global styles cache file.
  • Removed legacy styles from Layout and Prose presets.
  • Added 2 additional footer designs.
  • Data block now defaults to <span> rather than <div> and has .ska-data class.
  • Data block can now render dynamic shortcodes.
  • Added AI capabilities for Rich Text blocks.
  • Added AI “Suggest SEO title & description” button.
  • Cache load_dynamic_template_parts.
  • Added ska_theme_additional_loop_product_image filter.
  • Added options under “Performance” category to facilitate disabling WooCommerce blocks and block patterns.

1.2.8

  • Add “WC per page” mode to Menu block.
  • Added ska-wc-result-count and ska-wc-current-per-page shortcodes.
  • Fix HTML entity decoding in Search module results.
  • Added experimental “Data” block.
  • Fix WC single product page reviews link to open reviews accordion tab.
  • Fix mobile menu closing swipe direction detection.
  • Add rel=nofollow to Menu block product ordering and per page links.
  • Added hoverintent option to Dropdown module – small delay before opening dropdowns on hover.
  • Dialog preset backdrop now matches the Backdrop template part styles.
  • Sticky module now automatically adds <html> element’s padding-right (from x-trap.noscroll) to the stuck element when overflow is hidden to prevent layout shift. The skaSticky({watchNoScroll:false}) option can be used to disable this functionality.
  • Fix: when cookie notice is enabled, set WP Consent API consent mode to optin server-side as well.
  • WC products per page cookie now requires preferences consent when WP Consent API plugin is enabled.
  • Label preset styles are now applied in the editor.
  • Added “Load more” template that can replace pagination with a button that loads more items without page reload. For WooCommerce there is an option “ska-theme -> WooCommerce -> Load more” that can enable it for product loops.
  • “Loading” preset is now available globally using the .ska-preset--ska-theme--loading class.
  • Using the Prose preset now adds the .prose class as well.
  • Adjusted Prose preset styles to use site text and heading colors.
  • WC product tabs now use <h2> as the tab toggle button text and don’t render an invisible <h2> themselves.
  • Color swatch picker now allows to pick an image from Media Library.
  • Added option to add variable products to cart on the Shop page via AJAX.
  • Updated default --max-width-prose from 65ch to 46rem for consistency with different fonts.
  • Post data block can now render “Time to read”.

1.2.7

  • Update Tailwind to 4.1.4.

1.2.6

  • Added more query loop patterns.
  • Adjust rendering order of theme template parts.
  • Nav menu items now have an option to select a Synced Pattern to render as a custom dropdown.
  • Added ska_menu_block_accordion_config, ska_menu_block_dropdown_config filters.
  • Load CF7 styles when using shortcode, not only block.
  • Don’t set (and delete existing) “WC per page” cookie when the value is default.

1.2.5

  • Added more patterns.

1.2.4

  • Fix wrong script handle for Swiper.
  • Fix WPML integration detection.
  • Added ska_theme_search_url_args and ska_theme_search_url filters.
  • Added language to REST search URL when using WPML.
  • Added ska_theme_get_block_template_part filter.
  • Added shiftMainAxis, shiftCrossAxis options to Dropdown module.
  • Added “WC order by” mode to Menu block.

1.2.3

  • Heading font sizes are now in Tailwind theme config rather than theme.json.

1.2.2

  • Remove legacy migrations.

1.2.1

  • Added “Archive title” option for Post data block – can render blog, archive or search title.
  • Button presets now use CSS variables for simpler customization and inheritance.
  • Added “No results” template part, used in query loops.
  • Use passive event listeners for Alpine.js swipe plugin.
  • Add experimental video preset and module.
  • skaDropdown module change: toggle dropdowns when clicking on a .dropdown-icon inside an <a> instead of following the link. Can be disabled with skaDropdown({toggleOnDropdownIconClick:false}).
  • skaDialog module – fix dialog closing when selecting text that spans multiple elements inside of it.
  • Fix Photoswipe Lightbox for Image block where the image is specified by URL.
  • Dropdown preset has list-style-type: none by default to prevent style bleed from other sources.
  • Simplified templates, better support for alignwide and alignfull. Removed wide width setting, replaced by breakout setting which can work universally with regular width content and prose content.
  • Featured image block (ska/image in “Featured” mode) in prose templates will no longer be rendered if the post content itself contains a featured image block, allowing to customize how the featured image is displayed on a per-post basis.
  • Added patterns – Brand, Featured image, Socials, Post/Page/Archive title, which are used throughout templates and now have a common location to edit them.

1.2

  • Update for Tailwind 4.
  • Remove heading text color.
  • Link styles moved from theme.json to style.css with lower specificity.
  • Custom CSS from theme options is now loaded last in the <head>.
  • Added “Global CSS variables” preset, Container preset now uses --gutter variable from “Global CSS variables” preset for inline padding.
  • WC notice styles moved to “Store notices” preset, legacy message styles gated behind “Legacy notice styles” theme option.
  • Added WC order preset.
  • Added WC shop table preset.
  • Added icons to My account page menu.
  • Added flags to WC country selects.
  • Base font size and line height options now accept strings rather than numbers, this allows setting a fluid font size such as clamp(14px, 2vw, 18px).
  • Content size and Wide size options now accept strings rather than numbers and use rem instead of px by default.
  • Paragraph default spacing specificity reduced.
  • Button preset is now inline-flex rather than inline-block.
  • Button and Icon button variations no longer include Outline button preset by default.
  • Edit site admin bar menu item now also links to WC settings when WC is active, provided that the “Tools -> Edit site” theme option is enabled.
  • Contact Form 7 wpautop is disabled by default, CF7 forms are now display: grid by default.
  • Added placeholder for Contact Form 7 for when the plugin is not installed, but its’ block is used.
  • Query block now has Sample blog posts and Sample testimonials patterns.
  • Added polyfill for requestIdleCallback.

1.1.3

  • Updated Accordion module to be smooth. Breaking change: accordion content element ([x-bind="content"]) can no longer have padding, wrap the contents in an element that has padding instead.
  • Added Toasts.
  • Updated Consent dialog to use Accept/Reject buttons by default with WP Consent API and Google Site Kit integration.
  • Added “Products per page” select for WooCommerce archives.
  • Use Loading preset with jQuery block UI.
  • Use correct font in TinyMCE, load theme.json styles.
  • Added options to modify Up-sells, Related products and Cross-sells amount.
  • Variation swatches now render placeholders.

1.1.2

  • Added option to always include “Shop” page in WooCommerce breadcrumbs.
  • Added option to disable comments.
  • Improve core/gallery styles.
  • Update mobile menu and search overlay accessibility.
  • Fix bug where WC “Order received” page hijacks menu item title value.
  • Prose headings now use Heading text color from Tailwind configuration Site palette by default.
  • Added preset for password form on password protected pages.
  • Automatically load child theme style.css from parent.
  • Fix Slider block .use-default-nav class not working when using “Controls outside” option.
  • Lower fetch priority of WC product hover images.
  • Fixed opening hover dropdown on mobile requiring 2 touches.
  • Added “Dialog” preset.
  • Added ska/language-switcher and ska/cart blocks.
  • Deprecated ska-langs shortcode in favor of ska/language-switcher block, removed “Language switcher” template part.
  • Removed “Primary button” variation, “Button” variation now has “Button”, “Primary button” and “Outline button” presets applied by default.
  • Added “Icon button” variation.
  • “Button” preset now has “not-prose” class applied by default to render correctly in prose.
  • Added “Search” module, updated “Search dialog” template to include autocomplete.

1.1.1

  • Update templates, template parts and presets.
  • Apply do_blocks and do_shortcode to WC additional product tabs content via ska_theme_wc_tab_content filter.
  • Fix potential PHP warning when applying dropdown preset to menu.
  • Removed scroll position tracking by default and added theme option “Track scroll position” to enable it.
  • Added “Body” preset to provide a permanent vertical scrollbar for the body element to prevent layout shift when moving between pages with various amounts of content.
  • Moved motion-safe:[html:has(&)]:scroll-smooth class from “Layout” to “Body” preset as it makes more sense there.
  • Apply “Loop product” preset to product categories as well.
  • Remove “Blank” template as it’s very simple to just create from scratch when actually needed.

1.1.0

  • Public release.