A partir de la version 5.3 de Liferay, va a haber soporte oficial para maven. En el este post Liferay Maven SDK publicado en el día de ayer en Liferay, se realiza una pequeña explicación de como se crea portlets como plugins con Maven.
También se esta trabajando para crear themes, hooks y layouts.
Para trabajar con Liferay 5.2 existe actualmente una implementación para crear portles en GitHub.
En xyberneticos me entero de una guia de 34 trucos para diseñadores y desarrolladores web; esta guia tiene muchos tips interesantes a tener en cuenta.
Este es el link.
Una funcionalidad que acabo de descubrir en el Blog de Liferay es crear el PortletUrl en JavaScript.
Un ejemplo de PortletUrl es:
http://localhost:8080/web/guest/home?p_p_id=EDITAR_CUENTA&p_p_lifecycle=0&p_p_state=maximized&p_p_mode=view&_EDITAR_CUENTA_struts_action=%2Feditar_cuenta%2Fview
Aca le estoy pasando el portlet id, el estado del portlet, la fase del ciclo de vida, la acción de struts a ejecutar y 1 parametro (podrian ser muchos más). Anteriormente la manipulación de esta url era medio complicada, ya que solo se podia generar a traves de JAVA o mediante una concatenación kilometrica de varios strings. Con esta funcion nos proporciona mayor flexibilidad a la hora de programar.
<script type=”text/javascript”>
var portletURL = new Liferay.PortletURL(_PHASE);
portletURL.setParameter(“key1″, “value”);
portletURL.setParameter(“key2″, “value”);
portletURL.setPortletId(_PORTLET_ID);
</script>
<a href=”javascript: portletURL.toString()”>Go to</a>
Los valores que puede tomar _PHASE son:
También existen los siguientes métodos que permiten crear el PortletUrl según _PHASE:
Estos son los métodos restantes de la clase Liferay.PortletURL:
A continuación esta el codigo que nos permite crear una comunidad a partir de una comunidad existente,
Obtener comunidad template
Group templateGroup = GroupLocalServiceUtil.getGroupByFriendlyUrl(“/template”);
Crear una comunidad
String name = ParamUtil.getString(actionRequest, “name”);
String description = ParamUtil.getString(actionRequest, “description”);
String friendlyURL = ParamUtil.getString(actionRequest, “friendlyURL”);
Group newGroup = GroupServiceUtil.addGroup(name, description,
GroupImpl.TYPE_COMMUNITY_PRIVATE, StringPool.BLANK, true);
Copiar la configuración del LayoutSet
LayoutSet publicLayoutSet = LayoutSetLocalServiceUtil.getLayoutSet(templateGroup.getGroupId(), false);
LayoutSetServiceUtil.updateLookAndFeel(newGroup.getGroupId(),
false, publicLayoutSet.getThemeId(), publicLayoutSet
.getColorSchemeId(), publicLayoutSet.getCss(),
false);
LayoutSetServiceUtil.updateLookAndFeel(newGroup.getGroupId(),
false, publicLayoutSet.getWapThemeId(), publicLayoutSet
.getWapColorSchemeId(), StringPool.BLANK, true);
LayoutSet privateLayoutSet = LayoutSetLocalServiceUtil.getLayoutSet(templateGroup.getGroupId(), false);
LayoutSetServiceUtil.updateLookAndFeel(newGroup.getGroupId(),
false, privateLayoutSet.getThemeId(), privateLayoutSet
.getColorSchemeId(), privateLayoutSet.getCss(),
false);
LayoutSetServiceUtil.updateLookAndFeel(newGroup.getGroupId(),
false, privateLayoutSet.getWapThemeId(), privateLayoutSet
.getWapColorSchemeId(), StringPool.BLANK, true);
Definir que copiar
Map<String, String[]> parameterMap = new HashMap<String, String[]>();
parameterMap.put(PortletDataHandlerKeys.PERMISSIONS,
new String[] { Boolean.TRUE.toString() });
parameterMap.put(PortletDataHandlerKeys.USER_PERMISSIONS,
new String[] { Boolean.TRUE.toString() });
parameterMap.put(PortletDataHandlerKeys.PORTLET_DATA,
new String[] { Boolean.TRUE.toString() });
parameterMap.put(PortletDataHandlerKeys.PORTLET_SETUP,
new String[] { Boolean.TRUE.toString() });
parameterMap.put(PortletDataHandlerKeys.PORTLET_ARCHIVED_SETUPS,
new String[] { Boolean.TRUE.toString() });
parameterMap.put(PortletDataHandlerKeys.PORTLET_USER_PREFERENCES,
new String[] { Boolean.TRUE.toString() });
parameterMap.put(PortletDataHandlerKeys.THEME,
new String[] { Boolean.TRUE.toString() });
Exportar datos de la comunidad template
byte[] publicOriginalGroup = LayoutServiceUtil.exportLayouts(
templateGroupId, false, parameterMap, null, null);
byte[] privateOriginalGroup = LayoutServiceUtil.exportLayouts(
templateGroupId, true, parameterMap, null, null);
Importar datos a la nueva comunidad
LayoutServiceUtil.importLayouts(newGroup.getGroupId(), false,
parameterMap, publicOriginalGroup);
LayoutServiceUtil.importLayouts(newGroup.getGroupId(), true,
parameterMap, privateOriginalGroup);
En varias ocasiones tuve el requerimiento de no mostrar algunos portlets en la lista de portlets disponibles para ser agregados a una página, y este ocultamiento no se podia hacer mediante permisos porque el usuario tenia que usar el portlet y no debia tirar el error de que el portlet no estaba disponibles. Entonces me di cuenta de que algunos portlets del core de Liferay no estaban disponibles para ser agregados a una página, por ejemplo el portlet de Look and Feel, el My Account o el del Page Setting. Para esto hay que declarar al portlet como portlet de sistema en liferay-portlet.xml.
liferay-portlet.xml
<portlet>
<portlet-name>MIPORTLET</portlet-name>
…
<system>true</system>
</portlet>
Desde otro portlet vamos a llamar a MIPORTLET
<%
PortletURL miPortletURL = new PortletURLImpl(
request, “MIPORTLET”, plid, PortletRequest.ACTION_PHASE);
miPortletURL.setWindowState(WindowState.MAXIMIZED);
miPortletURL.setPortletMode(PortletMode.VIEW);
miPortletURL.setParameter(“struts_action”, “/miportlet/view”);
%>
<a href=”<%= miPortletURL %>”>IR A MI PORTLET</a>
Armo la URL
<portlet:renderURL windowState=”<%= LiferayWindowState.EXCLUSIVE.toString() %>” var=”url”>
<portlet:param name=”struts_action” value=”/miportlet/popupview” />
</portlet:actionURL>
Llamo al POPUP
<script type=”text/javascript”>
function mostrar_popup() {
var _dialog = Liferay.Popup( {
width: 700,
modal: true,
message: ‘<div class=”loading-animation” />’,
position: ['center', 100],
title: <liferay-ui:message key”popup-title”/>,
resizable: false,
draggable: false,
onClose: function() {
// se ejecuta cuando el portle se cierra
}
} );
jQuery.ajax( {
url: “<%= url %>”,
success: function(message) {
_dialog.html(message);
}
} );
}
</script>
<a href=”javascript:mostrar_popup();”>mostrar popup</a>
Al definir el estado de la ventana como exclusivo, el resultado de la respuesta solamente va a ser el contenido del portlet al cual se invoca.
Ejemplo:
:
Para redirigir a una página de una comunidad después de registrarse en Liferay, hay que agregar un Evento, entonces vamos a hacer lo siguiente:
portal-ext.properties
login.events.post=com.liferay.portal.events.MyLoginPostAction,\
com.liferay.portal.events.DefaultLandingPageAction
MyLoginPostAction.java
package com.liferay.portal.events;
import ….
public class MyLoginPostAction extends Action {
private static Log _log = LogFactory.getLog(MyLoginPostAction.class);
public void run(HttpServletRequest req, HttpServletResponse res) throws ActionException {
try {
Group group = this.getGroup(req);
this.setLastPath(group, req);
} catch(Exception e) {
_log.error(e);
throw new ActionException(e);
}
}
private void getGroup(HttpServletRequest req) {
return null;
}
private void setLastPath(Group group, HttpServletRequest req)
throws PortalException, SystemException {
long defaultPlid = LayoutLocalServiceUtil.getDefaultPlid(group.getGroupId());
Layout defaultLayout = LayoutLocalServiceUtil.getLayout(defaultPlid);
HttpSession ses = req.getSession();
Map<String, String[]> params = new HashMap<String, String[]>();
params.put(“p_l_id”, new String[] { Long.toString(defaultLayout.getPlid()) });
LastPath lastPath = new LastPath(“/c”, “/portal/layout”, params);
ses.setAttribute(WebKeys.LAST_PATH, lastPath);
}
}
En este caso va a redirigir a la primer página publica de la comunidad y si esta no existe la redirige a la primer página privada.
Esto también puede ser para redirigir a una organización o a la página de un usuario.
En primer lugar vamos a crear un portlet con el Plugin SDK y luego vamos a editar el archivo $SDK_HOME/docroot/WEB-INF/portlet.xml.
En este caso vamos a ver la configuración del Portlet RSS para tener un ejemplo concreto para ver, luego de agregar las propiedades vamos a ver como obtenemos dichos valores.
<portlet>
<portlet-name>RSS</portlet-name>
<display-name>RSS</display-name>
<portlet-class>com.liferay.portlet.StrutsPortlet</portlet-class>
<init-param>
<name>view-action</name>
<value>/rss/view</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
</supports>
<resource-bundle>com.liferay.portlet.StrutsResourceBundle</resource-bundle>
<portlet-preferences>
<preference>
<name>urls</name>
<value>http://rss.news.yahoo.com/rss/tech</value>
<value>http://csmonitor.com/rss/scitech.rss</value>
<value>http://partners.userland.com/nytRss/technology.xml</value>
</preference>
<preference>
<name>items-per-channel</name>
<value>2</value>
</preference>
</portlet-preferences>
<security-role-ref>
<role-name>power-user</role-name>
</security-role-ref>
<security-role-ref>
<role-name>user</role-name>
</security-role-ref>
</portlet>
En ese caso hemos creado 2 preferencias, urls y items-per-channel.
Para obener estos valores hay que hacer:
PortletPreferences porttletPreferences = renderRequest.getPortletPreferences();
String[] urls = porttletPreferences.getValues(“urls”, new String[]());
long ipc = GetterUtil.getLong(portletPreferences.getValue(“items-per-channel”));
Para crear un portlet vamos a utilizar la versión 5.1.2 de Liferay, y requerimos los siguientes componentes:
Liferay se puede descargar desde http://sourceforge.net/projects/lportal/.
Paso a seguir:
SDK_HOME=/home/joyola/desarrollo/liferay/liferay-plugins-sdk-5.1.2
TOMCAT_HOME=/home/joyola/desarrollo/liferay/liferay-portal-tomcat-5.5-5.1.2
Creamos el archivo: $SDK_HOME/build.${user.name}.properties
Todas la propiedades utilizadas aca, sobreescriben el valor por default de las propiedades del archivo build.properties.
A continuación se especifican aquellas propiedades necesarias para comenzar.
#
# Specify the paths to an unzipped Tomcat 5.5.x bundle.
#
app.server.dir=${project.dir}/../liferay-portal-tomcat-5.5-5.1.2
app.server.portal.dir=${app.server.dir}/webapps/ROOT
app.server.classes.portal.dir=${app.server.portal.dir}/WEB-INF/classes
app.server.lib.portal.dir=${app.server.portal.dir}/WEB-INF/lib
app.server.lib.global.dir=${app.server.dir}/common/lib/ext
#
# Plugins will be deployed to this directory. Make sure that Liferay is
# also set to scan this directory.
#
auto.deploy.dir=${user.home}/liferay/deploy
Ejecutamos el comando: $SDK_HOME/portlets/create.sh miportlet “Mi Portlet”
Este comando tiene 2 parametros:
En el directorio $SDK_HOME/portles/miportlet-portlet, ejecutamos el comando: ant deploy
Acá tenemos un problema con esta versión, el archivo build.xml no es copiado cuando se crea el portlet. Por lo tanto tenemos que copiar el build.xml de una versión anterior del plugin, también es necesario agregar el build.xml al portlet.zip para que la proxima vez que creamos un portlet no tengamos este mismo error.
Iniciamos el TOMCAT, para esto ejecutamos el comando:
$TOMCAT_HOME/bin/startup.sh
Links:
http://www.liferay.com/web/guest/community/wiki/-/wiki/Main/Plugins+SDK
