Tertiary menu in Drupal 6

Tertiary menu in Drupal 6


By default, Drupal allows you to set a "primary" menu and a "secondary" menu. At this point you should know that if you go to admin-> menus -> settings and pick the same menu for both primary and secondary links, the secondary links menu will contain the sub-menu of the selected item in the primary menu.

What happens if you have three levels of menus?

Problem: the lack of a tertiary menu

What happens if you have three levels of menus? For example, what happens if your menu looks like this:

  • One
    • One one
    • --One one A
    • --One one B
    • --One one C
    • One two
    • --One two A
    • --One two B
    • One three
    • --One three A
    • --One three B
  • Two
    • Two one
    • --Two one A
    • --Two one B

...ecc.? PHPTemplate will create a two nice variables for you, $primary_links and secondary_links. Also, $secondary_links will contain the "right" entries if you set the primary menu and the secondary menu the same. What about $tertiary_links? Nowhere to be seen.

Searching for a solution

If you search the forums about this topic, you will find the most diverse solutions. They all take considerable efforts. The first question you want to ask is: how does the template generate those links? If you look at themes/engines/phptemplate/phptemplate.engine, and look for the string primary_links, you will find:

'primary_links'       => menu_primary_links(),
...
'secondary_links'     => menu_secondary_links(),

If you search Drupal's codebase for those functions:

# grep -il menu_primary_links `find .`
./includes/menu.inc
./themes/chameleon/chameleon.theme
./themes/engines/phptemplate/phptemplate.engine
./themes/engines/phptemplate/.svn/text-base/phptemplate.engine.svn-base
#

Ah! Menu.inc seems to be the way to go. The first function you find is:

/**
 * Returns an array containing the primary links.
 * Can optionally descend from the root of the Primary links menu towards the
 * current node for a specified number of levels and return that submenu.
 * Used to generate a primary/secondary menu from different levels of one menu.
[...]
function menu_primary_links($start_level = 1, $pid = 0) {

This is probably a little complex for a non-programmer. However, menu_secondary_links() really gives everything away:

/**
 * Returns an array containing the secondary links.
 * Secondary links can be either a second level of the Primary links
 * menu or generated from their own menu.
 */
function menu_secondary_links() {
  $msm = variable_get('menu_secondary_menu', 0);
  if ($msm == 0) {
    return NULL;
  }

  if ($msm == variable_get('menu_primary_menu', 0)) {
    return menu_primary_links(2, $msm);
  }

  return menu_primary_links(1, $msm);
}

The second if is obviously checking if primary and secondary links come from the same menu. If they are, then it just prints them out.

So, you can assume that this:

menu_primary_links(3, variable_get('menu_primary_menu', 0) );

Will return the "tertiary" menu!

The last piece of the puzzle is the rendering. FOr that, just see what any theme does:

<?php print theme('links', $primary_links, array('class' => 'links primary-links')) ?>

The solution

At this point, the solution should be clear. Just type:

$m=menu_primary_links(3, variable_get('menu_primary_menu', 0) );
print theme('links', $m, array('class' => 'links tertiary-links'));

Anywhere, and you will get your "tertiary links"! You can place this code in a block, or in the template directly.

Troubleshooting

  • Make sure that the secondary menus are "expanded"
  • Make sure you have <?php and ?> around the code
Category: 
Tagging: 

Comments

xiffy's picture
Submitted by xiffy on

Thanks for the clear explanation. Unfortunatly, every new drupal version needs revision of almost any hacks. No exception for this one.
To get the tertiary links in Drupal 6 you would do
$m = menu_navigation_links(variable_get('menu_primary_links_source', 'primary-links'), 2);
because menu_primay_links() has lost it's footprint in Drupal 6
hth

theneemies@drupal.org's picture

This site looks like a great Drupal implementation - have you considered submitting a case study for drupal.org?

Also, a usability tip - if you're posting code http://drupal.org/project/geshifilter might be of use.

dener's picture
Submitted by dener on

tnx for the explanation. But I've encountered the following problem; the script seems to place the entire tertiary menu under the secondary instead of placing it in between the chosen menu-items. anyone any idea what might be the reason?

Author information

Tony Mobily's picture

Biography

Tony is the founder and the Editor In Chief of Free Software Magazine

Most forwarded

Interview with Dave Mohyla, of DTIDATA

