Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.
Cannot retrieve contributors at this time
[1.1.0] - 2017-09-24
Handles mapping rewrite tags for any post type now. Any of the standard rewrite tags are mapped. It also handles any custom taxonomy when used as part of the post type rewrite slug (e.g.,
Adds proper breadcrumbs when viewing post type archives by author.
Support for paged comments. When viewing paged comments, the post title gets linked and
Comment Page %s becomes the final item.
paged_comments label available.
browse_tag argument for controlling the header/browse tag. Defaults to
list_tag argument for controlling the list tag. Defaults to
item_tag argument for controlling the item tag. Defaults to
itemprop="item" microdata for the list item inner element.
breadcrumb_trail_inline_style filter hook for changing or disabling the inline style.
Changes default search label to
Search results for: %s to avoid double quotes (search queries sometimes have quotes in them).
Properly reverse term parents array (in wrong order before).
wp_list_sort() for sorting terms, available since WP 4.7.
user_trailingslashit() to make sure it has a trailing slash when it should.
[1.0.0] - 2015-07-07
Plugins and themes can now filter the
breadcrumb_trail_object to use their own sub-classes of
aria-label attributes to improve accessibility.
Changed from a flat HTML structure to a proper HTML5
<nav> > header > list structure.
Added basic CSS output for themes that don't support the plugin. This was needed for backwards compatibility with the new HTML structure.
Added additional classes for styling in themes such as
.trail-items (items wrapper) and
.trail-item (single item).
Schema.org support for the newer BreadcrumbList type. The category will now be shown by default on sites with a
%postname% permalink structure for single post views.
Better support for finding related custom post types and taxonomies.
Added French translation files.
is_paged() on single post views, which is needed for custom post types like forums that are paged.
Always makes sure taxonomy terms exist before adding them as breadcrumb items.
get_post() instead of the deprecated
Don't show parent page item if it's set as the front page and we're viewing a child page.
title attribute for links. This is far better for accessibility.
Hardening security by making sure all URLs are passed through
Hardening security by running translations through
bbPress support was dropped. If needed, developers should sub-class
breadcrumb_trail() can return the HTML.
rel="home" to the home page link. This got removed at some point.
Do network and site home links in bbPress.
Slight fix to stop bbPress from putting double "Forums" in the breadcrumb trail.
show_on_front argument should only work if the front page is not paginated.
Better handling of the text strings, particularly when displaying date/time.
breadcrumb-trail.pot file for better translating.
Schema.org support. Completely overhauled the entire plugin, rewriting large swathes of code from the ground up. This version takes an object-oriented approach.
Blew every other breadcrumb menu script out of the water.
post_type_archive_title() on post type archives in the trail.
Add support for taxonomies that have a
$rewrite->slug that matches a string value for a custom post type's
Added support for an
archive_title label for custom post types because we can't use the
post_type_archive_title() function on single posts views for the post type.
Loads of pagination support on both archive-type pages and paged single posts.
Added support for hierarchical custom post types (get parent posts).
network argument to allow multisite owners to run the trail all the way back to the main site.
Only check attachment trail if the attachment has a parent.
Fixed the issue where the wrong post type archive link matches with a term archive page.
No friggin' clue. I think I actually skipped version numbers somehow. :)
Changed license from GPL 2-only to GPL 2+.
Smarter handling of the
container argument for wrapping breadcrumbs in a custom HTML element.
Use hardcoded strings for the textdomain, not a variable.
Inline doc updates.
Added bbPress support.
single_post_title() instead of
get_the_title() for post titles.
get_queried_object_id() instead of accessing
$args as second parameter in
breadcrumb_trail_get_items(), which grabs a list of all the trail items. This separates the items from the main
New filter hook:
breadcrumb_trail_items, which allows devs to filter just the items.
breadcrumb_trail_map_rewrite_tags(), which maps the permalink structure tags set under Permalink Settings in the admin to make for a much more accurate breadcrumb trail.
breadcrumb_trail_textdomain(), which can be filtered when integrating the plugin into a theme to match the theme's textdomain.
Added functionality to handle WP 3.1 post type enhancements.
Smarter logic in certain areas.
Removed localization for things that shouldn't be localized with time formats.
single_tax set to
null instead of
Better escaping of element attributes.
Add in initial support of WordPress 3.1's post type archives.
Better formatting and organization of the output late in the function.
trail-after CSS classes if
$after is set.
Undefined index error fixes.
Fixes for trying to get a property of a non-object.
Added more support for custom post types and taxonomies.
Added more support for more complex hierarchies.
The breadcrumb trail now recognizes more patterns with pages as part of the permalink structure of other objects.
All post types can have any taxonomy as the leading part of the trail.
Cleaned up the code.
Removed and/or added (depending on the case) the extra separator item on sub-categories and date-/time-based breadcrumbs.
The title of the "home" page (i.e. posts page) when not the front page is now properly recognized.
Cleaned up the code and logic behind the plugin.
Launch of the new plugin.
Press h to open a hovercard with more details.