haiau009 / settings
使用Backpack CRUD的Laravel 5应用程序设置界面。
Requires
- haiau009/crud: ^1.0.0
- haiau009/laravel-caching-model: ^1.0.0
Requires (Dev)
- phpunit/phpunit: ^9.0||^7.0
- scrutinizer/ocular: ~1.1
README
管理员界面,用于轻松更改应用程序设置。使用Laravel Backpack。支持Laravel 5.2至Laravel 8。
安全更新和重大变更
请订阅Backpack通讯,以了解任何安全更新、重大变更或新功能。我们每月发送1-2封电子邮件。
安装
注意:默认表名为settings
,如需更改,请仔细阅读以下说明中的注释。
在您的终端中
# install the package composer require backpack/settings # [optional] if you need to change table name or migration name, please do it now before proceding php artisan vendor:publish --provider="Backpack\Settings\SettingsServiceProvider" --tag="config" # then change the values you need in in `config/backpack/settings.php` # publish & run the migration php artisan vendor:publish --provider="Backpack\Settings\SettingsServiceProvider" php artisan migrate # [optional] add a menu item for it to the sidebar_content file php artisan backpack:add-sidebar-content "<li class='nav-item'><a class='nav-link' href='{{ backpack_url('setting') }}'><i class='nav-icon la la-cog'></i> <span>Settings</span></a></li>" # [optional] insert some example dummy data to the database php artisan db:seed --class="Backpack\Settings\database\seeds\SettingsTableSeeder"
用法
最终用户
将其添加到菜单或通过其路由访问:application/admin/setting
程序员
就像在任何虚拟settings.php文件中配置值一样使用它。除了值存储在数据库中并在启动时获取,而不是存储在文件中。
Setting::get('contact_email') // or Config::get('settings.contact_email')
添加新设置
设置存储在数据库中的"settings"表中。其列包括
- id(例如:1)
- key(例如:contact_email)
- name(例如:联系表单电子邮件地址)
- description(例如:所有邮件都发送到的电子邮件地址。)
- value(例如:admin@laravelbackpack.com)
- field(Backpack CRUD字段配置的JSON格式。 https://backpackforlaravel.com/docs/crud-fields#default-field-types)
- active(1或0)
- created_at
- updated_at
没有提供添加新设置的界面。它们由开发人员直接在数据库中添加,因为Backpack CRUD字段配置相当复杂。请参阅https://backpackforlaravel.com/docs上的字段类型及其配置代码。
覆盖现有配置
您可以使用此插件通过设置GUI调整各种Laravel配置,包括Backpack本身。例如,您可以通过/config/Backpack/base.php
覆盖Backpack的show_powered_by
或skin
设置。
-
在您的设置数据库中创建设置条目。您可以手动添加设置,或通过Laravel seeders。插入到数据库中的值应类似于以下内容
对于Backpack
show_powered_by
设置对于Backpack
Skin
设置 -
打开
app/Providers/AppServiceProvider
文件,并添加以下行<?php namespace App\Providers; use Illuminate\Support\ServiceProvider; class AppServiceProvider extends ServiceProvider { /** * Bootstrap any application services. * * @return void */ public function boot() { + $this->overrideConfigValues(); } /** * Register any application services. * * @return void */ public function register() { // } + protected function overrideConfigValues() + { + $config = []; + if (config('settings.skin')) + $config['backpack.base.skin'] = config('settings.skin'); + if (config('settings.show_powered_by')) + $config['backpack.base.show_powered_by'] = config('settings.show_powered_by') == '1'; + config($config); + } }
屏幕截图
变更日志
请参阅CHANGELOG以获取最近更改的更多信息。
测试
$ composer test
贡献
请参阅CONTRIBUTING以获取详细信息。
覆盖功能
如果您需要修改项目中的此功能
- 创建一个
routes/backpack/settings.php
文件;包将看到该文件,并加载您自己的路由文件,而不是包中的文件; - 创建扩展包中那些控制器/模型的控制器/模型,并在您的新路由文件中使用它们;
- 在新的控制器/模型中修改您想修改的任何内容;
安全
如果您发现任何与安全相关的问题,请发送电子邮件至 tabacitu@backpackforlaravel.com,而不是使用问题跟踪器。
请订阅Backpack通讯,以了解任何安全更新、重大变更或新功能。我们每月发送1-2封电子邮件。
鸣谢
许可证
Backpack 对非商业用途是免费的,商业用途为每项目 69 欧元。请参阅许可证文件和backpackforlaravel.com获取更多信息。
雇佣我们
我们在 Laravel 上创建、打磨和维护管理面板已经投入了超过 50,000 个小时。我们开发了电子商务、电子学习、ERP、社交网络、支付网关等等。我们在管理面板上投入了如此多的精力,以至于我们创造了一个在其领域中最受欢迎的软件——仅仅是通过公开我们在项目中的重复工作。
如果您正在寻找一个开发者/团队来帮助您在 Laravel 上构建管理面板,那就不要再寻找了。您将很难找到比我们更有经验和热情的人。这就是我们的事业所在。 联系我们。让我们看看我们是否可以合作。