Dcat Admin Extension

https://github.com/ycookies/dcatplus-demo
Admin
An extension designed to add new features or enhance the functionality of the Dcat Admin framework.
Tokens:4,668
Snippets:9
Trust Score:7.7
Update:1 year ago
Show doc for...
Tokens:
Raw
### PHP Route Configuration Examples

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

Defines the routes for the dcatplus-demo extension, including the main entry point, layout demonstrations, grid examples, form examples, component routes, and data API endpoints. This configuration uses PHP and the IlluminateSupportFacadesRoute facade.

```php
use Illuminate\Support\Facades\Route;

Route::prefix('dcatplus-demo')
    ->namespace('Dcat\Admin\DcatplusDemo\Http\Controllers')
    ->group(function () {
        // Main entry
        Route::get('/', DcatplusDemoController::class.'@index');

        // Layout demos
        Route::get('layout', 'Full\LayoutController@index');

        // Grid examples
        Route::get('reports', 'Full\ReportController@index');
        Route::get('reports/preview', 'Full\ReportController@preview');
        Route::get('merge-cell', 'Full\MergeCellController@index');
        Route::get('fixed-columns', 'Full\FixedController@index');
        Route::get('tree', 'Full\GridTreeController@index');
        Route::resource('grid', 'Full\GridController', ['except' => ['create', 'show', 'destroy']]);

        // Form examples
        Route::get('forms', 'Full\FormController@index');
        Route::get('form/step', 'Full\StepFormController@index');
        Route::post('form/step', 'Full\StepFormController@store');
        Route::get('form/modal', 'Full\ModalFormController@index');
        Route::get('form/when', 'Full\FormWhenController@index');

        // Form layouts
        Route::get('form/layout/column', 'Full\FormColumnController@create');
        Route::get('form/layout/block', 'Full\FormBlockController@create');
        Route::get('form/layout/tab', 'Full\FormTabController@create');
        Route::get('form/layout/row', 'Full\FormRowController@create');

        // Components
        Route::get('full-widget', 'Full\FullWidgetController@index');
        Route::get('components/charts', 'Components\ChartController@index');
        Route::get('components/cards', 'Components\CardController@index');
        Route::get('components/loading', 'Components\LoadingController@index');
        Route::get('components/modal', 'Components\ModalController@index');
        Route::get('components/timeline', 'Components\TimelineController@index');

        // Data from API examples
        Route::resource('movies/in-theaters', 'Movies\InTheaterController', ['except' => ['create', 'show']]);
        Route::get('movies/top250', 'Movies\Top250Controller@index');
    });
```

--------------------------------

### Install Dcatplus Demo Extension with Composer

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

This command adds the Dcatplus Demo extension package to your Laravel project using Composer. The service provider is automatically discovered and registered by Laravel.

```bash
# Add the package to your Laravel project
composer require ycookies/dcatplus-demo

# The service provider registers automatically via Laravel's auto-discovery
# Access the demo at: http://your-domain/admin/dcatplus-demo
```

--------------------------------

### PHP Card Widget Component Examples

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

Demonstrates how to create and customize card components in PHP using the Dcat Admin framework. It covers various styles, including headers, footers, badges, collapsible, and removable cards. This component is part of the Dcat Admin widget library.

```php
namespace Dcat\Admin\DcatplusDemo\Http\Controllers\Components;

use Dcat\Admin\Layout\Content;
use Dcat\Admin\Layout\Row;
use Dcat\Admin\Widgets\Card;
use Illuminate\Routing\Controller;

class CardController extends Controller {
    public function index(Content $content) {
        return $content
            ->header('普通卡片')
            ->breadcrumb(
                ['text' => 'Dcat-Plus 示例大全', 'url' => '/dcatplus-demo'],
                ['text' => '页面组件', 'url' => '/dcatplus-demo/full-widget'],
                ['text' => '普通卡片']
            )
            ->row(function (Row $row) {
                // Various card styles
                $row->column(3, Card::make('标题','内容')->withHeaderBorder()->outline());
                $row->column(3, Card::make('标题','内容')->withHeaderBorder()->setCardColor());
                $row->column(3, Card::make('标题','内容')->withHeaderBorder());

                // Card with warning outline
                $row->column(3, Card::make('标题','内容')
                    ->withHeaderBorder()
                    ->outline('card-warning'));

                // Card with footer
                $row->column(3, Card::make('标题','内容')
                    ->withHeaderBorder()
                    ->outline('card-success')
                    ->footer('这是尾部'));

                // Card with badge tool
                $row->column(3, Card::make('标题','内容')
                    ->withHeaderBorder()
                    ->tool('<span class="badge badge-pill badge-primary">123</span>'));

                // Collapsible card
                $row->column(3, Card::make('标题','内容')->withHeaderBorder()->collapse());

                // Removable card
                $row->column(3, Card::make('标题','内容')->withHeaderBorder()->remove());
            });
    }
}
```

