Añadir portlet de Mapa Web con Velocity en Liferay

Cuando queremos que en nuestra cabecera o pie de página siempre nos aparezca un portlet determinado debemos de incluirlo a través de del código velocity correspondiente. Por tanto hoy os voy a enseñar como añadir un portlet de Mapa web y en posteriores post os iré enseñando los principales portlets que podemos añadir y para que sirve cada linea de código.

Vamos a ver poco a poco como es el código y que hace:

$velocityPortletPreferences.setValue("portlet-setup-show-borders",
"false")

Con esta línea establecemos que queremos que el portlet aparezca sin los bordes que trae por defecto. Nosotros solemos siempre desactivarlos pero cada uno puede hacer lo que prefiera.

$velocityPortletPreferences.setValue("group-id", "$group_id")

Establecemos el grupo al que pertenece el portlet. Esta linea deberiamos de dejarla siempre por defecto, tal y como está aquí.

$velocityPortletPreferences.setValue("root-layout-id", "2")

En esta línea definimos la raiz de la que cuelga el mapa web. Es una línea propia de este portlet. Si queremos saber que número debemos ponerle tan solo debemos de ir a la configuración del portlet e inspeccionar con el firebug de firefox el select con sus options que corresponde a la raiz de la que queremos que cuelga. Si nos fijamos en las option podemos ver que tiene un número identificador, ése es el número que debemos de incluir aquí. Por ejemplo, la raiz principal de la página será el 0, la primera página creada será el 1 y así sucesivamente. Es una línea opcional, por defecto se establece a 0.

$velocityPortletPreferences.setValue("display-depth", "1")

Con ésto establecemos la pronfundidad del mapa que queremos mostrar. Si ponemos un 0 lo mostraremos todo a partir de la raiz, con un 1 mostramos los hijos de la raiz, con un 2 mostramos los hijos de la raiz y a su vez los hijos de éstos y así sucesivamente. Es una linea opcional, por defecto se establece a 0.

$theme.runtime("85_INSTANCE_RECURSIVAS", "",
$velocityPortletPreferences.toString())

Lanza el portlet con el identificador, en este caso 85_INTANCE_RECURSIVA. (85 es el identificador genérico para el tipo mapa web. _instance_recursivas otorga un identificador único para este portlet de tipo mapaweb). Es una línea obligatoria y debe seguir rigurosamente la estructura establecida. Solo podríamos variar el "RECURSIVAS" ya que es el identificador que ponemos a nuestro gusto.

$velocityPortletPreferences.reset()

Y por último añadimos esta línea que hace un reset de las preferencias. Debemos incluirla siempre.

Os dejo aquí el código completo listo para incluirse:

$velocityPortletPreferences.setValue("portlet-setup-show-borders", "false")
$velocityPortletPreferences.setValue("group-id", "$group_id")
$velocityPortletPreferences.setValue("root-layout-id", "2") 
$velocityPortletPreferences.setValue("display-depth", "1") 
$theme.runtime("85_INSTANCE_RECURSIVAS", "", 
$velocityPortletPreferences.toString()) 
$velocityPortletPreferences.reset()

Todo este código deberíamos incluirlo en el portal-normal.vm del tema o ,en su defecto, en un archivo.vm independiente y luego cargarlo desde el portal-normal.

Espero que os sea de utilidad.