3.4.6.2. Customizing a page layout

Warning

You are looking at documentation for an older release. Not what you want? See the current release documentation.

This section is related to the configuration. You can see a sample of Intranet here. You can leave all the portlet's preferences as blank, this means the default value will be taken and you do not need to care about it at this time.

Like the site layout, you can easily define the layout for each page in a site easily.

As an example, here are steps to alter the homepage layout of Intranet by moving the Getting Started and Calendar portlets from right to the left corner.

Follow steps 1 and 2 which are similar when you change the site layout.

Create pages.xml to override configuration of the Intranet site under custom-extension.war!/WEB-INF/myintranet-conf/portal/intranet.


<page-set xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xsi:schemaLocation="http://www.gatein.org/xml/ns/gatein_objects_1_2 http://www.gatein.org/xml/ns/gatein_objects_1_2"

  xmlns="http://www.gatein.org/xml/ns/gatein_objects_1_2">

  

  <page>

    <name>homepage</name>

    <title>Home Page</title>

    <access-permissions>Everyone</access-permissions>

    <move-apps-permissions>*:/platform/administrators</move-apps-permissions>

    <move-containers-permissions>*:/platform/administrators</move-containers-permissions>

    <container template="system:/groovy/portal/webui/container/UITableColumnContainer.gtmpl">

      <access-permissions>Everyone</access-permissions>

      <container id="Left" template="system:/groovy/portal/webui/container/UIContainer.gtmpl">

        <access-permissions>Everyone</access-permissions>

        <portlet-application>

          <portlet>

            <application-ref>homepage-portlets</application-ref>

            <portlet-ref>GettingStartedPortlet</portlet-ref>

          </portlet>

          <title>Getting Started</title>

          <access-permissions>*:/platform/users</access-permissions>

          <show-info-bar>false</show-info-bar>

          <show-application-state>false</show-application-state>

          <show-application-mode>false</show-application-mode>

        </portlet-application>

        

        <portlet-application>

          <portlet>

            <application-ref>homepage-portlets</application-ref>

            <portlet-ref>HomePageCalendarPortlet</portlet-ref>

          </portlet>

          <title>Calendar Portlet</title>

          <access-permissions>*:/platform/users</access-permissions>

          <show-info-bar>false</show-info-bar>

          <show-application-state>false</show-application-state>

          <show-application-mode>false</show-application-mode>

        </portlet-application>

      </container>

      

      <container template="system:/groovy/portal/webui/container/UIContainer.gtmpl">

        <access-permissions>Everyone</access-permissions>

        <portlet-application>

          <portlet>

            <application-ref>social-portlet</application-ref>

            <portlet-ref>UserActivityStreamPortlet</portlet-ref>

          </portlet>

          <title>User Activity Stream</title>

          <access-permissions>*:/platform/users</access-permissions>

          <show-info-bar>false</show-info-bar>

          <show-application-state>false</show-application-state>

          <show-application-mode>false</show-application-mode>

        </portlet-application>

      </container>

    </container>

  </page>

</page-set>

As you see in the pages.xml file above, the GettingStartedPortlet and HomePageCalendarPortlet are registered in the container with id = "Left" that specifies the new position (left) of Getting Started and Calendar portlets.

Follow steps 5 and 6. The Getting Started and Calendar portlets are now in the left that is different from its default page layout: