README

A Symfony bundle providing the Start Bootstrap SB Admin theme as a ready-to-use admin dashboard template.

Description

This bundle integrates the popular SB Admin template into Symfony applications, offering a clean and modern Bootstrap 5-based admin interface with responsive design, sidebar navigation, and comprehensive example pages.

Features

Modern Admin Dashboard - Clean, professional Bootstrap 5 admin interface
Responsive Design - Fully responsive layout for mobile, tablet, and desktop
Sidebar Navigation - Collapsible sidebar with hierarchical menu structure
Pre-built Pages - Ready-to-use pages for common admin scenarios
FontAwesome Icons - Comprehensive icon set included
Symfony Integration - Seamless integration with Symfony's Asset Mapper
Navigation Attributes - Automatic menu generation using PHP attributes

Requirements

PHP >= 8.3
Symfony >= 6.4 or 7.0+
Composer

Installation

composer require php-lion/theme-sb-admin

Configuration

1. Register the Bundle

The bundle should be automatically registered via Symfony Flex. If not, add it to config/bundles.php:

return [
    // ...
    PhpLion\Theme\SbAdminBundle\PhpLionSbAdminBundle::class => ['all' => true],
];

2. Compile Assets

php bin/console asset-map:compile

Demo Pages (Optional)

The bundle includes example pages to showcase the theme. To enable them, add the bundle routes to your config/routes.yaml:

phplion_theme_sb_admin:
    resource: '@PhpLionSbAdminBundle/config/routes.yaml'

All demo pages will then be accessible under the /_phplion/theme/sb_admin prefix:

Core Pages

/ - Dashboard (Main admin page with stats cards and tables)
/charts - Charts page with Chart.js examples
/tables - Data tables page with sample data

Layout Examples

/layout_static - Static navigation demo
/layout_sidenav_light - Light sidebar theme demo

Authentication Pages

/login - Login page
/register - Registration page
/password - Password recovery page

Error Pages

/error_401 - 401 Unauthorized page
/error_404 - 404 Not Found page
/error_500 - 500 Internal Server Error page

Usage

Using the Base Template

Extend the base template in your own Twig files:

{% extends '@PhpLionSbAdmin/base.html.twig' %}

{% block content %}
    <h1 class="mt-4">My Admin Page</h1>
    <div class="card mb-4">
        <div class="card-body">
            Your content here
        </div>
    </div>
{% endblock %}

Navigation System

The bundle uses PHP attributes for automatic navigation generation:

use PhpLion\NavigationBundle\Attribute\Navigation;
use PhpLion\NavigationBundle\Attribute\NavigationGroup;

#[NavigationGroup(name: '_phplion_theme_sb_admin')]
class MyAdminController extends AbstractController
{
    #[Route('/my-page', name: 'my_admin_page')]
    #[Navigation(path: 'My Section|My Page', priority: 1000)]
    public function myPage(): Response
    {
        return $this->render('@PhpLionSbAdmin/page/custom.html.twig');
    }
}

Template Blocks

Available blocks for customization:

title - Page title
stylesheets - Additional CSS files
body_class - Body CSS classes
navbar - Top navigation bar
sidebar - Side navigation
content - Main content area
footer - Footer section
javascripts - Additional JavaScript files

Asset Structure

assets/
├── css/
│   └── styles.css          # Main theme stylesheet
├── js/
│   ├── scripts.js          # Theme JavaScript (sidebar toggle, etc.)
│   └── datatables-simple-demo.js
├── fonts/                  # Custom fonts
├── images/                 # Theme images
└── vendor/                 # Third-party assets

Template Structure

templates/
├── base.html.twig          # Base layout with sidebar and navbar
└── page/
    ├── index.html.twig     # Dashboard
    ├── charts.html.twig    # Charts page
    ├── tables.html.twig    # Tables page
    ├── login.html.twig     # Login page
    ├── register.html.twig  # Registration page
    ├── password.html.twig  # Password recovery
    ├── 401.html.twig       # 401 error
    ├── 404.html.twig       # 404 error
    ├── 500.html.twig       # 500 error
    ├── layout-static.html.twig
    └── layout-sidenav-light.html.twig

Customization

Override Templates

Create your own templates in templates/bundles/PhpLionSbAdminBundle/:

templates/
└── bundles/
    └── PhpLionSbAdminBundle/
        └── base.html.twig  # Your customized base template

Custom Styling

Add your own CSS after the theme's stylesheet:

{% block stylesheets %}
    {{ parent() }}
    <link href="{{ asset('css/my-custom-admin.css') }}" rel="stylesheet" />
{% endblock %}

Sidebar Customization

Override the sidebar block to customize the navigation:

{% extends '@PhpLionSbAdmin/base.html.twig' %}

{% block sidebar %}
    {# Your custom sidebar #}
{% endblock %}

License

MIT License - see LICENSE file for details

Credits

Original Template: Start Bootstrap - SB Admin
Bootstrap 5: https://getbootstrap.com/
FontAwesome: https://fontawesome.com/

Support

For issues and questions:

Homepage: https://www.php-lion.de
Email: info@php-lion.de

Original Template

This bundle is based on the SB Admin template by Start Bootstrap, licensed under the MIT License. The original template can be found at: https://startbootstrap.com/template/sb-admin

php-lion / theme-sb-admin

Maintainers

Details