Una de los temas mas interesante en Google App Engine es la posibilidad de usar plantillas. En la página de GAE existen ejemplos sencillos de cómo utilizar plantillas.El problema empieza cuando dentro de esas plantillas quieres hacer tratamiento de los datos para mostrar los datos correctamente. En esta articulo intentaremos explicar como usar esos filtros y como crear propios.

Como habéis podido ver en el ejemplo de la pagina de GAE, la forma de mostrar un valor en la plantilla es usando la sintaxis {{ variable }}. En la mayoría de los casos dichas variables serán de tipo string o integer por lo que su visualización no tendrá mayor problema. Pero por ejemplo en el caso de variables tipo datetime u otro tipo de objeto propio, el sistema de plantillas no es capaz de mostrar el contenido de dichas variables, ya que solo es capaz de mostrar valores tipo string o integer.

Para los tipos de datos mas comunes existen ya filtros por defecto como es el caso de los valores datetime. La forma de aplicar un filtro es la siguiente:

<br />
{{variable|filtro}}<br />

Y en algunos casos:

<br />
{{variable|filtro:argumento}}<br />

En el caso de los valores datetime que hemos comentado antes, para mostrar un valor de fecha deberemos usar el filtro date de la siguiente manera:

<br />
{{mydatevar|date:"j"}}<br />

Esto seria equivalente a ejecutar una función date(mydatevar,”j”) y lo que estoy haciendo es mostrar el día del mes (código %j) similar a como se hace en otros lenguajes de programación.

Aquí podéis encontrar un listado con los principales filtros predeterminados en django

El problema es cuando estas funciones no son suficientes para hacer lo que nosotros queremos, o queremos tratar tipos de objetos poco comunes o propios.

Por ejemplo imaginemos que queremos tenemos un libro de visitas donde los usuarios puede escribir entradas, e indican su dirección de correo. Pero no queremos que esa dirección de correo sea visible para que no pueda ser rastreada por spammers, por lo que optamos por mostrar solo los 5 primeros caracteres de el nombre de usuario de la cuenta de correo mas tres puntos suspensivos (algo parecido a lo que se hace en las listas de distribución). Es decir para estoesunaprueba@gmail.com nos generara una dirección del tipo estoe…@gmail.com.

Por tanto nuestra función en python seria algo así como:

<br />
def securemail (mail):<br />
	return mail.split(‘@’)[0][:5]+”…@”+ mail.split(‘@’)[1]<br />

Es decir, dividimos la dirección en usuario y dominio con la función split y el carácter @, y generamos una nueva dirección con los primeros 5 caracteres de el usuario mas tres puntos suspensivos la arroba y el dominio.

Para poder usar esta función en nuestras plantillas haremos lo siguiente. Crearemos un script customfilters.py donde guardaremos todas nuestros filtros. Dicho script tendrá la siguiente forma

<br />
from google.appengine.ext import webapp<br />
from datetime import datetime</p>
<p>register = webapp.template.create_template_register()</p>
<p>def securemail (mail):<br />
	return mail.split(‘@’)[0][:5]+”…@”+ mail.split(‘@’)[1]</p>
<p>register.filter(securemail)<br />

Para importar los filtros en nuestra aplicación añadiremos la siguiente sentencia justo después de los imports.

<br />
webapp.template.register_template_library('customfilters')<br />

De esta forma podremos usar nuestro filtro de la siguiente manera:

<br />
{{mail|securemail}}<br />

Imaginemos que damos la opción al usuario que la función securemail muestre su cuenta de dos modos, uno, el por defecto que es el funcionamiento explicado anteriormente, y otro, que hace que solo se muestre el usuario sin el dominio. Por tanto deberemos definir un parámetro en la función para poder elegir el tipo de ofuscación. La función en este caso nos quedaría así:

<br />
def securemail (mail,default=true):<br />
	if default:<br />
		return mail.split(‘@’)[0][:5]+”…@”+ mail.split(‘@’)[1]<br />
	else:<br />
		return mail.split(‘@’)[0]<br />

Por tanto si la variable mail tomara el valor estoesunaprueba@gmail.com este seria el resultado para las diferentes expresiones:

<br />
{{mail|securemail}} #estoe…@gmail.com<br />
{{mail|securemail:true}} #estoe…@gmail.com<br />
{{mail|securemail:false}} #estoesunaprueba<br />

De esta forma podemos controlar y procesar la información a mostrar en nuestra plantilla cuando esta se trata de un objeto no string (o integer).