Code Monkey home page Code Monkey logo

laravel-site-settings's Introduction

Easy laravel cached settings

Easy laravel cached settings (stored in MYSQL) package with MoonShine/Filament Laravel Admin GUI

Latest Version on Packagist Total Downloads

Installation

You can install the package via composer:

composer require visual-ideas/laravel-site-settings

You must run the migrations with:

php artisan migrate

You can publish the config file with:

php artisan vendor:publish --provider="VI\LaravelSiteSettings\LaravelSiteSettingsProvider" --tag="config"

This is the contents of the published config file:

return [
    'cache_key' => env('LSS_CACHE_KEY','laravel_site_settings_data'),
   
    // Set to true if you're using Filament (https://filamentphp.com/)
    'filament' => false,
];

Usage

You can use this package as default laravel config() function!

function settings($key = null, $default = null)
{
    if (is_null($key)) {
        return app('Settings')->all();
    }

    if (is_array($key)) {
        return app('Settings')->set($key);
    }

    return app('Settings')->get($key, $default);
}

or Blade directive @settings

@settings('group.setting')

For PHPStorm you can set this blade directive with This instruction

or as part of native Laravel config()

@config('settings.group.setting')

Not working in console!

Update settings

You can use models VI\LaravelSiteSettings\Models\SettingGroup and VI\LaravelSiteSettings\Models\Setting

or set settings values with the settings() function:

settings(['group.setting' => 'Value']);
settings(['setting' => 'Value']);

Usage with MoonShine Laravel Admin panel

Please see MoonShine

You can use settings in your MoonShine admin panel, like this:

MenuGroup::make('Settings', [
    MenuItem::make(
        'Setting groups',
        new \VI\LaravelSiteSettings\MoonShine\Resources\SettingGroupResource(),
        'heroicons.outline.wrench-screwdriver'
    ),
    MenuItem::make(
        'Settings',
        new \VI\LaravelSiteSettings\MoonShine\Resources\SettingResource(),
        'heroicons.outline.wrench'
    ),
], 'heroicons.outline.cog-8-tooth'),

Usage with Filament Laravel Admin panel

Please see Filament

You can use settings in your Filament admin panel!

Just change config file:

    //...   
    // Set to true if you're using Filament (https://filamentphp.com/)
    'filament' => true,
    //...

Seeding settings

I recommend saving the settings in the seeders using the orangehill/iseed package:

php artisan iseed setting_groups,settings

But you can use seeder or migration to set your settings

settings([
    ['group.setting1' => 'Value1'],
    ['group.setting2' => 'Value2'],
    ['group.setting3' => 'Value3'],
    ['setting1' => 'Value4'],
    ['setting2' => 'Value5'],
    ['setting3' => 'Value6'],
    ['setting4' => 'Value7'],
    ['setting5' => 'Value8']
]);

Credits

License

The MIT License (MIT). Please see License File for more information.

laravel-site-settings's People

Contributors

alexvenga avatar sweet1s avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

laravel-site-settings's Issues

Error on seeding

Just installed this package into MoonShine v1.64 project and followed your instructions in README: ran migrations, published config, etc. Then I made a new console command to seed my database:

settings([
            ['group.setting1' => 'Value1'],
            ['group.setting2' => 'Value2'],
            ['group.setting3' => 'Value3'],
            ['setting1' => 'Value4'],
            ['setting2' => 'Value5'],
            ['setting3' => 'Value6'],
            ['setting4' => 'Value7'],
            ['setting5' => 'Value8']
        ]);

Then tried to run the command and got the following error:


   Illuminate\Database\QueryException 

  Array to string conversion (Connection: mysql, SQL: insert into `settings` (`setting_group_id`, `slug`, `value`, `updated_at`, `created_at`) values (?, 0, ?, 2023-11-21 10:36:25, 2023-11-21 10:36:25))

  at vendor\laravel\framework\src\Illuminate\Database\Connection.php:822
    818тЦХ                     $this->getName(), $query, $this->prepareBindings($bindings), $e
    819тЦХ                 );
    820тЦХ             }
    821тЦХ 
  тЮЬ 822тЦХ             throw new QueryException(
    823тЦХ                 $this->getName(), $query, $this->prepareBindings($bindings), $e
    824тЦХ             );
    825тЦХ         }
    826тЦХ     }

  1   vendor\laravel\framework\src\Illuminate\Database\Connection.php:722
      ErrorException::("Array to string conversion")

  2   vendor\laravel\framework\src\Illuminate\Database\Connection.php:722
      PDOStatement::bindValue(["Value1"])

Перевод

Нужен перевод пакета, лично использую на разных проектах, которые требуют разные языки. Давно висит PR по переводу для MoonshineAdminPanel

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.