bakerkretzmar/nova-settings-tool

Laravel Nova 工具,用于管理应用程序设置。

2.0.5 2024-02-21 23:59 UTC

This package is auto-updated.

Last update: 2024-09-22 01:21:22 UTC


README

Latest Version on Packagist Total Downloads Build License: MIT

在 Nova 中直接存储和编辑简单的全局设置。设置以 JSON 格式存储,使用 spatie/valuestore,使其非常容易在应用程序的任何其他地方调用和使用。

Settings Tool screenshot

安装

使用 Nova 在任何 Laravel 应用程序中通过 Composer 安装此包

composer require bakerkretzmar/nova-settings-tool

Nova Settings Tool v2 需要 Nova 4——对于 Nova 的旧版本,请使用此包的 v1。

将默认配置文件发布到 config/nova-settings-tool.php

php artisan vendor:publish --tag="nova-settings-tool"

在您的 NovaServiceProvidertools 方法中注册此工具

// in app/Providers/NovaServiceProvider.php

use Bakerkretzmar\NovaSettingsTool\SettingsTool;

    // ...

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

使用方法

设置在 nova-settings-tool.php 配置文件中声明。此文件指定了设置存储的位置,工具在 Nova 侧边栏中的标题,设置页面的布局以及有关设置本身的元数据。

包含一些有用示例的 默认配置文件 作为起点

settings 数组中的每个项目都渲染为一个带有标签和帮助文本的输入框,类似于 Nova 中的一个字段。设置也可以分组到面板中,以便在视觉上分开它们。

设置的实际值存储在配置文件中指定的位置——默认情况下为 storage/app/settings.json

目前有六种可用的设置类型

  • text:单行文本输入
  • textarea:多行文本输入
  • toggle:布尔开关
  • codeCodeMirror 文本编辑器
  • number:数字输入
  • select:单选下拉菜单

此包中的所有字符串以及您传递给它的任何字符串都可以通过 Laravel 的内置本地化功能 轻松翻译。

此工具还会在任何设置更改时触发一个事件,附带所有旧的和新的设置。

路线图

以下功能正在计划或开发中

  • color 设置类型
  • date 设置类型
  • file 设置类型
  • 设置验证

CHANGELOGCONTRIBUTINGLICENSE