README

⛵laravel-admin is administrative interface builder for laravel which can help you build CRUD backends just with few lines of code.

Documentation | 中文文档 | Demo | Demo source code | Extensions

</a>

Inspired by SleepingOwlAdmin and rapyd-laravel.

Requirements

PHP >= 7.0.0
Laravel >= 5.5.0
Fileinfo PHP Extension

Installation

This package requires PHP 7+ and Laravel 5.5, for old versions please refer to 1.4

First, install laravel 5.5, and make sure that the database connection settings are correct.

composer require xn/laravel-admin

Then run these commands to publish assets and config：

php artisan vendor:publish --provider="Xn\Admin\AdminServiceProvider"

php artisan vendor:publish --tag=laravel-admin-checkboxtree

After run command you can find config file in config/admin.php, in this file you can change the install directory,db connection or table names.

At last run following command to finish install.

php artisan admin:install

Open http://localhost/admin/ in browser,use username admin and password admin to login.

Configurations

The file config/admin.php contains an array of configurations, you can find the default configurations in there.

Session Configuration

app/config/session.php

change table from 'sessions' to 'admin_sessions'

    # 重整按鈕定時器
    'refresh_timer' => [
        'roles' => [
            'administrator'
        ],
        'timers' => [
            10,
            20,
            30,
            60
        ]
    ],

Form使用欄位table時檔案、圖片上傳在修改存檔會消失的解決方式

    public function setItemsAttribute($value)
    {
        $oldValue = $this->attributes['items']??[];
        $updValue = array_replace_recursive($oldValue, $value);
        $newValue = array_intersect_key($updValue, $value);
        $this->attributes['items'] = array_values($newValue);
    }

Login登入採用database時env配置

    SESSION_DRIVER=database.session

filesystems.php配置

    'admin' => [
        'driver' => 'local',
        'root' => public_path('uploads'),
        'visibility' => 'public',
        'url' => env('APP_URL').'/uploads',
    ],

Auth Method

None
Captcha 安装 https://github.com/mewebstudio/captcha
OTP 安装 https://github.com/antonioribeiro/google2fa-laravel

Language Translate

https://github.com/spatie/laravel-translation-loader

Extensions

Extension	Description	laravel-admin
helpers	Several tools to help you in development	~1.5
media-manager	Provides a web interface to manage local files	~1.5
api-tester	Help you to test the local laravel APIs	~1.5
scheduling	Scheduling task manager for laravel-admin	~1.5
redis-manager	Redis manager for laravel-admin	~1.5
backup	An admin interface for managing backups	~1.5
log-viewer	Log viewer for laravel	~1.5
config	Config manager for laravel-admin	~1.5
reporter	Provides a developer-friendly web interface to view the exception	~1.5
wangEditor	A rich text editor based on wangeditor	~1.6
summernote	A rich text editor based on summernote	~1.6
china-distpicker	一个基于distpicker的中国省市区选择器	~1.6
simplemde	A markdown editor based on simplemde	~1.6
phpinfo	Integrate the `phpinfo` page into laravel-admin	~1.6
php-editor <br/> python-editor <br/> js-editor<br/> css-editor<br/> clike-editor	Several programing language editor extensions based on code-mirror	~1.6
star-rating	Star Rating extension for laravel-admin	~1.6
json-editor	JSON Editor for Laravel-admin	~1.6
grid-lightbox	Turn your grid into a lightbox & gallery	~1.6
daterangepicker	Integrates daterangepicker into laravel-admin	~1.6
material-ui	Material-UI extension for laravel-admin	~1.6
sparkline	Integrates jQuery sparkline into laravel-admin	~1.6
chartjs	Use Chartjs in laravel-admin	~1.6
echarts	Use Echarts in laravel-admin	~1.6
simditor	Integrates simditor full-rich editor into laravel-admin	~1.6
cropper	A simple jQuery image cropping plugin.	~1.6
composer-viewer	A web interface of composer packages in laravel.	~1.6
data-table	Advanced table widget for laravel-admin	~1.6
watermark	Text watermark for laravel-admin	~1.6
google-authenticator	Google authenticator	~1.6

Contributors

This project exists thanks to all the people who contribute. [Contribute]. ## Backers Thank you to all our backers! 🙏 [Become a backer] ## Sponsors Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]