--------------------------------

### Dcatplus Demo Main Dashboard Controller

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

This PHP controller code defines the main dashboard for the Dcatplus Demo extension. It uses Dcat Admin's layout classes to render a welcome page with dynamic content widgets, including author cards, cover cards, a list of updates, and a timeline.

```php
namespace Dcat\Admin\DcatplusDemo\Http\Controllers;

use Dcat\Admin\Layout\Content;
use Dcat\Admin\Layout\Row;
use Dcat\Admin\Layout\Column;
use Dcat\Admin\Widgets\Card;
use Dcat\Admin\Widgets\CoverCard;
use Dcat\Admin\Widgets\ListGroup;
use Dcat\Admin\Widgets\Timeline;
use Illuminate\Routing\Controller;

class DcatplusDemoController extends Controller {
    public function index(Content $content) {
        return $content
            ->title('Dcat-plus 示例大全')
            ->description('降低学习成本的示例集合')
            ->row(function (Row $row) {
                // Author card in left column
                $row->column(4, function (Column $column) {
                    $column->row(Card::make('作者展示', view('ycookies.dcatplus-demo::author')));
                });

                // Cover cards and updates in right column
                $row->column(8, function (Column $column) {
                    $column->row(function (Row $row) {
                        $cover = CoverCard::make()
                            ->add('开源公众号','关注公众号 随时了解更新动态')
                            ->bg('https://dcat-plus.saishiyun.net/img/card-bg1.jpeg')
                            ->avatar('https://dcat-plus.saishiyun.net/img/wxgzh_qrcode.jpg');
                        $row->column(6, $cover->render());
                    });

                    // Recent updates list
                    $list = ListGroup::make();
                    $list->add('让DcatAdmin再放光芒', '2024-07-10', 'https://learnku.com/articles/87518');
                    $column->row(Card::make('Dcatplus 动态', $list->render()));

                    // Timeline widget
                    $timeline = Timeline::make();
                    $timeline->add('2024-07-10', '更新发布2种实用页面组件', '12:58', '<ul><li>列表组vue版，时间轴vue版</li></ul>')
                             ->icons('fa fa-get-pocket bg-blue');
                    $column->row(Card::make('扩展包-更新日志', $timeline->render())->withHeaderBorder());
                });
            });
    }
}
```

--------------------------------

### Register Dcatplus Demo Service Provider and Menu Items

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

This PHP code snippet demonstrates the registration of a service provider for the Dcatplus Demo extension. It automatically registers CSS and JavaScript assets and defines a navigation menu structure for the admin panel.

```php
namespace Dcat\Admin\DcatplusDemo;

use Dcat\Admin\Extend\ServiceProvider;

class DcatplusDemoServiceProvider extends ServiceProvider {
    protected $js = ['js/index.js'];
    protected $css = ['css/index.css'];

    protected $menu = [
        [
            'title' => 'Dcat-plus 示例大全',
            'uri'   => 'dcatplus-demo',
            'icon'  => 'feather icon-monitor',
        ],
        [
            'parent' => 'Dcat-plus 示例大全',
            'title'  => '数据表格',
            'icon'   => 'feather icon-grid',
            'uri'    => '',
        ],
        [
            'parent' => '数据表格',
            'title'  => '默认表格',
            'icon'   => 'feather icon-menu',
            'uri'    => 'dcatplus-demo/grid',
        ]
    ];

    public function init() {
        parent::init();
    }
}
```

--------------------------------

### Dcatplus Demo Extension Composer Package Configuration

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

This JSON object defines the metadata for the Dcatplus Demo Composer package. It specifies the package name, type, PHP version requirement, and dependencies, including Laravel-Admin.

```json
{
  "name": "ycookies/dcatplus-demo",
  "type": "library",
  "require": {
    "php": ">=7.1.0",
    "dcat-plus/laravel-admin": "~1.0"
  },
  "autoload": {
    "psr-4": {
      "Dcat\\Admin\\DcatplusDemo\": "src/"
    }
  }
}
```

--------------------------------

### PHP Data Grid with Filtering and Actions - Dcat Admin

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

This PHP code defines a controller for displaying an interactive data grid using the Dcat Admin framework. It includes features for column formatting, expandable rows, interactive column types, grid configurations, and advanced filtering with multiple operators. Dependencies include the Dcat Admin package and Faker for data generation.

