README

在 Laravel 5 中以 Laravel 风格创建面包屑的简单方法。

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

此软件包已不再维护

简短版

• 您欢迎继续使用 Laravel Breadcrumbs，但
• 不会回答支持请求
• 不会修复错误
• 不会合并拉取请求
• 请随意将其分支出来并自行维护

为什么？

我最初在 2013 年 5 月构建 Laravel Breadcrumbs，当时我正在学习 Laravel（当时 Laravel 4 仍在 beta 测试阶段）。我决定将其作为一个软件包发布，主要是为了更详细地了解软件包的工作原理。

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

因此，为了避免默默放弃它并让用户感到困惑，我决定正式宣布该软件包已不再维护。

（为了明确起见，您欢迎继续使用它 - 但如果它出现故障，不要期望我会修复它。这包括当发布新的 Laravel 版本时。）

分支

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

文档 包含 一些可能有助于您完成此操作的说明。

我目前没有计划将此存储库的控制权交给其他人（因为它以我的名义），但如果有人决定创建一个他们愿意支持和维护的分支，请 给我发邮件，我将在本页添加链接。您也可以使用 问题 #137 来进行讨论。

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

• 处理 模糊的支持请求 和 期望您免费解决他们的错误的人
• 被要求编写 新功能，这些功能您个人不需要，因为其他人想要它们，但不愿意花时间编写它们
• 为每个功能编写清晰简洁的文档，以便用户不会感到困惑，也不需要花费更多时间寻求支持。
• 由于很少有 PRs 包含 它们，因此您需要自己编写大部分文档和单元测试。
• 尽管如此，您为此并不收取任何费用。

已知问题

我只知道1个未解决的问题。

• 当您在未命名的路由中使用路由绑定的面包屑时，会抛出异常。.

作为解决方案，您可以命名您的路由或将其包裹在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许可证下发布。