doctype_admin/settings

Doctype Admin Panel Settings Plugin

v1.0.4 2020-10-08 09:38 UTC

Requires

• intervention/image: ^2.4@dev

Requires (Dev)

• orchestra/testbench: 5.x-dev

MIT

• Pratik Shrestha

README

Laravel 7 Admin Panel Settings Plugin for lazy developers.

Contains : -

• Setting Management System

Installation

Run Composer Require Command

composer require doctype_admin/settings

Then migrate database

php artisan migrate

To use specific seed use(publish them first)

php artisan db:seed --class=SettingsTableSeeder

If you want to modify Stuffs do..

Install package assets

Install all assets

php artisan DoctypeAdminSetting:install -a

This command will publish

• config file named Setting.php
• views files of setting
• migrations files
• seed files

Install config file only

php artisan DoctypeAdminSetting:install -c

Install view files only

php artisan DoctypeAdminSetting:install -f

Install migrations files only

php artisan DoctypeAdminSetting:install -m

Install seed files only

php artisan DoctypeAdminSetting:install -d

Note

If seed class is not found try running composer dump-autoload

To add the package route link to be accesable from sidemenu just add following on config/adminlte.php under key 'menu'

        [
            'text' => 'Setting',
            'icon' => 'fas fa-cog',
            'url' => 'admin/setting'
        ],

Setting Plugin Consists following input fields

• Text Field
• Rich Textarea
• Image
• Select
• Radio
• Checkbox

How to access setting value ?

We can access setting's assigned value globally by simply using blade directive like

{{@setting('setting_name')}} // setting_name is one you make while you are creating setting (should be lower cap with space replaced by underscore(_) : Recommended)

e.g

if we have a setting and you name that setting "Site name" then to use the value assigned to that setting use

{{@setting('site_name')}}

Customization

It uses JSON object to customize the input fields.

Customization Objects

Example

Simple Text Field Setting Customization

{
  "class" : "my_class",
  "id" : "my_id",
  "value" : "Doctype Admin",
  "placeholder" : "Site Title Here!!",
  "style" : {
    "color" : "red"
  }
}

Simple Rich Textarea Setting Customization

{
  "class" : "my_class",
  "id" : "another_id",
  "placeholder" : "Rich Text Placeholder",
  "style" : {
    "color" : "red"
  }

Simple Select Field Setting Customization

{
  "default" : "1",
  "options" : {
    "1" : "option 1",
    "2" : "option 2"
  }
}

Simple Radio Field Setting Customization Note type object is mandatory defining whetjer the value to be stored is integer or string type

{
  "type" : "integer",
   "checked" : "1",
  "options" : {
  "1" : "Pratik Shrestha",
  "2" : "DRH2SO4"
            },
"style": {
  "color" : "red"
      }
}

Simple Image Field Setting Customization

{
  "image" : {
    "fit" : {
      "width" : "300",
      "height" : "300"
    },
    "quality" : "80"
  }
}

Note

When using select and radio giving options object in customization is mandatory

Admin Panel Screenshot

Todos

• Better Confile File Control
• Maintainabilty
• More flexible customization
• Adding Exceptions

Package Used

• http://image.intervention.io/

License

MIT

DOCTYPE NEPAL ||DR.H2SO4