hiiicomtw/breadcrumb-for-laravel

A simple breadcrumb for laravel.

breadcrumb-for-laravel

A simple breadcrumb for laravel., _(*1)

Installation

composer require hiiicomtw/breadcrumb-for-laravel:dev-master

Configuration

config/app.php

providers:, _(*2)

Hiiicomtw\Breadcrumb\BreadcrumbServiceProvider::class

aliases:, _(*3)

'Breadcrumb' => Hiiicomtw\Breadcrumb\BreadcrumbFacade::class

config/breadcrumb.php

You can change the "default-template" key by value 'breadcrumb::template' 、 'breadcrumb::sample' or 'breadcrumb::backend', _(*4)

php artisan vendor:publish

return [
    'breadcrumb-file-path' => app_path('Http/breadcrumb.php'),
    'default-template' => 'breadcrumb::template',
    'ignore-undefined-breadcrumb' => false
];

views/vendor/breadcrumb

You can edit the views where in "resources/views/vendor", _(*5)

Base Usage

1. Create the breadcrumb file in the "breadcrumb-file-path"., _(*6)

2. Define breadcrumbs in the breadcrumb file., _(*7)

   Without parameters:, _(*8)

   // Home
   Breadcrumb::define('home', function ($breadcrumb) {
       $breadcrumb->add('Home', action('HomeController@index'));
   });
   

   With a parameter:, _(*9)

   // Home > $category->title
   Breadcrumb::define('category', function ($breadcrumb, $category) {
       $breadcrumb->add('Home', action('HomeController@index'));
       $breadcrumb->add($category->title, $category->url);
   });
   

   With parameters:, _(*10)

   // Home > $category['title'] > $content->title
   Breadcrumb::define('content', function ($breadcrumb, $category, $content) {
       $breadcrumb->add('Home', action('HomeController@index'));
       $breadcrumb->add($category['title'], $category['id']);
       $breadcrumb->add($content->title, $content->url);
   });
   

3. Render breadcrumbs., _(*11)

   Without parameters:, _(*12)

   {!! Breadcrumbs::render('home') !!}
   

   With a parameter:, _(*13)

   {!! Breadcrumbs::render('home', $category) !!}
   

   With parameters:, _(*14)

   {!! Breadcrumbs::render('home', $category, $content) !!}
   

Advanced Usage

1. The breadcrumb use the special template.blade.php in resources/views., _(*15)

   {!! Breadcrumbs::setTemplate('path/to/view')->render('home') !!}