Dave Mohyla is the president and founder of dtidata.com, a hard drive recovery facility based in Tampa, Florida.

TM: Where are you based? What does your company do?
DTI Data recovery is based in South Pasadena, Florida which is a suburb of Tampa. We have been here for over 10 years. We operate a bio-metrically secured class 100 clean room where we perform hard drive recovery on all types of hard disks, from laptop hard drives to multi drive RAID systems.

Anybody up to writing good directory software?

Since the very beginning, directories (of any kind) have had a very central role in the internet. (I have recently grown fond of Free Web Directory. Even Slashdot can be considered a directory: a collection of great news and invaluable user-generated comments. As far as software is concerned, doing a quick search on Google about software directories will return the free (as in freedom) software directories like Savannah, SourceForge, Freshmeat and so on, followed by shareware and freeware sites such as FileBuzz, PCWin Download Center and All Freeware (great if you're looking for shareware and freeware, but definitely less comprehensive than their free-as-in-freedom counterparts).

Interview with Mark Shuttleworth

Mark Shuttleworth is the founder of Thawte, the first Certification Authority to sell public SSL certificates. After selling Thawte to Verisign, Mark moved on to training as an astronaut in Russia and visiting space. Once he got back he founded Ubuntu, the leading GNU/Linux distribution. He agreed on releasing a quick interview to Free Software Magazine.

Is better education the key to finding better software?

I read David Jonathon's article Anybody Up To Writing Good Directory Software? the other day, which got me thinking about software directories in general. As David mentioned, many of the software directories one finds when doing a quick google search are free as in beer, not as in freedom. But what interests me is the software directories that already exist, providing a combination of both free as in beer software, and open source software. Sites such as Freeware Downloads and Shareware Download don't advertise themselves as providing free as in liberty software, but each of them have a good selection of open source software available... if you know where to look.

Most emailed

Free Open Document label templates

If you’ve ever spent hours at work doing mailings, cursed your printer for printing outside the lines on your labels, or moaned “There has got to be a better way to do this,” here’s the solution you’ve been looking for. Working smarter, not harder! Worldlabel.com, a manufacture of labels offers Open Office / Libre Office labels templates for downloading in ODF format which will save you time, effort, and (if you want) make really cool-looking labels

Creating a user-centric site in Drupal

A little while ago, while talking in the #drupal mailing list, I showed my latest creation to one of the core developers there. His reaction was "Wow, I am always surprised what people use Drupal for". His surprise is somehow justified: I did create a site for a bunch of entertainers in Perth, a company set to use Drupal to take over the world with Entertainers.Biz.

Update: since writing this article, I have updated the system so that the whole booking process happens online. I will update the article accordingly!

So, why, why do people and companies develop free software?

More and more people are discovering free software. Many people only do so after weeks, or even months, of using it. I wonder, for example, how many Firefox users actually know how free Firefox really is—many of them realise that you can get it for free, but find it hard to believe that anybody can modify it and even redistribute it legally.

When the discovery is made, the first instinct is to ask: why do they do it? Programming is hard work. Even though most (if not all) programmers are driven by their higher-than-normal IQs and their amazing passion for solving problems, it’s still hard to understand why so many of them would donate so much of their time to creating something that they can’t really show off to anybody but their colleagues or geek friends.

Sure, anybody can buy laptops, and just program. No need to get a full-on lab or spend thousands of dollars in equipment. But... is that the full story?

Fun articles

Santa Claus - the most successful open source project

It dawned on me the other day, as I was shopping for the dozens of gifts it seems I have to buy every December, that Santa Claus is the most successful open source project in history. (Bridget @ Illiterarty would agree with that). Santa Claus is essentially a marketing development that is embodied by everyone who stuffs a sock, gives a gift, hosts a dinner or wishes Merry Christmas over the holiday season.

Most emailed

Editorial

When I first started thinking about Free Software Magazine, I was feeling enthusiastic about the dream. I had Dave, Gianluca, and Alan willing to help me, I had established members of the free software community willing to help me out, I had writers volunteering their time and energy for free, and I had a generous offer from OpenHosting for servers, all before I'd proved myself. There was a sense of excitement in the air, and I thought maybe, just maybe, I could make this work.

Free Software Magazine uses Apollo project management software and CRM for its everyday activities!