Jelly Theme Documentation

Installationtop

1. Uploading

  1. Download the add-on
  2. Go to Admin panel > Add-ons > Manage Add-ons
  3. Click on [+] to open upload modal window
  4. Please choose whatever is comfortable to you:
    Local: zip archive is saved on your computer
    Server: zip archive is uploaded on your server
    URL: you have a direct link to the zip archive
  5. After you selected the zip archive corresponding to your current version of CS-Cart please click Upload & install

2. License Activation

  1. Open add-on settings page Admin panel > Add-ons > Manage Add-ons >
    [TH] Jelly Theme Settings
  2. In Activation tab insert License key
  3. Save the settings and go back to Manage Add-ons page
  4. In same line with the name of the add-on, click Active
  5. Clear cache, choose Administration > Storage > Clear cache

3. Theme Activation

  1. Go to Admin panel > Design > Themes
  2. Click on tab Browse all available themes
  3. Hover “Jelly theme” and press Install button
  4. Then you can activate the theme in the Installed theme tab

That’s all, the theme is installed

The demonstration banners will be installed automatically

Thin Theme & Emerald Theme

If you are using Thin Theme and/or Emerald Theme themes, you need to comment or remove

ADD `section_class` varchar(255) NOT NULL default '',
ADD `section_width` varchar(1) NOT NULL default 'S',

in app/addons/ath_jelly_theme_settings/addon.xml file before installing


Change colorstop

  1. Go to Design > Themes
  2. Press Visual Editor in front of the currently active layout
  3. In the new tab, you will see your shop with Theme editor panel
  4. In CUSTOMIZE selector choose Colors
  5. After editing save your changes by pressing Save and press [X] to close editor

Change stylestop

Style files add-on should not be changed, this can lead to incorrect work of the add-on. If there was a need to redefine or add styles, please use Theme editor for this

  1. Go to Design > Themes
  2. Press Visual Editor in front of the currently active layout
  3. In the new tab, you will see your shop with Theme editor panel
  4. In CUSTOMIZE selector choose Custom CSS
  5. In textarea your can add your styles
  6. After editing save your changes by pressing Save and press [X] to close editor

Full-width sectiontop

You can easily make the section to full width

In grid settings added User-defined CSS class for section and Full width

For their appearance it is necessary to fulfill two conditions

  1. The grid has no parent
  2. Width – 16

Theme Update top

Starting from version 1.13, updates are installed through the Upgrade center

Administration > Upgrade center

To upgrade to 1.13, follow these steps:

  • make a full backup of the store
  • close the store
  • install the theme add-on over the old version without removing the previous one
  • clear the cache
  • if necessary, make changes that can be erased during the upgrade if you changed the theme files directly
  • check that everything is successfully updated
  • open the store

To update language variables and add-on settings:

  • Go to developer mode
  • For this file local_conf.php add define(‘DEVELOPMENT’, true);
    If you do not have a file, create one.
  • Clear the cache
  • On the add-ons page in the drop – down list next to the add-on “[TH] Jelly Theme Settings” select “Update”
  • Return to normal store mode
A subscription is required to access to product latest version and for technical support.

You can update alone or contact with us via support@themehills.com

Update layout to CS-Cart 4.10.1

Checkout_layout_for_4.10.1.zip – this is a Checkout layout, to install it follow these steps

  1. Go to Design > Layouts > Gear next to the plus > Import layout
  2. In the opened window select Update current layout > Override locations by dispatch
  3. Upload the unzip file

Theme update for CS-Cart 4.11.3

After the standard theme update process, you must change the color scheme
In the file design/themes/thin_theme/styles/data/<Your_color_scheme>.less
Add less variables:

//checkout
@checkout_selected_control_border: #4fbe31;
@checkout_control_border: #acbdcd;
@checkout_input_border: #acbdcd;
@checkout_selected_input_border: #4fbe31;
@checkout_step_title: #2e3a47;
@checkout_input_text: #2e3a47;
@checkout_input_label: #a1a6aa;
@checkout_control_background: #fff;
@checkout_selected_control_background: #fff;
@checkout_control_title: #4fbe31;
@checkout_control_description: #6c6c6c;
@checkout_control_label: #2e3a47;
@checkout_terms_background: #f9f9f9;


FAQ (Frequently asked questions)top

  • How do I change the default vendor logo?

    Change the file design/themes/jelly_theme/media/images/logo.png to yours own and clear the cache.


Changelog

3.00 (August 27, 2026)
Compatible with CS-Cart 4.21

Storefront

The theme now comes with the [TH] Fast Blocks add-on, and the shipped layouts are ready for it
Blocks the visitor never reaches on his device are not built at all: the home page got about 30% lighter
Product lists and category tiles pick the picture size for the screen: sharp on retina, no oversized downloads
Pictures below the first screen load only when the visitor gets to them
The first slide of the home banner loads at once and can ask the browser for priority, by a block setting
The banner no longer jumps into place when the slider script starts
The carousel library and the image zoom load only on the pages that use them: the cart and the checkout are about 60 KB lighter
Pages start loading while the visitor hovers the link, off by a setting
Theme colours are CSS variables now: restyle the shop without recompiling the theme
Both product grids follow one rule: the number of columns is decided by the width of a card, and your setting is the maximum
The mobile filters panel is driven by one controller: Escape closes it, the close icon follows the cursor over the dimmed area, and the keyboard is not left behind the panel
The filters button stands under the subcategories, right above the list of products, and follows the screen while scrolling, stopping under the header
The demo banners are created on install with fresh ids and their pictures travel inside the add-on: nothing in your store is overwritten any more

