Installation

Requirements

• CS-Cart, CS-Cart Ultimate, Multi-Vendor or Multi-Vendor Ultimate 4.17.2 – 4.21.x.
• For the quiz and the filters as questions: product features of the types Select box, Multiple checkboxes or Brand/Manufacturer, with product filters for the “See all matches” link (the demo content creates both).
• For field notes, the core Blog add-on; for store reviews, Comments and reviews; for product ratings, Product reviews; for the newsletter, Newsletters.
• Administrator access to the admin panel.

Install

1. Download kv_theme_compass-<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 Compass theme installs the Compass theme files. It does not change your storefront.
3. Enter your licence key: Add-ons → Manage add-ons → Compass theme → Settings → License (see Configuration).
4. Open Website → Themes, find Compass and click Activate. CS-Cart asks whether to apply the theme’s recommended settings (the Match cards product list view, 24 products per page, square product images without a background colour); accept them for the intended look.
5. Open any admin page once: Compass adds its demo content (Lodestar: eight goals as categories with 24 needs as subcategories, 48 products with the quiz features Good for, Format, For, Diet and Caffeine, units for prices per unit, the “Is this right for me?” feature group, reviews, an “Autumn reset” promotion with a real end date, four field notes, store reviews and a main menu; on Multi-Vendor three demo shops with shop reviews) and points the homepage blocks at it. The homepage quiz names these features and categories, so it works right away. 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: Sage, Clinic, Pet or Roast.

The theme brings its own layout (header with the ask field and the goal sentence, the consultation, trust line, goal index, match cards, comparison and adviser card, field notes and reviews, goal page header, product page comparison, footer). 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, including your quiz text, are never replaced, and the demo content is never added twice.

Uninstall

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

If a storefront still uses Compass 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.