/** * The code below is inspired by Justin Tadlock's Hybrid Core. * * woo_breadcrumbs() shows a breadcrumb for all types of pages. Themes and plugins can filter $args or input directly. * Allow filtering of only the $args using get_the_breadcrumb_args. * * @since 3.7.0 * @param array $args Mixed arguments for the menu. * @return string Output of the breadcrumb menu. */ function woo_breadcrumbs($args = array()) { global $wp_query, $wp_rewrite; /* Create an empty variable for the breadcrumb. */ $breadcrumb = ''; /* Create an empty array for the trail. */ $trail = array(); $path = ''; /* Set up the default arguments for the breadcrumb. */ $defaults = array('separator' => '›', 'before' => '<span class="breadcrumb-title">' . __('You are here:', 'woothemes') . '</span>', 'after' => false, 'front_page' => true, 'show_home' => __('Home', 'woothemes'), 'echo' => true, 'show_posts_page' => true, 'show_only_first_taxonomy_tree' => false); /* Allow singular post views to have a taxonomy's terms prefixing the trail. */ if (is_singular()) { $defaults["singular_{$wp_query->post->post_type}_taxonomy"] = false; } /* Apply filters to the arguments. */ $args = apply_filters('woo_breadcrumbs_args', $args); /* Parse the arguments and extract them for easy variable naming. */ extract(wp_parse_args($args, $defaults)); /* If $show_home is set and we're not on the front page of the site, link to the home page. */ if (!is_front_page() && $show_home) { $trail[] = '<a href="' . esc_url(home_url()) . '" title="' . esc_attr(get_bloginfo('name')) . '" rel="home" class="trail-begin">' . esc_html($show_home) . '</a>'; } /* If viewing the front page of the site. */ if (is_front_page()) { if (!$front_page) { $trail = false; } elseif ($show_home) { $trail['trail_end'] = "{$show_home}"; } } elseif (is_home()) { $home_page = get_page($wp_query->get_queried_object_id()); $trail = array_merge($trail, woo_breadcrumbs_get_parents($home_page->post_parent, '')); $trail['trail_end'] = get_the_title($home_page->ID); } elseif (is_singular()) { /* Get singular post variables needed. */ $post = $wp_query->get_queried_object(); $post_id = absint($wp_query->get_queried_object_id()); $post_type = $post->post_type; $parent = $post->post_parent; $post_type_object = get_post_type_object($post_type); /* If an attachment, check if there are any pages in its hierarchy based on the slug. */ if ('attachment' == $post_type) { /* If $front has been set, add it to the $path. */ if ($post_type_object->rewrite['with_front'] && $wp_rewrite->front) { $path .= trailingslashit($wp_rewrite->front); } /* If there's a slug, add it to the $path. */ if (!empty($post_type_object->rewrite['slug'])) { $path .= $post_type_object->rewrite['slug']; } /* If there's a path, check for parents. */ if (!empty($path) && '/' != $path) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } } /* If there's an archive page, add it to the trail. */ if (!empty($post_type_object->has_archive)) { $trail['post_type_archive_link'] = '<a href="' . get_post_type_archive_link($post_type) . '" title="' . esc_attr($post_type_object->labels->name) . '">' . esc_html($post_type_object->labels->name) . '</a>'; } /* If the post type path returns nothing and there is a parent, get its parents. */ if (empty($path) && 0 !== $parent || 'attachment' == $post_type) { $trail = array_merge($trail, woo_breadcrumbs_get_parents($parent, '')); } /* Toggle the display of the posts page on single blog posts. */ if ('post' == $post_type && $show_posts_page == true && 'page' == get_option('show_on_front')) { $posts_page = get_option('page_for_posts'); if ($posts_page != '' && is_numeric($posts_page)) { $trail = array_merge($trail, woo_breadcrumbs_get_parents($posts_page, '')); } } /* Display terms for specific post type taxonomy if requested. */ if (isset($args["singular_{$post_type}_taxonomy"]) && $post_type != 'page') { $raw_terms = get_the_terms($post_id, $args["singular_{$post_type}_taxonomy"]); if (is_array($raw_terms) && 0 < count($raw_terms) && !is_wp_error($raw_terms)) { $links = array(); $count = 0; $sorted = $raw_terms; $terms_by_ancestor = array(); foreach ($raw_terms as $k => $v) { $ancestors = array_reverse(get_ancestors($v->term_id, $args["singular_{$post_type}_taxonomy"])); if (isset($ancestors[0])) { $key = $ancestors[0]; } else { $key = $v->term_id; } $terms_by_ancestor[$key][$v->term_id] = get_term_by('term_id', $v->term_id, $args["singular_{$post_type}_taxonomy"]); } if (0 < count($terms_by_ancestor)) { $sorted = array(); foreach ($terms_by_ancestor as $k => $v) { if (0 < count($v)) { foreach ($v as $i => $j) { $sorted[$i] = $j; } } } foreach ($sorted as $k => $v) { if (isset($sorted[$v->parent])) { unset($sorted[$v->parent]); } } } foreach ($sorted as $k => $v) { $count++; if (isset($args['show_only_first_taxonomy_tree']) && true == (bool) $args['show_only_first_taxonomy_tree'] && 1 < $count) { continue; } // Display only the first match. $parents = woo_get_term_parents($v->term_id, $args["singular_{$post_type}_taxonomy"], true, '|-|', $v->name, array()); if ($parents != '' && !is_wp_error($parents)) { $parents_arr = explode('|-|', $parents); foreach ($parents_arr as $p) { if ($p != '' && !in_array($p, $links)) { $links[] = $p; } } } } if (0 < count($links)) { foreach ($links as $k => $v) { $trail[] = $v; } } } } /* End with the post title. */ $post_title = get_the_title($post_id); // Force the post_id to make sure we get the correct page title. if (!empty($post_title)) { $trail['trail_end'] = $post_title; } } elseif (is_archive()) { /* If viewing a taxonomy term archive. */ if (is_tax() || is_category() || is_tag()) { /* Get some taxonomy and term variables. */ $term = $wp_query->get_queried_object(); $taxonomy = get_taxonomy($term->taxonomy); /* Get the path to the term archive. Use this to determine if a page is present with it. */ if (is_category()) { $path = get_option('category_base'); } elseif (is_tag()) { $path = get_option('tag_base'); } else { if ($taxonomy->rewrite['with_front'] && $wp_rewrite->front) { $path = trailingslashit($wp_rewrite->front); } $path .= $taxonomy->rewrite['slug']; } /* Get parent pages by path if they exist. */ if ($path) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } /* If the taxonomy is hierarchical, list its parent terms. */ if (is_taxonomy_hierarchical($term->taxonomy) && $term->parent) { $trail = array_merge($trail, woo_breadcrumbs_get_term_parents($term->parent, $term->taxonomy)); } /* Add the term name to the trail end. */ $trail['trail_end'] = $term->name; } elseif (is_post_type_archive()) { /* Get the post type object. */ $post_type_object = get_post_type_object(get_query_var('post_type')); /* If $front has been set, add it to the $path. */ if ($post_type_object->rewrite['with_front'] && $wp_rewrite->front) { $path .= trailingslashit($wp_rewrite->front); } /* If there's a slug, add it to the $path. */ if (!empty($post_type_object->rewrite['archive'])) { $path .= $post_type_object->rewrite['archive']; } /* If there's a path, check for parents. */ if (!empty($path) && '/' != $path) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } /* Add the post type [plural] name to the trail end. */ $trail['trail_end'] = $post_type_object->labels->name; } elseif (is_author()) { /* If $front has been set, add it to $path. */ if (!empty($wp_rewrite->front)) { $path .= trailingslashit($wp_rewrite->front); } /* If an $author_base exists, add it to $path. */ if (!empty($wp_rewrite->author_base)) { $path .= $wp_rewrite->author_base; } /* If $path exists, check for parent pages. */ if (!empty($path)) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } /* Add the author's display name to the trail end. */ $trail['trail_end'] = get_the_author_meta('display_name', get_query_var('author')); } elseif (is_time()) { if (get_query_var('minute') && get_query_var('hour')) { $trail['trail_end'] = get_the_time(__('g:i a', 'woothemes')); } elseif (get_query_var('minute')) { $trail['trail_end'] = sprintf(__('Minute %1$s', 'woothemes'), get_the_time(__('i', 'woothemes'))); } elseif (get_query_var('hour')) { $trail['trail_end'] = get_the_time(__('g a', 'woothemes')); } } elseif (is_date()) { /* If $front has been set, check for parent pages. */ if ($wp_rewrite->front) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $wp_rewrite->front)); } if (is_day()) { $trail[] = '<a href="' . get_year_link(get_the_time('Y')) . '" title="' . get_the_time(esc_attr__('Y', 'woothemes')) . '">' . get_the_time(__('Y', 'woothemes')) . '</a>'; $trail[] = '<a href="' . get_month_link(get_the_time('Y'), get_the_time('m')) . '" title="' . get_the_time(esc_attr__('F', 'woothemes')) . '">' . get_the_time(__('F', 'woothemes')) . '</a>'; $trail['trail_end'] = get_the_time(__('j', 'woothemes')); } elseif (get_query_var('w')) { $trail[] = '<a href="' . get_year_link(get_the_time('Y')) . '" title="' . get_the_time(esc_attr__('Y', 'woothemes')) . '">' . get_the_time(__('Y', 'woothemes')) . '</a>'; $trail['trail_end'] = sprintf(__('Week %1$s', 'woothemes'), get_the_time(esc_attr__('W', 'woothemes'))); } elseif (is_month()) { $trail[] = '<a href="' . get_year_link(get_the_time('Y')) . '" title="' . get_the_time(esc_attr__('Y', 'woothemes')) . '">' . get_the_time(__('Y', 'woothemes')) . '</a>'; $trail['trail_end'] = get_the_time(__('F', 'woothemes')); } elseif (is_year()) { $trail['trail_end'] = get_the_time(__('Y', 'woothemes')); } } } elseif (is_search()) { $trail['trail_end'] = sprintf(__('Search results for "%1$s"', 'woothemes'), esc_attr(get_search_query())); } elseif (is_404()) { $trail['trail_end'] = __('404 Not Found', 'woothemes'); } /* Allow child themes/plugins to filter the trail array. */ $trail = apply_filters('woo_breadcrumbs_trail', $trail, $args); /* Connect the breadcrumb trail if there are items in the trail. */ if (is_array($trail)) { /* Open the breadcrumb trail containers. */ $breadcrumb = '<div class="breadcrumb breadcrumbs woo-breadcrumbs"><div class="breadcrumb-trail">'; /* If $before was set, wrap it in a container. */ if (!empty($before)) { $breadcrumb .= '<span class="trail-before">' . wp_kses_post($before) . '</span> '; } /* Wrap the $trail['trail_end'] value in a container. */ if (!empty($trail['trail_end'])) { $trail['trail_end'] = '<span class="trail-end">' . wp_kses_post($trail['trail_end']) . '</span>'; } /* Format the separator. */ if (!empty($separator)) { $separator = '<span class="sep">' . wp_kses_post($separator) . '</span>'; } /* Join the individual trail items into a single string. */ $breadcrumb .= join(" {$separator} ", $trail); /* If $after was set, wrap it in a container. */ if (!empty($after)) { $breadcrumb .= ' <span class="trail-after">' . wp_kses_post($after) . '</span>'; } /* Close the breadcrumb trail containers. */ $breadcrumb .= '</div></div>'; } /* Allow developers to filter the breadcrumb trail HTML. */ $breadcrumb = apply_filters('woo_breadcrumbs', $breadcrumb); /* Output the breadcrumb. */ if ($echo) { echo $breadcrumb; } else { return $breadcrumb; } }
/** * The code below is inspired by Justin Tadlock's Hybrid Core. * * woo_breadcrumbs() shows a breadcrumb for all types of pages. Themes and plugins can filter $args or input directly. * Allow filtering of only the $args using get_the_breadcrumb_args. * * @since 3.7.0 * @param array $args Mixed arguments for the menu. * @return string Output of the breadcrumb menu. */ function woo_breadcrumbs($args = array()) { global $wp_query, $wp_rewrite; /* Get the textdomain. */ $textdomain = 'woothemes'; /* Create an empty variable for the breadcrumb. */ $breadcrumb = ''; /* Create an empty array for the trail. */ $trail = array(); $path = ''; /* Set up the default arguments for the breadcrumb. */ $defaults = array('separator' => '»', 'before' => '<span class="breadcrumb-title">' . __('You are here:', $textdomain) . '</span>', 'after' => false, 'front_page' => true, 'show_home' => __('Home', $textdomain), 'echo' => true); /* Allow singular post views to have a taxonomy's terms prefixing the trail. */ if (is_singular()) { $defaults["singular_{$wp_query->post->post_type}_taxonomy"] = false; } /* Apply filters to the arguments. */ $args = apply_filters('woo_breadcrumbs_args', $args); /* Parse the arguments and extract them for easy variable naming. */ extract(wp_parse_args($args, $defaults)); /* If $show_home is set and we're not on the front page of the site, link to the home page. */ if (!is_front_page() && $show_home) { $trail[] = '<a href="' . home_url() . '" title="' . esc_attr(get_bloginfo('name')) . '" rel="home" class="trail-begin">' . $show_home . '</a>'; } /* If viewing the front page of the site. */ if (is_front_page()) { if (!$front_page) { $trail = false; } elseif ($show_home) { $trail['trail_end'] = "{$show_home}"; } } elseif (is_home()) { $home_page = get_page($wp_query->get_queried_object_id()); $trail = array_merge($trail, woo_breadcrumbs_get_parents($home_page->post_parent, '')); $trail['trail_end'] = get_the_title($home_page->ID); } elseif (is_singular()) { /* Get singular post variables needed. */ $post = $wp_query->get_queried_object(); $post_id = absint($wp_query->get_queried_object_id()); $post_type = $post->post_type; $parent = $post->post_parent; /* If a custom post type, check if there are any pages in its hierarchy based on the slug. */ if ('page' !== $post_type) { $post_type_object = get_post_type_object($post_type); /* If $front has been set, add it to the $path. */ if ('post' == $post_type || 'attachment' == $post_type || $post_type_object->rewrite['with_front'] && $wp_rewrite->front) { $path .= trailingslashit($wp_rewrite->front); } /* If there's a slug, add it to the $path. */ if (!empty($post_type_object->rewrite['slug'])) { $path .= $post_type_object->rewrite['slug']; } /* If there's a path, check for parents. */ if (!empty($path)) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } /* If there's an archive page, add it to the trail. */ if (!empty($post_type_object->rewrite['archive']) && function_exists('get_post_type_archive_link')) { $trail[] = '<a href="' . get_post_type_archive_link($post_type) . '" title="' . esc_attr($post_type_object->labels->name) . '">' . $post_type_object->labels->name . '</a>'; } } /* If the post type path returns nothing and there is a parent, get its parents. */ if (empty($path) && 0 !== $parent || 'attachment' == $post_type) { $trail = array_merge($trail, woo_breadcrumbs_get_parents($parent, '')); } /* Display terms for specific post type taxonomy if requested. */ if (isset($args["singular_{$post_type}_taxonomy"]) && ($terms = get_the_term_list($post_id, $args["singular_{$post_type}_taxonomy"], '', ', ', ''))) { $trail[] = $terms; } /* End with the post title. */ $post_title = get_the_title($post_id); // Force the post_id to make sure we get the correct page title. if (!empty($post_title)) { $trail['trail_end'] = $post_title; } } elseif (is_archive()) { /* If viewing a taxonomy term archive. */ if (is_tax() || is_category() || is_tag()) { /* Get some taxonomy and term variables. */ $term = $wp_query->get_queried_object(); $taxonomy = get_taxonomy($term->taxonomy); /* Get the path to the term archive. Use this to determine if a page is present with it. */ if (is_category()) { $path = get_option('category_base'); } elseif (is_tag()) { $path = get_option('tag_base'); } else { if ($taxonomy->rewrite['with_front'] && $wp_rewrite->front) { $path = trailingslashit($wp_rewrite->front); } $path .= $taxonomy->rewrite['slug']; } /* Get parent pages by path if they exist. */ if ($path) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } /* If the taxonomy is hierarchical, list its parent terms. */ if (is_taxonomy_hierarchical($term->taxonomy) && $term->parent) { $trail = array_merge($trail, woo_breadcrumbs_get_term_parents($term->parent, $term->taxonomy)); } /* Add the term name to the trail end. */ $trail['trail_end'] = $term->name; } elseif (function_exists('is_post_type_archive') && is_post_type_archive()) { /* Get the post type object. */ $post_type_object = get_post_type_object(get_query_var('post_type')); /* If $front has been set, add it to the $path. */ if ($post_type_object->rewrite['with_front'] && $wp_rewrite->front) { $path .= trailingslashit($wp_rewrite->front); } /* If there's a slug, add it to the $path. */ if (!empty($post_type_object->rewrite['archive'])) { $path .= $post_type_object->rewrite['archive']; } /* If there's a path, check for parents. */ if (!empty($path)) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } /* Add the post type [plural] name to the trail end. */ $trail['trail_end'] = $post_type_object->labels->name; } elseif (is_author()) { /* If $front has been set, add it to $path. */ if (!empty($wp_rewrite->front)) { $path .= trailingslashit($wp_rewrite->front); } /* If an $author_base exists, add it to $path. */ if (!empty($wp_rewrite->author_base)) { $path .= $wp_rewrite->author_base; } /* If $path exists, check for parent pages. */ if (!empty($path)) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $path)); } /* Add the author's display name to the trail end. */ $trail['trail_end'] = get_the_author_meta('display_name', get_query_var('author')); } elseif (is_time()) { if (get_query_var('minute') && get_query_var('hour')) { $trail['trail_end'] = get_the_time(__('g:i a', $textdomain)); } elseif (get_query_var('minute')) { $trail['trail_end'] = sprintf(__('Minute %1$s', $textdomain), get_the_time(__('i', $textdomain))); } elseif (get_query_var('hour')) { $trail['trail_end'] = get_the_time(__('g a', $textdomain)); } } elseif (is_date()) { /* If $front has been set, check for parent pages. */ if ($wp_rewrite->front) { $trail = array_merge($trail, woo_breadcrumbs_get_parents('', $wp_rewrite->front)); } if (is_day()) { $trail[] = '<a href="' . get_year_link(get_the_time('Y')) . '" title="' . get_the_time(esc_attr__('Y', $textdomain)) . '">' . get_the_time(__('Y', $textdomain)) . '</a>'; $trail[] = '<a href="' . get_month_link(get_the_time('Y'), get_the_time('m')) . '" title="' . get_the_time(esc_attr__('F', $textdomain)) . '">' . get_the_time(__('F', $textdomain)) . '</a>'; $trail['trail_end'] = get_the_time(__('j', $textdomain)); } elseif (get_query_var('w')) { $trail[] = '<a href="' . get_year_link(get_the_time('Y')) . '" title="' . get_the_time(esc_attr__('Y', $textdomain)) . '">' . get_the_time(__('Y', $textdomain)) . '</a>'; $trail['trail_end'] = sprintf(__('Week %1$s', $textdomain), get_the_time(esc_attr__('W', $textdomain))); } elseif (is_month()) { $trail[] = '<a href="' . get_year_link(get_the_time('Y')) . '" title="' . get_the_time(esc_attr__('Y', $textdomain)) . '">' . get_the_time(__('Y', $textdomain)) . '</a>'; $trail['trail_end'] = get_the_time(__('F', $textdomain)); } elseif (is_year()) { $trail['trail_end'] = get_the_time(__('Y', $textdomain)); } } } elseif (is_search()) { $trail['trail_end'] = sprintf(__('Search results for "%1$s"', $textdomain), esc_attr(get_search_query())); } elseif (is_404()) { $trail['trail_end'] = __('404 Not Found', $textdomain); } /* Connect the breadcrumb trail if there are items in the trail. */ if (is_array($trail)) { /* Open the breadcrumb trail containers. */ $breadcrumb = '<div class="breadcrumb breadcrumbs woo-breadcrumbs"><div class="breadcrumb-trail">'; /* If $before was set, wrap it in a container. */ if (!empty($before)) { $breadcrumb .= '<span class="trail-before">' . $before . '</span> '; } /* Wrap the $trail['trail_end'] value in a container. */ if (!empty($trail['trail_end'])) { $trail['trail_end'] = '<span class="trail-end">' . $trail['trail_end'] . '</span>'; } /* Format the separator. */ if (!empty($separator)) { $separator = '<span class="sep">' . $separator . '</span>'; } /* Join the individual trail items into a single string. */ $breadcrumb .= join(" {$separator} ", $trail); /* If $after was set, wrap it in a container. */ if (!empty($after)) { $breadcrumb .= ' <span class="trail-after">' . $after . '</span>'; } /* Close the breadcrumb trail containers. */ $breadcrumb .= '</div></div>'; } /* Allow developers to filter the breadcrumb trail HTML. */ $breadcrumb = apply_filters('woo_breadcrumbs', $breadcrumb); /* Output the breadcrumb. */ if ($echo) { echo $breadcrumb; } else { return $breadcrumb; } }