Accessibility

The home page has a first level heading again
The controls drawn with an icon only have a name now: the menu toggles, the account link, the buttons of a product tile, the language and currency switchers and the view switcher of a listing
The link around the shop logo keeps a name even when the logo has no alternative text
Fixed the picture description: the shop logo on a product page used to be announced as that product

Languages

The theme is translated into all 30 languages of the package, the admin panel included

Under the hood

PHP 8.2 and 8.3 compatibility
The license system has been updated
The storefront no longer depends on the add-on of the theme being switched on
The Upgrade Center downloads the package by itself and tells you the reason when a download cannot finish
Fixed the quick view: the picture took most of the popup and pushed the price, the options and the button off the first screen
Fixed the tabs of a product page: a tab with no content left an empty box under the product
Fixed an invalid font preload tag in the page head
Fixed the Lazy Load setting of the brands block: it was ignored and the loader was always on
Fixed the filters panel ignoring a tap after the filters had been changed a few times
The header subscribes to scrolling once: after a few window resizes every scroll used to be answered by as many handlers as there had been resizes

2.00 (10 Nov 2025)
Product grid rebuilt using CSS Grid
Removed isotope.js library and optimized JavaScript
Improved theme loading speed
Fixed minor style issues

1.26 (15 Sep 2025)
Added support for Product Video add-on
Added support for Mega Wiahlist add-on

1.25 (30 Jun 2025)
- Added support for the Tabbed Blocks Free add-on (eCom Labs)
- Updated label display and fixed related bug
- Updated hooks (removed deprecated ones and switched to new ones)

1.24 (13 Oct 2024)
Fixed compatibility with the Mega Wishlist add-on  
Fixes in PHP scripts

1.23 (31 Jul 2024)
- Fix in styles
- Improved update center
- Script fixes

1.22 (25 Jul 2023)
Fonts are hosted locally
Fix for layout editing mode

1.21 (10 Jan 2023)
Added the login button for the multivendor to the drop-down list
Fixes in styles for drop-down lists (bug in cs-cart 4.15.2)

1.20 (14 Jul 2022)
Fix in the license system
If you have www in your domain, and you don't see the new version in the update center, then install the new theme add-on on top of the old one (in a dangerous way - without erasing data in the database)

1.19 (04 Jul 2022)
The "Price per unit" add-on has been adapted
Updates in the license system (www ignored)
Fix in styles

1.18 (21 Jan 2022)
Fixes for the Zoom Image add-on
Fixed scrolling on the detail page
Changes in the image template

1.17 (05 Jan 2022)
Updated scripts 

1.16 (01 Nov 2021)
Fixed image viewers on the detail page
Fixed a bug when installing on 4.13.3
Fixed PHP error when calling the fn_get_discussion function when the feedback add-on is turned off

1.15 (23 Mar 2021)
Fixed a bug that occurs when the Comments & reviews add-on is disabled

1.14 (03 Mar 2021)
Fixed compatibility with Call requests add-on
Added captions to icons
Added the ability to enable / disable the image stub on the detailed product page
Fixes to styles

1.13 (22 Feb 2021)
Integrated the update system through the Upgrade center

1.12 (18 Dec 2020)
Updated the add-on for compatibility with CS-Cart 4.12.1
You need to reinstall the add-on for CS-Cart Multivendor Ultimate

1.11 (24 Jun 2020)
Fixes in styles
Added a hook to fix the shopping cart icon when the "Direct Customer-to-Vendor Payments" add-on is enabled

1.10 (25 Mar 2020)
RTL fixes: quick view and arrows
design/themes/jelly_theme/css/rtl.less

1.09 (18 Mar 2020)
--!Before updating, let us know if you have Multi-Vendor Ultimate!--
Updated the license system
Added language variables
Fix for Image zoom add-on
design/themes/jelly_theme/css/product_pages.less

1.08 (06 Feb 2020)
Added compatibility with CS-Cart 4.11.3
Modified files design/themes/thin_theme/styles/schema.json
and LESS files in the folder design/themes/thin_theme/styles/data

add fix for "Simtech Development: YouTube Video Gallery" add-on
design/themes/jelly_theme/templates/addons/sd_youtube/overrides/common/image.tpl

add fix for phone block
design/themes/jelly_theme/templates/blocks/static_templates/phone_dropdown.tpl

1.07 (28 Jul 2019)
Updated search layout
Updated checkout layout

1.06 (05 Jul 2019)
Fixed a bug of the "Image zoom" add-on

1.05 (27 Jun 2019)
Fixed product detail page

1.04 (03 Jun 2019)
Fixed checkout page for 4.10.1
Fixed product details page
Updated layouts

1.03 (22 May 2019)
Fixed display of SVG for Firefox
Fixed error when no add-on "Call requests "

1.02 (14 May 2019)
RTL support
Russification of layout
Added styles to support CS-Cart 4.10

1.01 (09 May 2019)
Changed license system
Changed the priority of the add-on

1.0 (07 May 2019)
Product release