Configuration
Open Add-ons → Manage add-ons → Agora theme → Settings.
| Setting | Default | Description |
|---|---|---|
| Sticky header | On | Keeps a compact header (logo, search, cart) at the top while shoppers scroll. |
| Mobile bottom bar | On | Home, menu (opens the All categories drawer), search, account and cart as a tab bar at the bottom of the screen on phones. |
| “More” menu for long top menus | On | Used by the standard main menu (Agora shows the All categories drawer and the campaign row instead). |
| Product card style | Theme default | Theme default (the offer card of the active style), Outlined, Plate or Minimal. |
| Show the second image on hover | Off | Product grids show the next product image when the pointer is over a card. |
| Product page layout | Large gallery | Large gallery (gallery beside a details column that follows on scroll) or Classic (the standard Responsive product page). |
| Subtle animations | On | Sections fade in while scrolling, cards lift on hover, the slider cross-fades. 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 Agora demo marketplace (eight departments with 20 subcategories, 51 products from six demo shops with GTIN codes, ten items offered by two or three shops, shop and product reviews, a flash sale and weekly deals with real end dates, three coupon promotions with codes, journal posts and a main menu) 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, vendors and pages are never changed. Turn it off before activating the theme to start with an empty design. |
| Setting | Default | Description |
|---|---|---|
| Offers feature code | GTIN |
Products from different vendors with the same value in this product feature (a GTIN / EAN barcode) are offers of one item: cards show “N sellers from $X” and the product page lists every offer in the Best offers table. When the core Master products add-on is active, its vendor offers are used instead. Leave empty to turn the grouping off. Only active vendors count; offers with the status Hidden count too (so the same item is not listed twice). |
| Seller badge tiers | On | A badge next to the vendor name, earned from the vendor reviews: Top seller (rating 4.7 or higher from at least 3 reviews), Rated seller (rating 4.0 or higher) or New shop (joined within the last 60 days). |
| “Buy now” button on product pages | On | A Buy now button next to Add to cart (also in the sticky bar on phones): it adds the product with the chosen options and quantity to the cart and opens the checkout. |
| Coupon tickets | On | The coupon tickets of the coupon wall and the coupon tile in category grids. |
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.
The card shows the status in colour (green valid, blue development host or the 14-day period of a new installation, amber when the licence server could not be reached, red when the theme design is switched off), what happens when it is switched off, the licensed domain and every storefront with its result, the end of the updates period, the last and next check, and the actions Change license key, Check now, Manage license and Buy a license.
| 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_agora_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 Agora design is switched off: the storefront shows the standard Responsive look (standard stylesheet and menu, the Agora 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 Agora and the design is switched off, every admin page shows a notice that names the theme, the reason (no key after the trial period, invalid key, revoked, other domain, licence not verified for 14 days) and how to fix it, and Website → Themes shows the same text above the current theme.
| Status (card) | Colour | Storefront |
|---|---|---|
| Valid | Green | Agora design. |
| Development host | Blue | Agora design. |
| Pending · N days left | Blue | Agora design for 14 days after installation. |
| Grace period · N days left | Amber | Agora 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.