Legacy Knowledge Base
Published Sep. 10, 2025

Customising soy files in ext plugins

Written By

Kanchan Bisht

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Issue

1) Create Ext-plugin by adding ext-files (SelectCategory.es.js and SelectCategory.soy).
2) Deploy through Gradle "deploy" Or place the jar to osgi/marketplace/override folder.
3) Deployed path should be: {Liferay-Home}osgi/marketplace/override.
4) Delete temp folders and osgi/state folder.
5) Restart the server.
6) Create Topic > Categories > Sub Categories (create before deploying the ext-plugins).
7) Create basic web content and try to add categories
8) Not able to add categories and would get browser console errors.Screenshot-2-extplugin.png

Environment

  • Liferay 7.2 with DXP-7

Resolution

  • The reason behind those errors is that the compiled SelectCategory.soy.js file is not wrapped into Liferay.Loader.define() as it is the one compiled within the portal.

  • The reason might be: Couldn't use liferay-npm-scripts to build anything outside liferay-portal because it is not intended to be used outside that build. It doesn't mean it wouldn't work, but it is not a supported scenario yet.

  • There is no proof that this ext plugin could build and work correctly at some point.

  • Issue marked as a sort of "Won't fix" since it is far beyond what Liferay support.

  • As of now, no documentation for overriding soy templates.

Additional Information

  • Liferay Support will not be able to assist with designing or implementing customizations with respects to the ext-plugins.
  • Deployment of Ext-plugin module

 

 

 

Did this article resolve your issue ?

Legacy Knowledge Base