Sun GlassFish Web Space Server 10.0 Administration Guide

Default Settings Layout

Default Settings Layout is a property in the portal.properties file, which is the default configuration file for Sun GlassFish Web Space Server. You can override this property using portal-ext.properties file.


layout.edit.page=/portal/layout/edit/portlet.jsp
layout.view.page=/portal/layout/view/portlet.jsp
layout.url=${liferay:mainPath}/portal/layout?p_l_id=${liferay:plid}
layout.url.friendliable=true
layout.parentable=true
layout.sitemapable=true
layout.configuration.action.update=
layout.configuration.action.delete=

Settings for portlet layouts are inherited from the default settings.


layout.edit.page[portlet]=/portal/layout/edit/portlet.jsp
layout.view.page[portlet]=/portal/layout/view/portlet.jsp
layout.url[portlet]=${liferay:mainPath}/portal/layout?p_l_id=${liferay:plid}
layout.url.friendliable[portlet]=true
layout.parentable[portlet]=true
layout.configuration.action.update[portlet]=
layout.configuration.action.delete[portlet]=

Settings for panel layouts.


layout.edit.page[panel]=/portal/layout/edit/panel.jsp
layout.view.page[panel]=/portal/layout/view/panel.jsp
layout.url[panel]=${liferay:mainPath}/portal/layout?p_l_id=${liferay:plid}
layout.url.friendliable[panel]=true
layout.parentable[panel]=true

Settings for embedded layouts.


layout.edit.page[embedded]=/portal/layout/edit/embedded.jsp
layout.view.page[embedded]=/portal/layout/view/embedded.jsp
layout.url[embedded]=${liferay:mainPath}/portal/layout?p_l_id=${liferay:
plid}
layout.url.friendliable[embedded]=true
layout.parentable[embedded]=false
layout.sitemapable[embedded]=true
layout.configuration.action.update[embedded]=
layout.configuration.action.delete[embedded]=

Settings for article layouts.


layout.edit.page[article]=/portal/layout/edit/article.jsp
layout.view.page[article]=/portal/layout/view/article.jsp
layout.url.friendliable[article]=true
layout.url[article]=${liferay:mainPath}/portal/layout?p_l_id=${liferay:plid}
layout.parentable[article]=false
layout.sitemapable[article]=true
layout.configuration.action.update[article]=com.liferay.portal.model.Layout-
TypeArticleConfigurationUpdateAction
layout.configuration.action.delete[article]=com.liferay.portal.model.Layout-
TypeArticleConfigurationDeleteAction

Settings for URL layouts.


layout.edit.page[url]=/portal/layout/edit/url.jsp
layout.view.page[url]=
layout.url[url]=${url}
layout.url.friendliable[url]=true
layout.parentable[url]=false
layout.sitemapable[url]=false
layout.configuration.action.update[url]=
layout.configuration.action.delete[url]=

Settings for page layouts.


layout.edit.page[link_to_layout]=/portal/layout/edit/link_to_layout.jsp
layout.view.page[link_to_layout]=
layout.url[link_to_layout]=${liferay:mainPath}/portal/layout?p_l_id=${link-
ToPlid}
layout.url.friendliable[link_to_layout]=true
layout.parentable[link_to_layout]=true
layout.sitemapable[link_to_layout]=false
layout.configuration.action.update[link_to_layout]=
layout.configuration.action.delete[link_to_layout]=

Specify static portlets that cannot be moved and will always appear on every layout. Static portlets will take precedence over portlets that may have been dynamically configured for the layout.

For example, if you want the Hello World portlet to always appear at the start of the iteration of the first column for user layouts, set the property layout.static.portlets. start.column-1[user] to 47. If you want the Hello World portlet to always appear at the end of the second column for user layouts, set the property layout.static.portlets.end.column-2[user] to 47. You can input a list of comma-delimited portletIDs to specify more than one portlet. If the portlet is instanceable, add the suffix _INSTANCE_abcd to the portletID, where abcd is any random alphanumeric string.

The static portlets are fetched based on the properties controlled by custom filters using EasyConf. By default, the available filters are user, community, and organization.


