The generator.yml
power for your

Table of contents
    Fork me on GitHub

    How to install


    You have two methods to install the project: using a pre-configured bundle or your own custom install.

    With the Symfony Ready to code a symfony-standard based project

    Configured with admingenerator and propel

    With the AdmingeneratorIpsum fully configured base project

    The AdmingeneratorIpsum project is a "Kitchen Sink" version that is complete and will allow you:

    • to have a Fast Start: with all the dependencies carefully configured with multiple templates - including Propel, Doctrine ORM, ODM.
    • to try out all the features: with working examples of generator configuration, models and documentation.
    • to contribute to the generator project using a known starting configuration, and
    • to see how site access control is configured . It comes preconfigured with the FOS_UserBundle.
    > git clone git://
    > cd AdmingeneratorIpsum
    > cp app/config/parameters.yml.sample app/config/parameters.yml
    > ./bin/vendors install
    > ./

    You work on Windows :(

    Ok, Windows need also his AdmingeneratorIpsum usable project. So for you I downloaded and packaged the admingenerator ipsum and all his deps nightly. Click here to go to downloads

    Your own Symfony2 project

    Configure your own project in the standard Symfony2 way.

    Full Custom Installation

    First add the AdminGenerator submodule to your project:

    git submodule add git:// vendor/bundles/Admingenerator/GeneratorBundle

    Or, if you use deps file:


    Register it in the autoload.php file:

    // app/autoload.php
        'Admingenerator'    => array(__DIR__.'/../src', __DIR__.'/../vendor/bundles'),

    Add it to the AppKernel class:

    // app/AppKernel.php
    public function registerBundles()
        $bundles = array(
            // ...
            // Admin Generator
            new Admingenerator\GeneratorBundle\AdmingeneratorGeneratorBundle(),
            new Admingenerator\OldThemeBundle\AdmingeneratorOldThemeBundle(),
        // ...

    In config.yml

        templates_dirs: [ %kernel.root_dir%/../vendor/cedriclombardot/admingenerator-oldtheme-bundle/Admingenerator/OldThemeBundle/Resources/templates ]

    Install SensioGeneratorBundle (if you're not on a symfony-standard)

    Add the bundle as a submodule:

    git submodule add git:// vendor/bundles/Sensio/Bundle/GeneratorBundle

    Or for the deps method:


    Register it in the autoload.php file:

    // app/autoload.php
        'Sensio\Bundle'     => __DIR__.'/../vendor/bundles',

    Add it to the AppKernel class:

    $bundles[] = new Sensio\Bundle\GeneratorBundle\SensioGeneratorBundle();

    Install KnpMenuBundle

    Adding Git submodules:

    git submodule add vendor/bundles/Knp/Bundle/MenuBundle
    git submodule add vendor/KnpMenu

    Or with deps file:


    Register it in the autoload.php file:

    // app/autoload.php
        'Knp'       => __DIR__.'/../vendor/bundles',
        'Knp\\Menu'  => __DIR__.'/../vendor/KnpMenu/src',

    Add it to the AppKernel class:

    $bundles[] = new Knp\Bundle\MenuBundle\KnpMenuBundle();

    Don't forget to configure it to use twig in config.yml:

        twig: true

    Now two ways to continue the setup :

    First of all, do not forget to install above vendors:

    php bin/vendors install

    Manually, follow the end of readme, or automatically (,

    php app/console admin:setup

    Install TwigGenerator

    git submodule add vendor/twig-generator

    Register it in the autoload.php file:

    // app/autoload.php
        'TwigGenerator'         => __DIR__.'/../vendor/twig-generator/src',

    Install Pagerfanta

    git submodule add vendor/pagerfanta
    git submodule add vendor/bundles/WhiteOctober/PagerfantaBundle

    Register it in the autoload.php file:

    // app/autoload.php
        'WhiteOctober\PagerfantaBundle' => __DIR__.'/../vendor/bundles',
        'Pagerfanta'                    => __DIR__.'/../vendor/pagerfanta/src',

    Add it to the AppKernel class:

    $bundles[] = new WhiteOctober\PagerfantaBundle\WhiteOctoberPagerfantaBundle();

    Configure JMS Security

    In config.yml:

         expressions: true

    Setup the Model Manager you want

    At this step, you'll have to install the Model Manager you want (Doctrine ORM, Doctrine ODM and/or Propel). E.g. with Doctrine, you'll have to setup the Doctrine2FixtureBundle bundle.

    Install Doctrine2FixtureBundle & create the database

    php app/console doctrine:database:create
    php app/console doctrine:schema:create
    php app/console doctrine:fixtures:load

    Install Assetic (Optional see without assetic part)

    git submodule add git:// vendor/bundles/Symfony/Bundle/AsseticBundle
    git submodule add git:// vendor/assetic

    Register it in the autoload.php file:

    // app/autoload.php
        'Assetic'           => __DIR__.'/../vendor/assetic/src',

    Add it to the AppKernel class:

    $bundles[] = new Symfony\Bundle\AsseticBundle\AsseticBundle();

    Configure the routing in app/config/routing.yml:

        resource: .
        type: assetic

    To run assets you also need to install sass & compass:

    sudo gem install compass #
    sudo gem install sass

    Configure Assetic:

            cssrewrite: ~
                bin: /var/lib/gems/1.8/gems/sass-3.1.7/bin/sass
                compass: /var/lib/gems/1.8/gems/compass-0.11.5/bin/compass

    Without Assetic

    Configure your config.yml to use the assetic less template

        base_admin_template: AdmingeneratorGeneratorBundle::base_admin_assetic_less.html.twig

    With or without assetic

    Publish assets:

    php app/console assets:install web/

    Choose the ORM/ODM you want to use

    In app/config.yml

        use_propel: true
        use_doctrine_orm: true
        use_doctrine_odm: true

    Want to connect to FOSUserBundle ?

    Just setup the AdmingeneratorUserBundle

    Without assetic set in config.yml :

         login_template: AdmingeneratorGeneratorBundle::base_login_assetic_less.html.twig