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

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: &lt;my_project&gt;/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.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