Pensando en Red nada es tan fácil como parece serlo

Drupal crear variables en nodos para personalizar el detalle de un contenido

Cuando trabajamos en la personalización del detalle de contenido, nos puede surgir la necesidad según requisitos de crear alguna lógica para mostrar los atributos de este contenido. Es muy fácil caer en aplicar esa lógica y creación de variables en la propia plantilla php (phptemplates), pero en la medida de los posible lo correcto sería evitar "codificar" en la plantilla.

Pongamos el ejemplo de que estamos mostrando el detalle de un contenido noticia, en donde tiene dos atributos a los que hay que darle importancia:
- Imagen
- Vídeo

Requisitos:
Si la noticia tiene vídeo, mostrar el vídeo y en caso contrario pintar la imagen.

Sería muy sencillo aplicar la lógica en el phptemplate:

if($field_noticia_video_rendered){
print $field_noticia_video_rendered;
}else{
print $field_noticia_imagen_rendered;
}

Como ya sabéis, si el tipo de contenido tiene un definido el campo con nombre field_noticia_imagen y el widget del atributo es de tipo imagen, al pintar $field_noticia_imagen_rendered te pinta el html necesario para renderizar la imagen, lo mismo ocurre con el vídeo.

Bien, hasta aquí hemos cumplido la funcionalidad. Pero... ¿es la manera correcta? tal vez no debería mojarme en decir "correcta" ya que ambas funcionan, pero queda mucho más ordenado si en vez de pintar ese churro lineas en la plantilla simplemente pintamos:

print $field_noticia_multimedia_rendered;

Ahora bien, el tipo de contenido noticia no tiene el atributo multimedia y antes de que interprete la plantilla tenemos que crear la variable.

Es muy improbable que estés haciendo un tema de Drupal de cero, así que en este paso vamos a abrir template.php.

Normalmente en este fichero si partes de un tema base, ya tendrás la función:

THEMENAME_preprocess_node(&$vars, $hook){
...
$function = '_THEMENAME_preprocess_node'.'__'. $vars['node']->type;
if (function_exists($function)) {
$function(&$vars);
}
}

Antes de procesar un nodo se ejecuta esta función, en donde comprobamos si tenemos declarada una función especifica para preprocesar un nodo de un tipo de contenido determinado, como en este caso el type es "noticia" tendremos la función "_THEMENAME_preprocess_node__noticia". Al declarar la función con un guión bajo al inicio del nombre, es una manera de indicar que es una función de ámbito privado y que no es un hook que lo entienda el core.

_THEMENAME_preprocess_node__noticia($vars){
...
}

El parámetro que recibe es un array asociativo que contiene toda la información que necesitamos. Si creamos una nueva key en este array asociativo, lo que vamos a conseguir es que en la plantilla de nodo exista una variable con el nombre de la key que hemos creado en el array.

_THEMENAME_preprocess_node__noticia($vars){
if($vars['field_noticia_video][0]['value']){
$vars['field_noticia_multimedia_rendered'] = $vars['field_noticia_video'][0]['view'];
}else{
$vars['field_noticia_multimedia_rendered'] = $vars['field_noticia_imagen'][0]['view'];
}
}

Una vez creado el preprocess para el tipo de contenido noticia, en la plantilla del nodo noticia tenemos que pintar la variable $field_noticia_multimedia_rendered.

print $field_noticia_multimedia_rendered;

Nos olvidamos de la lógica en la plantilla, para cuando pase diseño a modificarla no se encuentre con esos churros que a veces metemos

La idea de llamar a la nueva variable $field_noticia_multimedia_rendered es por seguir un poco la nomenclatura de las variables que utiliza Drupal, pero puede ser sólo $multimedia ya que a otra persona que vaya a ver la plantilla le puede llevar a confusión entendiendo que es un atributo del contenido. Esto queda a elección de cada uno.