Nova Settings 项目教程

Nova Settings 项目教程

nova-settingsA Laravel Nova tool for editing custom settings using native Nova fields.项目地址:https://gitcode.com/gh_mirrors/no/nova-settings

1. 项目的目录结构及介绍

Nova Settings 是一个 Laravel Nova 工具，用于编辑自定义设置。以下是其基本目录结构：

nova-settings/
├── config/
│   └── nova-settings.php
├── database/
│   └── migrations/
│       └── 2021_01_01_000000_create_nova_settings_table.php
├── resources/
│   └── views/
│       └── settings.blade.php
├── src/
│   ├── NovaSettings.php
│   ├── NovaSettingsServiceProvider.php
│   └── helpers.php
├── tests/
└── composer.json

• config/：包含项目的配置文件 nova-settings.php。
• database/migrations/：包含数据库迁移文件，用于创建设置表。
• resources/views/：包含视图文件，用于显示设置页面。
• src/：包含主要源代码文件，如 NovaSettings.php 和 NovaSettingsServiceProvider.php。
• tests/：包含测试文件。
• composer.json：项目的依赖管理文件。

2. 项目的启动文件介绍

Nova Settings 的启动文件主要位于 src/ 目录下：

• NovaSettingsServiceProvider.php：这是服务提供者文件，负责注册工具和发布配置文件。

namespace Outl1ne\NovaSettings;

use Illuminate\Support\ServiceProvider;

class NovaSettingsServiceProvider extends ServiceProvider
{
    public function boot()
    {
        $this->publishes([
            __DIR__.'/../config/nova-settings.php' => config_path('nova-settings.php'),
        ], 'config');

        $this->loadMigrationsFrom(__DIR__.'/../database/migrations');
    }

    public function register()
    {
        $this->mergeConfigFrom(__DIR__.'/../config/nova-settings.php', 'nova-settings');
    }
}

• NovaSettings.php：这是工具的主要类文件，负责定义工具的行为和功能。

namespace Outl1ne\NovaSettings;

use Laravel\Nova\Nova;
use Laravel\Nova\Tool;

class NovaSettings extends Tool
{
    public function boot()
    {
        Nova::script('nova-settings', __DIR__.'/../dist/js/tool.js');
        Nova::style('nova-settings', __DIR__.'/../dist/css/tool.css');
    }

    public function renderNavigation()
    {
        return view('nova-settings::navigation');
    }
}

3. 项目的配置文件介绍

Nova Settings 的配置文件位于 config/nova-settings.php，可以通过以下命令发布：

php artisan vendor:publish --provider="Outl1ne\NovaSettings\NovaSettingsServiceProvider" --tag="config"

配置文件内容如下：

return [
    'base_path' => 'nova-settings',
    'reload_page_on_save' => false,
    'models' => [
        'settings' => \Outl1ne\NovaSettings\Models\Settings::class,
    ],
];

• base_path：设置页面的 URL 路径。
• reload_page_on_save：保存设置时是否重新加载整个页面。
• models：可选的设置模型。

通过以上介绍，您可以更好地理解和使用 Nova Settings 项目。

nova-settingsA Laravel Nova tool for editing custom settings using native Nova fields.项目地址:https://gitcode.com/gh_mirrors/no/nova-settings