Configuration

Open Add-ons → Manage add-ons → Kudos theme → Settings.

Theme

Setting	Default	Description
Sticky header	On	Keeps a compact header (logo, search, cart) at the top of the shop while shoppers scroll.
Mobile bottom bar	On	Home, Menu, Search, Account and Cart as a bar at the bottom of the screen on phones.
“More” menu for long top menus	On	Menu items that do not fit on one line move into a “More” dropdown instead of wrapping to a second row.
Product card style	Theme default	Theme default (white card with a soft shadow on the cream page), Outlined, Plate or Minimal.
Show the second image on hover	On	Product grids show the next product image when the pointer is over a card. Needs Settings → Appearance → Thumbnails gallery for product lists, which the theme switches on when you activate it.
Product page layout	Classic	Classic or Large gallery.
Subtle animations	On	Sections fade in while scrolling. Visitors who prefer reduced motion never see animations or the automatic slide change.
Install the demo content when the theme is activated	On	When a storefront switches to this theme, the next admin page adds the Kudos demo catalogue (a technology store “Starling”: eight departments, products with images, options, features and reviews, journal posts, a main menu and, on Multi-Vendor, demo shops) and points the homepage blocks of the theme layouts at it. Runs once per storefront. Your own products, categories and pages are never changed. Turn it off before activating the theme to start with an empty design.

Colours and fonts: Website → Themes → Theme editor (per scheme).

The review elements

Every Kudos review element reads the approved reviews of the core Product Reviews add-on (4.17 and later). Nothing is invented: no element shows a number your database does not hold, and every element prints nothing while there is no approved review. Reviews follow the add-on setting Split reviews by storefronts.

Element	Where	What it shows
Review snippet	every product card (grids, lists)	the product’s review that shoppers voted most helpful, otherwise the newest one (any star rating, never picked by rating), with its own stars and the label “Most helpful” or “Newest”; 20-600 characters, cut to 140; the reviewer as first name + last initial with an initials avatar, and “Verified” when the core marks the review as from a buyer. Multi-Vendor vendor offers show the reviews of their master product
Proof bar	Template block Proof bar (Kudos theme)	store average, number of reviews, share of 4 and 5 star reviews, number of reviewed products, link to the top rated products
Review wall	Template block Review wall (Kudos theme)	the same store numbers with a 5-bar histogram, then the 9 newest reviews with text, at most one per product (every rating included), each linked to its product
Top rated	Products block, filling Top rated, template Top rated grid (Kudos theme)	only products that have a rating, best average first; nothing when the add-on is off
Rating card	product page, under the title	average, share of 4 and 5 star reviews and a 5-bar histogram; each bar opens the Reviews tab
Most helpful reviews	Template block Most helpful reviews (Kudos theme), product page bottom	the 4-5 star and the 1-3 star review with the most “helpful” votes; one side alone when only one exists; nothing without votes

Store numbers count only products a guest can see (active products, active vendors on Multi-Vendor, the storefront’s categories on Ultimate). They are cached and refresh when reviews or products change. Approve or decline reviews in Products → Reviews as usual.

The demo import points the Top rated block at the five demo products with the best demo averages (a manual list). When you remove the demo products, open the block’s Content tab and choose the filling Top rated again.

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_kudos_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 Kudos design is switched off: the storefront shows the standard Responsive look (standard stylesheet and menu, the Kudos 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 Kudos 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	Kudos design.
Development host	Blue	Kudos design.
Pending · N days left	Blue	Kudos design for 14 days after installation.
Grace period · N days left	Amber	Kudos 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.