README

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

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

此包已不再维护

简版

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

为什么？

我最初在 2013 年 5 月构建 Laravel Breadcrumbs，当时我刚开始学习 Laravel（当时 Laravel 4 还处于测试阶段）。我决定将其发布为包，主要是为了更详细地了解包的工作原理。

随着时间的推移，它变得相当受欢迎（381k 安装，757 星级，Packalyst 最受欢迎包的榜首），人们开始提出问题，请求支持和额外功能。我一直尽力提供帮助和支持，并在过去 18 个月中一直在计划花时间合并所有开放 pull 请求，实现功能请求和更新/重写文档……但最终我意识到我不再有进行这些工作的动力。

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

(为了清楚起见，您当然可以继续使用它 - 只是不期待我修复它可能出现的任何问题。这包括当发布新的 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许可证下发布。