imp/admingenerator-bundle

Admingenerator for Symfony2 based on YAML configuration and Twig templating

dev-master / 2.3.x-dev 2016-03-17 11:37 UTC

Requires

• cedriclombardot/twig-generator: >= 1.1.0
• components/jquery: >= 1.9.0, < 3.0.0
• components/jqueryui: ~1.10
• genemu/form-bundle: 2.2.*
• knplabs/knp-menu-bundle: dev-master
• leafo/lessphp: >= 0.4.0
• pinano/select2-bundle: 3.5.*
• robloach/component-installer: >= 0.0.11
• sensio/generator-bundle: >= 2.3.3
• symfony/symfony: >= 2.8.0
• twig/extensions: 1.*
• twig/twig: >= 1.9.0
• white-october/pagerfanta-bundle: @stable
• zerkalica/millwright-menu-bundle: @stable

Requires (Dev)

• doctrine/common: >=2.2.3,<2.5-dev
• doctrine/dbal: >=2.2.3,<2.5-dev
• doctrine/orm: >=2.2.3,<2.5-dev

Suggests

• avocode/form-extensions-bundle: Symfony2 form extensions for Admingenerator
• cedriclombardot/admingenerator-user-bundle: FOSUserBundle integration for Admingenerator
• jms/security-extra-bundle: Allows expressions in credential checks for generated actions

MIT

• Cedric LOMBARDOT
• Symfony Community
• Nitra Labs
• Igor Paramonov

• admin
• generator
• yaml

README

The Real Missing Admin Generator for Symfony2!

This package is a Symfony2 Admin Generator based on YAML configuration and Twig templating. It's inspired by fzaninotto/Doctrine2ActiveRecord.

Follow us on Twitter!

Don't miss any updates from Symfony2 Admin Generator! Join Twitter today and follow us!

Features:

• Generate Views and Controllers for Models with one command
• Configure all options in one (per model) YAML file
• Includes standard actions: create/edit, show, delete, list/nestedset tree list
• Flexible and extendable: you can easily add or overwrite almost everything!
• Supports most popular model managers: Doctrine ORM, Doctrine ODM and Propel
• Introduces nested forms: create/edit object and all it's associated objects in one form!
• Manage relations one to one, one to many, many to one and many to many
• Fully translatable: all field elements (labels, placeholders, helpers), all widgets, actions, error messages and titles
• List features: sortable, paginated, filters, batch actions, scopes
• Nestedset tree list features: drag&drop to manage your tree
• New/Edit featues: fieldsets, tabbable, cool widgets for collection, file upload, date and entity fields
• Translated into DE, EN (default), ES, FA, FR, GR, IT, JA, NL, PL, PT, RO, RU, SL, TR, UK (you can easily contribute to add your own)
• Credentials for actions, columns and form fields
• Complete admin design based on twitter bootstrap (see next section)
• ... and more!

This bundle in pictures

Important note

Documentation is currently being rewritten. Old documentation can be found in:

• Resources/old-doc directory
• symfony2admingenerator.org website
• some new features configuration can be found in github issues/PR comments

Sorry for inconvenience, we will fix that as soon as possible!

Installation

All the installation instructions are located in documentation.

Documentation

The documentation for this bundle is located in Resources/doc directory. Start by reading Table of contents.

Translations

If you wish to use default texts provided in this bundle, you have to make sure you have translator enabled in your config.

# app/config/config.yml

framework:
    translator: ~

For more information about translations, check Symfony documentation.

Installation

Installation is a 3 step process:

1. Download NitraThemeBundle using composer
2. Enable the Bundle
3. Configure the NitraThemeBundle

Step 1: Download NitraThemeBundle using composer

Add NitraThemeBundle in your composer.json:

{
    "require": {
        "nitra/admingenerator-generator-bundle": "2.3.*@dev"
    }
}

Now tell composer to download the bundle by running the command:

$ php composer.phar update nitra/admingenerator-generator-bundle

Composer will install the bundle to your project's vendor/nitra directory.

Step 2: Enable the bundle

Enable the bundle in the kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Knp\Bundle\MenuBundle\KnpMenuBundle(),
        new WhiteOctober\PagerfantaBundle\WhiteOctoberPagerfantaBundle(),
        new Admingenerator\GeneratorBundle\AdmingeneratorGeneratorBundle(),
        new Millwright\MenuBundle\MillwrightMenuBundle(),
	new Millwright\ConfigurationBundle\MillwrightConfigurationBundle(),
        new Genemu\Bundle\FormBundle\GenemuFormBundle(),
        new Pinano\Select2Bundle\PinanoSelect2Bundle(),
	new FOS\UserBundle\FOSUserBundle(),
    );
}

Step 3: Configure

Add the following configuration to your config.yml file according to which type of datastore you are using.

# app/config/config.yml
imports:
    - { resource: menu.yml }
    - { resource: ../../vendor/nitra/doctrine-behaviors/config/orm-services.yml }


# Assetic Configuration
assetic:
    debug:          %kernel.debug%
    use_controller: false
    bundles:        [ AdmingeneratorGeneratorBundle ]
    #java: /usr/bin/java
    filters:
        cssrewrite: ~
        lessphp: ~

# Doctrine Configuration
doctrine:
    orm:
        filters:
            softdeleteable:
                class: Admingenerator\GeneratorBundle\Filter\SoftDeleteableFilter
                enabled: true
        hydrators:
            KeyPair: Admingenerator\GeneratorBundle\Hydrators\KeyPairHydrator      
            
# FOS Configuration
fos_user:
    db_driver: orm # other valid values are 'mongodb'
    firewall_name: main
    user_class: Nitra\NitraThemeBundle\Entity\User
	
# Admingenerator Configuration
admingenerator_generator:
    base_admin_template: ::base_admin.html.twig
    use_doctrine_orm: true
    stylesheets: []
    logout_path: fos_user_security_logout
    twig:
        use_localized_date: true
        use_form_resources: true
        date_format: 'Y-M-d'
        localized_date_format: 'medium'
        localized_datetime_format: 'medium'
        datetime_format: 'Y-m-d H:i'  
        number_format:
            decimal: 2
            decimal_point: ','
            thousand_separator: ' '
    colors:
        link:       '#128bbd'
        border:     '#c3c3c3'
        main:       '#008abd'
        dark_main:  '#005b7d'
        light_main: '#cbe6f2'
        gray:       '#bfbfbf'
        hover:      '#0f769f'
            
# Замена combobox на Select2             
genemu_form:
    select2:
        enabled: true
        
# Add blameable listener
parameters:
    knp.doctrine_behaviors.blameable_listener.user_entity: Nitra\NitraThemeBundle\Entity\User