Installation

Requirements

• CS-Cart, CS-Cart Ultimate, Multi-Vendor or Multi-Vendor Ultimate 4.17.2 – 4.21.x.
• For the hero slider and the promo banners, the core Banners add-on; for inspiration posts, Blog; for store reviews, Comments and reviews; for product ratings, Product reviews; for colour variations, Product variations; for the newsletter, Newsletters; for the heart on cards, Wish list.
• Administrator access to the admin panel.

Install

1. Download kv_theme_hearth-<version>.zip from your Kavio Labs or CS-Cart Marketplace account.
2. Open Add-ons → Manage add-ons, click the gear button, choose Manual installation and upload the archive. The add-on Hearth theme installs the Hearth theme files. It does not change your storefront.
3. Enter your licence key: Add-ons → Manage add-ons → Hearth theme → Settings → License (see Configuration).
4. Open Website → Themes, find Hearth and click Activate. CS-Cart asks whether to apply the theme’s recommended settings (square product images without a background colour, the thumbnails gallery in product lists for the second image on hover, quick view, 12 products per page, sorting by popularity); accept them for the intended look.
5. Open any admin page once: Hearth adds its demo content (Alder House: eight rooms as categories with 25 subcategories, 55 products with materials, colours, dimensions, delivery and assembly features, four colour variation groups, options, reviews, an “Autumn living” promotion with a real end date, three hero slides and two promo banners, four inspiration posts, store reviews and a main menu; on Multi-Vendor four demo shops with shop reviews) and points the homepage blocks at it. A notice confirms it. Turn the setting Install the demo content when the theme is activated off before step 4 to start with an empty design.
6. Choose a style: Clay, Coast, Rattan or Evening.

The theme brings its own layout (top bar, header with account, wish list and cart, category bar, homepage sections, category promo tile, product page bottom, footer brand column). Layouts of your other themes stay untouched; switching back to your previous theme brings them back.

Upgrade

Upload the new package the same way (Manual installation over the installed add-on), or install the upgrade package in Administration → Upgrade center. Then open any admin page once: the add-on updates the installed theme files. Files you changed yourself (for example a style edited in the Theme editor) are kept, and a notice lists them. Your layouts and blocks are never replaced, and the demo content is never added twice.

Uninstall

1. Switch every storefront to another theme in Website → Themes.
2. Uninstall Hearth theme in Add-ons → Manage add-ons. The Hearth theme files and its layouts are removed. The demo products, categories, features, banners, promotions and posts stay (they are normal items); delete the ones you do not need.

If a storefront still uses Hearth when you uninstall the add-on, the theme files are kept and that storefront shows the standard Responsive look until you install the add-on again or switch the theme.