<?php// $Id: template.php,v 1.12.2.1 2007/01/17 05:28:41 jjeff Exp $/** * @file * File which contains theme overrides for the Zen theme. *//* * ABOUT * * The template.php file is one of the most useful files when creating or modifying Drupal themes. * You can add new regions for block content, modify or override Drupal's theme functions, * intercept or make additional variables available to your theme, and create custom PHP logic. * For more information, please visit the Theme Developer's Guide on Drupal.org: * http://drupal.org/node/509 *//* * MODIFYING OR CREATING REGIONS * * Regions are areas in your theme where you can place blocks. * The default regions used in themes are "left sidebar", "right sidebar", "header", and "footer", although you can create * as many regions as you want. Once declared, they are made available to the page.tpl.php file as a variable. * For instance, use <?php print $header ?> for the placement of the "header" region in page.tpl.php. * * By going to the administer > site building > blocks page you can choose which regions various blocks should be placed. * New regions you define here will automatically show up in the drop-down list by their human readable name. *//* * Declare the available regions implemented by this engine. * * @return * An array of regions. The first array element will be used as the default region for themes. * Each array element takes the format: variable_name => t('human readable name') */function zen_regions() { return array( 'left' => t('left sidebar'), 'right' => t('right sidebar'), 'content_top' => t('content top'), 'content_bottom' => t('content bottom'), 'header' => t('header'), 'footer' => t('footer') );} /* * OVERRIDING THEME FUNCTIONS * * The Drupal theme system uses special theme functions to generate HTML output automatically. * Often we wish to customize this HTML output. To do this, we have to override the theme function. * You have to first find the theme function that generates the output, and then "catch" it and modify it here. * The easiest way to do it is to copy the original function in its entirety and paste it here, changing * the prefix from theme_ to zen_. For example: * * original: theme_breadcrumb() * theme override: zen_breadcrumb() * * See the following example. In this theme, we want to change all of the breadcrumb separator links from >> to :: * */ /** * Return a themed breadcrumb trail. * * @param $breadcrumb * An array containing the breadcrumb links. * @return a string containing the breadcrumb output. */ function zen_breadcrumb($breadcrumb) { if (!empty($breadcrumb)) { return '<div class="breadcrumb">'. implode(' :: ', $breadcrumb) .'</div>'; } }/* * CREATE OR MODIFY VARIABLES FOR YOUR THEME * * The most powerful function available to themers is the _phptemplate_variables() function. It allows you * to pass newly created variables to different template (tpl.php) files in your theme. Or even unset ones you don't want * to use. * * It works by switching on the hook, or name of the theme function, such as: * - page * - node * - comment * - block * * By switching on this hook you can send different variables to page.tpl.php file, node.tpl.php * (and any other derivative node template file, like node-forum.tpl.php), comment.tpl.php, and block.tpl.php * *//** * Intercept template variables * * @param $hook * The name of the theme function being executed * @param $vars * A sequential array of variables passed to the theme function. */function _phptemplate_variables($hook, $vars = array()) { switch ($hook) { // Send a new variable, $logged_in, to page.tpl.php to tell us if the current user is logged in or out. case 'page': // get the currently logged in user global $user; // An anonymous user has a user id of zero. if ($user->uid > 0) { // The user is logged in. $vars['logged_in'] = TRUE; } else { // The user has logged out. $vars['logged_in'] = FALSE; } $body_classes = array(); // classes for body element // allows advanced theming based on context (home page, node of certain type, etc.) $body_classes[] = ($vars['is_front']) ? 'front' : 'not-front'; $body_classes[] = ($vars['logged_in']) ? 'logged-in' : 'not-logged-in'; if ($vars['node']->type) { $body_classes[] = 'ntype-'. zen_id_safe($vars['node']->type); } switch (TRUE) { case $vars['sidebar_left'] && $vars['sidebar_right'] : $body_classes[] = 'both-sidebars'; break; case $vars['sidebar_left'] : $body_classes[] = 'sidebar-left'; break; case $vars['sidebar_right'] : $body_classes[] = 'sidebar-right'; break; } // implode with spaces $vars['body_classes'] = implode(' ', $body_classes); break; case 'node': // get the currently logged in user global $user; /* CUSTOM CHANGES START !! */ if ($vars['teaser']) { $vars['template_file'] = 'node-teaser'; } /* CUSTOM CHANGES END !! */ // set a new $is_admin variable // this is determined by looking at the currently logged in user and seeing if they are in the role 'admin' $vars['is_admin'] = in_array('admin', $user->roles); $node_classes = array('node'); if ($vars['sticky']) { $node_classes[] = 'sticky'; } if (!$vars['node']->status) { $node_classes[] = 'node-unpublished'; } $node_classes[] = 'ntype-'. zen_id_safe($vars['node']->type); // implode with spaces $vars['node_classes'] = implode(' ', $node_classes); break; case 'comment': // we load the node object that the current comment is attached to $node = node_load($vars['comment']->nid); // if the author of this comment is equal to the author of the node, we set a variable // then in our theme we can theme this comment differently to stand out $vars['author_comment'] = $vars['comment']->uid == $node->uid ? TRUE : FALSE; break; } return $vars;}/*** Converts a string to a suitable html ID attribute.* - Preceeds initial numeric with 'n' character.* - Replaces space and underscore with dash.* - Converts entire string to lowercase.* - Works for classes too!* * @param string $string* the string* @return* the converted string*/function zen_id_safe($string) { if (is_numeric($string{0})) { // if the first character is numeric, add 'n' in front $string = 'n'. $string; } return strtolower(preg_replace('/[^a-zA-Z0-9-]+/', '-', $string));}