AdminLTE Bundle for Symfony

This repository contains an upgraded version of the AvanzuAdminThemeBundle, bringing the AdminLTE theme to Symfony 4.

Introduction

Documentation - How to install, use and enjoy this bundle
Demo app - Demo application using this bundle
Kimai time-tracking - online time-tracking app using this bundle and Symfony 4

Minimum requirements

Symfony 4.3
PHP 7.1.3
Twig 2.0

Compatibility:

Version 4.x is compatible with Symfony >= 4.3 (reason: AdminLTE 3)
Version 3.x is compatible with Symfony >= 4.3 (reason: maintenance, AdminLTE 2.4.8)
Version 2.x of is compatible with Symfony < 4.3

Features

Some of the main features of this theme bundle:

Two main layouts for main application and security (login, forgot password, register account...)
Support for Symfony 4.x
Support for KNPMenuBundle
Support for FOSUserBundle
Webpack-Encore support for building assets
Event-driven handling of menu entries, tasks and notifications
Translations for: english, german, italian, czech, spanish, russian, arabic, finnish, japanese, swedish, portuguese (brazilian), dutch, french, turkish, danish, chinese, slovakian, basque, polish, esperanto, hebrew, romanian (please help translating it to more languages)
Based on AdminLTE 3
Using FontAwesome 5

Installation with Symfony Flex

Installation using Symfony flex:

composer config extra.symfony.allow-contrib true
composer req "kevinpapst/adminlte-bundle:^4.0"

Installation with Composer

Installation using the "traditional" composer approach:

   composer require kevinpapst/adminlte-bundle ^4.0

Afterwards copy the default config to your config/packages/ directory:

cp vendor/kevinpapst/adminlte-bundle/config/packages/admin_lte.yaml config/packages/

Then, enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

<?php

return [
    // ...
    KevinPapst\AdminLTEBundle\AdminLTEBundle::class => ['all' => true],
];

AdminLTEBundle vs AvanzuAdminThemeBundle

Let me try to explain the reason why I created this repo and why you might want to to choose it over the original AvanzuAdminThemeBundle.

First and foremost: the original repository has a strong backward compatibility in mind, maintenance is only done if Symfony 2 and 3 compatibility is kept (e.g. here).

That means you don't get the new shiny stuff for SF4. As I am working on a Symfony 4 project, utilizing webpack-encore I needed a solution.

First I tried to sent PRs for the original repository, but those were not always accepted eg. here. As I really needed an upgraded version, I tried to manage a branch in a fork for a couple of weeks, but that wasn't working well and I found myself overwriting more and more stuff in my project until there was a point were I had to choose between:

doing all the changes in my project
doing the changes in my forked repository and having "dev-" entries in my composer.json
cleanup the fork, merge it with my project changes and release it for the community

I went with 3 and now, 1.5 years later it looks as if this was the right choice. Please compare the commit history and decide for yourself!

This repository was created from the original master, but with a lot of enhancements on top:

Upgraded to AdminLTE 3
Added support for FOSUserBundle
Fixed and updated KNPMenu integration
Added Symfony Flex recipe for easier integration
Using Webpack-Encore for compiling frontend-assets
Codebase cleanup, introduction of unit tests, phpstan and code-style rules (all checked by Travis)
Replaced AliasRouting with simpler version
Added a Demo application as living documentation for first time users and easier testing
Auto discovery for commands (see #215)
Symfony4 compatibility (see #215)
Dynamic config options (see #217)
Updated composer.json to reflect more up-to-date bundle dependencies
Introduction of unit tests, phpstan and code-style rules (all checked by Travis)

Migration from AvanzuAdminTheme

Be aware: I decided to change some project internals and got rid of some features from the original AdminThemeBundle. I found the all-in-one solution to be more problematic then helpful at several places, so I took the chance to update it to my own interpretation of a theme bundle.

If you previously used the AvanzuAdminTheme you will not be able to "just replace" the composer package. Plan ahead, you will need (depending on the size of your project) a couple of hours for the migration.

I migrated my own project within ~4 hours, but I had to move a lot of the customization to the bundle (e.g. the webpack-encore build) in the same time. See the PRs #202 and #206 for migration examples.

License and contributors

Published under the MIT, read the LICENSE file for more information.

This repository is based on the work of AdminThemeBundle, please check their contributor list as well and give them a star!

svenkrefeld / AdminLTEBundle