Docs
Using AI
The Tailwind block allows communicating with a GPT to generate Tailwind HTML, which can then be converted to blocks. API key OpenRouter allows interacting with various GPTs via a single API. First, set up your OpenRouter.ai API key and model under ska-blocks -> Options -> AI: Models can be found at OpenRouter -> Models, for…
Importing a demo
Pre-built demos for ska-theme are available here. Demos are a fast starting point for a website with a particular appearance or style. They include customizations to ska-blocks, ska-theme configurations, Tailwind theme, modifications to presets and sample pages. Importing a demo Next steps See: ska-theme getting started – first steps
Toast
Display notifications that appear on the front end to provide feedback or information to the user. ska-theme includes a template part for rendering Toasts, which can be enabled from ska-theme -> General -> Toasts. The template part is set up to use the skaToast Alpine.js module. Adding a toast Ensure that rendering of the template…
Cart dialog
The Cart dialog block can display a button to the WooCommerce mini cart widget in a Dialog, which is a light-weight alternative for the WC “Mini-cart” block. When WooCommerce isn’t activated the block renders nothing. The inner block for the Cart dialog block is a button that will open the dialog – the button can…
Language switcher
The Language switcher block can display a placeholder language switcher when a multilingual plugin isn’t installed yet, but will switch to using languages from WPML or Polylang once detected. Block options Mode The block can be in “List” mode to render a basic <ul> > <li> of the languages, or in “Dropdown” mode which utilizes…
Dialog
ska-theme includes a custom Alpine.js component for handling HTML dialog elements. The module abstracts away calling the native .showModal(), .close() functions, adds x-transition to the dialog and enables closing of the modal by clicking away from the modal. Creating a dialog Adding x-data=”skaDialog” do an element will locate a button and a dialog from its’…
Code block
The code block is an alternative for the WordPress code block with the addition of syntax highlighting, indenting and copy function. The Code block uses the “Code block” preset for its’ appearance by default. Basic code block Code block with a header Code block can have a header that can contain a short description of…
Attributes
ska-blocks blocks, such as Element and Text, have the ability to accept custom HTML attributes: This allows to add things that the block editor may not support at the time, such as specifying aria- values, adding data- values, integrating with Alpine.js, adding schema markup and more. Since attribute values can get long and it’s a…
Alpine.js
ska-theme comes equipped with Alpine.js, its’ plugins “collapse”, “focus” and “intersect”, as well as some custom components listed below. Alpine.js pairs well with ska-blocks plugin because the blocks have an ability to accept custom HTML attributes, making it easy to add Alpine.js directives in the editor. The Alpine.js instance can be accessed on the front…
Landing page
To create a landing page, you’ll want to add a new WordPress page and assign the Full width template for it (a template that comes with ska-theme). Template can be changed from the right sidebar when editing a page: Choose Swap template and pick the Full width template. Once created, you can make the page…