README

管理员轻松更改应用设置的界面。使用 Laravel Backpack。支持 Backpack v4、v5 和 v6。

安全更新和重大更改

请 订阅 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
# For Backpack v6
php artisan backpack:add-menu-content "<x-backpack::menu-item title='Settings' icon='la la-cog' :link=\"backpack_url('setting')\" />"
# For Backpack v5 or v4
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

程序员

就像使用虚拟设置.php 文件中的任何配置值一样使用它。不过，值存储在数据库中，并在启动时检索，而不是存储在文件中。

Setting::get('contact_email')
// or
Config::get('settings.contact_email')

添加新设置

设置存储在数据库的 "settings" 表中。其列包括

• id (例如：1)
• key (例如：contact_email)
• name (例如：联系表单电子邮件地址)
• description (例如：所有电子邮件都发送到的电子邮件地址.)
• value (例如： admin@laravelbackpack.com)
• field (JSON 格式的 Backpack CRUD 字段配置。字段的 "name" 必须是 强制性的 "value") - 请参阅字段类型及其配置代码 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/ui.php 覆盖 Backpack 的 show_powered_by 设置。

1. 在您的设置数据库中创建设置条目。您可以手动添加设置，或通过 Laravel 种子。插入到数据库中的值应类似于以下内容

   对于 Backpack show_powered_by 设置

注意： field 列应该是 JSON 字符串。JSON 字符串中的 name 键应该是 value。使用任何其他键将不起作用。

1. 打开 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.show_powered_by')) {
   +           $config['backpack.ui.show_powered_by'] = config('settings.show_powered_by') == '1';
   +       }
   +       config($config);
   +   }
   }

截图

见 backpackforlaravel.com

• 列表视图：
• 使用电子邮件字段类型编辑设置

变更日志

请参阅CHANGELOG了解最近有哪些变更。

测试

$ composer test

贡献

请参阅CONTRIBUTING获取详细信息。

覆盖功能

如果您需要修改项目中的工作方式

• 创建一个routes/backpack/settings.php文件；包会看到这个文件，并加载您的路由文件，而不是包中的路由文件；
• 创建扩展包中类的控制器/模型，并在新的路由文件中使用它们；
• 修改新的控制器/模型中的任何内容；

安全

如果您发现任何安全相关的问题，请通过电子邮件tabacitu@backpackforlaravel.com联系，而不是使用问题跟踪器。

请 订阅 Backpack 通讯，以便了解任何安全更新、重大更改或新功能。我们每 1-2 个月发送一封电子邮件。

鸣谢

• Cristian Tabacitu
• 所有贡献者

许可证

Backpack对非商业用途是免费的，商业用途为69 EUR/项目。请参阅许可证文件和backpackforlaravel.com获取更多信息。

雇佣我们

我们已经在Laravel上创建、打磨和维护管理面板超过了50,000小时。我们开发了电子商务、在线学习、ERP系统、社交网络、支付网关等等。我们在管理面板上工作得如此之多，以至于我们创造了该领域最受欢迎的软件之一——仅仅是从我们项目的重复性内容中公开。

如果您正在寻找一个开发者/团队来帮助您在Laravel上构建管理面板，那就无需再找了。您很难找到有更多经验和对此充满热情的人。这就是我们做的事。联系我们。让我们看看我们是否可以合作。