```php
namespace Dcat\Admin\DcatplusDemo\Http\Controllers\Full;

use Dcat\Admin\Grid;
use Dcat\Admin\Layout\Content;
use Faker\Factory;
use Illuminate\Routing\Controller;

class GridController extends Controller {
    public function index(Content $content) {
        return $content
            ->header('表格')
            ->description('表格功能展示')
            ->body($this->grid());
    }

    protected function grid() {
        return new Grid(null, function (Grid $grid) {
            $grid->number();
            $grid->column('id')->code()->sortable();
            $grid->column('label')->explode()->label();
            $grid->column('progressBar')->progressBar()->sortable();

            // Expandable row with nested table
            $grid->column('expand')
                ->display(Factory::create()->name)
                ->expand(PostTable::make());

            // Interactive columns
            $grid->column('select')->select(['GET', 'POST', 'PUT', 'DELETE']);
            $grid->column('switch')->switch();
            $grid->column('switchGroup', 'Switch Group')
                ->if(function () { return $this->id != mt_rand(3, 5); })
                ->switchGroup(['is_new', 'is_hot', 'published']);

            $grid->column('checkbox')->checkbox(['GET', 'POST', 'PUT', 'DELETE']);
            $grid->column('radio')->radio(['PHP', 'JAVA', 'GO', 'C']);

            // Grid configuration
            $grid->disableCreateButton();
            $grid->disableActions();
            $grid->model()->setData($this->generate());

            // Advanced filter with multiple operators
            $grid->filter(function (Grid\Filter $filter) {
                $group = function (Grid\Filter\Group $group) {
                    $group->equal('等于');
                    $group->gt('大于');
                    $group->lt('小于');
                    $group->like('包含');
                    $group->match('正则');
                };
                $filter->group('id', $group)->width('350px');
                $filter->equal('select')->select(range(1, 10));
                $filter->between('between')->datetime();
            });
        });
    }

    protected function generate() {
        $faker = Factory::create();
        $data = [];
        for ($i = 0; $i < 10; $i++) {
            $data[] = [
                'id' => $i+1,
                'label' => str_repeat($faker->name().',', mt_rand(1, 2)),
                'progressBar' => mt_rand(1, 100),
                'switch' => mt_rand(0, 1),
                'checkbox' => join(',', [mt_rand(0,3), mt_rand(0,3)]),
                'radio' => mt_rand(0, 3)
            ];
        }
        return $data;
    }
}

```

--------------------------------

### PHP Multi-Step Form with Validation

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

This PHP code defines a controller for creating multi-step forms. It utilizes the Dcat Admin framework's `Form` and `multipleSteps` components to manage form progression and validation. The form includes various field types and supports both HTML5 and backend validation rules, along with custom step event handlers and a completion page.

```php
namespace Dcat\Admin\DcatplusDemo\Http\Controllers\Full;

use Dcat\Admin\Form;
use Dcat\Admin\Form\Steps\Form as StepForm;
use Dcat\Admin\Layout\Content;
use Illuminate\Routing\Controller;

class StepFormController extends Controller {
    public function index(Content $content) {
        return $content
            ->body($this->form())
            ->header('Step Form')
            ->description('分步表单DEMO');
    }

    protected function form() {
        return new Form(null, function (Form $form) {
            $form->title('分步表单');
            $form->action('dcatplus-demo/form/step');

            $form->multipleSteps()
                ->remember()
                ->width('950px')
                ->add('基本信息', function (StepForm $step) {
                    $step->text('name', '姓名')->required()->maxLength(20);

                    // HTML5 validation
                    $step->text('age', '年龄')
                        ->required()
                        ->type('number')
                        ->attribute('max', 150)
                        ->help('前端验证');

                    $step->radio('sex', '性别')->options(['未知', '男', '女'])->default(0);

                    // Backend validation
                    $step->text('birthplace', '籍贯')
                        ->rules('required')
                        ->help('演示后端字段验证');

                    $step->url('homepage', '个人主页');
                    $step->textarea('description', '简介');
                })
                ->add('兴趣爱好', function (StepForm $step) {
                    $step->tags('hobbies', '爱好')
                        ->options(['唱', '跳', 'RAP', '踢足球'])
                        ->required();

                    $step->text('books', '书籍');
                    $step->text('music', '音乐');

                    // Step event handler
                    $step->shown(function () {
                        return <<<JS
    Dcat.info('兴趣爱好');
    console.log('兴趣爱好', args);
JS;
                    });
                })
                ->add('地址', function (StepForm $step) {
                    $step->text('address', '街道地址');
                    $step->text('post_code', '邮政编码');
                    $step->tel('tel', ' 联系电话');
                })
                ->done(function () use ($form) {
                    $resource = $form->resource(0);
                    return view('admin::form.steps.completion-page', [
                        'title' => '操作成功',
                        'description' => '恭喜您成为第10086位用户',
                        'createUrl' => $resource,
                        'backUrl' => $resource
                    ]);
                });
        });
    }

    public function store() {
        return $this->form()->saving(function (Form $form) {
            // Clear step cache
            $form->multipleSteps()->flushStash();

            // Return completion page
            return response(
                $form->multipleSteps()->done()->render()
            );
        })->store();
    }
}

```

