Breadcrumb NavXT.
Version: 1.5.0
Author: John Havlik
Author URI: http://mtekk.us/
*/
/* Copyright 2011 John Havlik (email : mtekkmonkey@gmail.com)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
if(class_exists('bcn_admin'))
{
class breadcrumb_trail_multidim extends bcn_breadcrumb_trail
{
//Default constructor
function __construct()
{
//Need to make sure we call the constructor of bcn_breadcrumb_trail
parent::__construct();
}
/**
* A Breadcrumb Trail Filling Function
*
* This recursive functions fills the trail with breadcrumbs for parent terms.
* @param int $id The id of the term.
* @param string $taxonomy The name of the taxonomy that the term belongs to
* @TODO Evaluate if we need to do tax_ for a prefix
*/
function term_parents($id, $taxonomy)
{
global $post;
//Get the current category object, filter applied within this call
$term = &get_term($id, $taxonomy);
$suffix = '' . wp_list_categories('depth=1&parent=' . $term->parent . '&exclude=' . $id . '&echo=0&taxonomy=' . $taxonomy . '&title_li=') . '
';
//Hide empty enteries
if($suffix === '')
{
$suffix = '';
}
//Place the breadcrumb in the trail, uses the constructor to set the title, template, and type, get a pointer to it in return
$breadcrumb = $this->add(new bcn_breadcrumb($term->name, $this->opt['H' . $taxonomy . '_template'] . $suffix, array($taxonomy), get_term_link($term, $taxonomy)));
//Make sure the id is valid, and that we won't end up spinning in a loop
if($term->parent && $term->parent != $id)
{
//Figure out the rest of the term hiearchy via recursion
$this->term_parents($term->parent, $taxonomy);
}
}
/**
* A Breadcrumb Trail Filling Function
*
* This function fills a breadcrumb for any taxonomy archive, was previously two separate functions. Was modified to output a list of related level terms.
*
*/
function do_archive_by_term()
{
global $wp_query;
//Simmilar to using $post, but for things $post doesn't cover
$term = $wp_query->get_queried_object();
$suffix = '' . wp_list_categories('depth=1&parent=' . $term->parent . '&exclude=' . $term->term_id . '&echo=0&taxonomy=' . $term->taxonomy . '&title_li=') . '
';
//Hide empty enteries
if($suffix === '')
{
$suffix = '';
}
//Run through a filter for good measure
$term->name = apply_filters('get_' . $term->taxonomy, $term->name);
//Place the breadcrumb in the trail, uses the constructor to set the title, template, and type, get a pointer to it in return
$breadcrumb = $this->add(new bcn_breadcrumb($term->name, $this->opt['H' . $term->taxonomy . '_template_no_anchor'] . $suffix, array($term->taxonomy, 'current-item')));
//If we're paged, let's link to the first page
if($this->opt['bcurrent_item_linked'] || (is_paged() && $this->opt['bpaged_display']))
{
$breadcrumb->set_template($this->opt['H' . $term->taxonomy . '_template'] . $suffix);
//Figure out the anchor for current category
$breadcrumb->set_url(get_term_link($term, $term->taxonomy));
}
//Get parents of current category
if($term->parent)
{
$this->term_parents($term->parent, $term->taxonomy);
}
}
/**
* A Breadcrumb Trail Filling Function
*
* This recursive functions fills the trail with breadcrumbs for parent posts/pages.
* @param int $id The id of the parent page.
* @param int $frontpage The id of the front page.
*/
function post_parents($id, $frontpage)
{
//Use WordPress API, though a bit heavier than the old method, this will ensure compatibility with other plug-ins
$parent = get_post($id);
$suffix = '' . wp_list_pages('depth=1&child_of=' . $parent->post_parent . '&exclude=' . $parent->ID . '&echo=0&title_li=') . '
';
//Hide empty enteries
if($suffix === '')
{
$suffix = '';
}
//Place the breadcrumb in the trail, uses the constructor to set the title, template, and type, get a pointer to it in return
$breadcrumb = $this->add(new bcn_breadcrumb(get_the_title($id), $this->opt['Hpost_' . $parent->post_type . '_template'] . $suffix, array($parent->post_type), get_permalink($id)));
//Make sure the id is valid, and that we won't end up spinning in a loop
if($parent->post_parent >= 0 && $parent->post_parent != false && $id != $parent->post_parent && $frontpage != $parent->post_parent)
{
//If valid, recursively call this function
$this->post_parents($parent->post_parent, $frontpage);
}
}
/**
* A Breadcrumb Trail Filling Function
*
* This functions fills a breadcrumb for posts
*
*/
function do_post()
{
global $post, $page;
$suffix = '';
if(is_post_type_hierarchical($post->post_type))
{
$suffix = '' . wp_list_pages('depth=1&child_of=' . $post->post_parent . '&exclude=' . $post->ID . '&echo=0&title_li=') . '
';
//Hide empty enteries
if($suffix === '')
{
$suffix = '';
}
}
//Place the breadcrumb in the trail, uses the bcn_breadcrumb constructor to set the title, template, and type
$breadcrumb = $this->add(new bcn_breadcrumb(get_the_title(), $this->opt['Hpost_' . $post->post_type . '_template_no_anchor'] . $suffix, array('post-' . $post->post_type, 'current-item')));
//If the current item is to be linked, or this is a paged post, add in links
if($this->opt['bcurrent_item_linked'] || ($page > 0 && $this->opt['bpaged_display']))
{
//Change the template over to the normal, linked one
$breadcrumb->set_template($this->opt['Hpost_' . $post->post_type . '_template']);
//Add the link
$breadcrumb->set_url(get_permalink());
}
//If we have a hiearchical post, go through the parent tree
if(is_post_type_hierarchical($post->post_type))
{
//Done with the current item, now on to the parents
$frontpage = get_option('page_on_front');
//If there is a parent page let's find it
if($post->post_parent && $post->ID != $post->post_parent && $frontpage != $post->post_parent)
{
$this->post_parents($post->post_parent, $frontpage);
}
else if(!$this->is_builtin($post->post_type))
{
//Handle the post's taxonomy
$this->post_taxonomy($post->ID, $post->post_type, $post->post_parent);
}
}
//Otherwise we need the follow the taxonomy tree
else
{
//Handle the post's taxonomy
$this->post_taxonomy($post->ID, $post->post_type, $post->post_parent);
}
}
}
/**
* Outputs the breadcrumb trail
*
* @param (bool) $return Whether to return or echo the trail.
* @param (bool) $linked Whether to allow hyperlinks in the trail or not.
* @param (bool) $reverse Whether to reverse the output or not.
*/
function bcn_display_list_multidim($return = false, $linked = true, $reverse = false)
{
//Make new instance of the ext_breadcrumb_trail object
$breadcrumb_trail = new breadcrumb_trail_multidim();
//Grab options from the database
$breadcrumb_trail->opt = get_option('bcn_options');
//Fill the breadcrumb trail
$breadcrumb_trail->fill();
//Display the trail
return $breadcrumb_trail->display_list($return, $linked, $reverse);
}
}