Configuration
Open Add-ons → Manage add-ons → Compass theme → Settings.
| Setting | Default | Description |
|---|---|---|
| Sticky header | On | Keeps the header (logo, ask field, basket) at the top while shoppers scroll; the goal sentence hides while it is stuck. |
| Mobile bottom bar | On | Compass replaces the standard phone bar with a floating “Tell us what you need…” bar and a basket button. |
| “More” menu for long top menus | On | Goals that do not fit into the goal sentence move into a “More” dropdown, so the line never wraps. |
| Product card style | Theme default | Theme default (match cards) or Outlined, Plate, Minimal for stock product grids. |
| Show the second image on hover | Off | Stock product grids show the next product image when the pointer is over a card. |
| Product page layout | Classic | Classic = the round image lens next to the details; Large gallery = wide images with the details column following on scroll. |
| Subtle animations | On | The needle turns to the chosen answer, matches re-sort smoothly, cards fade in. Visitors who prefer reduced motion never see animations. |
| Install the demo content when the theme is activated | On | When a storefront switches to this theme, the next admin page adds the Lodestar demo store (eight goals with needs, 48 products with quiz features, units and reviews, a promotion with a real end date, field notes, store reviews, a main menu; on Multi-Vendor three demo shops) 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. |
Compass
Section titled “Compass”| Setting | Default | Description |
|---|---|---|
| Blend white product photos into the round image lenses | On | Product photos with a white background are drawn with a multiply blend inside the tinted lenses. Turn it off when your product images are cut-outs or photos with their own background. |
| Show prices per unit | On | “$0.21 / capsule” from the features with the codes CP_UNITS and CP_UNIT (see Usage). |
Block settings (Website → Themes → Layouts, the block’s gear button):
| Block | Setting | Description |
|---|---|---|
| Quiz (Compass theme) | Content | The questions and answers as plain text (see Usage). |
| Quiz (Compass theme) | Show matches while the shopper answers | On: the right column updates after every answer. Off: matches appear only at the end. |
| Goal index | — | Lists the categories of the block with their three most popular products. |
Colours and fonts: Website → Themes → Theme editor (per style).
License
Section titled “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 (for example example.com) and every subdomain
of it. Local development hosts (localhost, private IP addresses, *.localhost, *.test, *.local, *.example,
*.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_compass_license.checkWhat 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 Compass design is switched off: the storefront shows the standard Responsive look (standard stylesheet and menu, the Compass homepage sections and the quiz 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 Compass 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 | Compass design. |
| Development host | Blue | Compass design. |
| Pending · N days left | Blue | Compass design for 14 days after installation. |
| Grace period · N days left | Amber | Compass 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.