⛵ exment-admin-core is an admin interface builder for Laravel that helps you build CRUD screens with just a few lines of code.

This package is a fork of open-admin / open-admin-core, adapted for Exment.

Documentation (en) | Documentation (zh) | Changelog

Inspired by SleepingOwlAdmin, rapyd-laravel and laravel-admin.

Requirements

• PHP ^8.2
• Laravel ^12.0
• Fileinfo PHP extension

Installation

First install Laravel 12 and make sure the database connection settings are correct.

Create the framework skeleton:

composer create-project laravel/laravel example-app

Set the application URL, timezone and locale. In Laravel 12 config/app.php reads these from the environment, so edit .env:

APP_URL=http://localhost
APP_TIMEZONE=UTC
APP_LOCALE=en

php artisan storage:link

Create a database named new_base (or any other name you prefer).

Configure the database connection in .env (example settings for a development environment):

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=new_base
DB_USERNAME=postgres
DB_PASSWORD=postgres

Then install the admin panel

The package is installed from a Git repository (or from a local path during development) — add it to the repositories section of your project's composer.json:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/exceedone/exment-admin-core"
    }
]

For local development, a path repository pointing at the package directory is more convenient:

"repositories": [
    {
        "type": "path",
        "url": "exment-admin-core"
    }
]

Then:

composer require exceedone/exment-admin-core

Next, run this command to publish the assets and the configuration:

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

After running it you will find the configuration file at config/admin.php, where you can change the install directory, the database connection or the table names.

Also add the required disks to config/filesystems.php:

    'disks' => [

        ...

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

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

        ...

Enabling HTTPS support:

    /*
    |--------------------------------------------------------------------------
    | Access via `https`
    |--------------------------------------------------------------------------
    |
    | If your page is going to be accessed via https, set it to `true`.
    |
    */
    'https' => env('ADMIN_HTTPS', true),

Finally, run the following command to complete the installation.

php artisan admin:install

Open http://localhost/admin/ in your browser and log in with the username admin and the password admin.

Configuration

The file config/admin.php contains the configuration array where you can find the default settings.

Updating

Updating to a new version of exment-admin-core may require republishing the assets, which you can do with:

php artisan vendor:publish --tag=open-admin-assets --force

RTL (right-to-left) support

Go to <YOUR_PROJECT_PATH>\vendor\exceedone\exment-admin-core\src\Traits\HasAssets.php and edit the $baseCss array to load the right-to-left (rtl) versions of the Bootstrap and AdminLTE CSS files.
Change bootstrap.min.css to bootstrap.rtl.min.css
Change AdminLTE.min.css to AdminLTE.rtl.min.css

Extensions

⚠️ The extensions listed below are written for laravel-admin / open-admin and use the old namespaces (Encore\Admin, OpenAdminCore\Admin). They do not work with ExmentAdminCore\Admin out of the box — a fork with the namespace replaced is required. The tables are kept as a reference of what is available.

Extensions by Zong

Extension	Description	laravel-admin
helpers	Several tools to help you in development	~1.0.2
media-manager	Provides a web interface to manage local files	~1.0.2
api-tester	Helps you test your local Laravel APIs	~1.0.2
scheduling	Task scheduling 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	A Chinese province/city/district picker based on distpicker	~1.6
simplemde	A markdown editor based on simplemde	~1.6
phpinfo	Integrate the phpinfo page into laravel-admin	~1.6
php-editor python-editor js-editor css-editor 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

Extensions reworked by Open-Admin for Bootstrap 5.3

Extension	Description	open-admin
helpers	Several tools to help you in development	~1.0
media-manager	Provides a web interface to manage local files	~1.0
config	Config manager for open-admin	~1.0
grid-sortable	Sortable grids	~1.0
Ckeditor	Ckeditor for forms	~1.0
api-tester	Test api calls from the admin	~1.0
scheduling	Show and test your cronjobs	~1.0
phpinfo	Show php info in the admin	~1.0
log-viewer	Log viewer for laravel	~1.0.12
page-designer	Page designer to position items freely	~1.0.18
reporter	Provides a developer-friendly web interface to view the exception	~1.0.18
redis-manager	Redis manager for open-admin	~1.0.20

Credits

This project exists thanks to everyone who contributes. [Contribute]

exment-admin-core builds on the work of:

• laravel-admin by z-song
• open-admin
• open-admin-core by dedermus

Other

exment-admin-core is based on the following plugins or services:

• Laravel
• AdminLTE
• Datetimepicker
• font-awesome
• moment
• Google map
• Tencent map
• bootstrap-fileinput
• jquery-pjax
• Nestable
• toastr
• X-editable
• bootstrap-number-input
• fontawesome-iconpicker
• sweetalert2

License

exment-admin-core is licensed under The MIT License (MIT).