LIFERAY. PROPIEDADES DE PORTAL.PROPERTIES MODIFICADAS QUE AFECTAN A FREEMARKER Y VELOCITY

Patrocinador

Ebooks sobre Liferay

Hay propiedades en el fichero portal.properties que afectan al procesamiento de plantillas realizadas en Freemarker o Velocity y aquí, aparece uno de los problemas comúnmente asociados al software libre: una nueva versión de la herramienta, puede implicar cambios que afectan a código desarrollado para versiones anteriores.

Es precisamente lo que ha ocurrido con las clases y variables restringidas en Freemarker y Velocity a partir de la versión 6.2 de Liferay. En versiones anteriores nos encontrábamos con:

// Entre otras propiedades...

journal.template.freemarker.restricted.variables=serviceLocator
journal.template.velocity.restricted.variables=serviceLocator

Sin embargo, si nos bajamos el código fuente de Liferay...

..., abrimos el fichero /portal-impl/src/portal.properties con un buen editor y buscamos la palabra Velocity o Freemarker, nos daremos cuenta que ya no existen. Lo que ahora tenemos a nuestra disposición es (se indican las propiedades con los valores que vienen por defecto):

Atención: Datos actualizados a 21/12/2015.

freemarker.engine.restricted.classes=\ 
java.lang.Class,\
java.lang.ClassLoader,\
java.lang.Thread

freemarker.engine.restricted.packages=

freemarker.engine.restricted.variables=serviceLocator

velocity.engine.restricted.classes=\
java.lang.Class,\
java.lang.ClassLoader,\
java.lang.Thread

velocity.engine.restricted.packages=

velocity.engine.restricted.variables=serviceLocator

Por tanto, si queremos acceder a esas variables y clases desde nuestras plantillas Freemarker o Velocity, el clásico fichero portal-ext.properties que sobrescribe a portal.properties contendrá algo como:

freemarker.engine.restricted.classes=
freemarker.engine.restricted.variables=
velocity.engine.restricted.classes=
velocity.engine.restricted.variables=

// Y para guardar compatibilidad hacia versiones anteriores:
journal.template.freemarker.restricted.variables=
journal.template.velocity.restricted.variables=

Parece ser que la razón del cambio es hacer más genéricas estas clases y variables que pueden ser usadas en diferentes contextos.

En cualquier caso, acceder a esas variables y clases en plantillas, implica generalmente que vamos a usar lógica en ellas, lo cual no es recomendable, como tampoco es recomendable el uso de serviceLocator en plantillas, recomendándose mejor usar el método getClass().forName('...'). Sobre esto tengo pensado realizar un artículo, así que lo veremos con más profundidad más adelante.

Un cordial saludo a todos y hasta otra.

HTML 5. REQUIRED SELECT.

Patrocinador

Ebooks sobre HTML5

HTML 5 ha traído bastantes funcionalidades a los desarrolladores de aplicaciones web que antes era necesario "fabricar"; bastantes de ellas dentro de los llamados Formularios HTML 5 y en concreto aquellas que tienen que ver con validaciones de los campos de formularios, como la frecuente tarea de comprobar si se han rellenado o no, los campos que establezcamos como obligatorios.

Una tarea, simple en su cometido, pero que requería un uso intensivo de JavaScript y CSS. Con HTML 5 solamente tenemos que añadir el atributo required al campo del formulario que consideremos obligatorio completar.

A partir de ahí, será el propio navegador el encargado de controlar si ese campo requerido tiene información o no, interactuando con el visitante de acuerdo a la implementación que de HTML 5 tenga el navegador que esté usando. Es el punto donde entra en juego la compatibilidad del navegador con el estándar HTML 5. Hay un muy buen artículo sobre compatibilidades aquí:

http://www.wufoo.com.mx/html5/

Puesto que con las nuevas versiones de navegadores esto puede cambiar, la información del artículo al que apunta el enlace, solamente debe servir como guía. En cualquier caso, si queremos cambiar el comportamiento que ofrece el navegador para required, tendremos que utilizar nuevamente CSS y JavaScript. También podemos usar el atributo aria-required (se puede utilizar de manera conjunta a required) que hace lo mismo que éste pero es compatible con algunos navegadores que no lo son con este atributo.

El uso con cualquier elemento de tipo input, textarea o select es muy simple, ya que simplemente basta con añadirlo al elemento obligatorio. De todas formas, si hay problemas de compatibilidades con navegadores, estas son las posibilidades:

1: required
2: required="required"
3: required='required'
4: required=required
5: required=""
6: required=''

Con todo, su utilización en un elemento select, actualmente implica tener en cuenta algunos detalles más que su mera inclusión. Estos factores son:

• Debe tener uno o más opciones (elementos option).
• La primera opción o elemento option debe tener su atributo value vacío o simplemente no tener contenido de texto.

Ejemplos:

1: Ejemplo 1:
2: <form action="#" method="post">
3:  <br />
4:  <div>
5:    <label for="provincias">Provincias</label> // Incluyo aria-required para mayor compatibilidad
6:    <select aria-required="true" id="provincias" name="provincias" required>
7:      <option value="">Seleccione una provincia, por favor</option>
8:      <option value="bar">Barcelona</option>
9:      <option value="mad">Madrid</option>
10:     <option value="sev">Sevilla</option>
11:      ...
12:      ...
13:    </select>
14:  </div>
15: </form>
16:
17:
18: Ejemplo 2:
19: <form action="#" method="post">
20:  <br />
21:  <div>
22:    <label for="provincias">Provincias</label> // Incluyo aria-required para mayor compatibilidad
23:    <select aria-required="true" id="provincias" name="provincias" required>
24:      <option></option>
25:      <option value="bar">Barcelona</option>
26:      <option value="mad">Madrid</option>
27:      <option value="sev">Sevilla</option>
28:      ...
29:      ...
30:    </select>
31:  </div>
32: </form>
33:
34:
35: Ejemplo 3: // NO VÁLIDO
36: <form action="#" method="post">
37:  <br />
38:  <div>
39:    <label for="provincias">Provincias</label>
40:    <select aria-required="true" id="provincias" name="provincias" required>
41:      <option>Seleccione una provincia, por favor</option>
42:      <option value="bar">Barcelona</option>
43:      <option value="mad">Madrid</option>
44:      <option value="sev">Sevilla</option>
45:      ...
46:      ...
47:    </select>
48:  </div>
49: </form>

A la hora de crear las vistas para nuestras aplicaciones o nuestras herramientas como Liferay, Joomla, Prestashop, etc., no cabe duda de que es un arma excelente que nos ahorrará mucho trabajo, eso, sin tener en cuenta que estaremos ahorrando código CSS y JavaScript, lo que hará que aumente el rendimiento de la aplicación.

Lo dejamos aquí de momento, ya que este artículo tenía como misión mostrar el uso correcto de required con select. La creación de formularios HTML 5 podéis estudiarla con todo detalle en nuestros cursos. Si quieres más información, puedes hacerlo a josmanuel.dominguez@gmail.com, josema@orbisapientia.com o más cómodamente desde el formulario de contacto.

Un cordial saludo y mis mejores deseos para todos para este nuevo año.