Included Components

Hyvä Commerce is an 'Early Access' product currently under development.

Early Access means that not all features of Hyvä Commerce are fully completed or released, and many areas are still under heavy development and may change. However, it means you can get your hands on everything currently available and being worked on, with a license. Find out more on our Early Access page.

This page details a full list and status of components Hyvä CMS ships with out-of-the-box, noting any considerations of changes that may occur during the Early Access period. At present, the majority of components are still undergoing heavy development, both in terms of their structure, such as the fields included and the data they store, as well as their frontend templates in regard to markup, Tailwind styles and any JavaScript (e.g. Alpine) logic.

A Guide, Not A Guarantee

Please be aware, the below is a guide to help you plan, not a guarantee things will or won't change. We'll ensure to update this list as often as we can.

Layout Components

Row

Overview: for creating rows of full width or contained content
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only

Columns

Overview: for creating column and grid based layouts
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only

Elements Components

Heading

Overview: for adding headings (H1-H6)
Status: included
Fields/structure: very unlikely to change
Template file(s): minor updates expected only

Text

Overview: for adding rich text with basic formatting tools (utilises the Quill editor)
Status: included
Fields/structure: very unlikely to change
Template file(s): minor updates expected only
Other: additional improvements to the Quill editor (e.g. formatting tools) may be considered in future

Spacer

Overview: for adding vertical spacing between other components, with the option to add a divider (<hr>)
Status: included
Fields/structure: very unlikely to change
Template file(s): minor updates expected only

Button

Overview: to allow adding button elements with links
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only

HTML Code

Overview: to allow embedding HTML code
Status: included
Fields/structure: very unlikely to change
Template file(s): minor updates expected only
Other: additional improvements to HTML editor (e.g. code syntax/highlighting) may be considered in future

Accordion

Overview: for adding multiple accordion item elements
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only

Accordion Item

Overview: to add an accordion item element
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only
Other:
- Allowed child components will be reviewed and likely relaxed to allow more flexibility
- This component can currently be added outside a parent Accordion component - this will no longer be possible once parent restrictions are implemented

Media Components

Image

Overview: to add an image
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s):
- The current image output will be replaced by a view model approach, once the integration with Media Optimization is completed
- Otherwise, minor updates expected only

CTA

Overview: to add a CTA (Call to Action) block (based on the Hyvä UI component of the same name)
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s):
- The current image output will be replaced by a view model approach, once the integration with Media Optimization is completed
- Otherwise, minor updates expected only

Overview: to add a banner block - imagery with overlaid text (based on the Hyvä UI component of the same name)
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s):
- The current image output will be replaced by a view model approach, once the integration with Media Optimization is completed
- Otherwise, minor updates expected only

Slider

Overview: to add a slider with various supported child elements (based on the Hyvä UI component of the same name)
Status: included
Fields/structure:
- The 'Title' field may be removed in favour of using the 'Heading' Component instead
- Otherwise, unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only

Testimonial

Overview: to add a testimonial block (based on the Hyvä UI component of the same name)
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s):
- The current image output will be replaced by a view model approach, once the integration with Media Optimization is completed
- Otherwise, minor updates expected only

USP List

Overview: to add a list of USP (Unique Selling Point) blocks (based on the Hyvä UI component of the same name)
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only

USP

Overview: to add a USP (Unique Selling Point) block - icons with titles and text (based on the Hyvä UI component of the same name)
- Also supports the Shortcut Hyvä UI element style, which has similar content
Status: included
Fields/structure: unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only
Other:
- This component renders correctly when added as a child component of a USP List. It can be added outside a USP List but it won't render and will display a warning in the editor instead. Future updates may restrict placement to within USP List components only.

Content Components

CMS Block

Overview: to include reusable content stored via CMS Blocks (which themselves can also contain Hyvä CMS content)
Status: included
Fields/structure: very unlikely to change
Template file(s): minor updates expected only

Product Slider

Overview: to include a list of products in a carousel (slider) either by manual selection or choosing one or more categories
Status: included
Fields/structure:
- The 'Title' field may be removed in favour of using the 'Heading' Component instead
- 'Category IDs' will likely be replaced with a category selector, and may be limited to a single category (TBD)
- Otherwise, unlikely to change (potentially BC-friendly additions)
Template file(s): minor updates expected only
Other:
- The product selector will likely see further improvements, but is very unlikely to affect data structure

Unreleased Components

The below are widgets that are not currently available, but are planned to be released before General Availability

Widgets (Legacy)

Overview: for adding existing CMS Widgets within Hyvä CMS with the main aim of aiding migration from legacy widget content, rather than for adding new widgets
Status: not included (under development)
Fields/structure: N/A
Template file(s): N/A

Marquee

Overview: a slider alternative, useful for creating content such as rotating/scrolling logo (e.g. Brand) sections
Status: not included (under development)
Fields/structure: N/A
Template file(s): N/A

Maps

Overview: a Google Maps embed integration (with performance considered!)
Status: not included (to be developed)
Fields/structure: N/A
Template file(s): N/A

Video

Overview: a YouTube embed integration (with performance considered!)
Status: not included (to be developed)
Fields/structure: N/A
Template file(s): N/A