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.
Like this entry? You will love getting my free business tips! No spam, and I won't give your email address to any other company.






24. June 2007 at 6:51 pm
Have I ever told you that I find girls who can code really hott?
24. June 2007 at 9:13 pm
You know, normally I would delete those sorts of comments, but since you are a friend I’ll just say “Thank you.”
6. July 2007 at 3:58 pm
Ya, don’t use globals! A good developer always knows the origin of every variables’ data.
13. December 2007 at 11:47 am
Hi Erica,
Thanks for the breadcrumb code. Is there a way to use the page title instead of the filename as the last crumb?
Thanks!
Elizabeth
19. February 2009 at 10:11 pm
Hi Erica,
Great script! Being a designer who’s only just starting to look at how to write ‘hello world’ type PHP scripts I would have had no idea how to go about building this thing.
… And of the variety of PHP breadcrumb scripts I’ve previously found on the net and tried out your above modification has been the most successful. It’s features were exactly what I was looking for.
Thanks again!
9. August 2009 at 12:16 pm
If you are looking for other free open source scripts, here is the link
http://www.freeopensourcescripts.com