README

Modules 是一个 FilamentPHP 插件，可轻松集成 nwidart/laravel-modules

注意：这些文档适用于 v3，仅支持 Filament 3。如果您使用的是 Filament v2，请在此处查看文档以开始。

安装

要求

1. Filament >= 3
2. PHP >= 8.1
3. Laravel >= 9.0
4. Livewire >= 3.0
5. nwidart/laravel-modules >=10.0

安装

• 请确保您已安装并配置了 Laravel Modules (遵循以下说明)
• 请确保您已安装并配置了 Filamentphp (遵循以下说明)
• 您现在可以通过 composer 安装此包

composer require coolsam/modules

用法

在此指南中，我们将使用 博客模块 作为示例

创建您的 Laravel 模块

如果您要工作的模块不存在，请使用 nwidart/laravel-modules 创建它

php artisan module:make Blog # Create the blog module

在您的模块中生成一个新的面板

php artisan module:make-filament-panel admin Blog # php artisan module:make-filament-panel [id] [module]

如果未传递任何参数，则命令将交互式地请求每个参数。在此示例中，如果传递的面板 ID 为 admin 且模块为 blog，则命令将生成一个 ID 为 blog::admin 的面板。此 ID 应用于下一步生成资源、页面和小部件时。在此步骤中，请使用此 ID。

按常规生成您的资源、页面和小部件，选择您刚刚创建的面板。

从现在开始，像平常一样使用 filament 生成 resources、Pages 和 Widgets。请确保指定之前生成的 ID 作为 --panel 选项。如果不传递 --panel 选项，则命令将交互式地请求它。

# For each of these commands, the package will ask for the Model and Panel.
php artisan make:filament-resource
php artisan make:filament-page
php artisan make:filament-widget

# The Model and Panel arguments are passed inline
php artisan make:filament-resource Author blog::admin
php artisan make:filament-page Library blog::admin
php artisan make:filament-widget BookStats blog::admin

完成！ 对于生成的每个面板，您可以通过导航到 module-path/panel-path 来访问它，例如 blog/admin，以访问您的面板以及资源链接和页面。

测试

composer test

变更日志

请查看变更日志以获取有关最近更改的更多信息。

贡献

请查看贡献指南以获取详细信息。

安全漏洞

请查阅我们的安全策略了解如何报告安全漏洞。

鸣谢

• Sam Maosa
• 所有贡献者

许可协议

MIT 许可协议 (MIT)。请参阅许可文件以获取更多信息。