Always install updates to the main SiteBuilder Module before any Themes
SiteBuilder updates won't overwrite your site code
Uninstalling the SiteBuilder module may cause some code to stop working.
Presets (for Tailwind Themes), JavaScript files and Liquid functions will use a folder based versioning system, so you can choose whether to continue or upgrade.
We're always adding to SiteBuilder and its associated Theme Modules. However, it's important to us that changes to this module do not cause you problems on your site.
Therefore, we never change the layouts on your site during an update. We only update the "master copy" of the layout in the module. That means brand new layout installs from the module will have updates, while older layouts will continue to function as before.
There are exceptions to this rule, for example Liquid includes which power functionality like dynamic forms. In these cases, we will only modify these files with non-breaking changes. For breaking changes, a new version of the file will be created and linked to new layouts, leaving the old version continuing to function with existing layouts.
Another exception of sorts is the contents of the marketplace_builder/assets/modules/module_86/src/open_me_to_set_up_tailwind_1st_time folder. This will not receive updates since this is only meant to be a template to get you setup and we don't want to encourage different developers on a project to set up differently. Instead, see Example Tailwind Project Setup for the recommended setup, which you can use to update if you choose- it may be important to update to get access to certain features like presets, but not for everyday use.
For the optimum compatibility, we recommend always making sure the main SiteBuilder module is up to date before updating any SiteBuilder Theme modules. Some Theme module updates may rely on the latest version of SiteBuilder.
Patches for Theme Presets. Thanks for the feedback so far, we have patched several issues. The major patch addresses a known issue in the Flowbite plugin, where it was impossible for a preset to override any existing colours defined by the Flowbite plugin. This has been addressed by a temporary fork of the Flowbite plugin, which will receive a permanent fix by Flowbite in the next major version, co-inciding with Tailwind version 4.
In order to receive this update, after updating the module, make sure to update a tailwind.config.js file's require('flowbite/plugin') to require('flowbite/../../modules/module_86/public/assets/css/presets/flowbite_plugin_fork_colors_disabled')
Added new documentation Example Tailwind Project Setup
We've also added a range of static and dynamic layouts to Flowbite with a more generous use of primary and secondary background and text colour utility classes. This will allow them to make better use of the preset you select and override with your own colour scheme:
New Form Layout with floating labels
New Testimonials Layout
New FAQ layout
New Menu Layouts
New Webapp Layouts
Hero, pricing, feature static layouts
Theme Presets released for the Flowbite Theme - we'll talk about these a lot more in the coming days. In short, presets are a set of defaults for your Tailwind Config which set default colour, font and much more! You can switch preset to completely change the look of your site while keeping the HTML untouched. To start with we're releasing the following:
Gardening Preset
MNTNs Preset
New layouts to be released alongside the presets which are fully compatible with the Flowbite Theme but have come from other designers' open-source work. These make a more generous use of both primary and secondary colour variables.
Structured Data added to the following Detail layouts for better SEO:
Authors
FAQs
Events
+ Flowbite Pro Version 1.9.4
New Admin Table Layouts for Modules:
Blog List
FAQ List
Events List
2 New Blog Detail Layouts
2 New Form Layouts
New Accordion WebApp Layout
Original Blog Detail Layout updated with new features (will roll out to other Blog layouts soon):
Google Structured Data Support
Support for visiting URL with ?edit=true at end of URL to display edit form (after permission checks). This goes nicely with the Admin Tables which can link to it.
Updated many modals to be "static" to prevent accidental closing
Support for new Pro layouts in Preview Mode
Removed console errors for Live Updates which were unnecessary (logs not errors).
Flowbite Pro Theme - Version 1.9.4
A new eCommerce themed menu layout containing a mini cart preview
Cart preview includes product thumbnails, names and prices
User can delete items from cart, with live-updates supported re-rendering for a smooth experience
A new Blog Detail layout alternative
More static layouts for Portfolio and Promotional Section
Tailwind build method can now be overridden on the Page Template level, either by setting when you create a Page Template, or by using the template_build_method parameter (can be set to either "cli" or "preview"):
New Preview build method for Tailwind. This is a replacement for the now deprecated JIT option, which should provide faster development times.
Preview mode is designed to load CSS fallbacks so that any Flowbite blocks added to the site will be supported out-of-the-box, using Flowbite default variables.
It can be used alongside a CLI build. The CLI build will override any classes you've used, with branded versions of the variables you've set in your Tailwind Config file, while continuing to fallback to Flowbite defaults when brand new blocks are added.
New Static Layouts for Flowbite:
Portfolio
Promotional Section
Small UX and styling improvements to navigation and scrolling
Patch to fix Flowbite WebApp Edit Form layout not installing properly in "static" mode.
New Layout type- Category List Views - these work as code snippets which can be added almost anywhere and either loop over all categories or children of a category ID you pass in in settings.
SiteBuilder 4.15.0
2 new Category List Layouts
Flowbite Pro Theme 1.9.0
5 new Category List Layouts
New Flowbite Form Confirmation Layout which will automatically display submitted custom fields with headings.
Each field type will be displayed appropriately, e.g. files can be downloaded and images will be displayed.
Page Templates and Flowbite Cookie Popup Layouts will include code for Google Tag Manager- ID will need adding manually in order to work.
Cleaned up some old files no longer used
Renamed some eCommerce layouts for clarity
Patches to manually-managed setting on files created with SiteBuilder
Changes to Tailwind setup folder structure - for easier setup
Changelog coming soon. Suggest holding off on update until ready.
Updated Layouts generally to support latest version of Flowbite v.2.3.0 and Tailwind CSS 3.4.3. To get the benefit of newer Flowbite JS, you will need to update the <script> tag in any SiteBuilder-built Page Templates. When testing the Site Templates, we didn't find many compatibility issues- the main one was a change in syntax for Flowbite Modal components. Please report any you find which can be fixed on our end.
Updated the Sitegurus Tailwind Template with these newer versions of Flowbite and Tailwind CSS. https://github.com/SiteGurus/Siteglide-Tailwind-Template You can update your existing CLI setups using NPM
Released eCommerce Layouts
Product List View
Product Detail View
Cart
Form Confirmation with embedded Order Detail
Orders List View (requires login)
Form Layouts
New Form Layout with embedded Cart Layout, designed to be used with Checkout/ Quote type forms
Added better support for Stripe Form elements in dark mode
Added better Flowbite dark mode support for spinners on buttons
standard Blog list view layout
Fix for author snippets links
Improved displaying user-feedback on filtering
A new Flowbite eCommerce Site Template will follow shortly, demoing many of these new layouts.
Fix for addresses in form layouts
Hotfix for bug in previous update
Form Layouts
Fix for eCommerce-themed Form type Layouts asking which Module you wish to use, instead of which CMS Form.
Module Add and Edit Layouts have been upgraded to better support Custom Modules from the Marketplace. This will work alongside an upcoming Siteglide release
Live Updates 1-4 hotfix - changelog
Hotfix for form layouts not working with the minified version of JavaScript files. This issue would only have affected more recent installs.
Support for upcoming eCommerce features- including new version of Live Updates 1.4.
Support for upcoming eCommerce features
Fix for broken links in the SiteBuilder UI
Fix for JIT Tailwind script not loading correctly after 4.8.8.
Live Updates v1-3
New version of Live Updates 1.3. Existing layouts can be updated by manually changing the <script>. New layouts will use the new version.
Performance
All SiteBuilder JS, including Live Updates, now has a minified version of the same file in the same folder. Simply replace .js with .min.js extensions for a performance boost. This will be applied to new installs of layouts going forwards. If you're experiencing unhandled JS errors and want to report a bug, you may find it helpful to switch back to the unminified version temporarily.
Performance boost to the SiteBuilder module UI
Forms
Datasources in forms used to only show a maximum of 20 options. A lower value may have increased performance, but also reduced the user's choices arbitrarily. Now that limit has been increased to 2000 by default on both dynamic and static form layouts. You can change the default on dynamic layouts by setting a datasource_limit parameter to a string value e.g. '1000' on the form_layout_fields include. On static layouts, the per_page parameter can be edited on the nested ```liquid
{% include %}
Cookie Popup Layouts
Fixed bug preventing some layouts from hiding scripts when cookies rejected. Remember changes will only apply to freshly installed layouts. If you need to fix an existing layout manually, replace:
with:
Live Updates
Added support for using a code_snippet or content_section as your layout. A new parameter of include_id has been added to the live_updates_params_encode include to store the ID of the code_snippet or content_section. See: Defining a Live Update Layout
New version of Live Updates 1.2
Fixed bug in Page Template install in Themes with no cookie popup option
Fixed bug in Live Updates error handling
Improved PageBuilder Options. You can now set custom pagination layouts in PageBuilder in the options drawer.
Improvement to WebApp table layout so that if a category filter is added, it's possible to choose a parent category in a Liquid variable at the top of the wrapper. This means you can organise relevant categories in a folder and only show those.
Improvement to Blog layouts using a grid where if few results, the cards would stretch to fill the space. Now they stay at the correct unstretched size.
Blog, Events, FAQ and other list layouts replaced with upgraded Live Updates versions of themselves, for better user experience. When using new list layouts alongside a details page, set use_adv_search: 'true' on the list view's tag to instantly apply detail page filters when linking back. (See below)
Fixed missing parameter range_field for live Updates API
Live Updates API now has a new version of its JavaScript file, with added functionality. This will be included in many new SiteBuilder layouts by default, or you can optionally upgrade your existing layouts with the tag:
Live Updates API now adds a click listener to text input fields. This helps to cover an edge-case where a cancel button is nested inside the text area to clear the field. Non-breaking change.
New feature modifyHistory changes te URL to match fitlers without page reload - useful for shareable links and single-page applications
New feature automatically launches a live-update on page load if any of the live-update form elemtns has a value.
Improvement to error message when a Liquid error is detected in updated HTML.
Fixed a rare bug relating to module API page templates conflicting with site page templates.
Fix for live-updates issue where radio button element's value is read incorrectly when filtering.
Fix for issue from 4.7.2
Added layouts to Flowbite and Bootstrap Themes for:
Cookie Policy Popups
Cookie Policy Settings Pages
These are examples of a brand new type of layout for SiteBuilder, as installing them creates a Siteglide code_snippet with a unique ID. More [code_snippet layouts are now possible for SiteBuilder developers](/sitebuilder/extending-sitebuilder/adding-dynamic-layouts-to-themes-and-modules.md #code-snippets). Currently, these are not supported in PageBuilder.
Page Template creation now gives you an option to install a cookie popup layout directly into your new Page Template. If chosen, this replaces the Google Analytics script which would normally be entered by default. The cookie popup layout contains the same Google Analytics script, but wraps it in logic which allows it to be toggled on and off by the end-user. Cookies settings page layouts are not designed to be entered in the Page Template and must be installed via the layouts tab instead.
Added new setting in settings tab for TinyMCE API key. This allows layouts to dynamically fetch key from one place.
Flowbite table webapp layout now uses left-align for its table headers.
Improvements to forms
All form components to use the {{field_id}} (plus any appropriate suffix) for their ID, instead of name (same for label for attributes). This should simplify any JS or CSS referencing it.
All required fields will have an asterisk " *" added after their labels by default. This can be changed in components.
All inputs will be given data-attributes containing the text of their human-readable label data-sg-validation-label and the main field ID for their field data-sg-validation-id (note this may be different from the ID of the element if there are multiple form elements responsible for controlling a field, e.g. checkboxes). These can be useful when writing custom validation rules.
If the error message from Siteglide validation references a field by ID, we will change the error message to be more human-friendly. The default is a generic message asking the user to complete missing fields, but a commented out alternative allows you to print the human-readable name of the first missing field. Likewise, we've added a more human-friendly error message when a captcha fails. These messages can be edited in the form layout JS.
Improvements for Date, File and Image fields when marked as required.
Improvements for rich-text textarea type fields when marked as required.
Added minimum value to date fields so they do not add a date which is out of range of Siteglide's date field. Siteglide dates must be within the unix epoch.
Improved animation transition on form progress bars.
Improvement to Flowbite Login Form Modal Layout - Wider padding and more modern syntax to make it less prone to closing accidentally. This may still happen if the user clicks on the backdrop, but is less likely to happen when missing a click event aimed at an input.
Supporting the ability to more easily add a parameter to redirect the form to a custom URL. Set custom_form_redirect parameter on the top include form tag or the include form_layout_fields tag.
Fixes for dark mode on some Flowbite Layouts
Hotfix for Rich Text fields not submitting correctly in forms
Fix for Flowbite Typography dark mode on Flowbite Layouts
Improvements and fixes to Sitebuilder Forms:
Type date fields now show initial values correctly, in local timezone, the same as Siteglide Admin. They also have max-values which don't allow invalid unix timestamps and expiry date will default to the max timestamp.
Textarea fields are now passed data-sg-rich-text attribute if rich_text is selected in the Siteglide Admin
Textarea fields now have rich-text-editor support when rich-text is turned on. This feature is powered by TinyMCE and requires a free API key to be added to remove warning notice. View the docs to add your API key and modify the settings.
Added experimental support for datasources on Flowbite Live-updates WebApp table layout. This outputs the names of data-sourced webapp items in the table-cell instead of IDs. In future, we'd like to optimise this for performance, for now, we recommend only using it on short lists.
Fix for SiteBuilder forms- datasource (single) fields in edit forms were not previously showing initial values correctly.
Launching the JS Live Update API - Making it quick and easy to live-update server-side code on the client side when users interact with it and its state changes.
New Flowbite Page Templates now have the beta feature option to select an alternative Template structure suitable for Portals and Applications. This supports a Flowbite sidebar layout.
Improvements and Fixes for some Form Layouts
Added a variant of the Flowbite multi-part form with full-width fields for use in smaller form sections.
Flowbite multi-part forms now fill the container height, making it more convenient to add them inside a grid.
Fixes for edit email & password functionality on Flowbite forms (Bootstrap Theme did not have the bug)
Fixes for some Slider Layouts
fixes layouts which were either missing the Liquid to load the JS, or using an older, less efficient, version.
fixes for layouts with broken image alt fields.
Fixes for compatible Themes, such as Flowbite Pro.
Fixed bug when installing a detail layout from a compatible theme on PageBuilder, where that layout would be given a list view tag.
Fixed bug in WebApp Layout field mapping where layouts from compatible Themes were given the wrong field slots.
Fixed bug viewing layouts from compatible themes on Layouts tab when the same ID was used in different Theme namespaces.
Added support for WebApp Layouts. WebApp Layouts allow agencies to map custom fields from a WebApp to slots in the Layout, so Generalised Layouts can suit a range of specific use-cases.
UI Improvements including Validation and Accessibility
Added a range of WebApp Layouts to the Flowbite Library.
More WebApp Layouts coming soon.
Support for Siteglide Slider Module
New optional JS script for layouts implementing a slider effect
Added Slider layouts to Flowbite and Bootstrap Themes
Fix for some layout options in Page Builder
Improvements to UI
Support for WebApp and Module item add, edit and delete form layouts.
Support for WebApp and Module item add forms to PageBuilder.
Updated documentation to explain the new reliable way to change the order of custom fields in dynamic form layouts.
Changed default order for system fields in forms to be negative. This will affect existing sites, so be prepared to review these when updating the module:
name: -40
email: -30
password: -20
Categories: -10 It is possible to order custom fields so that they fall before, after or between these system fields.
PageBuilder UI updated to guide the user to select Page Template and name before the Theme is locked-in.
Form Layout progress bars only display while form is submitting, not before.
Improvements to Form Layout Image and File fields.
Fixes to SiteBuilder UI
Changed Home tab video
Added new home tab to Module UI
Fix for some issues in the settings page
Further Static Layouts Fixes
Fix for Static Layouts from compatible Themes e.g. Flowbite Pro, so that the Theme does not need to be installed on a Page Template, only installed to the Site, before the Static Layouts appear.
Adds tips when a user adds a Module Layout in Page Builder, or when a Module Layout is installed.
Links to Siteglide Admin from the UI now open in the same tab to take advantage of faster loading speeds.
Multiple UI styling and responsiveness fixes
Form field labels on Static Layouts now support apostrophe characters.
Improves reliability of installs of layouts from compatible Themes.
Fixes install bug
Reduces Module install time
Adds support for agencies to add SiteBuilder content through creating modules in the Siteglide Marketplace. These modules can be of two types, Themes which add entirely new Themes to SiteBuilder, or can extend existing compatible Themes. Or functional modules which add new content to Siteglide and can include SiteBuilder compatible layouts to extend any existing Theme. Read more in the documentation.
New module UI which aims to deliver a clearer starting point for new users and better defaults for more experienced users.
hcaptcha support for forms. This allows you to use Siteglide's recommended spam protection method.
Remove unwanted PageBuilder sections
Liquid tag recommendations when creating layouts
More Modules and Sub-modules supported
Bug fix for Form Layouts to support HTML entities like ' in form config field options e.g. in checkboxes.
PageBuilder Safari bugfixes
PageBuilder UI design Improvements
Released PageBuilder, a brand new user-interface for quickly building a page from scratch using SiteBuilder content. Access this by clicking a library and scrolling down to PageBuilder.
Search for and apply an existing Page Template
Add as many sections as you like and choose whether to add static or dynamic layouts
Visually preview and choose layouts from the current SiteBuilder library.
Use the UI to select module specific settings to automatically add to the Liquid tags when we build the page
Support for form fields for changing email and passwords.
Performance upgrade when adding duplicate layouts to the same PageBuilder Page
Added support for adding Detail Layouts. Tip: use item_ids to select a specific item's detail page
Added Changelog to documentation
Added new contextual docs links
Improved Page Template Creation wizard to add Header/ Footer options
Introducing the Flowbite Library