Archive for the ‘General’ Category

Portlet de sistema

Wednesday, November 19th, 2008

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>

Configurar las preferencias de los Portlets

Monday, November 10th, 2008

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”));

Antes de comenzar

Sunday, November 9th, 2008

Antes de comenzar con Liferay, voy a hacer un resumen de las propiedades más importantes

portal-ext.properties

# El nombre de la compañia por default

company.default.web.id=miproyecto.com

# Especifica como el usuario puede loguearse al sistema

# Valores que puede tomar esta propiedad: emailAddress, screenName, userId

company.security.auth.type=emailAddress

# Permite si un usuario no logueado puede crear o no una cuenta

company.security.strangers=true

# Locales disponibles

locales=es_ES

# Si esta propiedad esta en true, un usuario invitado toma como por default el lenguaje de la aplicacion.

# Caso contrario toma el valor de header del request.

locale.default.request=false

# Los Time Zones disponibles

time.zones=America/Buenos_aires

# Directorio donde Liferay guardar los indices de Lucene, los archivos de Document Library, Jackrabbit, etc.

resource.repositories.root=${user.home}/liferay/miproyecto

# Si esta propiedad esta en true, carga todo el css en un archivo comprimido (SUPER RECOMENDADO)

theme.css.fast.load=true

# Si esta propiedad esta en true, carga todo el javascript en un archivo comprimido (SUPER RECOMENDADO)

javascript.fast.load=true

system-ext.properties

#País y Lenguaje predeterminado

user.country=AR
user.language=es

# Time Zone predeterminado

user.timezone=GMT

Crear un Portlet con el Plugins SDK

Saturday, November 8th, 2008

Para crear un portlet vamos a utilizar la versión 5.1.2 de Liferay, y requerimos los siguientes componentes:

  1. ANT 1.7
  2. JAVA
  3. MySQL (opcional)
  4. liferay-portal-tomcat-5.5-5.1.2
  5. liferay-plugins-sdk-5.1.2

Liferay se puede descargar desde http://sourceforge.net/projects/lportal/.

Paso a seguir:

  • Variables de entorno

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

  • Configuracion del SDK

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

  • Crear el portlet

Ejecutamos el comando: $SDK_HOME/portlets/create.sh miportlet “Mi Portlet”
Este comando tiene 2 parametros:

  1. Portlet Id
  2. Display name
  • Tasks más utilizados
  1. clean: elimina los archivos generados por los otros comandos
  2. compile: compila los java
  3. war: genera el war
  4. deploy: compila, genera el war y lo copia al directorio deploy
  • Ejecutamos el deploy

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.

  • Tomcat

Iniciamos el TOMCAT, para esto ejecutamos el comando:
$TOMCAT_HOME/bin/startup.sh

  • Agregamos el portlet a una página
  1. Entar a http://localhost:8080/c/portal/login
  2. Usuario: test@liferay.com y Password: test
  3. Ir al dock, hacer click en Add Portlet
  4. Buscar el nuevo portlet
  5. Hacer click sobre add

Links:

http://www.liferay.com/web/guest/community/wiki/-/wiki/Main/Plugins+SDK

¡Hola, mundo!

Wednesday, November 5th, 2008

Te doy la bienvenida a Liferay Latino Blog. La idea de esto Blog es compartir mi conocimiento adquirido en estos 2 años en lo que estuve trabajando con Liferay, y el otro motivo importante que me lleva a escribir este blog es seguir aprendiendo e investigando Liferay.

Espero que les sirva de referencia, y que puedan participar de este proyecto que estoy iniciando en este momento.

Desde ya muchas gracias,

Saludos

LR Latino Blog