Introducción a PHPTemplate con Drupal 6

Introducción.

PHPTemplate es un motor (engine) de temas desarrollado a la par de Drupal que permite la utilización de código PHP en ellas facilitando la separación entre lo concerniente al programador y lo relacionado con el diseñador web.  En la versión 6 se ubica su núcleo en themes/engines/phptemplate pero además se incluyen a otros archivos en ubicaciones según los módulos y funcionalidades que afectan.  Los nombres de los archivos que utilizan este motor obedecen al patrón *.tpl.php.

Los archivos mínimos requeridos son los siguientes.

  • page.tpl.php: contiene la distribución general de la página del tema.
  • <tema>.info: contiene la información de especificación del tema.

El archivo page.tpl.php.

En este archivo se detalla la estructura básica de la presentación de la página del tema.  Su personalización se realiza mediante la manipulación de clases utilizando CSS, además es posible definir plantillas alternativas que definen la presentación de secciones específicas del contenido: bloques (block.tpl.php), secciones (box.tpl.php), comentarios (comment.tpl.php), nodos (node.tpl.php), etc o a tipos de contenido específicos: noticias, artículos de blog, páginas, etc.

Algunas de las variables que se pueden utilizar en el head de los archivos *.tpl.php son las siguientes.

  • $head_title: título de la página.
  • $head: información de la sección head.
  • $styles: las hojas de estilo a incluírse, definidas en <tema>.info.
  • $scripts: los scripts a incluírse, definidos en <tema>.info.

También se incluyen las regiones (placeholders) que conformarán el contenido del tema.  Estas regiones deben registrarse previamente para poder ser utilizadas como tales.

  • $header: cabecera.
  • $left: columna izquierda.
  • $content: contenido (central).
  • $right: columna derecha.
  • $footer: pies de página.

Frecuentemente estas secciones deberán ser incluídas si se satisfacen ciertas condiciones, como por ejemplo, que se encuentren definidas.

<?php if($left): ?>
<div id="sidebar-left">
    <?php print $left; ?>
</div>
<?php endif; ?>

El archivo <tema>.info.

Su nombre corresponde el nombre del tema y la extensión .info, su función es la de definir la especificación y configuración básica del tema.

Este es el contenido del archivo bluemarine.info asociado con el tema con el mismo nombre incluído por defecto en Drupal.

; $Id: bluemarine.info,v 1.4 2007/06/08 05:50:57 dries Exp $
name = Bluemarine
description = Table-based multi-column theme with a marine and ash color scheme.
version = VERSION
core = 6.x
engine = phptemplate

; Information added by drupal.org packaging script on 2009-05-13
version = “6.12”
project = “drupal”
datestamp = “1242243950”

Es posible consultar mayor información al respecto en el documento Estructura del archivo .info.

Enlaces.

Leave a Reply

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