Remote Apps UI Reference¶
Remote Apps use Liferay’s front-end infrastructure to register external JavaScript applications and render them as Page widgets. To access Remote Apps, open the Global Menu (), click the Applications tab, and go to Remote Apps.
To add a remote app, click the Add button ().
When creating or editing a remote app, the following fields are available depending on the selected remote app type (i.e., IFrame or Custom Element).
Field |
Description |
---|---|
Name |
The display name used for the remote app entry and its widget. |
Description |
A description for the remote app entry. |
Source Code URL |
A URL to the external application’s source code for convenience. |
Type |
Currently, Liferay supports two types: IFrame and Custom Element. These types determine the contract between the Liferay platform and the external application. |
URL (IFrame) |
A URL to where the external application is hosted. The entry’s widget renders the application in an |
HTML Element Name (Custom Element) |
The name for the custom element that’s declared in its |
Use ES Modules (Custom Element) |
Determine whether the browser sees the application’s JS injection as an ES module. When enabled, Liferay uses |
URL (Custom Element) |
Enter individual URLs for each of the application’s |
CSS URL (Custom Element) |
Enter individual URLs for each of the application’s |
Instanceable |
Determine whether the remote app’s widget is instanceable. When enabled, multiple instances of a widget can be added to the same Page. |
Portlet Category Name |
Enter the widget’s category in the Widget menu. The default value is Remote Apps. |
Friendly URL Mapping |
Define the widget’s Friendly URL Mapping, so you can refer to it using a more user readable URL. |
Properties |
Define default properties that are included in all instances of the app’s widget. These properties are passed to the application by the widget as additional URL attributes so they be accessed programmatically. If desired, you can configure individual widget instances to override these entry properties. |