Komento allows you to create custom theme overrides in your Joomla template. This is ideal when you need to customize the theme files but do not want the updates to override your existing changes.
IMPORTANT! This feature is only available for Komento 1.5.2771+.
NOTE: In major version updates, you need to ensure that your customized file is up to date.
There are 3 methods of theme overriding in Komento:
- Template override.
- Component override.
- Komento new theme.
Theme override order
In Komento, when a theme is loaded, it is following the order of (with 1 being the highest priority):
- Template override
- Component override
- Selected Komento theme
- Komento's base theme - Kuro
Komento will always use Kuro as the base theme and as the fallback theme to load. Template designers should use Kuro theme (and the files in the Kuro folder) as reference to build new theme.
Take note that not all files are required to be created in your new theme. Files that are created will be overriden while files that are not will fallback according to the ordering.
Default Base Theme
The default base theme (
Kuro theme) path located in the following folder:
Template overrides refers to your current Joomla template. Some template comes with premade Komento theme to match the layout of the template.
You can utilise this method to override some specific layout of Komento. This method will override the theme across all Komento's supported component. The path is typically located at:
For example, you would like to have a different structure for the comment item, copy the original file from
/templates/<template_name>/html/com_komento/comment/item.php and Komento will load this file instead.
If you are writing your own component integration file as outlined Creating your own integration files, then you can utilise this method to override certain aspects in Komento to better suit your component.
This method will only override Komento's theme when user is on your component's page. By default the path is defined as:
The path can be redefined by the component integration file's method: getComponentThemePath.
You can create a new theme by just creating a folder in
/components/com_komento/themes. Upon creating a new folder, Komento will listed it as an available theme in the configuration page at
Komento > Integrations > (Select Component) > Layout > General Layout > Theme.