avanzu/admin-theme-bundle

Admin Theme based on the AdminLTE Template for easy integration into symfony

AdminThemeBundle

[][3] ![Symfony 2.x & 3.x][2]    , _(*1)

  , _(*2)

, _(*3)

Admin Theme based on the AdminLTE Template for easy integration into symfony. This bundle integrates several commonly used javascripts and the awesome AdminLTE Template., _(*4)

Installation

Installation using composer is really easy: this command will add "avanzu/admin-theme-bundle": "~1.3" to your composer.json and will download the bundle:, _(*5)

   php composer.phar require avanzu/admin-theme-bundle

Notice: if you prefer to stay with the AdminLTE theme v1.x, manually reference "avanzu/admin-theme-bundle": "~1.1" in composer.json "require" part and run php composer.phar update, _(*6)

For unstable releases (based in master branch) use:, _(*7)

   php composer.phar avanzu/admin-theme-bundle dev-master

Enable the bundle in your kernel:, _(*8)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Avanzu\AdminThemeBundle\AvanzuAdminThemeBundle(),
    );
}

If you use 2.x branch or dev-master version of this bundle you need additionally:, _(*9)

php bin/console avanzu:admin:initialize

Install assets (preferably using symlink method but hardcopy works as well)..., _(*10)

    php app/console assets:install --symlink

Or symfony 3.x/4.x version:, _(*11)

    php bin/console assets:install --symlink

... and fetch vendors:, _(*12)

    php app/console avanzu:admin:fetch-vendor

Or symfony 3.x/4.x version:, _(*13)

    php bin/console avanzu:admin:fetch-vendor

Additionaly, you can trigger fetch the vendor in each install or update of this bundle, for that edit your archive composer.json and add:, _(*14)

    "scripts": {
        "post-install-cmd": [
            "Avanzu\\AdminThemeBundle\\Composer\\ScriptHandler::fetchThemeVendors"
        ],
        "post-update-cmd": [
            "Avanzu\\AdminThemeBundle\\Composer\\ScriptHandler::fetchThemeVendors"
        ]
    } 

Symfony 2.8 notice

This bundle requires assetic, but it isn't shipped with symfony anymore since version 2.8. To install assetic, follow these steps:, _(*15)

php composer.phar require symfony/assetic-bundle

Enable the bundle in your kernel:, _(*16)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Symfony\Bundle\AsseticBundle\AsseticBundle(),
    );
}

Add the following lines at app/config/config_dev.yml:, _(*17)

assetic:
    use_controller: false

Changing default values from templates

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

# Twig Configuration
twig:
    debug:            "%kernel.debug%"
    strict_variables: "%kernel.debug%"
    globals:
        admin_skin: skin-blue

You could also define those values at app/config/parameters.yml:, _(*19)

admin_skin: skin-blue

and then use as follow in app/config/config.yml:, _(*20)

# Twig Configuration
twig:
    debug:            "%kernel.debug%"
    strict_variables: "%kernel.debug%"
    globals:
        admin_skin: "%admin_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., _(*21)

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., _(*22)

Upgrade notice

Version >= 1.3 comes with pre packaged asset files located under Resources/public/static/[prod|dev]. So, there is no longer a strict requirement for bower and/or assetic. The assetic groups hovever, are still there and should work as usual., _(*23)

If the assetic bundle is installed but you don't want the AdminThemeBundle to use it you can add following lines to config.yml:, _(*24)

    avanzu_admin_theme:
        use_assetic: false

Next Steps

• Using the layout
• Rebuilding the assets
• Using the ThemeManager
• Components
• Navbar User
• Navbar Tasks
• Navbar Messages
• Navbar Notifications
• Sidebar User
• Sidebar Navigation
• Breadcrumb Menu
• Form theme