howlowck / settings-l4
此软件包最新版本(dev-master)没有提供许可证信息。
dev-master
2014-01-08 22:42 UTC
Requires
- php: >=5.4.0
- howlowck/html-builder: *
- illuminate/support: ~4
This package is not auto-updated.
Last update: 2024-09-23 14:09:21 UTC
README
此软件包旨在轻松更改管理员可以更改的应用程序级别设置。
设置
- 在您的应用 composer.json 中包含
"howlowck/settings-l4": "dev-master",
- 运行
composer update
- 通过在
app/config/app.php
中添加'Howlowck\SettingsL4\SettingsL4ServiceProvider',
来添加服务提供者 - 通过在
app/config/app.php
中添加'Setting' => 'Howlowck\SettingsL4\Facade\Setting'
来添加设置外观 - 运行
php artisan config:publish howlowck/settings-l4
- 使用表名 'settings' 生成您自己的迁移。(如果您想使用名为其他名称的表,请更改配置文件中的 'table' 配置项)
- 生成一行数据的种子。(对于设置正常工作是必需的)
配置
在 app/config/howlowck/settings-l4/config.php
table
--- 表名
db
--- 是否使用数据库或redis
user_column
--- 如果要捕获更改设置的用户,则指定用户列名(尚未实现)
controller
--- 控制器名称
route_path
--- 获取设置资源控制器路由的路径
route_before
--- 执行路由前的过滤器字符串
route_after
--- 执行路由后的过滤器字符串
form_types
--- 输入类型与数据库数据字段关联的关联数组,* 是默认值
使用方法
设置软件包允许您以各种方式与设置交互。
基本用法
Setting::get($settingName)
返回具有该名称设置的值 Setting::set($settingName, $settingValue)
将值设置为设置名称 Setting::all()
以数组形式返回所有设置
内置视图和路由
- 在 routes.php 中包含
Setting::route()
,这将为您设置控制器设置一个路由组。您可以在配置文件中更改路径和过滤器的 before/after。 - 将设置控制器从
vendors/howlowck/settings-l4/src/controllers/SettingsController.php
复制到您的控制器文件夹。您可以根据需要更改控制器的名称,只需更改配置文件中的 'controller' 配置项即可。 - 运行
php artisan asset:publish howlowck/settings-l4
- 现在,当您访问任何路径
path/to/settings/settingName/edit
时,您将看到一个允许您编辑值的 UI。
可用的路径只有 path/to/settings
和 path/to/settings/settingName
创建自己的视图
如果您希望创建自己的视图,可以使用以下函数:Setting::getTitle($settingName)
--- 返回设置的标题
Setting::getField($settingName)
--- 返回设置的域
Settings::getUpdateUrl($settingName)
--- 返回用于表单 action 属性的正确 URL