Developer notes
| Item | Value |
|---|---|
| Add-on id | kv_theme_atelier |
| Theme | kv_atelier (child of responsive), installed from var/themes_repository/kv_atelier |
| Built with | Kavio theme kit 1.x (kv-files.json in the theme lists every file with its hash and the kit version) |
| CSS prefix | at- (theme), kv- (kit) |
design/themes/kv_atelier/css/kit/{fonts,base,features,addons}.less(kit layer),css/skin/skin.less(Atelier),styles/data/{Bone,Noir,Sorbet,Sage}.less(styles: Theme editor variables +@kv_*and@at_*tokens).- Block templates:
blocks/products/kv_lookbook_grid.tpl(grid with a section lead),blocks/products/kv_look_list.tpl(shop the look),blocks/menu/kv_mega.tpl,blocks/wrappers/kv_gate.tpl. Without the licensed add-on they render the stock templates (products scroller, products grid in the simple wrapper, dropdown menu) or nothing. - Hook files in
templates/addons/kv_theme_atelier/hooks/:wrapper/mainbox_simple_title.override.tplandwrapper/mainbox_general_title.override.tpl(last word of a title in<em>; stock output otherwise),products/product_multicolumns_list.post.tpl(size chips from a “size” option or variation feature),index/footer.post.tpl(wordmark),index/html_tag.post.tplandindex/scripts.post.tpl(kit). - Scripts:
js/addons/kv_theme_atelier/kit.js(kit) andtheme.js(size chips and quick add, card action bar, wordmark fit, desktop gallery, phone buy bar and filter fold, size select chip grid, italic product name). Both load only while the design is on. - Add-on:
Tygh/Addons/KvThemeAtelier/Theme/Kit.php(install, licence gate, admin notice, upgrade refresh),License/(licence client),Upgrade/Synchronizer.php,schemas/block_manager/{block_cache_properties,templates}.post.php.
| Hook | Use |
|---|---|
before_dispatch (storefront) |
assigns $kv_theme (theme, settings, data-kvt tokens) while the add-on is enabled, the storefront runs kv_atelier and the licence is active |
dispatch_before_display (admin) |
notice while a storefront uses the theme and the design is off; status on Website → Themes |
update_addon_status_post |
warning when the add-on is disabled while a storefront uses the theme |
Templates index:html_tag, index:scripts, index:footer, wrapper:mainbox_*_title, products:product_multicolumns_list |
kit attributes and scripts, wordmark, italic titles, size chips |
| Block cache | callable_handlers.kv_theme_atelier = licence and settings state |
Full page cache (4.21): the theme prints nothing visitor-specific; cart and account data come from the core blocks, the quick add uses the card’s stock add-to-cart form.
Customising
Section titled “Customising”Use a child theme or the Theme editor’s custom CSS. Upgrades replace only theme files you have not changed. Design
tokens are LESS variables (@kv_*, @at_*) set by each style file; the hero illustrations read the CSS custom
properties --at-wall, --at-light, --at-floor, --at-plinth, --at-vase set from the style.