Widget Types

Developer Note

Developer documentation for the Hyvä Commerce widget types is available here.

Hyvä Commerce ships with a number of widgets out-of-the-box and will continue to add more widgets over time. The following is a list of widgets currently available with Hyvä Commerce:

• Average Order Value
• Best Selling Products
• Checklist
• Google CrUX History
• Launchpad
• Links
• Most Viewed Products
• New Customers
• Orders by Country
• Order Volume
• Recent Orders
• Sales Figures
• Sales Funnel Activity
• Search Activity
• Text

Average Order Value

The Average Order Value widget displays the average order value for orders in a given set of states for selected stores.

Display Properties

Name	Purpose	Required (Y/N)
Default Interval	Initial data time period to display.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Eligible Order Statuses	Set of order statuses to consider during calculation.	Y

Best Selling Products

The Best Selling Products widget displays a number of the best-selling products from selected stores over a given period.

Display Properties

Name	Purpose	Required (Y/N)
Interval	Time period to display data for.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Number of Products to Display	How many products should be displayed.	Y

Checklist

The Checklist widget displays a user-specified series of labels and checkboxes.

Display Properties

Name	Purpose	Required (Y/N)
Description	Personal widget description.	N
Show Filters	Add buttons to show all items, completed items, or incomplete items.	Y
Sort Items	Add a button to separate completed items from incomplete ones.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Done	Determines whether the checkbox is checked or not.	Y
Item Name	Label content.	Y

Adding and Removing Items

Clicking Add button at the bottom of the Configurable Properties section will add an additional item to the widget while clicking the trash icon will remove the associated item.

Google CrUX History

The Google CrUX History widget displays information about the Core Web Vitals of a given website or webpage.

Display Properties

Name	Purpose	Required (Y/N)
Use Logarithmic Scale	Set whether the Y-axis displays raw metric values on a logarithmic scale.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Use Custom URL	Choose whether the widget should report on a given store view or a custom URL.	Y
Store View	The store view to measure.	Y
URL	The URL to measure.	Y
Collect Data for the Origin?	Choose whether data is collected for a specific page or the website as a whole.	Y

URLs

Only one of Store View or URL is required. The Store View property is used when Use Custom URL is disabled, otherwise the URL property is used.

Launchpad

The Launchpad widget provides quick access to a number of common admin actions such as CMS content creation and catalog management etc.

Configurable Properties

Name	Purpose	Required (Y/N)
Link Type	Type of action to include.	Y
Open in New Tab		Y

Links

The Links widget displays a series of user-configured links or bookmarks.

Display Properties

Name	Purpose	Required (Y/N)
Description	Personal widget description.	N

Configurable Properties

Name	Purpose	Required (Y/N)
URL		Y
Open in New Tab		Y
Title		Y

Adding and Removing Items

Clicking Add button at the bottom of the Configurable Properties section will add an additional item to the widget while clicking the trash icon will remove the associated item.

Most Viewed Products

The Most Viewed Products widget displays a number of the most viewed products from selected stores over a given period.

Display Properties

Name	Purpose	Required (Y/N)
Interval	Time period to display data for.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Number of Products to Display	How many products should be displayed.	Y

New Customers

The New Customers widget displays the newest customers from selected stores, along with their name, the number of orders they have placed, their average order value, and their total spend.

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Number of Customers to Display	How many customers should be displayed.	Y

Orders by Country

The Orders by Country widget displays a pie chart of the countries responsible for placing the most orders.

Display Properties

Name	Purpose	Required (Y/N)
Number of Countries to Display		Y
Group Non-Top Countries	Sets whether to include an "Other" segment to list all other countries.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Determine Country Using	Set how to determine the order country.	Y
Eligible Order Statuses	Set of order statuses to consider during calculation.	Y

Order Volume

The Order Volume widget shows a line graph of the number of orders placed per day.

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Eligible Order Statuses	Set of order statuses to consider during calculation.	Y

Recent Orders

The Recent Orders widget shows a number of recent orders - including the customer name, the number of items purchased, and the order total.

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Number of Orders to Display		Y

Sales Figures

The Sales Figures widget shows a number of different totals values - filterable by store, order status, and time period.

Display Properties

Name	Purpose	Required (Y/N)
Default Interval	Initial data time period to display.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y
Order Status	Which order statuses to include during calculation.	Y
Figures	Which totals data to include during calculation.	Y

Sales Funnel Activity

The Sales Funnel Activity widget shows the number of customers with items in their basket, the number of customers in the process or checking out, and the number of customers who have completed their order.

Display Properties

Name	Purpose	Required (Y/N)
Default Interval	Initial data time period to display.	Y

Configurable Properties

Name	Purpose	Required (Y/N)
Store Views	Which store views to include during calculation.	Y

Search Activity

The Search Activity widget displays a number of the most recent or most popular search terms for selected stores.

Configurable Properties

Name	Purpose	Required (Y/N)
Sort By	Choose whether to show most popular or most recent search terms.	Y
Store Views	Which store views to include during calculation.	Y
Number of Search Terms to Display	How many search terms should be displayed.	Y

Text

The Text widget allows the admin to include miscellaneous text on their dashboard.

Display Properties

Name	Purpose	Required (Y/N)
Description	Personal widget description.	N

Configurable Properties

Name	Purpose	Required (Y/N)
Content	The text to display.	Y