Open-source, free PHP breadcrumb link script

Last night, I was working on the new Simpli website. The designers who did the website had a Javascript that created breadcrumbs at the top of each page (you know, those links that say Home > Section Name > Page Name). I thought it was really silly to do that in Javascript; plus, the code was hard to modify and had a bug in it that was difficult to fix since the variables were named (I am serious) a, b, foo, and bar. Ugh!

I searched and found this free PHP breadcrumb script, but it didn’t do some things that I wanted — namely, if the visitor is on the index page of a section, it shouldn’t link that section name (since the link would be to the same page the visitor is already on.) Also, I wanted the final breadcrumb to be the page name if the page wasn’t an index page (for instance: Simpli Hosting > About Us > Our Datacenter, instead of Simpli Hosting > About Us for the Our Datacenter page.) That script didn’t offer that.

Also, even though I had “convert underlines in page filenames to spaces” and “uppercase the first letter of every word” enabled, they didn’t actually work. So I fixed that too.

Since the original author released the PHP breadcrumb script free of charge, I will release my modifications free of charge, and document my modifications below.

Here is the script: breadcrumbs.phps

You use it simply by including it in the page, and it will output the breadcrumb based on the directory structure of your site. For instance, a directory structure of http://www.simpli.biz/FAQ/Colocation_FAQ.php will generate:

Simpli Hosting » FAQ » Colocation FAQ

Change the $topLevelName and $separator variables to change the text in the first part of the breadcrumb (in this case, “Simpli Hosting”) and the separator between each breadcrumb (in this case, ».)

The key here is that if you’re on the page http://www.simpli.biz/FAQ/index.php, it won’t print “index” and it won’t link “FAQ”. However, if you’re on http://www.simpli.biz/FAQ/Colocation_FAQ.php, it will link FAQ to http://www.simpli.biz/FAQ/index.php.

This script does assume index.php is your directory index in every directory, and it does convert underscores in pages to spaces and uppercase the first letter of every word in the breadcrumb. If you don’t want it to do this, you can comment out the lines in the code that do that. See if you can figure out which lines do that.

This script is free to download, free to use (public domain), but there is no support. If it works for you, great! If not, hack it till it does. 😉

One catch: My modifications use $_SERVER. If you use $HTTP_SERVER_VARS, you will need to global $server and change $_SERVER to $server in the MPBCDirIndex function.