Configuration

Open Add-ons → Manage add-ons → Hearth theme → Settings.

Theme

Setting	Default	Description
Sticky header	On	Keeps the header at the top while shoppers scroll; on phones only the logo, search and cart stay.
Mobile bottom bar	On	Home, Rooms, Search, Saved and Cart at the bottom of the screen on phones.
“More” menu for long top menus	On	Categories that do not fit into the category bar move into a “More” dropdown, so the bar never wraps.
Product card style	Theme default	Theme default (studio wells) or Outlined, Plate, Minimal.
Show the second image on hover	On	Product cards show the next product image when the pointer is over a card (needs a second image).
Product page layout	Classic	Classic = gallery and details side by side; Large gallery = wide images with the details column following on scroll.
Subtle animations	On	Sections fade in, images zoom slightly on hover, the hero slides fade. Visitors who prefer reduced motion never see animations, and the hero does not advance on its own for them.
Install the demo content when the theme is activated	On	When a storefront switches to this theme, the next admin page adds the Alder House demo store and points the homepage blocks of the theme layout at it. Runs once per storefront (re-activating or upgrading adds nothing). Your own products, categories and pages are never changed. Turn it off before activating the theme to start with an empty design.

Hearth

Setting	Default	Description
Studio wells behind product images	On	Product images stand in a warm seamless backdrop with a soft floor shadow. Best with cut-out product images. Turn it off for photos with their own background: they are shown on a plain light card.
Zoom lens on product images	On	On computers with a mouse, a round lens enlarges the product image under the pointer. Clicking still opens the image viewer.
Delivery panel on product pages	On	The delivery, assembly and returns panel under the add to cart button, with estimated delivery dates (see Usage).

Block settings (Website → Themes → Layouts, the block’s gear button):

Block	Setting	Description
Hero slider (Hearth theme)	Seconds per slide	How long each slide stays before the next one (only for visitors who allow animations).
Product grid (Hearth theme)	Columns, “View all” link, Swipe row on phones	Grid width on computers, an optional link next to the title, and a swipe row instead of a two-column grid on phones.
Complete the look (Hearth theme)	Room photo URL, Title, Caption	The room photo next to the pieces (empty = the photo that comes with the theme) and its texts.

Colours and fonts: Website → Themes → Theme editor (per style).

License

The licence status is shown in a License card at the top of the add-on page, above the tabs. The License tab holds the key itself. The key is stored once for the whole installation.

Setting	Description
License key	Your Kavio Labs licence key (KAVIO-XXXX-XXXX-XXXX-XXXX, from My licenses on cs-cart.kaviolabs.com) or your CS-Cart Marketplace license number. If you entered the Marketplace number in Add-ons → Manage add-ons, leave this empty.
License status	Points to the License card and explains what the check sends.

What the licence covers. The base domain you entered at purchase and every subdomain of it. Local development hosts (localhost, private IP addresses, *.localhost, *.test, *.local, *.invalid) are always allowed. A store on a different base domain needs its own licence.

When it checks. When you save the key and then once a day, only in the admin panel or from cron, never while customers browse the storefront:

php /path/to/store/admin.php --dispatch=kv_theme_hearth_license.check

What is sent. Only this, to https://cs-cart.kaviolabs.com: the licence key, the add-on ID and version, the host names of your storefronts, your CS-Cart version and edition, and a random one-time value. No customer, order or personal data. The answer is digitally signed.

What happens without a valid licence. A new installation works for 14 days without a key. If the licence server cannot be reached, the theme keeps working for 14 days after the first failed check. After that, or with an invalid, revoked or other-domain licence, the Hearth design is switched off: the storefront shows the standard Responsive look (standard stylesheet and menu, the Hearth homepage sections hidden; the colours of the active style stay). Cart, checkout, orders and customer accounts keep working; visitors see no message. The design is also switched off while the add-on is disabled or uninstalled.

While a storefront uses Hearth and the design is switched off, every admin page shows a notice that names the theme, the reason and how to fix it, and Website → Themes shows the same text above the current theme.

Status (card)	Colour	Storefront
Valid	Green	Hearth design.
Development host	Blue	Hearth design.
Pending · N days left	Blue	Hearth design for 14 days after installation.
Grace period · N days left	Amber	Hearth design for 14 days after the first failed check.
Not activated, Invalid key, Revoked, Domain mismatch, Not verified	Red	Standard Responsive look; the store keeps working.

When your updates period ends, the theme keeps working; only updates and support stop. Licence information appears in the admin panel only, for administrators who may manage add-ons; vendors and customers never see it.