Download the PHP package lcharette/uf_breadcrumb without Composer
On this page you can find all versions of the php package lcharette/uf_breadcrumb. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download lcharette/uf_breadcrumb
More information about lcharette/uf_breadcrumb
Files in lcharette/uf_breadcrumb
Package uf_breadcrumb
Short Description Breadcrumb service provider for UserFrosting V4
License MIT
Homepage https://github.com/lcharette/UF_Breadcrumb
Informations about the package uf_breadcrumb
Breadcrumb Sprinkle for UserFrosting 4
This Sprinkle provides an helper service and Twig template to manage simple page breadcrumb for UserFrosting 4.
Help and Contributing
If you need help using this sprinkle or found any bug, feels free to open an issue or submit a pull request. You can also find me on the UserFrosting Chat most of the time for direct support.
Installation
Edit UserFrosting app/sprinkles.json
file and add the following to the require
list : "lcharette/uf_breadcrumb": "^3.0.0"
. Also add Breadcrumb
to the base
list. For example:
Run composer update
then php bakery bake
to install the sprinkle.
Usage
Adding crumbs
Breadcrumbs hierarchy needs to be manually defined in each controllers. To dynamically add breadcrumbs to the UI, simply use the add
method of the breadcrumb
service:
You can also chain multiple methods :
The crumbs can also be created using the Crumb
object :
The item name can also be switched for a translation key :
Path is actually optional if you don't want to provide a link with your crumb. Alternatively, a route name / route pattern placeholders can also be used :
Prepend crumbs
You can also use the prepend
method to add a new item to the beginning of the list:
Note that the site index is automatically added to the beginning of the list, whether you use prepend
or not.
If you don't add any custom breadcrumbs, it will fallback to the default UserFrosting behaviour.
Custom style
The default UserFrosting layouts and themes will pick up the breadcrumbs automatically. If your UserFrosting theme doesn't include breadcrumbs automatically, simply add this line to your twig files:
If you want to edit the style of the breadcrumbs, simply copy the templates/navigation/breadcrumb.html.twig
file in your own sprinkle and edit according to your styling. No custom assets are included with this sprinkle.
Licence
By Louis Charette. Copyright (c) 2020, free to use in personal and commercial software as per the MIT license.