Title: Carbon Breadcrumbs
Author: Marin Atanasov
Published: <strong>ජනවාරි 8, 2016</strong>
Last modified: අප්‍රේල් 11, 2016

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/carbon-breadcrumbs.svg)

# Carbon Breadcrumbs

 By [Marin Atanasov](https://profiles.wordpress.org/tyxla/)

[Download](https://downloads.wordpress.org/plugin/carbon-breadcrumbs.1.0.2.zip)

 * [Details](https://si.wordpress.org/plugins/carbon-breadcrumbs/#description)
 * [Reviews](https://si.wordpress.org/plugins/carbon-breadcrumbs/#reviews)
 *  [Installation](https://si.wordpress.org/plugins/carbon-breadcrumbs/#installation)
 * [Development](https://si.wordpress.org/plugins/carbon-breadcrumbs/#developers)

 [Support](https://wordpress.org/support/plugin/carbon-breadcrumbs/)

## Description

Provides the theme and plugin developers an easy way to build and implement highly
customizable breadcrumb functionality, specifically tailored to their needs.
 Supports
a lot of filters and hooks, and is written in OOP style, giving developers full 
control over the breadcrumb trail items and appearance. This plugin can also be 
embedded in themes, instead of installing it as a WordPress plugin.

### Configuration

The most basic way to insert Carbon Breadcrumbs in your theme code is:

    ```
    <?php Carbon_Breadcrumb_Trail::output(); ?>
    ```

If you want to specify various breadcrumb rendering options, you can specify them
in an array, like this:

    ```
    <?php
    Carbon_Breadcrumb_Trail::output(array(
        'glue' => ' &gt; ', // glue between breadcrumb items
        'link_before' => '',
        'link_after' => '',
        'wrapper_before' => '',
        'wrapper_after' => '',
        'title_before' => '',
        'title_after' => '',
        'min_items' => 2,
        'last_item_link' => true,
        'display_home_item' => true,
        'home_item_title' => __('Home', 'carbon_breadcrumbs'),
        'renderer' => 'Carbon_Breadcrumb_Trail_Renderer',
    ));
    ?>
    ```

For additional configuration and developer documentation, you can visit the Github
repository:

https://github.com/tyxla/carbon-breadcrumbs

### Ideas and bug reports

Any ideas for new modules or any other additional functionality that users would
benefit from are welcome.

If you have an idea for a new feature, or you want to report a bug, feel free to
do it here in the Support tab, or you can do it at the Github repository of the 
project:

https://github.com/tyxla/carbon-breadcrumbs

## Installation

 1. Install Carbon Breadcrumbs either via the WordPress.org plugin directory, or by
    uploading the files to your server.
 2. Activate the plugin.
 3. That’s it. You’re ready to go! Please, refer to the Configuration section for examples
    and usage information.

## Reviews

![](https://secure.gravatar.com/avatar/1dda19ba3fdb42d7340902f89bd787b128105c59aa4516de45e31d6b163f49f1?
s=60&d=retro&r=g)

### 󠀁[Really wonderful, well-thought code. wish there were schematags](https://wordpress.org/support/topic/really-wonderful-well-thought-code-wish-there-were-schematags/)󠁿

 [gnowland](https://profiles.wordpress.org/gnowland/) ඔක්තෝබර් 17, 2017

GREAT plugin, fantastic codebase: super clean & TESTED?! FTW! Only downside is no
schematagging out of the box :/. This is a pivotal SEO feature and I think this 
would greatly boost interest in your plugin. Info: https://developers.google.com/
search/docs/data-types/breadcrumbs#guidelines Result should look like: <ol itemscope
itemtype="http://schema.org/BreadcrumbList"> <li itemprop="itemListElement" itemscope
itemtype="http://schema.org/ListItem"> <a itemscope itemtype="http://schema.org/
WebPage" itemprop="item" href="link.html"> <span itemprop="name">Crumb 1</span> 
</a> <meta itemprop="position" content="1" /> / </li> <li itemprop="itemListElement"
itemscope itemtype="http://schema.org/ListItem"> <a itemscope itemtype="http://schema.
org/WebPage" itemprop="item" href="link2.html"> <span itemprop="name">Crumb 2</span
> </a> <meta itemprop="position" content="2" /> </li> </ol> Here’s how I’ve shimmed
it in: <?php $breadcrumbs = new Carbon_Breadcrumb_Trail(array( 'glue' => ' / ', '
link_before' => '<li itemprop="itemListElement" itemscope itemtype="http://schema.
org/ListItem">', 'link_after' => '</li>', 'wrapper_before' => '<ol class="breadcrumbs"
itemscope itemtype="http://schema.org/BreadcrumbList">', 'wrapper_after' => '</ol
>', 'title_before' => '<span itemprop="name">', 'title_after' => '</span>', )); 
$breadcrumbs->setup(); echo $breadcrumbs->render(true); // WP_KSES strips itemprop,
itemscope, etc, so bypassing!!! add_filter('carbon_breadcrumbs_item_attributes',_'
breadcrumb_schematags', 10, 2); function breadcrumb_schematags($attributes, $item){
if (!is_array($attributes)) $attributes = array(); $attributes['itemscope'] = null;
$attributes['itemtype'] = 'http://schema.org/WebPage'; $attributes['itemprop'] ='
item'; return $attributes; } add_filter('carbon_breadcrumbs_item_output', 'breadcrumb_item_position',
10, 5); function breadcrumb_item_position($item_output, $item, $trail, $trail_renderer,
$index){ // Add Position $n = strrpos($item_output, '</li>'); $item_output = substr(
$item_output, 0, $n) . '<meta itemprop="position" content="'. $index .'" />' . substr(
$item_output, $n); return $item_output; }

![](https://secure.gravatar.com/avatar/d17f1043b9216eeec469b28f73b96617c8912384da9134c9cff1f6ad70851519?
s=60&d=retro&r=g)

### 󠀁[Fab for Woocommerce products](https://wordpress.org/support/topic/fab-for-woocommerce-products/)󠁿

 [stevehoo](https://profiles.wordpress.org/stevehoo/) දෙසැම්බර් 6, 2016

see how.

![](https://secure.gravatar.com/avatar/774c1731d3e408331d6254fe7c5add84e6172385909ed73bd6a6922dc7b81d76?
s=60&d=retro&r=g)

### 󠀁[The best breadcrumbs plugin I've used](https://wordpress.org/support/topic/the-best-breadcrumbs-plugin-ive-used/)󠁿

 [Marin Atanasov](https://profiles.wordpress.org/tyxla/) සැප්තැම්බර් 3, 2016

This remains the best breadcrumbs plugin I’ve used. In addition to its rich customization
options, it provides developers with various easy ways to extend it.

![](https://secure.gravatar.com/avatar/ff89ce4520d3e19d6c775ce7410f197e8beb22188d1f4f941ccb1732a47c6b67?
s=60&d=retro&r=g)

### 󠀁[Very customizable](https://wordpress.org/support/topic/very-customizable-20/)󠁿

 [Peter Petrov](https://profiles.wordpress.org/ppetrov2c/) දෙසැම්බර් 24, 2016

This plugin has saved me quite some time. Thanks to the numerous filters, you can
adjust everything. Respect <3

 [ Read all 4 reviews ](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/)

## Contributors & Developers

“Carbon Breadcrumbs” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Marin Atanasov ](https://profiles.wordpress.org/tyxla/)

[Translate “Carbon Breadcrumbs” into your language.](https://translate.wordpress.org/projects/wp-plugins/carbon-breadcrumbs)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/carbon-breadcrumbs/),
check out the [SVN repository](https://plugins.svn.wordpress.org/carbon-breadcrumbs/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/carbon-breadcrumbs/)
by [RSS](https://plugins.trac.wordpress.org/log/carbon-breadcrumbs/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.2

Tested with WordPress 4.5.

#### 1.0.1

Add some `.gitattributes` to make exporting lighter.

#### 1.0

Initial version.

## Meta

 *  Version **1.0.2**
 *  Last updated **වසර 10ක් ago**
 *  Active installations **60+**
 *  WordPress version ** 3.8 or higher **
 *  Tested up to **4.5.33**
 *  Language
 * [English (US)](https://wordpress.org/plugins/carbon-breadcrumbs/)
 * Tags
 * [admin](https://si.wordpress.org/plugins/tags/admin/)[breadcrumb](https://si.wordpress.org/plugins/tags/breadcrumb/)
   [breadcrumbs](https://si.wordpress.org/plugins/tags/breadcrumbs/)[carbon](https://si.wordpress.org/plugins/tags/carbon/)
   [trail](https://si.wordpress.org/plugins/tags/trail/)
 *  [Advanced View](https://si.wordpress.org/plugins/carbon-breadcrumbs/advanced/)

## Ratings

 4.8 out of 5 stars.

 *  [  3 5-star reviews     ](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/carbon-breadcrumbs/reviews/)

## Contributors

 *   [ Marin Atanasov ](https://profiles.wordpress.org/tyxla/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/carbon-breadcrumbs/)