Looking to hire Laravel developers? Try LaraJobs

laravel-admin-panel maintained by statisticlv

Description
A comprehensive admin panel for Laravel with authentication and content management
Author
StatisticLv
Last update
2025/12/31 11:44 (dev-main)
License
MIT
Links
Homepage - GitHub - Packagist
Downloads
14
Tags
admin - authentication - cms - panel - laravel - content-management

dev-main

Last update
2025/12/31 11:44
License
MIT
Require
  • php ^8.1
  • laravel/framework ^10.0|^11.0|^12.0
Comments
comments powered by Disqus

Laravel Admin Panel

A comprehensive admin panel package for Laravel with authentication, content management, and frontend integration. This package provides a complete CMS solution with news management, pages, menus, settings, and a built-in frontend.

Version

Current Version: 1.0.0

Features

  • 🔐 Secure Authentication - Separate admin authentication with role-based access control (admin, super_admin)
  • 👥 User Management - Super admin can manage all admin users with full CRUD operations
  • 📰 News Management - Create, edit, publish, and archive news articles with featured images
  • 📄 Page Management - Manage static pages with custom templates and SEO metadata
  • 🗂️ Menu Management - Create and manage nested menu structures for different locations
  • ⚙️ Settings Management - Dynamic settings system with grouping and type casting
  • 🎨 Frontend Integration - Built-in frontend routes and controllers for immediate use
  • 🔄 Soft Deletes - All main models support soft deletes for data recovery
  • 🔗 Slug Generation - Automatic URL-friendly slug generation
  • 💾 Caching - Built-in cache management for improved performance
  • 📝 Activity Logging - Automatic logging of admin actions
  • ✅ Testing - PHPUnit tests included for authentication features

Requirements

  • PHP 8.1 or higher
  • Laravel 10.0, 11.0, or 12.0

Installation

Step 1: Install via Composer

composer require statisticlv/laravel-admin-panel

Step 2: Install the Package

Run the installation command to publish all necessary files:

php artisan admin-panel:install

The installation command will:

  • Publish configuration file to config/admin-panel.php
  • Publish database migrations
  • Publish controllers to app/Http/Controllers/
  • Publish web routes to routes/web.php
  • Publish views to resources/views/
  • Publish assets to public/vendor/admin-panel/
  • Run database migrations
  • Seed settings table
  • Optionally install demo data

Step 3: Install with Demo Data (Optional)

To install with sample data for testing:

php artisan admin-panel:install --demo

Demo credentials:

Configuration

After installation, you can customize the package by editing config/admin-panel.php:

return [
    // Admin panel route prefix
    'route_prefix' => 'admin',

    // Middleware applied to admin routes
    'middleware' => ['web'],

    // Enable default frontend routes
    'enable_frontend_routes' => true,

    // Authentication guard
    'guard' => 'admin',

    // Admin panel title
    'title' => 'Admin Panel',

    // Items per page in list views
    'per_page' => 15,

    // Default date format
    'date_format' => 'Y-m-d H:i:s',
];

Available Commands

Create Admin User

Create a new admin user via command line:

php artisan admin:create-user

Options:

  • --name - The name of the admin user
  • --email - The email of the admin user
  • --password - The password for the admin user
  • --role - The role (admin or super_admin, default: admin)

Example:

php artisan admin:create-user --name="John Doe" --email="john@example.com" --password="SecurePass123" --role="super_admin"

Database Tables

The package creates the following tables:

  • admin_users - Admin user accounts with roles and status
  • news - News articles with status, author, and view counts
  • pages - Static pages with templates and SEO metadata
  • menus - Menu definitions with locations
  • menu_items - Individual menu items with support for nesting
  • settings - Dynamic key-value settings with grouping

Models

AdminUser

Admin user model with role-based access control.

use StatisticLv\AdminPanel\Models\AdminUser;

// Check if user is super admin
$user->isSuperAdmin(); // bool

// Check if user is admin (regular or super)
$user->isAdmin(); // bool

// Get news articles by author
$user->news;

News

News article model with publishing workflow.

use StatisticLv\AdminPanel\Models\News;

// Get published news
$publishedNews = News::published()->get();

// Get draft news
$draftNews = News::draft()->get();

// Check if published
$news->isPublished(); // bool

// Increment view count
$news->incrementViews();

Page

Page model with SEO support.

use StatisticLv\AdminPanel\Models\Page;

// Get published pages
$pages = Page::published()->get();

// Get meta title (falls back to title)
$page->meta_title;

// Get meta description (falls back to excerpt)
$page->meta_description;

Menu & MenuItem

Menu management with nested structure.

use StatisticLv\AdminPanel\Models\Menu;

$menu = Menu::where('slug', 'main')->first();

// Get root items only
$items = $menu->items;

// Get all items including nested
$allItems = $menu->allItems;

Setting

Dynamic settings management.

use StatisticLv\AdminPanel\Models\Setting;

// Get a setting value
$value = Setting::getValue('site_name', 'Default Name');

// Set a setting value
Setting::setValue('site_name', 'My Site');

// Get all settings grouped
$groupedSettings = Setting::getAllGrouped();

// Get all settings as array
$settingsArray = Setting::getAllAsArray();

Helper Functions

The package provides global helper functions for easy access to data:

Menu Helpers

// Get a menu by identifier
$menu = admin_menu('main');

