devot:eeDevoted to ExpressionEngine

Breadcrumbs from url

ExpressionEngine 2.x (not tested on earlier version) breadcrumb navigational menu.  This menu allows you to create breadcrumbs without having to do any of the work.  This plugin uses the url you are on, excluding your site name, to display each navigational section to your end user.

Features

 
• Allows wrapping of each item in tags of your choosing (div,span, or lists)
 
• Has support for making all your breadcrumbs uppercase, lowercase, or just capitalizing the first letter
 
• Supports the addition of classes for easy styling
 
• Let’s you specify what you would like to see between the breadcrumbs
 
• Creates a way to replace index.php in your url when displayed on the page (great for development
 
• Gives the option to replace any segment with the word you prefer

Usage

1. exp:breadcrumb:urls - Puts urls on page with associated links.

Basic Usage:

{exp:breadcrumb:urls}
          example:  if your url is yoursite.com/dev/index.php/employment/employment-application, breadcrumbs would be
          dev >> index.php >> employment >> employment-application


2. exp:breadcrumb:urls split=”->”  - split will put whatever characters you desire between the links. Default is “»”. The dividers are wrapped in span tags for easier styling.

{exp:breadcrumb:urls split=”->”}
          produces
          yourpage -> employment -> employment-application


3. exp:breadcrumb:urls replace=“Home”  - will replace “index.php” with whatever word you want it to say (this is for whoever has index.php still in the url)

          changes:
          dev -> index.php -> employment -> employment-application
         
          to:
            dev -> Home -> employment -> employment-application
         
  4. exp:breadcrumb:urls type=“upper”  - types: upper,lower,words | pretty self explanatory, upper = uppercase, lower = lowercase and words caps first letter

          type=“words” changes:
          dev -> index.php -> employment -> employment-application
         
          to:
            Dev -> Home -> Employment -> Employment-application
           
5. exp:breadcrumb:urls tag=“list”  - tags: list,div,span
         
          tag=“list” changes:
         
          dev -> index.php -> employment -> employment-application
         

to:
                <ul>
                <li>dev</li>
                <li>index</li>
                <li>employment</li>
                <li>employment-application</li>
                </ul>
 

       
         
  6. exp:breadcrumb:urls class=“yourclass”  - class adds the class you want to the div, ul, or span tags so you’re able to style the links individually
         
          tag=“list” changes:
         
          dev -> index.php -> employment -> employment-application
           
  7. exp:breadcrumb:urls change"old|new,old1|new1” - change allows you to change the value of certain segments. For Example:
   
    change=“dev|develop,employment|employee”
     
      dev -> index.php -> employment -> employment-application
     
      changes to:
     
      develop -> index.php -> employee -> employment-application
       
       
          1.0 - initial release
          1.1.1 - fixed replace bug that changed the url instead of the segment, added change parameter
          Questions: nick@nicholascheek.com              
       
  Complete options
          {exp:breadcrumb:urls change=“old|new” split=”.” replace=“Home” type=“words” tag=“div” class=“testing”}

Installation

Place the breadcrumbs folder inside your ExpressionEngine third party folder