bakerkretzmar / nova-settings-tool
Laravel Nova 工具,用于管理应用程序设置。
2.0.5
2024-02-21 23:59 UTC
Requires
- php: ^7.3|^8.0
- laravel/nova: ^4.0
- spatie/valuestore: ^1.3
Requires (Dev)
- orchestra/testbench: ^7.29|^8.9
- phpunit/phpunit: ^9.5
README
在 Nova 中直接存储和编辑简单的全局设置。设置以 JSON 格式存储,使用 spatie/valuestore
,使其非常容易在应用程序的任何其他地方调用和使用。
安装
使用 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"
在您的 NovaServiceProvider
的 tools
方法中注册此工具
// 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
:布尔开关code
:CodeMirror 文本编辑器number
:数字输入select
:单选下拉菜单
此包中的所有字符串以及您传递给它的任何字符串都可以通过 Laravel 的内置本地化功能 轻松翻译。
此工具还会在任何设置更改时触发一个事件,附带所有旧的和新的设置。
路线图
以下功能正在计划或开发中
color
设置类型date
设置类型file
设置类型- 设置验证