Developer notes
| Item | Value |
|---|---|
| Add-on id | kv_theme_reel (CS-Cart and Multi-Vendor) |
| Theme | kv_reel (child of responsive), installed from var/themes_repository/kv_reel |
| Built with | Kavio theme kit 1.2.2 (kv-files.json in the theme lists every file with its hash and the kit version); kit modules stories, rail and dock (drawer mode); kit banner meta |
| CSS prefix | re- (theme), kv- (kit) |
design/themes/kv_reel/css/kit/{fonts,base,features,addons,modules}.less(kit layer),css/skin/skin.less(Reel),styles/data/{Papaya,Ink,Seafoam,Velvet}.less(styles).- Block templates:
addons/banners/blocks/kv_re_reels.tpl(shoppable reels),blocks/products/kv_re_tiles.tpl(portrait tiles),kv_re_feed.tpl(product reels),kv_re_routine.tpl(routine builder),addons/blog/blocks/kv_re_journal.tpl(journal covers),blocks/static_templates/kv_re_cathead.tpl(category header with story circles),kv_re_howto.tpl(how-to step reels + rating summary),kv_re_profile.tpl(creator profile, Multi-Vendor); product list viewsblocks/product_list_templates/kv_re_tiles.tpl(Grid) andkv_re_feed.tpl(Feed); kit templates (kv_stories,kv_mega,kv_icons,kv_dock,kv_gate). - Partials
templates/addons/kv_theme_reel/partials/:kv_re_sticker.tpl(reel sticker + action stack),kv_re_list.tpl(tiles / product reels list). - Hook files
templates/addons/kv_theme_reel/hooks/:index/html_tag.pre(data-repage flags),index/scripts.pre(texts and URLs for theme.js),products/main_info_title.pre(category line),products/main_price.post(unit price, saving, deal countdown),products/product_detail_bottom.pre(facts). js/addons/kv_theme_reel/theme.js: floating phone bar items, quick shop sheet, Bag label and drawer opener, reel Add/Share, sticker price label, sticker reveal, remembered hearts (localStorage), highlighted words in stock block titles, comment initials, list view labels; kit components (buy bar, option chips, filter sheet, swipe gallery).
| Hook | Use |
|---|---|
before_dispatch (storefront) |
kit: assigns $kv_theme while the add-on is enabled, the storefront runs kv_reel and the licence is active |
gather_additional_products_data_post |
kv_re on every product: size, unit price, routine step, rating and review count (Product reviews prepared data), new flag |
dispatch_before_display |
$re: category header (name, subtree count, lead, subcategories with images and counts), product page (how-to steps, rating histogram, recommend share, category line), vendor profile (Multi-Vendor), free delivery threshold |
| Kit product data / banner meta | kv_promo_end, kv_seller on product lists; $banner.kv_meta (eyebrow, HUD, lead, paired product, promotion end) on banners |
Every storefront handler returns at once unless the storefront runs the licensed theme. Full page cache (4.21): the
theme prints nothing visitor-specific; bag and wish list counts come from the core blocks; “seen” story circles and
saved hearts live in the visitor’s browser; countdowns are data-kv-end timestamps ticked in the browser.
Customising
Section titled “Customising”Use a child theme or the Theme editor’s custom CSS. Design tokens are LESS variables set by each style file:
@re_w1a … @re_w6b (the six gradient frames, cycled by position), @re_t1 … @re_t6 (routine step tints),
@re_hi / @re_hi_ink (highlight), @re_hi_line (true = underline highlight, Ink), @re_sale, @re_star, @re_bar
(phone bar), @re_foot* (footer panel), @re_tot* (routine total card), @re_r / @re_rs (frame radii), @re_blend
(blend mode of product images on the frames), plus the kit tokens @kv_*.