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
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
BrainRam 