layout.static.portlets.start.column-1[user]=3,6
layout.static.portlets.end.column-1[user]=14
layout.static.portlets.start.column-2[user]=71_INSTANCE_abcd,7
layout.static.portlets.end.column-2[user]=34,70
layout.static.portlets.start.column-3[user]=
layout.static.portlets.end.column-3[user]=

It is also possible to set static portlets based on the layout's friendly URL.


layout.static.portlets.start.column-1[user][/home]=3,6
layout.static.portlets.end.column-2[community][/home]=14

Set the static layouts for community layouts.


layout.static.portlets.start.column-1[community]=
layout.static.portlets.end.column-1[community]=
layout.static.portlets.start.column-2[community]=
layout.static.portlets.end.column-2[community]=
layout.static.portlets.start.column-3[community]=
layout.static.portlets.end.column-3[community]=

Set the static layouts for organization layouts.


layout.static.portlets.start.column-1[organization]=
layout.static.portlets.end.column-1[organization]=
layout.static.portlets.start.column-2[organization]=
layout.static.portlets.end.column-2[organization]=
layout.static.portlets.start.column-3[organization]=
layout.static.portlets.end.column-3[organization]=

Set the private group, private user, and public servlet mapping for com.liferay.portal.servlet.FriendlyURLServlet. This value must match the servlet mapping set in web.xml.

For example, if the private group pages are mapped to /group and the group's friendly URL is set to /guest and the layout's friendly URL is set to /company/community, then the friendly URL for the page will be http://www.liferay.com/group/guest/company/community. Private group pages map to a community's private pages and are only available to authenticated users with the proper permissions.

For example, if the public pages are mapped to /web and the group or user's friendly URL is set to /guest and the layout's friendly URL is set to /company/community, then the friendly URL for the page will be http://www.liferay.com/web/guest/company/ community. Public pages are available to unauthenticated users.

The friendly URLs for users, groups, and layouts can be set during runtime.


layout.friendly.url.private.group.servlet.mapping=/group
layout.friendly.url.private.user.servlet.mapping=/user
layout.friendly.url.public.servlet.mapping=/web

Redirect to this resource if the user requested a friendly URL that does not exist. Leave it blank to display nothing.


Note –

For backward compatibility, this overrides the property layout.show.http.status for the 404 status code.



layout.friendly.url.page.not.found=/html/portal/404.html

Set the reserved keywords that cannot be used in a friendly URL.


layout.friendly.url.keywords=c,group,web,image,wsrp,page,public,private,rss,
tags

Set the following to true if layouts should remember (across requests) that a window state was set to maximized.


layout.remember.request.window.state.maximized=false

Set the following to true if guest users should see the maximize window icon.


layout.guest.show.max.icon=false

Set the following to true if guest users should see the minimize window icon.


layout.guest.show.min.icon=false

Set the following to true if users are shown that they do not have access to a portlet. The portlet init parameter show-portlet-access-denied will override this setting.


layout.show.portlet.access.denied=true

Set the following to true if users are shown that a portlet is inactive. The portlet init parameter show-portlet-inactive will override this setting.


layout.show.portlet.inactive=true

Set the following to true if the portal should show HTTP status codes like 404 if the requested page is not found.


layout.show.http.status=true

Set the default layout templateID used when creating layouts.


layout.default.template.id=2_columns_ii

Set the following to false to disable parallel rendering. You can also disable it on a per request basis by setting the attribute key com.liferay.portal.util.WebKeys.PORTLET_ PARALLEL_RENDER to the Boolean.FALSE in a pre service event or by setting the URL parameter p_p_parallel to 0.


layout.parallel.render.enable=true

Set the name of a class that implements com.liferay.portal.util.LayoutClone. This class is used to remember maximized and minimized states on shared pages. The default implementation persists the state in the browser session.


layout.clone.impl=com.liferay.portal.util.SessionLayoutClone

Set the following to true to cache the content of layout templates. This is recommended because it improves performance for production servers. Setting it to false is useful during development if you need to make a lot of changes.


layout.template.cache.enabled=true

Set the default value for the p_l_reset parameter. If set to true, then render parameters are cleared when different pages are hit. This is not the behavior promoted by the portlet specification, but is the one that most end users seem to prefer.


layout.default.p_l_reset=true