Most of the described behavior was first introduced in version 4.4.1.
If theme X has theme Y specified in the
parent_theme field of the manifest.json file, then we say that theme X is the dependent theme (otherwise called child theme), and theme Y is the parent theme.
The dependent theme contains only the files that differ from the files of the parent theme. Dependent themes use the content (templates, logos, etc.) of the parent theme, when necessary.
$images_dirin Smarty templates will point to the media/images directory of the parent theme.
$images_dirwill point to the theme’s own media/images directory.
You can use the
$self_images_dir variable in Smarty templates to point to the theme’s own media/images directory.
If the source theme has no parent, its files won’t be copied to the clone theme’s directory.
The clone theme will contain only the manifest.json file and the /media/images/ directory with theme logos. The name of the source theme will be specified as
parent_theme in the manifest.json file of the clone theme.
If the source theme has a parent, the whole content of source theme will be copied to the directory of the clone theme.
Files of the parent theme won’t be merged with the files of the dependent theme during the installation of the dependent theme. Only the files of the dependent theme will be copied from var/themes_repository to design/themes.
The Upgrade Center doesn’t upgrade the files of custom themes. Only the Responsive and Basic themes will be affected when upgrading a store.
Theme-related files (such as styles, templates, etc.) from add-ons are installed only for the theme they are created for, and not for themes that depend on it.
For example, the content of var/themes_repository/responsive/templates/addons/[addon] will be copied only to design/themes/responsive/templates/addons/[addon].
Add-ons that provide template files only for the Basic theme will be usable only in the Basic theme and the themes that depend on it. CS-Cart will not fall back to the templates of the Basic theme when the required templates are missing in the current theme.