# laiguAdminTheme plugin #

## Overview ##
The laiguAdminThemePlugin package a new admin generator theme based on AJAX requests via ExtJs. You can use laiguAdminThemePlugin to create yours master-detail relations.

This plugin allows to change the default admin generator theme to one based on the ExtJs framework.
This admin generator theme is only targeting the actual element of the admin generator (table, forms...), it does not modify your overall layout.

## Features ##
- Master-detail.
- History manager. Back and forward browser buttons are managed by plugin.
- Change maximum rows per page.
- tinyMCE compatible


## Demo ##

Visit our site and live demo <a href="http://www.laigu.net/en/recursos-lliures/symfony-plugins/plugin-symfony-laiguadminthemeplugin" target="_blank">here</a>.
You can download live demo source in our site.


## Screenshot ##

![laiguAdminThemePlugin master-detail](http://www.laigu.net/wp-content/uploads/2010/02/laiguAdminThemePlugin_example2.jpg)


## Installation ##

* Download and install the plugin

        ./symfony plugin:install laiguAdminThemePlugin --stability=beta

* Clear the cache

        ./symfony cc

* Publish the plugin's assets:

        ./symfony plugin:publish-assets


## Configuration ##

* Enable the plugin `laiguAdminThemePlugin` on a project, via /config/ProjectConfiguration.class.php:

          class ProjectConfiguration extends sfProjectConfiguration
          {
            public function setup()
            {
              $this->enablePlugins('sfDoctrinePlugin', 'laiguAdminThemePlugin');
            }
          }

* Download and install Ext JS

    1. Download <a href="http://www.extjs.com/products/extjs/download.php?dl=extjs310" target="_blank">Ext JS</a>
    2. Uncompress on js directory (ex: <my_project>/web/js/extjs/)

* ExtJs related configuration (optional)

    You should change your ExtJs web dir inside your *app.yml*:

            all:
              laigu_admin_theme_plugin:
                web_dir_extjs:   /js/extjs # specify your folder where to pick ExtJs.


## How to use it ##

* Generate an admin generator:

        ./symfony --theme=laigu doctrine:generate-admin

* Don't forget:

        ./symfony cc

That's it!.

## Extra features configuration ##

This plugin add as well some new features that you can configure in your **generator.yml**. Currently available:

* Master-detail: a parameter to link 1-n relations.
* Filter collapsed: view filters collapsed in the list view


### Master-detail parameter ###

        edit:
          detail:
            town: # detail name
              module: town # module name to link (you must created module previously using laiguAdminTheme, is not necessary to configure anymore)
              params: { state_id: getId } # parameters pass to detail module (first, detail parameter name; after, parent object method) (NOTE: MAY BE CHANGE IN THE FUTURE)


### Filter collapsed parameter ###

      filter:
        params: { collapsed: true }


## Contact ##

* Jordi Llonch ( jordi [at] laigu [dot] net ), [http://www.laigu.net]
* Magí Carbonell ( mcarbonell [at] laigu [dot] net ), [http://www.laigu.net]


## Changelog ##

* version 0.5.7:
    bug on ie (thanks to Oscar Arroyo)
* version 0.5.6:
    bug on detail link, not pass master xget variable (thanks to Rodrigo Ayala to report this bug)
* version 0.5.5:
    master id lost when order by column and pagination on detail div
* version 0.5.4:
    bug on pagination
* version 0.5.3:
    bug on batch process if index list is a detail from master
* version 0.5.2:
    tinyMCE compatible
* version 0.5.1:
    added change max rows per page
* version 0.5.0:
    history manager (back/forward browser button are managed by plugin)
* version 0.4.0: 
    disable layout if is an ajax request
    bug on batch action on sf 1.2
    bug on check all when are multiple details
    error message fired if an error HTTP status was returned from the server
* version 0.3.0: bug on field links and filters (IMPORTANT: change in your generator.yml "class: sfDoctrineGenerator" for "class: laiguDoctrineGenerator"
* version 0.2.2: created new method to redirect using ajax
* version 0.2.1: bug on package.xml
* version 0.2.0: bug on input submit with names
* version 0.1.0: initial release


## TODO ##

* add new features integrating ExtJs widgets