README

这是一个为Laravel Survey包提供的 Filament 插件。

此包为Laravel Survey提供了 Filament 资源。

要求

• PHP 8.1+
• Laravel 10.0+
• Filament 3.0+

依赖项

• maatwebsite/excel
• matt-daneshvar/laravel-survey
• spatie/eloquent-sortable

安装

安装所需的包（Laravel Survey）

此插件使用Laravel Survey包的修改版本：[https://github.com/tappnetwork/laravel-survey/tree/translatable](https://github.com/tappnetwork/laravel-survey/tree/translatable)，该版本为调查模型添加了可翻译和可排序的字段。更多详细信息请参阅此PR：[matt-daneshvar/laravel-survey#39](https://github.com/matt-daneshvar/laravel-survey/pull/39)。

因此，您必须安装此版本，而不是直接要求 matt-daneshvar/laravel-survey。要做到这一点，请将以下内容添加到您的项目中的 composer.json 文件中：

"require": {
    ...
    "matt-daneshvar/laravel-survey": "dev-translatable",
},

"repositories": [
    ...
    {
        "type": "vcs",
        "url": "https://github.com/TappNetwork/laravel-survey"
    }
],

使用 Composer 进行安装

composer update

发布包迁移

php artisan vendor:publish --provider="MattDaneshvar\Survey\SurveyServiceProvider" --tag="migrations"

运行迁移

php artisan migrate

安装 Filament Survey 插件

通过 Composer 安装插件

composer require tapp/filament-survey:"^3.0"

注意 对于 Filament 2.x，请检查 2.x 分支

可选：发布插件的视图、翻译和配置

您可以使用以下命令发布视图文件：

php artisan vendor:publish --tag="filament-survey-views"

您可以使用以下命令发布翻译文件：

php artisan vendor:publish --tag="filament-survey-translations"

您可以使用以下命令发布配置文件：

php artisan vendor:publish --tag="filament-survey-config"

将插件添加到面板

将此插件添加到 plugins() 方法中的面板（例如，在 app/Providers/Filament/AdminPanelProvider.php 中）。此插件需要Spatie Translatable 插件，因此它也应添加到面板中，如下所示：

use Filament\SpatieLaravelTranslatablePlugin;
use Tapp\FilamentSurvey\FilamentSurveyPlugin;
 
public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([
            FilamentSurveyPlugin::make(),
            SpatieLaravelTranslatablePlugin::make(),
            //...
        ]);
}

就是这样！现在调查、答案和条目资源将在 Filament 管理面板的左侧边栏中显示。要启用部分和问题的专用资源，请发布配置并将 QuestionResource 和 SectionResource 添加到 'resources' 数组中。