Customization

Learn how to customize your Komento to make it more unique. Get your creative juice flowing!

Theme Overriding

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:

  1. Template override.
  2. Component override.
  3. 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):

  1. Template override
  2. Component override
  3. Selected Komento theme
  4. 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:

Joomla/components/com_komento/themes/kuro/

Template Overrides

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: Joomla/templates/<template_name>/html/com_komento/

For example, you would like to have a different structure for the comment item, copy the original file from /components/com_komento/themes/kuro/comment/item.php to /templates/<template_name>/html/com_komento/comment/item.php and Komento will load this file instead.

Component override

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: /components/<component_name>/komento

The path can be redefined by the component integration file's method: getComponentThemePath.

Komento theme

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.