However, Liferay has a nice method of controlling the URL the portal generates for a portlet, the ‘FriendlyURLMapper‘. You can implement this interface, registerd it in the liferay-portlet.xml and you will have nice URLs. In the following example I will show how to implement it and what each individual method does.

I assume you have installed Liferay and the plugin SDK and that you know how to develop Liferay portlets.

The first step is to create a new class which will implement the ‘FriendlyURLMapper‘ interface. To make things easies we will derive that class from ‘BaseFriendlyURLMapper‘. You have to implement several methods yourself but don’t worry I will show you how.

The getMapping method

The ‘getMapping‘ method must return an identifier for the mapping. The mapping identifier is used by Liferay to map URLs to instances of the ‘FriendlyURLMapper‘. For example Liferay will resolve the following URL ‘/seoPortlet/123/view’ to a ‘FriendlyURLMapper‘ instance with mapping ‘seoPortlet‘. You can choose whatever mapping you want, just make sure your custom URLs always start with the mapping identifier.

To implement the ‘getMapping‘ method just return an unique identifier for the URL mapper.

public String getMapping() {
    return "seoPortlet";
}

The buildPath method

The ‘buildPath‘ method builds the actual URL. Here you implement the URL generation logic. You have access to the ‘LiferayPortletURL‘ object for which the URL is generated. You can extract the portletId, parameters, window state, etc. from it. The method should return a string containing the friendly URL for that particular portletURL, when the method returns null the default portletURL is used.

For each parameter (p_p_id for example) you move from the query string to the URL, you need to call ‘portletURL.addParameterIncludedInPath(“p_p_id”)‘. This will tell Liferay to not include the parameter in the query string. Parameters who are not marked as ‘included in path’ will be added to the query string automatically by Liferay.

Here is an example which maps URLs with a parameter named event to a friendly URL.

public String buildPath(final LiferayPortletURL portletURL) {
    String friendlyURLPath = null;

    // get the value
    final String portletId = portletURL.getPortletId();
    final String eventName = GetterUtil.getString(portletURL.getParameter("event"));

    if (Validator.isNotNull(portletId) && Validator.isNotNull(eventName)) {
        friendlyURLPath = StringPool.FORWARD_SLASH + "seoPortlet"+ StringPool.FORWARD_SLASH + portletId + StringPool.FORWARD_SLASH + eventName;
        portletURL.addParameterIncludedInPath("event");
    }

    // add other pararmeters
    if (Validator.isNotNull(friendlyURLPath)) {
        portletURL.addParameterIncludedInPath("p_p_id");
    }

    return friendlyURLPath;
}

Notice that we are including the mapping prefix ‘seoPortlet’ and that we are excluding the ‘p_p_id’ and ‘event’ parameters from the URL.

The getPortletId method

This method is used by the ‘BaseFriendlyURLMapper‘ super class to retrieve the portlet id. This will be used by ‘populateParams‘ method.

To implement the ‘getPortletId‘ method just return the value of a backing field with the name portletId. See example:

private String portletId;
public String getPortletId() {
    return portletId;
}

The populateParams method

This method will be called by Liferay each time a request is made with the mapping identifier in the URL. This method is responsible for mapping the parameters we removed from the query string and added to the path back to parameters: reversing the work we did in the ‘buildPath’ method.

Here is an example implementation.

public void populateParams(final String friendlyURLPath, final Map<String, String[]> params) {
    // get the values
    final String[] parts = StringUtil.split(friendlyURLPath, StringPool.SLASH);
    portletId = parts[2];
    final String event = parts[3];
    final String namespace = getNamespace();

    params.put("p_p_id", new String[]{portletId});
    params.put("p_p_state", new String[]{WindowState.NORMAL.toString()});
    params.put(namespace + "event", new String[]{event});
}

The method takes apart the ‘friendlyURLPath‘ and assembles parameters from it’s parts. Notice that in order to avoid parameter clashes between portlets the event parameter is prefixed with the portlet namespace, generated by the ‘BaseFriendlyURLMapper”s ‘getNamespace‘ method. The ‘getNamespace‘ method consumes the portletId using the ‘getPortletId‘ method.

liferay-portlet.xml

Now that the mapper is finished we need to tell Liferay to start using it. Add the friendly-url-mapper-class declaration to the portlet declaration and set its content to point to the class you just wrote:

<friendly-url-mapper-class>com.sample.FriendlyURLMapper</friendly-url-mapper-class>

That is it, know you can assemble your own FriendlyURLMapper now. I hope this article was useful to you. Please let me know if you have any questions or comments.

In this post I will show you how you can in use build in features of Liferay to optimize SEO, First we will discus what you can do on a portal level and then I will show you how you can optimize SEO directly from a portlet itself.

Liferay Page Search Engine Optimization

In this section I will discuss the features Liferay provides to optimize SEO on a page level. First of all log in as (community) administrator on your portal. Navigate to the page you want to optimize. Click on ‘manage pages’ in the dock. You will now see the following screen:

You can use HTML title to specify the title of the page, you can use this field to change the title of the page in the HTML to something much more elaborate, the title of the for example menu item will not change.

When you expand the ‘Meta Tags’ tab you can specify (localized!) values for description and keywords.

Although this level of optimization is sufficient for static content, it wont react to the individual portlets displayed on the page: If you have a detail portlet for example you might want to extract keywords from it. In the next section I will show you how to achieve that.

Liferay Portlet Search Engine Optimization

In this section I will show you how you can optimize page SEO from inside a portlet, this is done using a Liferay specific API.  You can use the API from the com.liferay.portal.util.PortalUtil class. There are a lot of methods in this class but you only need a few of them to perform SEO optimization. Please take a look at the following documented code:

// Adds a title to the page
PortalUtil.addPageTitle("title", PortalUtil.getHttpServletRequest(renderRequest));
// Adds a subtitle to the page
PortalUtil.addPageSubtitle("subtitle", PortalUtil.getHttpServletRequest(renderRequest));
// Adds a description to the page
PortalUtil.addPageDescription("description", PortalUtil.getHttpServletRequest(renderRequest));
// adds a keyword to the page
PortalUtil.addPageKeywords("keywords", PortalUtil.getHttpServletRequest(renderRequest));
//Replaces the title of the page with this
PortalUtil.setPageTitle("title", PortalUtil.getHttpServletRequest(renderRequest));
// Replaces the subtitle of the page with this
PortalUtil.setPageSubtitle("subtitle", PortalUtil.getHttpServletRequest(renderRequest));
// Replaces the description of the page with this
PortalUtil.setPageDescription("description", PortalUtil.getHttpServletRequest(renderRequest));
// Replaces the keyword of the page with this
PortalUtil.setPageKeywords("keyword", PortalUtil.getHttpServletRequest(renderRequest));

I recommend that you make use of the addPage* function because you don’t know what other portlets will be on the page.

That is it for now. You can find a tutorial on how to create portlet SEO friendly URLs here.