这份指南的部分内容改编自 Laravel 贡献指南,这一指南提供了宝贵的启发。
如果您在 Filament 中发现错误,请通过在我们的 GitHub 仓库 上提交问题来报告。在提交问题之前,请搜索 现有问题,以检查该错误是否已被报告。
请尽可能多地提供信息,特别是您应用程序中软件包的版本号。您可以在应用程序中使用此 Artisan 命令来打开一个新问题,其中所有正确的版本都已自动预填充:
php artisan make:filament-issue创建问题时,我们需要一个"复现仓库"。请不要链接到你的实际项目。相反,我们需要的是一个最小化的复现在一个不含任何不必要的代码的全新项目中。这意味着你的实际项目是私有/机密的也无关紧要,因为我们想要的是一个独立的、隔离的复现链接。这能让我们更快地修复问题。如果缺少此项,问题将自动关闭且不予审核,以节省维护者时间,并确保对于那些努力报告问题的人来说,这个过程是公平的。 如果你认为复现仓库不适用于该问题,这是一种非常罕见的情况,请@danharrin并解释原因。说"这只是个简单的问题"不是不创建仓库的借口!需要一个起点吗?我们为你准备了一个Filament项目模板。
请记住,创建错误报告是为了让有相同问题的其他人能够与您协作解决问题。不要期望错误报告会自动获得关注,或者其他人会立即着手修复它。创建错误报告有助于您和他人开始解决问题的过程。
如果您想向 Filament 提出新功能或改进建议,您可以使用我们托管在 GitHub 上的讨论论坛。如果您打算通过拉取请求自己实现该功能,我们建议您在功能讨论中提前向 @danharrin (Filament 的核心维护者) 询问它是否适合该框架,以免浪费您的时间。
如果您想为 Filament 开发插件,请参阅文档中的插件开发部分。我们的Discord服务器也是提出问题并获得插件开发帮助的好地方。您可以在#plugin-developers-chat频道中开始对话。
如果你想为 Filament 包做贡献,那么你可能想在一个真实的 Laravel 项目中测试它:
/filament目录中,为你的修复创建一个分支,例如fix/error-message。在你的应用的composer.json中安装这些包:
{
// ...
"require": {
"filament/filament": "*",
},
"minimum-stability": "dev",
"repositories": [
{
"type": "path",
"url": "filament/packages/*"
}
],
// ...
}现在,运行 composer update。
完成更改后,您可以提交更改并向 GitHub 仓库 提交拉取请求。
要检查过时的翻译,你可以使用我们的翻译工具。克隆 Filament 仓库,安装命令所需的依赖项,然后运行该命令。
# Clone
git clone git@github.com:filamentphp/filament.git
# Install dependencies
composer install
# Run the tool
./bin/translation-tool.php首先选择“List outdated translations”作为命令,然后选择您要检查的语言环境。此命令将显示指定语言环境缺少哪些翻译。然后,您可以提交一个包含缺失翻译的拉取请求到 GitHub 仓库。
如果您在 Filament 中发现安全漏洞,请通过 GitHub 报告。 所有安全漏洞都将得到及时解决。 请查阅我们的版本支持策略 以了解哪些版本目前正在维护中。
请注意,Filament 发布时附带一份贡献者行为准则. 参与本项目,即表示您同意遵守其条款。