parfumix / nova-settings-tool

一个用于管理应用程序设置的 Laravel Nova 工具。

1.0.1 2019-11-15 19:06 UTC

This package is auto-updated.

Last update: 2024-08-29 05:16:17 UTC


README

Latest Version on Packagist Total Downloads Build StyleCI License: MIT

在 Nova 中直接存储和编辑简单的全局设置。设置以 JSON 格式存储,使用 spatie/valuestore,使其在应用程序的其他地方轻松使用。

Settings Tool screenshot

安装

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

composer require parfumix/nova-settings-tool

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

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

NovaServiceProvidertools 方法中注册此工具

// in app/Providers/NovaServiceProvider.php

use Parfumix\NovaSettingsTool\SettingsTool;

    // ...

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

用法

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

包括了一个 默认配置文件和一些有用的示例 作为起点。

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

设置的实际值以 JSON 格式存储在配置文件中指定的位置——默认为 storage/app/settings.json

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

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

此包中所有的字符串以及传递给它的任何字符串都可以使用 Laravel 内置的本地化功能 简单地翻译。

路线图

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

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

变更日志贡献指南许可证