README

这是一个在Laravel 5中创建面包屑的简单Laravel风格方法。

（如果您仍然在使用Laravel 4.0到4.2，请使用2.x版本的Laravel Breadcrumbs。）

此包不再维护

简短版

• 您可以使用Laravel Breadcrumbs，但
• 不会回答支持请求
• 不会修复错误
• 不会合并拉取请求
• 请随意分叉并自行维护

为什么？

我在2013年5月首次构建Laravel Breadcrumbs，当时我正在学习Laravel（当时Laravel 4还在测试版）。我决定将其发布为一个包，主要是为了更详细地了解包的工作原理。

随着时间的推移，它变得相当受欢迎（381k次安装，757个星标，在Packalyst最受欢迎的第1页），人们开始提出问题，要求支持和新功能。我一直尽力提供帮助并提供支持，并在过去18个月中一直计划花时间合并所有未解决的拉取请求、实现功能请求和更新/重写文档...但最终我意识到我不再有足够的动力。

因此，我决定不再默默地放弃它，让用户感到困惑，而是正式宣布该包不再维护。

（为了清楚起见，您可以使用它 - 只是不要期望我在它出错时修复它。这包括在发布新Laravel版本时。）

分叉它

Laravel Breadcrumbs是在MIT许可证下发布的，这意味着您可以自由创建自己的分叉（无论用于个人使用还是供他人使用），只要您保留版权声明。

文档包括一些可能有助于您之前未执行过此操作的说明。

我并不打算将此仓库的控制权转交给其他人（因为它以我的名义），但如果有人决定创建一个他们愿意支持和维护的分叉，请给我发邮件，我会在本页上添加链接。您还可以使用问题#137来讨论此事。

如果您决定支持您的分叉，您应该意识到编写解决自己问题的代码是容易的部分 - 困难的部分包括

• 处理模糊的支持请求和期望您无需感谢就解决他们错误的人
• 被要求编写您自己不需要的新功能，因为其他人想要它们，但不愿意花时间编写它们
• 为每个功能编写清晰简洁的文档，以便用户不会感到困惑，并花费更多时间寻求支持
• 大多数文档和单元测试都需要自己编写，因为 很少 PRs 包含 它们
• 尽管如此，你为此并没有得到任何报酬

已知错误

我只知道有一个悬而未决的错误

• 当你在无名路由中使用路由绑定的面包屑时，会抛出异常.

作为替代方案，要么给你的路由命名，要么将其包裹在 try/catch 块中。

开放的 Pull Requests

感谢提出这些 PR 的人。很抱歉我不能合并它们。也许如果有人创建了分叉，他们可能会愿意审查它们

• 允许在路由中设置面包屑名称
• 添加 Breadcrumbs::get() 方法
• 模板中的微数据 - 选项 1，选项 2
• Bootstrap 4 模板
• 支持基于类的面包屑（闭包的替代方案）
• 使面包屑位置可配置
• Materialize 和 Foundation 6 模板

开放请求

• 自动为分页添加面包屑
• 支持依赖注入
• 改进关于多个参数的文档
• 添加 Breadcrumbs::group() 方法 - 尽管我个人并不认为它有价值
• 缓存面包屑 - 尽管我不确定这会有多少速度提升
• 如果意外递归调用，则抛出异常 - 尽管如果已安装 Xdebug，它已经可以处理这个问题

其他分叉建议

• 文档需要更新，以推荐在路由中使用 ->name('name') 而不是 ['as' => 'name']（自 Laravel 5.3 以来），请参阅 此处
• 我正在考虑重新编写文档，将路由绑定的面包屑作为标准，而不是事后考虑，并更好地解释显式和隐式绑定如何工作，因为这似乎是人们容易遇到的问题
• 您需要在 Packagist 上设置账户以进行包交付，并在 Read the Docs 上设置文档
• 您还可能想要设置 Travis CI 和 Coveralls - 仓库中已有相应的配置文件

文档

查看文档 >>

版权所有 © 2013-2015 Dave James Miller。在 MIT 许可证下发布。