haiau009/settings

使用Backpack CRUD的Laravel 5应用程序设置界面。

1.0.0 2023-12-19 18:51 UTC

This package is auto-updated.

Last update: 2024-09-19 20:28:22 UTC


README

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Style CI Total Downloads

管理员界面,用于轻松更改应用程序设置。使用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"表中。其列包括

没有提供添加新设置的界面。它们由开发人员直接在数据库中添加,因为Backpack CRUD字段配置相当复杂。请参阅https://backpackforlaravel.com/docs上的字段类型及其配置代码。

覆盖现有配置

您可以使用此插件通过设置GUI调整各种Laravel配置,包括Backpack本身。例如,您可以通过/config/Backpack/base.php覆盖Backpack的show_powered_byskin设置。

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

    对于Backpack show_powered_by设置

    对于Backpack Skin设置

  2. 打开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);
    +   }
    }

屏幕截图

请访问backpackforlaravel.com

  • 列表视图:Backpack/Settings中的列表/表格视图
  • 使用电子邮件字段类型编辑设置

变更日志

请参阅CHANGELOG以获取最近更改的更多信息。

测试

$ composer test

贡献

请参阅CONTRIBUTING以获取详细信息。

覆盖功能

如果您需要修改项目中的此功能

  • 创建一个routes/backpack/settings.php文件;包将看到该文件,并加载您自己的路由文件,而不是包中的文件;
  • 创建扩展包中那些控制器/模型的控制器/模型,并在您的新路由文件中使用它们;
  • 在新的控制器/模型中修改您想修改的任何内容;

安全

如果您发现任何与安全相关的问题,请发送电子邮件至 tabacitu@backpackforlaravel.com,而不是使用问题跟踪器。

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

鸣谢

许可证

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

雇佣我们

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

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