ইনস্টলেশন
প্রয়োজনীয়তা
- PHP >= 8.2
- Laravel 10.x / 11.x / 12.x / 13.x (PHP 8.0+ এ 8.x ও 9.x-ও চলে, তবে দুটোই end-of-life;
composer config audit.block-insecure falseচালানোর পরেই কেবল Composer এগুলো ইনস্টল করে)। দেখুন কম্প্যাটিবিলিটি। - Fileinfo PHP এক্সটেনশন
ইনস্টল করুন
প্রথমে, Laravel ইনস্টল করুন এবং নিশ্চিত করুন যে ডাটাবেস কানেকশন সেটিংস সঠিক আছে।
composer require super-admin-org/super-admin
এরপর অ্যাসেট এবং কনফিগ পাবলিশ করুন:
php artisan vendor:publish --provider="SuperAdmin\Admin\AdminServiceProvider"
এটি config/admin.php অবস্থানে কনফিগারেশন ফাইল তৈরি করে। এগিয়ে যাওয়ার আগে আপনি ইনস্টল ডিরেক্টরি, ডাটাবেস কানেকশন, বা টেবিলের নাম পরিবর্তন করতে পারেন।
সবশেষে, ইনস্টলার রান করুন:
php artisan admin:install
আপনার ব্রাউজারে http://localhost/admin/ ওপেন করুন এবং নিচের তথ্য দিয়ে লগইন করুন:
- Username:
admin - Password:
admin

জেনারেটেড ফাইলসমূহ
ইনস্টলেশনের পর, নিম্নলিখিত ফাইল এবং ডিরেক্টরিগুলো তৈরি হয়:
কনফিগারেশন
config/admin.php - অ্যাডমিন প্যানেলের সব সেটিংস।
অ্যাডমিন ডিরেক্টরি
আপনার ডেভেলপমেন্টের কাজ app/Admin/-এ হয়:
app/Admin/
├── Controllers/
│ ├── HomeController.php # Dashboard
│ ├── AuthController.php # Login/logout
│ └── ExampleController.php # Sample CRUD controller
├── routes.php # Admin routes
└── bootstrap.php # Admin bootstrapper
স্ট্যাটিক অ্যাসেট
ফ্রন্টএন্ড অ্যাসেট /public/packages/admin/-এ পাবলিশ করা হয়।
ডাটাবেস টেবিল
ইনস্টলার এই টেবিলগুলো তৈরি করে (config/admin.php-এ কনফিগারযোগ্য):
| টেবিল | উদ্দেশ্য |
|---|---|
admin_users | অ্যাডমিন ইউজার অ্যাকাউন্ট |
admin_roles | রোল |
admin_permissions | পারমিশন |
admin_menu | সাইডবার মেনু আইটেম |
admin_role_users | ইউজার-রোল পিভট |
admin_role_permissions | রোল-পারমিশন পিভট |
admin_role_menu | রোল-মেনু পিভট |
admin_user_permissions | ইউজার-পারমিশন পিভট |
admin_operation_log | অডিট লগ |
সমস্যা সমাধান
ইনস্টলেশনের সময় যদি আপনি কোনো সমস্যার সম্মুখীন হন:
- নিশ্চিত করুন যে আপনার ডাটাবেস কানেকশন
.env-এ কনফিগার করা আছে - টেবিল না থাকলে
php artisan migrateরান করুন - ক্যাশ ক্লিয়ার করুন:
php artisan config:clear && php artisan cache:clear - অ্যাসেট পুনরায় পাবলিশ করুন:
php artisan vendor:publish --tag=super-admin-assets --force