bloggers bloggers

L'installazione standard di Liferay mette a disposizione nel template la visualizzazione della breadcrumb (vedi immagine), con l'interessante funzionalità di essere sempre visualizzata anche in caso di scrolling verticale del contenuto.

Le API di Liferay consentono di poter interagire con essa, aggiungendo voci custom direttamente via codice.

Come prima è necessario inserire una nuova direttiva nel file liferay-portlet.xml all'interno del blocco della propria portlet:

<private-request-attributes>false</private-request-attributes>

Dopodichè è sufficiente utilizzare il seguente metodo per aggiungere una voce alla breadcrumb:

PortalUtil.addPortletBreadcrumbEntry(HttpServletRequest request, String title, String url);

I parametri hanno il seguente significato:

• request, request di Liferay
• title, testo da visualizzare nella breadcrumb
• url, URL associato al titolo visualizzato (di solito è la URLcorrente)

Vediamo un esempio di utilizzo.

// creazione della URL "corrente" da associare al testo visualizzato

HttpServletRequest request = (HttpServletRequest) renderRequest

.getAttribute(PortletServlet.PORTLET_SERVLET_REQUEST);

PortletURL portletURL = renderResponse.createRenderURL();

portletURL.setParameter("parm1", "qualcosa");

portletURL.setParameter("parm2", "qualcosaltro");


// ... eventuali altri parametri da aggiungere alla URL


PortalUtil.addPortletBreadcrumbEntry(request, "miaVoce", portletURL.toString());

Enjoy!