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

程序员

像处理虚拟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格式。字段的“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获取更多信息。

雇佣我们

我们投入了超过50,000小时来创建、磨光和维护Laravel上的管理面板。我们开发了电子商务、电子学习、ERP、社交网络、支付网关等等。我们从事管理面板工作如此之多，以至于我们创建了这个领域中最受欢迎的软件之一——仅仅是从我们项目的重复性工作中公开。

如果您正在寻找一个开发者/团队来帮助您在Laravel上构建管理面板，那就不用再找了。您将很难找到比这更有经验且热情的人。这就是我们做的。 联系我们。让我们看看是否可以一起工作。