ferdiunal / nova-settings

一个用于管理设置的 Laravel Nova 工具

v1.0.12 2024-09-19 00:11 UTC

This package is auto-updated.

Last update: 2024-09-19 08:16:14 UTC


README

工作进度:此项目正在进行中。功能和文档可能会更改。

Nova Settings 是一个 Laravel Nova 包,它提供了一个直观的界面来使用 Spatie 的设置包来管理设置。

截图

安装

要安装 Nova Settings,您可以使用 Composer

composer require ferdiunal/nova-settings

安装包后,您需要将工具与 Nova 进行注册。将以下内容添加到您的 NovaServiceProvider

// in app/Providers/NovaServiceProvider.php

use Ferdiunal\NovaSettings\NovaSettings;

public function tools()
{
    return [
        new NovaSettings,
    ];
}

创建设置资源

php artisan make:settings-resource GeneralSettings --group General   
# Resource created successfully.
# Resource path: app/NovaSettings/GeneralSettings.php

用法

安装后,您可以从 Nova 仪表板访问设置界面。此界面允许您轻松管理应用程序的设置,而无需编写任何额外的代码。

要使用 SettingsHelper 类,您可以使用提供的 settings 辅助函数。以下是一些示例

use function Ferdiunal\NovaSettings\settings;

// Accessing all settings
$allSettings = settings()->toArray();

// Accessing settings as a collection
$settingsCollection = settings()->toCollection(); // OR
$settingsCollection = settings("general")->toCollection();

// Converting settings to JSON
$jsonSettings = settings()->toJson(); // OR
$jsonSettings = settings("general")->toJson();

// Accessing a specific group of settings
$generalSettings = settings('general')->toArray();

// Accessing a specific setting within a group
$specificSetting = settings('general')->site_name;
$specificSetting = settings('general')->site_name();

// Accessing a nested setting directly
$nestedSetting = settings('general.site_name');

配置

请确保您已经在 Laravel 应用程序中安装并配置了 Spatie 的设置包。您可以按照官方文档中的详细说明进行操作。

特性

  • 易于与 Laravel Nova 集成
  • 用户友好的设置管理界面
  • 兼容 Spatie 的设置包

贡献

欢迎贡献!请随时提交拉取请求或打开问题。

许可协议 此软件包是开源软件,许可协议为 MIT 许可证