AdminLTEBundle

AdminLTE Bundle based on the AdminLTE Template for easy integration into Symfony. This bundle integrates several commonly used JavaScripts and Font-Awesome.

Installation

Installation using composer is really easy: Configure components directory in composer.json:

"config": {
    "bin-dir": "bin",
    "component-dir": "web/components",
    "component-baseurl": "/components"
},

After that run the next composer command to add and download bundle sbs/symfony-adminlte-bundle to your composer.json:

composer require sbs/symfony-adminlte-bundle

Configurations

Enable the bundle in your kernel:

<?php
// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new SbS\AdminLTEBundle\SbSAdminLTEBundle(),
        new AppBundle\AppBundle(),
    );
}

Configure composer.json to install AdminLTE assets into bundle public directory.

Notice: insert line before Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::installAssets

"scripts": {
    "symfony-scripts": [
        "SbS\\AdminLTEBundle\\Composer\\ScriptHandler::buildAssets",
        "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::installAssets",
    ],
    "post-install-cmd": [
        "@symfony-scripts"
    ],
    "post-update-cmd": [
        "@symfony-scripts"
    ]
},

Symfony 2.8 and higher notice

Notice: This bundle requires assetic, but it isn't shipped with Symfony anymore since version 2.8.

Assetic will be installed as require bundle and you should enable bundle in your kernel:

<?php
// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new Symfony\Bundle\AsseticBundle\AsseticBundle(),
        new SbS\AdminLTEBundle\SbSAdminLTEBundle(),
    );
}

Add the following lines to app/config/config.yml:

assetic:
    debug: "%kernel.debug%"
    use_controller: "%kernel.debug%"
    bundles: ["SbSAdminLTEBundle"]
    filters:
        cssrewrite: ~
    assets:
        fontawesome:
            inputs: '%kernel.root_dir%/../web/components/font-awesome/fonts/FontAwesome.otf'
            output: 'fonts/FontAwesome.otf'
        fontawesome-webfont-eot:
            inputs: '%kernel.root_dir%/../web/components/font-awesome/fonts/fontawesome-webfont.eot'
            output: 'fonts/fontawesome-webfont.eot'
        fontawesome-webfont-svg:
            inputs: '%kernel.root_dir%/../web/components/font-awesome/fonts/fontawesome-webfont.svg'
            output: 'fonts/fontawesome-webfont.svg'
        fontawesome-webfont-ttf:
            inputs: '%kernel.root_dir%/../web/components/font-awesome/fonts/fontawesome-webfont.ttf'
            output: 'fonts/fontawesome-webfont.ttf'

And following lines at app/config/config_dev.yml:

# Assetic Configuration
assetic:
    use_controller: false

Changing default values template

If you want to change any default value as for example skin all you need to do is define the same at app/config/config.yml under [twig] section. See example below:

# Twig Configuration
twig:
    # ...
    globals:
        admin_lte_skin: skin-blue
    # ...

You could also define those values at app/config/parameters.yml:

app.skin: skin-blue

and then use as follow in app/config/config.yml:

# Twig Configuration
twig:
    # ...
    globals:
        admin_lte_skin: "%app.skin%"

AdminLTE skins are: skin-blue (default for this bundle), skin-blue-light, skin-yellow, skin-yellow-light, skin-green, skin-green-light, skin-purple, skin-purple-light, skin-red, skin-red-light, skin-black and skin-black-light. If you want to know more then go ahead and check docs for AdminLTE here.

Install Assets and Dump Assetic

Run the following two commands:

   php bin/console assets:install
   php bin/console assetic:dump

Replace the contents of index.html.twig

Replace the contents of app/Resources/views/default/index.html.twig with:

{% extends 'SbSAdminLTEBundle:Layout:base.html.twig' %}

There are a few values you could change for sure without need to touch anything at bundle, just take a look under Resources/views.

That's all. Enjoy.