// Render a menu as HTML
echo admin_render_menu('main', 'slug', ['class' => 'nav-menu']);

News Helpers

// Get published news
$news = admin_news($limit = 10, $paginate = 15);

// Get news by slug
$article = admin_news_by_slug('my-article');

// Get latest news
$latest = admin_latest_news(5);

// Get popular news
$popular = admin_popular_news(5);

Page Helpers

// Get page by slug
$page = admin_page_by_slug('about-us');

// Get all published pages
$pages = admin_pages($limit = 10);

Utility Helpers

// Format date
$formattedDate = admin_format_date($date, 'Y-m-d');

// Truncate text
$truncated = admin_truncate($text, 100, '...');

// Get excerpt from HTML
$excerpt = admin_excerpt($htmlContent, 200);

Routes

Admin Routes (Prefix: /admin)

  • GET /admin/login - Login page
  • POST /admin/login - Login action
  • POST /admin/logout - Logout action
  • GET /admin - Dashboard
  • GET /admin/dashboard - Dashboard
  • GET|POST|PUT|DELETE /admin/news - News management (CRUD)
  • GET|POST|PUT|DELETE /admin/pages - Page management (CRUD)
  • GET|POST|PUT|DELETE /admin/menus - Menu management (CRUD)
  • POST /admin/menus/{menu}/items - Add menu item
  • PUT /admin/menus/{menu}/items/{item} - Update menu item
  • DELETE /admin/menus/{menu}/items/{item} - Delete menu item
  • GET|POST|PUT|DELETE /admin/settings - Settings management
  • GET|POST|PUT|DELETE /admin/users - User management (CRUD, Super Admin only)
  • POST /admin/users/{user}/restore - Restore soft-deleted user (Super Admin only)
  • DELETE /admin/users/{user}/force-delete - Permanently delete user (Super Admin only)

Frontend Routes

  • GET / - Homepage
  • GET /news - News listing
  • GET /news/{slug} - Single news article
  • GET /{slug} - Page (catch-all route)

Authentication

The package uses a separate authentication guard for admin users:

// Authenticate admin user
if (Auth::guard('admin')->attempt($credentials)) {
    // Success
}

// Get authenticated admin user
$admin = Auth::guard('admin')->user();

// Check authentication
if (Auth::guard('admin')->check()) {
    // User is authenticated
}

Roles

Two roles are available:

  • admin - Regular admin with standard permissions (news, pages, menus, settings)
  • super_admin - Super admin with full permissions including user management

Middleware

The package includes the following middleware:

  • admin.auth - Authentication middleware for admin routes
  • super.admin - Authorization middleware for super admin only routes
// Protect admin routes (requires authentication)
Route::middleware(['admin.auth'])->group(function () {
    // Protected admin routes
});

// Protect super admin routes (requires super admin role)
Route::middleware(['super.admin'])->group(function () {
    // Super admin only routes (e.g., user management)
});

Views

The package publishes views to resources/views/:

  • auth/login.blade.php - Admin login page
  • dashboard/index.blade.php - Admin dashboard
  • news/index.blade.php - News listing
  • news/create.blade.php - Create news form
  • news/edit.blade.php - Edit news form
  • pages/index.blade.php - Pages listing
  • pages/create.blade.php - Create page form
  • pages/edit.blade.php - Edit page form
  • menus/index.blade.php - Menus listing
  • menus/create.blade.php - Create menu form
  • menus/edit.blade.php - Edit menu form
  • users/index.blade.php - Users listing (Super Admin only)
  • users/create.blade.php - Create user form (Super Admin only)
  • users/edit.blade.php - Edit user form (Super Admin only)
  • users/show.blade.php - User details view (Super Admin only)
  • settings/index.blade.php - Settings listing
  • settings/edit.blade.php - Edit settings form
  • frontend/home.blade.php - Homepage
  • frontend/news/index.blade.php - News listing (frontend)
  • frontend/news/show.blade.php - Single news article (frontend)
  • frontend/pages/default.blade.php - Default page template (frontend)
  • layouts/app.blade.php - Admin layout
  • frontend/layouts/app.blade.php - Frontend layout

Customization

Customizing Controllers

After installation, controllers are published to app/Http/Controllers/. You can modify them to add custom logic:

// app/Http/Controllers/NewsController.php

namespace App\Http\Controllers;

use StatisticLv\AdminPanel\Models\News;

class NewsController extends \StatisticLv\AdminPanel\Http\Controllers\NewsController
{
    // Override methods or add new ones
}

Customizing Views

All views are published to resources/views/ and can be customized as needed.

Customizing Routes

The web routes file is published to routes/web.php. You can modify routes or add new ones.

Testing

Run the included tests:

php artisan test

Tests cover:

  • Admin authentication
  • Login validation
  • Rate limiting
  • Authorization checks
  • Session management

Security

  • Password strength validation (minimum 8 characters, uppercase, lowercase, number)
  • Rate limiting on login attempts
  • Role-based access control (admin and super_admin roles)
  • Super admin exclusive routes for sensitive operations
  • Self-protection (admins cannot delete/deactivate themselves)
  • CSRF protection
  • SQL injection protection via Eloquent ORM

Performance

  • Database indexing on frequently queried columns
  • Soft deletes for data recovery
  • Caching support for news articles
  • Optimized queries with eager loading

Support

License

This package is open-source software licensed under the MIT License.

Credits

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Changelog

See CHANGELOG.md for version history and changes.