Usage

Agora reads everything from standard CS-Cart data: categories, vendors and their reviews, product features, promotions and Block Manager blocks. This page shows which data feeds which part of the design.

Offers of the same item (“N sellers from $X”)

A price-led marketplace has the same item from several sellers. Agora groups them in one of two ways:

• Master products (core add-on, Multi-Vendor 4.x): vendor offers of a master product are its offers.
• Offers feature (setting, default GTIN): products of different vendors with the same value in the text feature with that code (for example the EAN barcode 2004815000004) are offers of one item.

The card shows “N sellers from $X” when at least two active shops offer the item; X is the lowest base price of the offers or the card’s own current price. The product page lists every offer (up to eight) in the Best offers table, cheapest first, with the seller, its badge and rating, free shipping, stock and an Add to cart button (offers with options open their own page). To list an item once while keeping its other offers, set the other offers to the status Hidden: they stay reachable from the table and still count.

Seller badges

Badges come from the vendor reviews (Vendors → the vendor → Reviews, the stars the vendor page shows):

Badge	Rule
Top seller	rating 4.7 or higher from at least 3 reviews
Rated seller	rating 4.0 or higher from at least 1 review
New shop	joined within the last 60 days (and not rated yet)

Coupons and the flash sale

• Coupon tickets are your cart promotions with a coupon code that are active now (Marketing → Promotions, condition “Coupon code”): the ticket shows the order discount (fixed amount, percentage or free shipping), the minimum order subtotal (condition “Total (subtotal)” with “equal or greater”), the end date and, on the last day, a live countdown. Copy puts the code on the clipboard. The three soonest-ending coupons are shown; no coupons, no tickets.
• Flash sale: the strip under the coupon wall shows the products of its block (Website → Themes → Layouts → Homepage → Flash sale); its clock counts down to the earliest end date of their catalog promotions. The Flash sale link in the menu bar shows a mini clock to the earliest end of any active catalog promotion. Without an end date there is no clock: Agora never shows invented timers.
• Free shipping chips come from the product’s Free shipping setting. “N sold” appears only when the Bestsellers add-on has sales data.

Homepage blocks (Website → Themes → Layouts → Homepage)

Block	Template	What to set
Agora coupon wall slider	static HTML	Three campaign slides: headline, text, button and “from” price
Coupon tickets	Coupon tickets (Agora theme)	Nothing: built from your coupon promotions
Flash sale	Flash sale strip with clock (Agora theme)	The products of your flash promotion
Shop by category	Category circles (Agora theme)	Category list (the category image is the circle)
Today’s best deals	Offer cards section, style Deals	Products on sale; the title shows the earliest promotion end
Top picks heading + Electronics / Home / Fashion / Beauty	Offer cards section, user class kv-tabs	One block per tab
Stores you’ll like	Store cards (Agora theme)	Vendors to feature
New arrivals	Offer cards section, style Scrolling row	Newest products
Seller tiers and selling, trust row, SEO text	static HTML	Your texts

Menu bar and header

• All categories is a categories block (template “All categories drawer”) before the main menu; it lists the top-level categories with their image and subcategories. The standard main menu stays for the standard look only.
• The campaign row and trending searches are static HTML blocks: edit the links in the Block Manager.
• The header search is the kit’s department search (categories block “Search with departments”).