Skip to content

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).

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.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 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.