--------------------------------

### PHP Form Controller for Dcat Admin

Source: https://context7.com/ycookies/dcatplus-demo/llms.txt

This PHP controller demonstrates how to create and render complex forms using the Dcat Admin package. It includes methods for generating two distinct forms with various field types, utilizing features like tabs, conditional logic, nested forms, and file uploads. The controller assumes the existence of models like SettingModel and Administrator, and helper classes like UserTable.

```php
namespace Dcat\Admin\DcatplusDemo\Http\Controllers\Full;

use Dcat\Admin\Widgets\Form;
use Dcat\Admin\Layout\Content;
use Dcat\Admin\Widgets\Tab;
use Dcat\Admin\Form\NestedForm;
use Illuminate\Routing\Controller;

class FormController extends Controller {
    public function index(Content $content) {
        $content->row(function (Row $row) {
            $tab = new Tab();
            $tab->add('Form-1', $this->form1(), false, 'Form-1');
            $tab->add('Form-2', $this->form2(), false, 'Form-2');
            $tab->title('<h1 class="text-warning">表单示例大全</h1>');
            $row->column(12, $tab->withCard());
        });

        return $content->header('Form');
    }

    protected function form1() {
        $form = Form::make(new SettingModel());
        $form->action(request()->fullUrl());

        // Basic input fields
        $form->text('form1.text', 'text')->required();
        $form->password('form1.password', 'password')->required();
        $form->email('form1.email', 'email');
        $form->mobile('form1.mobile', 'mobile');
        $form->url('form1.url', 'url');
        $form->ip('form1.ip', 'ip');
        $form->color('form1.color', 'color');

        $form->divider();

        // Advanced selection fields
        $form->selectTable('form1.select-table', 'Select Table')
            ->title('User')
            ->from(UserTable::make())
            ->model(Administrator::class, 'id', 'name');

        $form->multipleSelectTable('form1.select-resource-multiple', 'Multiple Select Table')
            ->title('User')
            ->max(4)
            ->from(UserTable::make())
            ->model(Administrator::class, 'id', 'name');

        // Special fields
        $form->icon('form1.icon', 'icon');
        $form->rate('form1.rate', 'rate');
        $form->decimal('form1.decimal', 'decimal');
        $form->currency('form1.currency', 'currency');
        $form->switch('form1.switch', 'switch')->default(1);

        $form->divider();

        // Date and time fields
        $form->date('form1.date', 'date');
        $form->datetime('form1.datetime', 'datetime');
        $form->dateRange('form1.date-start', 'form1.date-end', 'date range');
        $form->datetimeRange('form1.datetime-start', 'form1.datetime-end', 'datetime range');

        // Conditional display with radio when()
        $form->radio('mode', '登陆方式')
            ->options([1 => '账号登陆', 2 => 'token登陆'])
            ->when([1], function (Form $form) {
                $form->text('discord.account')->rules(['require']);
                $form->text('discord.password')->rules(['require']);
            })
            ->when([2], function (Form $form) {
                $form->text('discord.token')->rules(['require']);
            })
            ->default(2);

        // Table field for dynamic rows
        $form->table('table', function (NestedForm $table) {
            $table->text('key');
            $table->text('value');
            $table->text('desc');
        });

        return "<div style='padding:10px 8px'>{$form->render()}</div>";
    }

    protected function form2() {
        $form = new Form();
        $names = $this->createNames();

        $form->select('form2.select', 'select')->options($names);
        $form->multipleSelect('form2.multiple-select', 'multiple select')->options($names);
        $form->image('form2.image', 'image');
        $form->multipleFile('form2.multiple-file', 'multiple file')->limit(3);
        $form->checkbox('form2.checkbox', 'checkbox')
            ->options(['GET', 'POST', 'PUT', 'DELETE'])
            ->canCheckAll()
            ->default(1);
        $form->radio('form2.radio', 'radio')
            ->options(['GET', 'POST', 'PUT', 'DELETE'])
            ->default(0);

        $form->editor('form2.editor', 'editor');
        $form->markdown('form2.markdown', 'markdown');

        return "<div style='padding:9px 8px'>{$form->render()}</div>";
    }
}
```
Tokens:
Raw