Displaying Object Entries

Liferay 7.4+

You can display object entries dynamically with Liferay’s page building features. For example, collection displays can show a list of entries while display pages can provide the entry detail view. When combined with the form container, display pages can also serve as the edit screen for object entries.

You can use collections and display page templates for object displays.

Collections, display pages and form containers offer the most flexibility and are recommended. However, other display methods are available:

Object Entry Display FeatureDescriptionObject Entry View
CollectionsYou can create dynamic collections, manual collections, or automatic collections with the collection provider* generated for every object, and display them in the Collection Display fragment or on a Collection Page. This is the preferred method for displaying published object entries on pages.List view
Display Page TemplatesYou can create a flexible page to display an object entry or its edit form using all the best page creation tools.Detail view
Edit screen
Form Containers/
Form Fragments
You can use form container fragments on any content or display page to display an object’s add or edit form.Creation screen
Edit screen
Data Sets BetaDisplay any data returned from a REST application registered in Liferay.List view
Detail view
Creation screen
Edit screen
Object WidgetYou automatically get a widget for your object entries, including a default table view and edit screen. The widget is full-featured but offers limited flexibility, relying on object layouts and views to customize its displays.List view
Detail view
Creation screen
Edit screen
Object LayoutsYou can use layouts to provide a customized detail view for the object’s widget.Detail view
Object ViewsYou can use views to customize the creation and edit form for the object’s widget.Creation screen
Edit screen
Information TemplatesYou can create FreeMarker templates to control how object entries appear in the Content Display fragment and fragments with sub-elements.Detail view
Navigation MenusAdd object entries to navigation menus.List view

* DXP users can also use a Search Blueprints Collection Provider Beta with objects. This is especially useful for displaying instance-scoped objects in a site, where manual and dynamic collections are not available.

Note

Information Templates can be used in Content Display fragments and any other fragment with sub-elements (e.g., text, rich text) that can be mapped to objects.

Together, these integrations enable users to leverage Liferay’s WYSIWYG page building capabilities while delivering personalized user experiences.

Creating Display Page Templates for Objects

When created, each object entry is assigned automatically a dedicated friendly URL that uses the following pattern: server-address/l/objectEntryId (e.g., https://mysite.com/l/44337). To view an entry at its URL, you must first create a Display Page Template for the object.

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

  2. Click the Display Page Templates tab.

  3. Click the Add button (Add Button) and select the Blank template.

    This opens a modal window.

  4. Enter a name and select the desired Object for Content Type.

    Enter a name and select the desired object for Content Type

  5. Click Save.

    This creates a blank template with the selected object as its default mapping source and redirects you to the template editing page.

  6. Use page fragments and widgets to create flexible, dynamic displays for object entries. See Using Display Page Templates for information.

    Map fragment elements to object fields to dynamically populate Display Pages for individual entries.

  7. Add the Page Comments widget so end users can comment on entry display pages.

    Note

    You must enable comments for the object definition. Otherwise, the widget is hidden in the display page.

  8. When finished, click Publish.

  9. Click the Actions button (Actions Button) for your template and select Mark as Default.

    This template is now used to render the object’s entries whenever users visit their friendly URLs.

    Click the Actions button for the template and select Mark as Default.

Enabling Comments

  1. Open the Global Menu (Global Menu), go to the Control Panel tab, and click Objects.

  2. Edit an object definition.

  3. In the Details tab, enable comments and click Save.

    Enable comments.

Creating Information Templates for Objects

With information templates, you can use FreeMarker to template objects.

  1. Open the Site Menu (Site Menu) and go to DesignTemplatesInformation Templates.

  2. Click Add (Add Button)

  3. Enter a name and select the desired Object.

    Enter a name and select the desired object.

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

  5. (Optional) Click Actions (Actions Button) in the Application Bar, select Import Script, and choose an .ftl file to import. This replaces the current template with the file’s FreeMarker script.

    Import script from an .ftl file.

  6. Use FreeMarker to design your template.

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

    Select from available fields in the object's structure.

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

    Add a description or image in the Properties panel.

  8. Click Save when finished.

You can now select from the template when mapping object entries to fragment fields.

Select the template when mapping fragment elements.

Adding Entries to Navigation Menus

Since objects are integrated with the info framework, you can add object entries to navigation menus to provide quick access. All published objects automatically appear as available sources for menu elements. See Using the Navigation Menus Application for more information.

Capabilities

Product

Contact Us

Connect

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