Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

174 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

super-admin

super-admin is an administrative interface builder for Laravel which can help you build CRUD backends with just a few lines of code.

Homepage | Documentation | GitHub | Extensions

Tests Code Style Latest Version Total Downloads License

Forked from Laravel-admin & Open-admin. Much thanks to Z-song and the open-admin team for their effort and great setup!

Both upstream projects are no longer maintained and remain incompatible with Laravel 11+. Super Admin 2.x supports Laravel 8 through 13 on PHP 8.0+.


Compatibility

Laravel PHP Status
13.x 8.3, 8.4 Supported
12.x 8.2, 8.3, 8.4 Supported
11.x 8.2, 8.3, 8.4 Supported
10.x 8.2, 8.3 Supported
9.x 8.0, 8.1, 8.2 Supported (end-of-life framework, see note)
8.x 8.0, 8.1 Supported (end-of-life framework, see note)

Features

  • Model Grid - Data tables with sorting, filtering, inline editing, export, and batch actions
  • Model Form - 60+ field types, validation, tabs, file uploads, and relationship management
  • Model Show - Detail pages with panels and relation display
  • Model Tree - Hierarchical/nested data with drag-and-drop ordering
  • RBAC - Built-in users, roles, and permissions management
  • Two-Factor Login - Authenticator-app codes and recovery codes; off, optional or required for everyone
  • Operation Log - Audit trail for all admin actions
  • Menu Management - Sidebar menu with drag-and-drop ordering
  • Templates - Tailwind Light (default) and Bootstrap Classic, switchable from Admin > Templates
  • Widgets - Box, Tab, Table, InfoBox, Collapse, Alert, Carousel, and more
  • Extension System - 12 official extensions that follow the active template
  • 23 Artisan Commands - Scaffolding, user management, code generation, and admin:upgrade to finish updates

Installation

Requires PHP 8.0+ and Laravel 8.0 or higher. Laravel 8 and 9 are end-of-life and ship with published security advisories; Composer 2.8+ refuses to install them unless audit.block-insecure is set to false. Use them only for existing applications you cannot upgrade yet.

composer require super-admin-org/super-admin

Publish assets and config:

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

After running the command you can find the config file in config/admin.php, where you can change the install directory, database connection, or table names.

Run the installer:

php artisan admin:install

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

Updating

composer update super-admin-org/super-admin
php artisan vendor:publish --tag=super-admin-assets --force

Quick Start

# 1. Create a model
php artisan make:model Post -m

# 2. Generate an admin controller
php artisan admin:controller \\App\\Models\\Post

# 3. Add route in app/Admin/routes.php
#    $router->resource('posts', PostController::class);

# 4. Add menu item at /admin/auth/menu with URI "posts"

That's it! Full CRUD interface with grid, form, filters, and detail page.


Documentation

Full documentation, in English and Bangla, is at super-admin.org. The same pages are in the docs/ directory of this repository.

After composer update, finish an update with:

php artisan admin:upgrade

It publishes the new assets, runs new migrations and clears compiled views. See Upgrading.

Getting Started

Page Description
Installation Step-by-step setup, database tables, troubleshooting
Quick Start Build your first CRUD in 5 minutes with scaffolding
Configuration Complete config reference - auth, upload, layout, map, and more
Upgrading Version upgrades, migration from open-admin/laravel-admin

Model Grid (Data Tables)

Page Description
Basic Usage Create grids, add columns, query data, pagination, relationships
Column Usage Width, color, sorting, help text, hide, string/collection operations
Column Display 20+ display formatters: image, label, badge, bool, progress, link, QR code, copyable, secret, modal, expand
Filters 17 filter types (equal, like, between, gt/lt, date, where...) with select, radio, checkbox, datetime presenters
Inline Editing Edit data directly in the grid: editable text, switch, select, radio, checkbox
Row & Batch Actions Custom row actions, batch operations, dropdown/context menu styles
Data Export CSV/Excel export, custom exporters
Grid Tools Header, footer, total row, quick search, quick create, hot keys, column selector

Model Form (Data Entry)

Page Description
Basic Usage Create forms, tools, footer, ignore fields, detect state
Form Fields 60+ field types: text, select, radio, checkbox, date/time, file, image, editor, tags, color, map, key-value, table, switch, belongs-to, has-many, embeds, and more
Validation Laravel validation rules, custom messages, creation/update rules, unique constraints
Image/File Upload Storage config, thumbnails, naming, cloud storage, multiple files
Callbacks Hooks: saving, saved, deleting, deleted, editing, submitted
Layout Tabs, columns, rows, fieldsets, dividers, cascade groups, step forms

Model Show & Tree

Page Description
Model Show Detail pages with panels, formatting, relations (one-to-one, one-to-many, many-to-many)
Model Tree Hierarchical data with ModelTree trait, drag-and-drop ordering, select options

Admin Features

Page Description
Permissions RBAC system: users, roles, permissions, route binding, middleware, operation log
Widgets Box, InfoBox, Tab, Table, Collapse, Alert, Callout, Carousel, Form widget, page layout
Console Commands 23 Artisan commands: install, upgrade, generate controller/form/action, create user, reset password, two-factor, templates, export seed
CSS/JavaScript Custom assets, inline scripts, theming, built-in libraries
Extensions Build and install extensions, official plugin list

Verification

Page Description
Test Coverage Map Every documented feature mapped to automated tests proving it works

Extensions

All extensions work with Super Admin 1.x and 2.x. Install with composer require super-admin-org/<name>.

Extension Description Docs
helpers Several tools to help you in development Guide
media-manager Web interface to manage local files Guide
config Config manager for super-admin Guide
grid-sortable Sortable grids Guide
CkEditor CkEditor for forms Guide
api-tester Test API calls from the admin Guide
scheduling Show and test your cron jobs Guide
phpinfo Show PHP info in the admin Guide
log-viewer Log viewer for Laravel Guide
page-designer Page designer to position items freely Guide
reporter Developer-friendly exception viewer Guide
redis-manager Redis manager for super-admin Guide

Contributing

We are looking for active contributors:

  • Testing
  • Extension development
  • Translating documentation
  • Financing

Built With

License

super-admin is licensed under The MIT License (MIT).

About

No description, website, or topics provided.

Resources

Contributing

Stars

6 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages