Updating 6.2 Theme Templates
Step 1 of 3
Follow these steps to update portal_normal.ftl
:
-
Open
portal_normal.ftl
and replace the following 6.2 directives with the updated syntax. This change is described in the 7.0 Breaking Changes reference document:6.2 Updated ${theme.include(top_head_include)}
<@liferay_util["include"] page=top_head_include />
${theme.include(body_top_include)}
<@liferay_util["include"] page=body_top_include />
${theme.include(content_include)}
<@liferay_util["include"] page=content_include />
${theme.wrapPortlet("portlet.ftl", content_include)}
<@liferay_theme["wrap-portlet"] page="portlet.ftl"> <@liferay_util["include"] page=content_include /> </@>
${theme.include(body_bottom_include)}
<@liferay_util["include"] page=body_bottom_include />
${theme.include(bottom_include)}
<@liferay_util["include"] page=bottom_include />
${theme_settings["my-theme-setting"]}
${themeDisplay.getThemeSetting("my-theme-setting")}
${theme.runtime("56", "articleId=" + my_article_id)}
<@liferay_portlet["runtime"] portletName=
"com_liferay_journal_content_web_portlet_JournalContentPortlet"
queryString="articleId=" + my_article_id />
-
Remove the breadcrumbs and page title code:
<nav id="breadcrumbs"> <@liferay.breadcrumbs /> </nav> ... <h2 class="page-title"> <span>${the_title}</span> </h2>
-
Remove
dockbar-split
from thebody
element’sclass
value so it matches the markup below:<body class="${css_class}">
-
Find the
<a href="#main-content" id="skip-to-content"><@liferay.language key="skip-to-content" /></a>
element and replace it with the updated Liferay UI quick access macro shown below:<@liferay_ui["quick-access"] contentId="#main-content" />
-
Replace the
<@liferay.dockbar />
macro with the updated Control menu macro:<@liferay.control_menu />
-
Replace the
|| is_signed_in
condition for thenavigation.ftl
theme template include with&& is_setup_complete
:<#if has_navigation && is_setup_complete> <#include "${full_templates_path}/navigation.ftl" /> </#if>
-
Replace the
content
<div>
with an HTML 5section
element. Thesection
element is more accurate and provides better accessibility for screen readers:<section id="content">
-
Add the
<h1 class="hide-accessible">${the_title}</h1>
header element just inside thecontent
<section>
to support accessibility, and remove the breadcrumbs<nav>
element from inside it.
portal_normal.ftl
is updated! Next you can update the navigation template.