Using Information Templates

Available 7.4+

With Information Templates, you can create FreeMarker templates for any item type that implements the Info Framework. Supported item types include web contents, documents, assets, blogs, categories, and objects. Once created, you can map fragment fields to your template to determine how an item is rendered in content and display Pages. This can help you implement a consistent style for your site.

Important

Information templates are only available in fragments and are not available in widgets. If you want to design FreeMarker templates for web content that’s displayed in widgets, use web content templates.

Creating Information Templates

  1. Open the Site Menu (Site Menu), expand Design, and go to TemplatesInformation Templates.

  2. Click New, enter a name, select an Item Type, and (if applicable) select an Item Subtype.

    Enter a name and select an Item Type and Item Subtype.

  3. Click Save. This redirects you to the template design page.

  4. (Optional) Import an existing FreeMarker script from an .ftl file.

  5. Design your template using FreeMarker.

    You can type ${ in the editor to use the autocomplete feature.

    In the Elements side panel (Elements), you can quickly access available fields from the selected item type’s structure.

    Design your template using FreeMarker and available fields in the Elements side panel.

    Note

    The Elements side panel does not include fields based on templates (e.g., Journal Article templates, Info templates). This is to prevent infinite loops.

  6. (Optional) Add a description or image to the template in the Properties side panel (Properties).

  7. Click Save when finished.

Once created, Info templates can be used in Content Display fragments and any other fragment with sub-elements that can be mapped, such as text and rich text. When selected, they determine how an item is rendered in content pages and display page templates.

Liferay’s Headless API services are available in the template editor through the restClient object. See Calling Headless APIs in the Template Editor for usage details.

Importing and Exporting Scripts

When editing an Info template, you can import and export FreeMarker scripts to reuse in other contexts:

  1. Open the Site Menu (Site Menu), expand Design, and go to TemplatesInformation Templates.

  2. Select the desired Info Template.

  3. Click Actions Actions Button in the Application Bar and select Export Script or Import Script.

    Use the Export/Import Script actions to export/import an Info template.

When exporting, the current FreeMarker script is saved as a script.ftl file.

When importing, the selected file replaces the template’s current FreeMarker script.

Managing Info Templates

In the Templates application, you can view and manage all existing Info templates. Each existing template appears with its type (e.g., Web Content Article) and sub-type (e.g., Basic Web Content). You can click Actions (Actions Button) for a template to access the following actions:

ActionDescription
EditEdit the template.
CopyCreate a new template with the selected template’s content.
PermissionsManage basic permissions for the template.
DeleteDelete the template.

Use the actions menu to access management options.

Here you can also export and import Info templates as LAR files to share them between sites and environments. To do this, click Actions in the Application Bar and select Export/Import.

Export and Import templates as LAR files.

Note

By default, Info template exports include Widget templates. However, you can configure which templates are included in the LAR file.

Capabilities

Product

Contact Us

Connect

Powered by Liferay
© 2024 Liferay Inc. All Rights Reserved • Privacy Policy