Liferay – Actualización de plugins a la 6.2


Útil cuando se quiera actualizar un portal y sus plugins a la versión 6.2 de Liferay, se puede usar como orientación para futuras versiones.

Actualizar los plugins

Themes

  • Los themes solo deberían contener las diferencias respecto al theme que extienden
  • Con la 6.2 los themes son responsivos y utilizan bootstrap, por ejemplo el theme base “Classic”
  • Los themes antiguos de la 6.1 deberían funcionar con la 6.2 sin ser responsivos
  1. Compilar el tema para la 6.2
  2. Comprobar el funcionamiento y sus logs
  3. (Opcional) Actualizar el tema para que sea responsivo 
  4. (Opcional) Empezar el tema des de cero con bootstrap

Layouts

  • Ahora incorporan bootstrap y scaffolding
  • Deberían funcionar sin problema con solo compilar para 6.2 sin ser responsivos
  • Es recomendable por su facilidad rehacerlos des de cero

Portlets

  • Ahora disponen de nuevas API
  • Algunas clases y métodos de la API han podido ser deprecados y deberían ser reemplazados
  • Se han añadido nuevas funciones que podrían ser útiles: ADT, papelera reciclaje, sandboxing, …
  1. Compilar el portlet para la versión 6.2
  2. Comprobar el funcionamiento y sus logs
  3. (Opcional) Utilizar la herramienta Liferay AUI Upgrade Tool para adaptarlo a la 6.2 y añadir responsive design
  4. (Opcional) Volver a compilar y comprobar el funcionamiento

Hooks

  • Nuevos tipos de hook disponibles
  • Más potencia y acceso
  • Se deployan en tiempo de ejecución
  • Los hooks pueden afectar al proceso de actualización, es importante que no estén instalados en ese momento
  • Los hooks pueden tener una fuerte dependencia con la versión del portal
  1. Se recomienda comprobar uno a uno los ficheros (jsps, clases, properties, …) que modifica el hook con el portal actual respecto la versión anterior.
    Se pueden comparar directamente los ficheros que modifica entre las versiones oficiales del portal, puede ser más fácil que directamente con el hook
  2. En caso que los ficheros originales que modifica el hook difieran de una versión de portal a la otra se debe rehacer el funcionamiento de esa parte para la nueva versión
  3. Compilar el hook para la versión 6.2
  4. En hooks agresivos (modifican permisos, documentos, contenidos, etc) es recomendable probar su funcionamiento con una versión limpia de la versión del portal
  5. Comprobar el funcionamiento y sus logs

Ext / Extlet

  • Probablemente deberán ser rehechos
  • Se recomienda evitarlos y reemplazar los que haya por portlets y/o hooks.
  • Para deployarse correctamente necesitan el reinicio del servidor
  • Pueden afectar al proceso de actualización, es importante que no estén instalados en ese momento
  1. Pensar si puede ser reemplazado por un portlet y/o hook, en caso afirmativo crear uno des de zero.
  2. En caso negativo adaptarlo a los nuevos ficheros del portal, se deberá comprobar cada fichero que modifique si ha cambiado en la nueva versión respecto la anterior
  3. Compilar el ext plugin para la versión 6.2
  4. Instalar y reiniciar el servidor
     

Recomendaciones para el futuro

  • Utiliza el entorno de plugins SDK para desarrollar
  • Sigue las buenas prácticas de programación
  • Evita el uso de plugins EXT
  • Minimiza el uso de hooks en lo posible
     

Nivel de dificultad en la actualización

Puntos de dificultad en la actualización incrementando según la diferenciación de los estándares (ej. JSR-286) y el uso de “malas” prácticas a la hora de personalizar los plugins, hooks y portal.

Icon

Información extraída de:

Utilizamos esta información como guía para actualizar nuestros plugins. ¡Esperamos que os sea de utilidad!


Leave a Reply

Your email address will not be published. Required fields are marked *