todomagichere/ibexa-breadcrumbs-bundle

This bundle provides a basic breadcrumbs system for ibexa cms

v1.1.1 2024-02-16 09:14 UTC

Requires

• php: ^7.1|^8.0

MIT

• Roberto Pérez

• breadcrumbs
• manipulation
• ibexa
• todomagichere

README

This is the first version of ibexa breadcrumbs bundle. The intention of this bundle is to make easy the breadcrumb system implementation for the ibexa platform, previously known as ezplatform.

Installation instructions

From composer, run the following command:

composer require todomagichere/ibexa-breadcrumbs-bundle

To get the breadcrumb system up and running, it must be invoked from a twig template (usually a full view) with this function:

{{ get_breadcrumbs(location) }}

It should be noted that the location parameter is mandatory, since the way the breadcrumbs are generated is through their pathString

Configuration file

The point of this configuration file is to avoid a certain number of locations, passing the location id, or in the other hand manage the content types rejected, for example:

#config/packages/ibexa_breadcrumbs.yaml
ibexa_breadcrumbs:
    locations_rejected: [2, 3, 140]
    contenttypes_rejected: ['folder', 'distributor', 'article']

Twig template

Suppose we have the following content tree:

We can see that it is rendered as follows:

Overriding Twig template

To override the default template breadcrumbs.html.twig just create a new template (See default template behaviour for new implementation):

ezplatform/templates/bundles/IbexaBreadcrumbsBundle/breadcrumbs.html.twig