Developer notes
| Item | Value |
|---|---|
| Add-on id | kv_theme_dock (CS-Cart and Multi-Vendor) |
| Theme | kv_dock (child of responsive), installed from var/themes_repository/kv_dock |
| 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 shell (sidebar), sidebar navigation, command search, docked cart, index rows |
| CSS prefix | dk- (theme), kv- (kit) |
design/themes/kv_dock/css/kit/{fonts,base,features,addons,modules}.less(kit layer),css/skin/skin.less(Dock),styles/data/{Graphite,Daylight,Midnight,Mint}.less(styles).- Block templates:
blocks/products/kv_dk_tiles.tpl(ruled tiles),kv_dk_mini.tpl(mini rows with timers),blocks/categories/kv_dk_launcher.tpl(department launcher),addons/blog/blocks/kv_dk_guides.tpl(buying guides),blocks/static_templates/kv_dk_quick.tpl(sidebar quick links and lists),kv_dk_tool.tpl(tool row live line),kv_dk_recent.tpl(recently viewed holder), and the kit templates (kv_command,kv_sidebar,kv_index,kv_dock,kv_gate). - Partials
templates/addons/kv_theme_dock/partials/:kv_dk_stock.tpl(stock line),kv_dk_off.tpl. - Hook files
templates/addons/kv_theme_dock/hooks/:index/html_tag.pre(data-dkpage flags),index/scripts.pre(texts and settings for theme.js),kv_index/price.post(promotion end for the tab strip timer),products/main_info_title.pre(code line),products/product_detail_bottom.pre(facts list),products/product_tabs.pre(key-spec strip). js/addons/kv_theme_dock/theme.js: recently viewed (localStorage), delivery line countdown, tab strip deal timer, compare tray; kit components (tab bar, buy bar, filter sheet, swipe gallery, steppers, variation buttons).
| Hook | Use |
|---|---|
before_dispatch (storefront) |
kit: assigns $kv_theme while the add-on is enabled, the storefront runs kv_dock and the licence is active |
dispatch_before_display |
$dk: catalogue counts (products, products on sale; cached for one hour per storefront), status bar and recently viewed switches, delivery cutoff and store timezone |
get_categories_post |
product counts per category subtree (sidebar departments, launcher) |
Kit product data (static Theme\Kit handlers) |
kv_chips, kv_promo_end, kv_seller on product lists |
kit controller kv_theme_dock_kit.suggest |
palette suggestions without Instant Live Search (GET, Cache-Control: private) |
Every storefront handler returns at once unless the storefront runs the licensed theme. Full page cache (4.21): the
theme prints nothing visitor-specific; cart, compare and wish list counts come from the core blocks; recently viewed
lives 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 (@kv_*, @dk_*) set by each
style file, e.g. @dk_side / @dk_side2 / @dk_side_text / @dk_side_muted (sidebar), @dk_bar / @dk_bar_text
(status bar and phone tab bar), @dk_ok / @dk_low / @dk_sale (stock and sale colours), @dk_promo1 /
@dk_promo2 (promo card), @dk_co* (checkout surface), @kv_img_well (image wells).