mj/breadcrumb

Laravel 4 的简单面包屑生成器

dev-master 2014-11-17 08:20 UTC

This package is not auto-updated.

Last update: 2024-09-23 13:37:22 UTC


README

** 如果更新后运行 setSeperator (误拼) 存在问题,我已经将函数名更改为 setSeperator。

Laravel 4 的一个小巧且易于定制的面包屑生成器。

编辑 .json 文件

编辑您的 .json 文件,并在 "require" 中添加以下行:

"mj/breadcrumb": "dev-master"

之后,运行 composer update 以更新您的框架,并将面包屑类加载到您的文件中。

配置

在配置文件夹中打开 app.php

  1. 'Mj\Breadcrumb\BreadcrumbServiceProvider' 行添加到 providers 数组中。

  2. 要使用 Laravel 4 中的 Facade,请确保在文件 'app/config/app.php' 中注册别名。

例如:'Breadcrumb' => 'Mj\Breadcrumb\Facades\breadcrumb'

用法

要创建面包屑,请使用以下代码:

Breadcrumb::addbreadcrumb('链接名称', 'url');

您可以通过重复上述代码添加多个面包屑。

要设置分隔符,可以使用

Breadcrumb::setSeparator('您的分隔符')

最后,使用以下命令将面包屑发送到您的模板(或直接生成):

Breadcrumb::generate()

示例

注意:请使用真实的 URL(如 /this/page),而不是 Laravel 的 URL 辅助器。完全不设置 URL 也可以。

//Controller

public function page()
{
  //Those are required to set some breadcrumbs first.
  Breadcrumb::addBreadcrumb('home', '/');
  Breadcrumb::addBreadcrumb('some page', '/some-page');
  Breadcrumb::addBreadcrumb('last piece'); //Does not need a url because it's the last breadcrumb segment

	Breadcrumb::setSeparator('/'); //Set some seperator you think is nicest (not required)

  $data = array(
	  'breadcrumbs' => Breadcrumb::generate() //Breadcrumbs UL is generated and stored in an array.
  )

  //return the view with the $data array to use it in the view
  return View::make('some/page', $data);
}

//View

{{$breadcrumbs}} // -> UL with list-items with the links :)