This is a WordPress plugin. Official download available on wordpress.org.

Menu Breadcrumb

Generate a breadcrumb trail from a WordPress Menu

Description

Breadcrumbs are often generated from Page structure, but in a world of Custom Post Types that doesn't always work. Menu Breadcrumb uses your WordPress Menu to generate a breadcrumb trail based on the current page.

Installation

1. Download the plugin and extract the files
2. Upload menu-breadcrumb to your ~/wp-content/plugins/ directory
3. Activate the plugin through the 'Plugins' menu in WordPress

Usage

After activating, add breadcrumbs by inserting the following in you template file:

<?php if ( function_exists( 'menu_breadcrumb') ) { menu_breadcrumb( 'main' ); } ?>

where 'main' is the Location of the Menu from which you want to generate the breadcrumb trail.

Full usage (all arguments)

<?php 
    if ( function_exists( 'menu_breadcrumb') ) { 
        menu_breadcrumb( 
            'main',                             // Menu Location to use for breadcrumb
            ' &raquo; ',                        // separator between each breadcrumb
            '<p class="menu-breadcrumb">',      // output before the breadcrumb
            '</p>'                              // output after the breadcrumb
        ); 
    } 
?>

Advanced Usage

If you would like to utilize Menu Breadcrumb more granularly you can use the class directly.

Mimic menu_breadcrumb()

<?php
    $menu_breadcrumb = new Menu_Breadcrumb( 'main' );   // 'main' is the Menu Location
    $menu_breadcrumb->render( ' &raquo; ', '<p class="menu-breadcrumb">', '</p>' );

Generate a breadcrumb array

<?php
    $menu_breadcrumb = new Menu_Breadcrumb( 'main' );   // 'main' is the Menu Location
    $breadcrumb_array = $menu_breadcrumb->generate_trail();
    print_r( $breadcrumb_array ); // array of WP_Post objects in order of breadcrumb

Generate breadcrumb markup from breadcrumb array

<?php
    $menu_breadcrumb = new Menu_Breadcrumb( 'main' );   // 'main' is the Menu Location
    $breadcrumb_array = $menu_breadcrumb->generate_trail();
    $breadcrumb_markup = $menu_breadcrumb->generate_markup( $breadcrumb_array, ' &raquo; ' );
    echo '<p class="menu-breadcrumb">' . $breadcrumb_markup . '</p>';

Get current Menu item (of the page currently being viewed)

<?php
    $menu_breadcrumb = new Menu_Breadcrumb( 'main' );   // 'main' is the Menu Location
    $current_menu_item_object = $menu_breadcrumb->get_current_menu_item_object();

Hooks

menu_breadcrumb_item_markup

Filter each breadcrumb item. By default Menu Breadcrumb will wrap each item as follows:

<span typeof="v:Breadcrumb"><a href="https://github.com/jchristopher/menu-breadcrumb/blob/master/{Menu Item URL}">{Menu Item Title}</a></span>

If you would like to disable that, you can remove all filters before adding your own:

<?php
    // remove core Menu Breadcrumb item markup filter
    remove_all_filters( 'menu_breadcrumb_item_markup' );

    // add my own Menu Breadcrumb item filter
    function my_menu_breadcrumb_item_markup( $markup, $breadcrumb ) {
        // $markup is in the format of <a href="https://github.com/jchristopher/menu-breadcrumb/blob/master/{Menu Item URL}">{Menu Item Title}</a>
        // $breadcrumb is the Menu item object itself
        return '<span class="breadcrumb-item">' . $markup . '</span>';
    }
    add_filter( 'menu_breadcrumb_item_markup', 'my_menu_breadcrumb_item_markup', 10, 2 );

menu_breadcrumb_markup

Filter the entire breadcrumb markup before it is returned. By default it is wrapped as follows:

<span prefix="v: http://rdf.data-vocabulary.org/#">{Markup for all breadcrumbs after they have been filtered}</span>

If you would like to disable that, you can remove all filters before adding your own:

<?php
    // remove core Menu Breadcrumb markup filter
    remove_all_filters( 'menu_breadcrumb_markup' );

    // add my own Menu Breadcrumb markup filter
    function my_menu_breadcrumb_markup( $markup ) {
        return '<p class="my-breadcrumbs">' . $markup . '</p>';
    }
    add_filter( 'menu_breadcrumb_markup', 'my_menu_breadcrumb_markup' );

Changelog

1.0.2

Added a menu_breadcrumb_level property to each breadcrumb object

1.0.1

Fixed an issue where the Menu wasn't properly retrieved from the location

1.0.0

Initial release