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.
[!CAUTION] This project has been archived. The features provided by this project are now built-in UserFrosting 6.
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.