Community Documentation

How to theme Nice Menus as table-based menus

Last updated October 7, 2012. Created by anithegregorian on December 23, 2008.
Edited by add1sun, GoddamnNoise, LeeHunter, xamount. Log in to edit this page.

NOTE: this is based on the 6.x-1.x version of Nice Menus. The 2.x version is quite different, so this example would need to be modified.

Wherever Drupal's theme() function is called, there is an opening to change the default theming. So for Nice Menus, just check out the source code of this module where we have these two functions:

function theme_nice_menu($id, $menu_name, $mlid, $direction = 'right', $menu = NULL)

and

function theme_nice_menu($id, $menu_name, $mlid, $direction = 'right', $menu = NULL)

We'll use them as our starting point. In whatever theme you're working on there's a template.php file designed specially for this kind of purpose. Open it up and insert the following two code segments:

/*
  NOTE: BEFORE YOU ACTUALLY DO THIS, PLEASE CLEAR ALL CACHES FROM YOUR DRUPAL SITE
  This is the point when Nice Menus renders a fully built tree menu to the $output variable
  We change it here to be wrapped inside a table instead of UL elements
*/
function YOURTHEMENAME_nice_menu($id, $menu_name, $mlid, $direction = 'right', $menu = NULL) {
  $output = array();
  if ($menu_tree = theme('nice_menu_tree', $menu_name, $mlid, $menu)) {
    if ($menu_tree['content']) {
      $output['content'] = '<table width="100%" class="site-menu"><tr>' .$menu_tree['content'] .'</tr></table>'."\n";
      $output['subject'] = $menu_tree['subject'];
    }
  }
  return $output;
}
}

The consequent theme function that actually builds the menu tree:

function YOURTHEMENAME_nice_menu_build($menu) {
  $output = '';
  global $is_child;
  foreach ($menu as $menu_item) {
    $mlid = $menu_item['link']['mlid'];
    // Check to see if it is a visible menu item.
    if ($menu_item['link']['hidden'] == 0) {
      // Build class name based on menu path e.g. to give each menu item individual style. Strip funny symbols.
      $clean_path = str_replace(array('http://', '<', '>', '&', '=', '?', ':'), '', $menu_item['link']['href']);
      // Convert slashes to dashes.
      $clean_path = str_replace('/', '-', $clean_path);
      $current_node = str_replace('node-', '', $clean_path);
      $path_class = 'menu-path-'. $clean_path;
      if ($current_node == $GLOBALS['active_node']) {
          $path_class.= ' active-content';
      }
      // If it has children build a nice little tree under it.
      if ((!empty($menu_item['link']['has_children'])) && (!empty($menu_item['below']))) {
        $is_child = true;
        // Keep passing children into the function 'til we get them all.
        $children = theme('nice_menu_build', $menu_item['below']);
        // Set the class to parent only of children are displayed.
        $parent_class = $children ? 'menuparent ' : '';
        if (isset($parent_class)):
          $output .= '<td id="menu-'. $mlid .'" class="'. $parent_class . $path_class .'">'. theme('menu_item_link', $menu_item['link']);
        else:
          $output .= '<li id="menu-'. $mlid .'" class="'. $parent_class . $path_class .'">'. theme('menu_item_link', $menu_item['link']);
        endif;
        // Build the child UL only if there is a child menu
        if ($children) {
          $output .= '<ul>';
          $output .= $children;
          $output .= "</ul>\n";
        }
        /* Notice that we have used <td> if we find a parent class otherwise it goes into <LI> elements. Here's why: All the parent menu items will be rendered inside table cells, so our idea is to create a menu system that can resize proportionally and horizontally to the browser's full width, the subsequent child elements can be placed into <UL><LI> elements which can be themed easily */
        if (isset($parent_class)):
          $output .= "</td>";
          //Adds some extra separators after each td
          $output .= '<td><span class="sep1"></span></td>'."\n";
        else:
          $output .= "</li>\n";
        endif;
      }
      else {
        if ($is_child == false) {
          $output .= '<td id="menu-'. $mlid .'" class="'. $path_class .'">'. theme('menu_item_link', $menu_item['link']) .'</td>'."\n";
          //Adds some extra separators after each td
          $output .= '<td><span class="sep1"></span></td>'."\n";
        }
        else
        {
          $output .= '<li id="menu-'. $mlid .'" class="'. $path_class .'">'. theme('menu_item_link', $menu_item['link']) .'</li>'."\n";
        }
      }
    }
  }
  $is_child = false;
  return $output;
}

And there you have it. The output will be a table-based menu. To read the full article with code and examples, see:

http://www.ravendevelopers.com/blog/2008/12/how-theme-nice-menus-table-b...

Comments

working, cleaned and full tree

Thanks for the idea and codes.
Here is the working, cleaned and full tree support.
Main menu goes inside of td, other elements in ul->li. Supports unlimited branches

function analytic_nice_menu_build($menu, $main_menu=true) {
  $output = '';
  foreach ($menu as $menu_item) {
    $mlid = $menu_item['link']['mlid'];
    // Check to see if it is a visible menu item.
    if ($menu_item['link']['hidden'] != 0)
      continue;
    $clean_path = str_replace(array('http://', '<', '>', '&', '=', '?', ':'), '', $menu_item['link']['href']); //Strip  symbols.
    // Convert slashes to dashes.
    $clean_path = str_replace('/', '-', $clean_path);
    $current_node = str_replace('node-', '', $clean_path);
    $path_class = 'menu-path-'. $clean_path;
    if ($current_node == $GLOBALS['active_node']) {
      $path_class.= ' active-content';
    }
    $children = '';
    // If it has children build a nice little tree under it.
    if ((!empty($menu_item['link']['has_children'])) && (!empty($menu_item['below']))) {
      $is_child = true; // Keep passing children into the function 'til we get them all.
      $children = theme('nice_menu_build', $menu_item['below'], false);
      $children = ($children)?"<ul>$children</ul>\n":'';
      // Set the class to parent only of children are displayed.
      $parent_class = $children ? 'menuparent ' : '';
    }
   
    // Build the child UL only if there is a child menu
    if($main_menu){
      $output .= "<td id='menu-$mlid' class='{$parent_class}{$path_class}'>".theme('menu_item_link', $menu_item['link'])."$children</td>";
      //Adds some extra separators after each td
      $output .= "<td><span class='sep1'></span></td>\n";
    }else {
      $output .= "<li id='menu-$mlid' class='{$parent_class}{$path_class}'>".theme('menu_item_link', $menu_item['link'])."$children</li>";
      }
  }
  return $output;
}

function analytic_nice_menu($id, $menu_name, $mlid, $direction = 'right', $menu = NULL) {
  $output = array();
  if ($menu_tree = theme('nice_menu_tree', $menu_name, $mlid, $menu)) {
    if ($menu_tree['content']) {
      $output['content'] = '<table width="100%" class="site-menu"><tr>' .$menu_tree['content'] .'</tr></table>'."\n";
      $output['subject'] = $menu_tree['subject'];
    }
  }
  return $output;
}

D7 theming documentation?

Any idea how to achieve this on D7?

nobody click here