liferay-freemarker

Access web content fields in Liferay FreeMarker templates by applying null-safety checks before rendering structure fields, images, repeaters, and nested fields. This prevents runtime errors when expected data is missing or unset in your web content structures.

saxReaderUtil parses article XML directly within Application Display Templates to extract and render specific content elements from Asset Publisher and custom lists. It enables contextual link generation and precise asset rendering in server-rendered views.

serviceLocator and themeDisplay are accessible in Liferay widget templates and fragments to retrieve portal URLs, layout details, and lightweight services. Use them safely to support reusable presentation logic without embedding heavy business logic.

Prevent XSS vulnerabilities in Liferay FreeMarker templates by applying htmlUtil.escape to all user-generated data and web content fields before output. Ensure templates remain presentation-only, avoiding manual caching and direct database calls.

Liferay FreeMarker templates fail when rendering nested structure fields if null-safety checks are missing. Validate the existence of nested fields, repeaters, and images before accessing them to avoid unexpected template processing interruptions.

FreeMarker macros are recommended for Liferay web content templates and fragments to encapsulate reusable presentation logic. They help maintain clean, presentation-only templates while handling themeDisplay, layout URLs, and safe HTML escaping consistently.