#926 Joomla template overrides are ignored when J2Commerce subtemplate plugins are active

Posted in ‘Technical Support / Bugs’
This is a public ticket

Everybody will be able to see its contents. Do not include usernames, passwords or any other sensitive information.

J2Commerce

Version
J2Commerce v6

Latest post by Adam Melcher on Thursday, 06 August 2026 00:03 UTC

Krzysztof Kuznowicz

Description:

Standard Joomla template overrides created under the active site template do not affect J2Commerce product list output when a J2Commerce subtemplate plugin such as is selected.app_uikit

The component provides template and layout override structures, suggesting that files can be overridden from the Joomla site template. In practice, the active subtemplate plugin intercepts J2Commerce rendering events and loads files from its own and directories.tmpllayouts

As a result, changes made in the expected Joomla override locations are ignored.

The only reliable solution was to clone the plugin, create a separate subtemplate plugin and modify the files inside that plugin.app_uikitapp_template

Expected result:

Overrides placed in the active Joomla template should take precedence over files provided by a J2Commerce subtemplate plugin, or the documentation and interface should clearly explain that plugin-based subtemplates bypass standard component overrides.

Actual result:

The plugin-generated output takes precedence, and ordinary Joomla template overrides have no visible effect.

This makes maintaining a custom storefront difficult because:

  • core or plugin files should not be edited directly;
  • standard Joomla overrides appear to be supported but are ignored;
  • creating a complete duplicate subtemplate plugin becomes necessary;
  • fixes must be duplicated for initial rendering and AJAX rendering events.

Please clarify the intended override hierarchy and provide a supported override path for plugin-based subtemplates such as .app_uikit

Adam Melcher

Krzysztof,

 

Thanks for the detailed feedback. Plugins do create the initial subtemplate override however instead of creating new plugins (which is not realistic for most users), you can simply use one of the override options for the subtemplates without needing to modify the plugins at all:
https://docs.j2commerce.com/v6/design/template-overrides

 

Adam

Growing Together

Help us get back to #1 in the Joomla Extension Directory by leaving us a 5-Star review here.

Krzysztof Kuznowicz

I followed the documentation and placed my modifications in:

  • templates/[template]/html/layouts/com_j2commerce
  • templates/[template]/html/com_j2commerce/templates

The changes were saved correctly, but none of them had any actual effect on the storefront while the UIkit subtemplate plugin was active.

I am also concerned about the override builder in the administrator panel. Custom work created there appears too easy to remove accidentally, which creates a real risk of losing extensive template modifications.

For these reasons, I created and installed my own independent J2Commerce plugin containing my custom subtemplate. It works correctly and cannot be accidentally deleted through the override builder or overwritten by future J2Commerce updates.

I have been working with VirtueMart for more than a decade and have been looking for a worthy successor. After analysing the J2Commerce codebase in detail, I have to say that I am genuinely impressed with the quality and architecture of the component.

I believe that during this month I will be able to migrate my entire store to your excellent component. I only need to develop modules for Polish parcel locker shipping and a few other integrations that I am currently missing. That should not be too difficult — I will manage. :)

Adam Melcher

Krzysztof,

Thank you for the kind words! We have put a lot of work into building something that can compete against the other major ecommerce platforms (outside of Joomla). We feel that this can help bring back previous users and is already attracting new users to Joomla.

The red parts of the overrides folders are probably the missing parts needed for creating easier overrides in the future.

  • templates/[template]/html/layouts/com_j2commerce/app_bootstrap/list/category
  • templates/[template]/html/layouts/com_j2commerce/app_bootstrap/list/tag
  • templates/[template]/html/layouts/com_j2commerce/app_uikit/list/category
  • templates/[template]/html/layouts/com_j2commerce/app_uikit/list/tag
  • templates/[template]/html/com_j2commerce/templates/uikit
  • templates/[template]/html/com_j2commerce/templates/bootstrap5
  • templates/[template]/html/com_j2commerce/templates/mycustomsubtemplate

As far as the Polish plugins, let me know which ones you are needing and if you have the sandbox credentials for them, I can help you build them out so other Polish Joomlers can also benefit. 

 

Adam

Growing Together

Help us get back to #1 in the Joomla Extension Directory by leaving us a 5-Star review here.

Stay Updated

Subscribe for free and be the first to know about the latest features, updates, and new additions.