PHPackages                             xi/breadcrumbs-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. xi/breadcrumbs-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

xi/breadcrumbs-bundle
=====================

Xi breadcrumbs bundle for Symfony2 that utilises routes as a tree to build the breadcrumbs in order to not pollute the controller actions with repetitive breadcrumbs code.

2.3.x-dev(13y ago)113.2k12[7 issues](https://github.com/xi-project/xi-bundle-breadcrumbs/issues)[1 PRs](https://github.com/xi-project/xi-bundle-breadcrumbs/pulls)BSD-3-ClausePHPCI failing

Since Oct 10Pushed 13y ago1 watchersCompare

[ Source](https://github.com/xi-project/xi-bundle-breadcrumbs)[ Packagist](https://packagist.org/packages/xi/breadcrumbs-bundle)[ RSS](/packages/xi-breadcrumbs-bundle/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (10)Versions (7)Used By (0)

xi-bundle-breadcrumbs
=====================

[](#xi-bundle-breadcrumbs)

A Breadcrumbs bundle for Symfony2.

This is different from other breadcrumb bundles, because it utilizes routes
as a tree to build the breadcrumbs in order to not pollute the controller
actions with repetitive breadcrumbs code.

[![Build Status](https://camo.githubusercontent.com/1d46fd1c8321ae7a66900b6fdc240f5f9a87f978a6e9e0f7f768c41b153caffc/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f78692d70726f6a6563742f78692d62756e646c652d62726561646372756d62732e706e673f6272616e63683d73657276696365)](http://travis-ci.org/xi-project/xi-bundle-breadcrumbs)

Design goals
------------

[](#design-goals)

- Implement breadcrumbs with configurable and internationalised labels and urls
- Keep it DRY: Do not repeat breadcrumbs code for the same page in several controller actions
- Avoid using annotations either
- Allow cyclical loops on breadcrumb hierarchy and handle it intelligently

Installing
----------

[](#installing)

### Add bundle to `composer.json`

[](#add-bundle-to-composerjson)

```
"require": {
    # ..
    "xi/breadcrumbs-bundle": ">=2.1"
    # ..
}

```

### Add bundle to `AppKernel.php`

[](#add-bundle-to-appkernelphp)

```
public function registerBundles()
{
    $bundles = array(
        ...

        new Xi\Bundle\BreadcrumbsBundle\XiBreadcrumbsBundle(),
    );

    ...
}
```

Usage
-----

[](#usage)

### Basic usage

[](#basic-usage)

Add `{{ xi_breadcrumbs() }}` into your template and add `parent` and `label` into your route defaults.
Label is optional, and defaults to the route name.

```
root:
    pattern:   /
    defaults:
        label: "home"

foo:
    pattern:   /foo
    defaults:
        parent: "root"

bar:
    pattern:   /foo/bar/{slug}
    defaults:
        label: "bar {slug}"
        parent: "foo"
```

`Parent` is the name of the parent route. `Label` can have placeholder values between braces, as shown
below with `{slug}`. Note that child routes should have all the placeholders available that their parents
will use – otherwise the placeholders will be stripped from the label.

### Internationalised routes

[](#internationalised-routes)

For internationalised routes using [BesimpleI18nRoutingBundle](https://github.com/BeSimple/BeSimpleI18nRoutingBundle), use a similar array of locales as in the `locales` option.

```
xi_service:
    locales:
        en: /service
        fi: /palvelu
    defaults:
        label:
            en: "Services"
            fi: "Palvelut"
```

### More examples

[](#more-examples)

For more usage examples, see the Yaml files at `Tests/Fixtures` directory.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance7

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~132 days

Total

3

Last Release

4747d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/70079?v=4)[Peter Hillerström](/maintainers/peterhil)[@peterhil](https://github.com/peterhil)

---

Top Contributors

[![peterhil](https://avatars.githubusercontent.com/u/70079?v=4)](https://github.com/peterhil "peterhil (4 commits)")[![puppe0](https://avatars.githubusercontent.com/u/506220?v=4)](https://github.com/puppe0 "puppe0 (4 commits)")[![kjones-boxuk](https://avatars.githubusercontent.com/u/2562510?v=4)](https://github.com/kjones-boxuk "kjones-boxuk (2 commits)")

---

Tags

routingbreadcrumbsinternationalisationXi

### Embed Badge

![Health badge](/badges/xi-breadcrumbs-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/xi-breadcrumbs-bundle/health.svg)](https://phpackages.com/packages/xi-breadcrumbs-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M378](/packages/easycorp-easyadmin-bundle)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1175.2k](/packages/rcsofttech-audit-trail-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1615.6k12](/packages/2lenet-crudit-bundle)[kimai/kimai

Kimai - Time Tracking

4.8k8.7k1](/packages/kimai-kimai)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M528](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)