brJqGridPlugin
=================

Presupposti
===========

  * jquery, jquery datapicker integrati

Istruzioni
==========
1) Attivare il plugin in ProjectConfiguration.class.php
	$this->enablePlugins('brJqGridPlugin');

2) Attivare i moduli nel settings.yml
	brJsonGrid,brActionGrid

3) Aggiungere i css nel view.yml
	/brJqGridPlugin/css/ui.jqgrid.css

4) Aggiungere i js nel view.yml
	/brJqGridPlugin/js/i18n/grid.locale-it.js,/brJqGridPlugin/js/jquery.jqGrid.min.js

5) Nella Action del modulo desiderato creare l'oggetto griglia
	$this->nomechesivuole = new brJqGrid('NomeClasseTabellaDaGestire');

6) Nel Success mostrare la griglia
	<?php $nomechesivuole->show() ?>

7) Aggiungere le rotte nel routing.yml
	brJsonGrid:
	  url: /brJsonGrid/:tabella
	  param: { module: brJsonGrid, action: configurazioni }
	brActionGrid:
	  url: /brActionGrid/:tabella
	  param: { module: brActionGrid, action: configurazioni }

Integrazioni
============
Se il plugin trova nel file schema.yml un campo type:date, mostra il datapicker.

Opzioni:
========
Nella Action del modulo dove si crea l'oggetto griglia si possono richiamare le seguenti funzioni che possono	essere usate per personalizzare la griglia:

	  	- $this->nomechesivuole->setStato('visible');
	  		Stabilisce se la griglia all'apertura e' chiusa o aperta
	  		parametri accettati "hidden" o "visible"

	  	- $this->nomechesivuole->setAltezza(100);
	  		Configura l'altezza della griglia, accetta valori numerici

	  	- $this->nomechesivuole->setLarghezza(800);
	  		Configura la larghezza della griglia, accetta valori numerici

	  	- $this->nomechesivuole->setCampoOrdineIniziale('nomedelcampo');
	  		Configura il campo da ordinare alla prima creazione della griglia

	  	- $this->nomechesivuole->setDirezioneOrdineIniziale('asc');
	  		Configura il tipo di ordinamento alla prima creazione della griglia
	  		parametri ammessi "asc" e "desc"

	  	- $this->nomechesivuole->setOperazioniGlobaliAggiungi('true');
	  		Attiva il pulsante aggiungi sul navigatore
	  		parametri ammessi "true" e "false"

	  	- $this->nomechesivuole->setOperazioniGlobaliCancella('false');
	  		Attiva il pulsante cancella sul navigatore
	  		parametri ammessi "true" e "false"

	  	- $this->nomechesivuole->setOperazioniGlobaliCerca('true');
	  		Attiva il pulsante cerca sul navigatore
	  		parametri ammessi "true" e "false"

	  	- $this->nomechesivuole->setOperazioniGlobaliModifica('false');
	  		Attiva il pulsante modifica sul navigatore
	  		parametri ammessi "true" e "false"

	  	- $this->nomechesivuole->setOperazioniGlobaliRecordPerPagina(10);
	  		Configura il numero di record da mostrare per ogni pagina
	  		parametro ammesso numerico

	  	- $this->nomechesivuole->setOperazioniGlobaliVedereRecord('true');
	  		Attiva la visualizzazione dei record sul navigatore
	  		parametri ammessi "true" e "false"

	  	- $this->nomechesivuole->setOperazioniGlobaliFiltroInLinea('true');
	  		Attiva la visualizzazione del filtro nell'intestazione della griglia
	  		parametri ammessi "true" e "false"

	  	$this->nomechesivuole->setOperazioniGlobaliNavigatore('true');
	  	$this->nomechesivuole->setTitolo('Lista Aliquote Iva');

Personalizzazione campi singoli
===============================
Per personalizzare il singolo campo si faccia riferimento alla guida di jqgrid.

Il plugin, prelevando alcune configurazioni dal file schema.yml, inserisce alcune opzioni di default, personalizzando vengono sovrascritte.

Ogni campo di tabella puo' essere personalizzato nel file app.yml della app desiderata inserendo:

    all:
      brJqGrid:
        config:
          NomeClasseTabella:
            nome_campo1:
              etichetta: 'Etichetta da mostrare'
              visibile: 'true' #(consentito true o false)
              width: 30
              editable: 'true'
              sortable: 'true'
              edittype: 'text'
              align: 'center'
              editoptions: '{size: "3",maxlength: "3"}'
              editrules: '{required:true,number:true,minValue:40,maxValue:100}'
            nome_campo2:
              etichetta: 'Etichetta da mostrare'
          NomeClasseTabella:
            nome_campo:
              etichetta: 'Etichetta da mostrare'


TODO
=======


  * completare documentazione