Diferencia entre revisiones de «Helper Datagrid»

De KumbiaPHP Framework Wiki
m (Revertidos los cambios de 80.31.149.109 (disc.) a la última edición de 190.96.230.110)
 
(No se muestran 30 ediciones intermedias de 8 usuarios)
Línea 1: Línea 1:
== DATAGRID FACIL DE CREAR.==
+
== DATAGRID FACIL DE USAR.==
  
*'''setFieldsAndHeaders($valor)'''
+
Invocando el helper datagrid y pasando el model se crea automáticamente una grilla con los campos (fields). La forma de modificar el diseño del datagrid es 100% hoja estilo 'CSS'. También con un poco de programación podrás
 +
ocultar campos, cambiar los titulos de los campos, crear link por fila el cual llamara una acción pasando el
 +
id como parámetro, link para editar y eliminar, personalizar mensajes de advertencias. asignar el tipo de campo
 +
que se está visualizando (moneda, número, porcentaje o una imagen). crear paginado.
  
$valor = 'id: código';
+
 
donde id es el campo de la tabla y código es un string a mostrar.
+
 
 +
===setValue($field_id, $field)===
 +
 
 +
Asigna un campo a mostrar de la tabla _id
 +
$field_id: campo_id del modelo.
 +
$field: nombre del campo que se encuentra en la tabla relacionada
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->setFieldsAndHeaders('id: COD.', 'nombre: NOMBRE');
+
$dataGrid = new($Clientes);
 +
$dataGrid->setValue('paises_id', 'nombre');
 
</source>
 
</source>
  
  
En este ejemplo hay un campo perfiles_id, pero indicando  perfiles_nombre se visualiza el campo nombre de la tabla perfiles.
+
<source lang=php>
 +
$dataGrid = new($Usuarios);
 +
$dataGrid->setValue('roles_id', 'rol');
 +
$dataGrid->setValue('paises_id', 'nombre');
 +
$dataGrid->setValue('ciudades_id', 'ciudad');
 +
</source>
 +
 
 +
 
 +
===setCaption($field, $title)===
 +
 
 +
Cambia el nombre de una columna
 +
$field: campo del modelo
 +
$title: nombre a mostrar en la columna.
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->setFieldsAndHeaders('id: COD.', 'perfiles_nombre: PERFIL');
+
$dataGrid = new($Clientes);
 +
$dataGrid->setCaption('id', 'COD');
 +
$dataGrid->setCaption('paises_id', 'PAIS');
 
</source>
 
</source>
  
  
*'''setColumnsAling($valor)'''
+
===setTextUpper($field)===
$valor = 'id: center';
+
 
donde id es el campo de la tabla y center es la propiedad
+
Transforma toda la cadena de texto en letras Mayúsculas.
 +
$field: campo del modelo
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->setColumnsAling('id: center', 'nombre: left');
+
$dataGrid = new($Clientes);
</source>
+
$dataGrid->setTextUpper('nombres');
 +
</source>
  
*'''caption'''
+
 
$tile: es un string que se muestra como titulo en la grilla.
+
===setTextLower($field)===
 +
 
 +
Transforma toda la cadena de texto en letras minúsculas.
 +
$field: campo del modelo
 +
 
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTextLower('nombres');
 +
</source>
 +
 
 +
 
 +
===setTextUpperFirst($field)===
 +
 
 +
Transforma en mayúscula la primera letra de la cadena de texto.
 +
$field: campo del modelo
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->caption = $title;
+
$dataGrid = new($Clientes);
 +
$dataGrid->setTextUpperFirst('nombres');
 
</source>
 
</source>
  
*'''data_source'''
+
===setTextUpperWords($field)===
Es una propiedad muy importante ya que se obtienen los datos a mostrar.
 
los datos son respuesta de un find, o un paginate.
 
  
 +
Transforma en mayúscula la primera letra de cada palabra de la cadena de texto.
 +
$field: campo del modelo
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTextUpperWords('nombres');
 +
</source>
 +
 +
 +
===setTypeDate($field)===
 +
 +
Formato de salida d/m/Y (01/01/2002) para base de datos mysql
 +
$field: campo del modelo
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTypeDate('fecha');
 +
</source>
 +
 +
===setTypeDateTime($field)===
 +
 +
Formato de salida d/m/Y H:m:s (01/01/2002 12:00:00) para base de datos mysql
 +
$field: campo del modelo
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTypeDate('fecha');
 +
</source>
 +
 +
===setTypeImage($field)===
 +
 +
Muestra una imagen que se encuentra en la carpeta img/, es decir, solo se almacena el nombre de la imagen en formato jpg, gif o png. Debe existir un subdirectorio llamdo thumbs el cual almacena las imagenes redimencionadas.
 +
El archivo config/datagrid.ini tiene información del tamaño de la imagen redimensionada.
 +
$field: campo del modelo
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTypeImage('photo');
 +
</source>
 +
 +
===setTypeMoney($field)===
 +
 +
Formato de salida de un campo numerico
 +
El archivo config/datagrid.ini tiene información para el signo y separadores.
 +
$field: campo del modelo
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTypeMoney('monto');
 +
</source>
 +
 +
===setTypeNumeric($field)===
 +
 +
Formato de salida de un campo numerico
 +
El archivo config/datagrid.ini tiene información para los separadores.
 +
$field: campo del modelo
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTypeNumeric('cantidad');
 +
</source>
 +
 +
 +
 +
===setTypePercent($field)===
 +
 +
Formato de salida de un campo numerico
 +
El archivo config/datagrid.ini tiene información adicional.
 +
$field: campo del modelo
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setTypePercent('porcentaje');
 +
</source>
 +
 +
===setMimes($params=array())===
 +
Visualiza un icono con un link a una accion al final de la fila para cada registro.
 +
 +
array $params: array de parametros
 +
 +
el primer paramtro es el nombre de la imagen que se encuentra en la carpeta img/ con extensión gif. 'xls:' el siguiente es el nombre de la accion que se encuetra en el mismo controlador creada la grilla, envia el id.
 +
ej: http://dominio.com/kumbia/clientes/verExcel/11
 +
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setMimes('xls: verExcel', 'pdf: verPdf');
 +
</source>
 +
 +
===setAlias($fields, $data=array())===
 +
Crea alias a los datos que se encuentran en la tabla
 +
 +
$field: nombre del campo
 +
$data: array de parametros
 +
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setAlias('status', array('A'=>'Activo', 'D'=>'Desactivo'));
 +
</source>
 +
o
 
<source lang="php">
 
<source lang="php">
$dataGrid->data_source = $this->Usuarios->find();
+
$dataGrid = new($Clientes);
 +
$dataGrid->setAlias('numeros', array('0'=>'Cero', '1'=>'Uno', '2'=>'Dos', '3'=>'Tres', '4'=>'Cuatro', '5'=>'Cinco'));
 +
</source>
  
$dataGrid->data_source = $this->Usuarios->find("nombre like '%al%'");
+
===setImage($fields, $data=array())===
 +
Coloca una imagen según el campo. La imagen puede ser cualquier formato soportado y debe estar almacenada en img/datagrid/
  
$dataGrid->data_source = Load::model('usurios')->paginate('per_page: 20', "page: $page", "order: $order $asc_desc");
+
 
 +
$field: nombre del campo
 +
$data: array de parametros
 +
 
 +
 
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setAlias('status', array('A'=>'Activo.png', 'D'=>'Desactivo.png'));
 
</source>
 
</source>
 +
o
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->setAlias('numeros', array('0'=>'Cero.gif', '1'=>'Uno.gif', '2'=>'Dos.gif', '3'=>'Tres.gif', '4'=>'Cuatro.gif', '5'=>'Cinco.gif'));
 +
</source>
 +
 +
===setClass($fields, $data=array())===
 +
Asigna una clase "CSS" al campo que se despliega según su valor
 +
  
<u>En caso que la grilla tenga un paginador</u>
+
$field: nombre del campo
 +
$data: array de parametros
  
*'''url'''
 
Si utiliza paginator la grilla se debe indicar la url para el paginado, sino se indica por defecto obtiene el nombre del controlador y su accion de donde fue creado el dataGrid.
 
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->url = 'usurios/index';
+
$dataGrid = new($Clientes);
 +
$dataGrid->setClass('status', array('P'=>'text-color-red', 'A'=>'text-color-green', 'R'=>'text-bold'));
 
</source>
 
</source>
  
*'''show'''
+
===auto_filter = true===
número de paginas que se mostraran en el paginador, por defecto 10.
+
Genera por cada celda un select o combo para realizar búsquedas en la misma grilla.
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->show = 10;
+
$dataGrid = new($Clientes);
 +
$dataGrid->auto_filter = true;
 
</source>
 
</source>
  
*'''paginator_name'''
+
===ignoreAutoFilter(array($campos))===
 +
Cuando se realiza un autofiltro, con esta funcion se puede eliminar filtros de una columna.
  
Es el nombre del paginador para la grilla por defecto usa el default
+
<source lang="php">
puede incluir paginadores del kumbia.
+
$dataGrid = new($Clientes);
  Classic -  Digg -  Extended -  Punbb -  Simple
+
$dataGrid->auto_filter = true;
 +
$dataGrid->ignoreAutoFilter(array('id', 'status'));
 +
</source>
 +
 
 +
===ignore($field)===
 +
No muestra un campo del molelo en la grilla
 +
$field: campo del modelo
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->paginator_name = 'classic';
+
$dataGrid = new($Clientes);
 +
$dataGrid->ignore('id');
 
</source>
 
</source>
  
*'''edit, delete'''
+
===createCol($caption, $html)===
Si existe un formulario por parte del programador estas funciones
+
Crea una nueva columna a la grilla
redireccionan a un controller personalizado, debe indicar el controller_name y action_name por defecto envia el id, a la accion
+
 
 +
$caption: Nombre de la columna.
 +
 
 +
$html: crea un html para ser visualizado
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->edit = 'usuarios/edit';
+
$dataGrid = new($Clientes);
 +
$dataGrid->createCol('APROBAR', '<div id="div_a_{id}">' . Html::img('yes.gif', 'APROBAR', 'onclick=aprobar({id}); class="manito" id="img_a_{id}"') . '</div>');
 
</source>
 
</source>
  
Línea 82: Línea 253:
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->delete = 'clientes/delete';
+
$dataGrid = new($Clientes);
 +
$dataGrid->createCol('PRIMER V°B°', '');
 
</source>
 
</source>
  
*'''delete_confirm'''
+
===create = $url ===
En caso que estubiera activo el delete se puede agregar un mensaje de confirmacion para eliminar.
+
Visualiza una imagen sobre la grilla y crea un link a la accion crear
por defecto viene desactivado, se pueden pasar el campo a confirmar dentro de { }.
+
 
 +
$url: nombre del controlador más la accion
 +
 
 +
ej: http://dominio.com/kumbia/clientes/create
 +
 
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->delete_confirm = '¿Desea elmimar este registro?';
+
$dataGrid = new($Clientes);
 +
$dataGrid->edit = $controller_name . '/create';
 
</source>
 
</source>
 +
 +
 +
===edit = $url ===
 +
Visualiza un icono con un link a una accion al final de la fila para cada registro.
 +
 +
$url: nombre del controlador más la accion, es devuelta con su id
 +
 +
ej: http://dominio.com/kumbia/clientes/edit/11
 +
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->delete_confirm = '¿Desea elmimar el registro {id}?';
+
$dataGrid = new($Clientes);
 +
$dataGrid->edit = $controller_name . '/edit';
 
</source>
 
</source>
 +
 +
===delete = $url ===
 +
Visualiza un icono con un link a una accion al final de la fila para cada registro.
 +
 +
$url: nombre del controlador más la accion, es devuelta con su id
 +
 +
ej: http://dominio.com/kumbia/clientes/delete/11
 +
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->delete = controller_name . '/delete';
 +
</source>
 +
 +
 +
===delete_confirm = $msg===
 +
Mensaje de alerta para la accion delete.
 +
$msg: se puede visualizar el valor de un campo pasandoselo entre llaves {$field}.
 +
 +
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->delete = $controller_name . '/delete';
 +
$dataGrid->delete_confirm = 'Desea elimina el registro {id}';
 +
</source>
 +
  
 
<source lang="php">
 
<source lang="php">
 +
$dataGrid = new($Clientes);
 +
$dataGrid->delete = $controller_name . '/delete';
 
$dataGrid->delete_confirm = '¿Desea elmimar este registro {nombre}, {apellido}?';
 
$dataGrid->delete_confirm = '¿Desea elmimar este registro {nombre}, {apellido}?';
 
</source>
 
</source>
  
*'''setMimes($valores)'''
+
===paginator_name = $paginador===
 +
 
 +
$paginador: Nombre del paginador para la grilla por defecto usa el default
 +
puede incluir paginadores del kumbia.
 +
  Classic -  Digg -  Extended -  Punbb -  Simple
 +
 
 +
<source lang="php">
 +
$dataGrid = new($Clientes->paginate('per_page: 20'));
 +
$dataGrid->paginator_name = 'classic';
 +
</source>
  
$valores = 'xls: verXls';
 
  
primer parametro es el nombre de la imagen que se encuentra en public/img/dataGrid/*.gif la extencion es gif.
+
===url = $url===
y el segundo parametro es la action que se será invocada en el mismo controlador que se encuentra el dataGrid.
+
Si utiliza paginator la grilla se debe indicar la url para el paginado, sino se indica por defecto obtiene el nombre del controlador y su accion de donde fue creado el dataGrid.
generea un icono al lado del registro, es util cuando el programador desea general una planilla excel o un
 
pdf por: 'usuario, cliente, etc...'.
 
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->setMimes('xls: descargarXls', 'pdf: verPdf', 'txt: archivoPlano');
+
$dataGrid = new($Clientes->paginate('per_page: 20'));
 +
$dataGrid->url = 'usurios/index';
 
</source>
 
</source>
  
*'''order_fields'''
+
===show = 10===
Por defecto esta en false. sirve para realizar orden by a los campos pinchando en la cabezera de la grilla.
+
número de paginas que se mostraran en el paginador, por defecto 10.
se puede utilizar con o sin paginado
 
  
 
<source lang="php">
 
<source lang="php">
$dataGrid->order_fields = true;
+
$dataGrid = new($Clientes->paginate('per_page: 20'));
 +
$dataGrid->show = 10;
 
</source>
 
</source>
  
 +
===style = $name===
 +
$name: nombre de la hoja de estilo ubicado en public/css/
  
para finalizar y llamar al partial debe ser de esta manera
+
<source lang="php">
 +
$dataGrid = new($Clientes->paginate('per_page: 20'));
 +
$dataGrid->style = 'default';
 +
</source>
  
===USO BASICO===
+
===Ejemplo 1 de Uso===
  
 
'''controller_clientes.php'''
 
'''controller_clientes.php'''
Línea 140: Línea 366:
 
     View::content();
 
     View::content();
 
     View::helpers('dataGrid');
 
     View::helpers('dataGrid');
     $dataGrid = new dataGrid();
+
     $dataGrid = new dataGrid($clientes);
    $dataGrid->setFieldsAndHeaders('rut: RUT', 'dv: DV', 'nombre: NOMBRE/RAZON SOCIAL', 'giro: GIRO',
+
     View::partial('datagrid/default',false,array('dataGrid'=>$dataGrid));
    'direccion: DIRECCION', 'ciudades_nombre: CIUDAD');
 
    $dataGrid->data_source = $clientes;
 
     View::partial('dataGrid/default',false,array('dataGrid'=>$dataGrid));
 
 
 
 
</source>
 
</source>
  
 
+
===Ejemplo 2 de Uso===
===DATAGRID CON PAGINATOR===
 
  
 
'''controller_clientes.php'''
 
'''controller_clientes.php'''
 
<source lang="php">
 
<source lang="php">
     public function index($page=1, $field='nombre', $order='asc')
+
     public function index($page=1)
 
     {
 
     {
     $this->clientes = $this->Clientes->paginate('per_page: 20', "page: $page", "order: $field $order");
+
     $this->clientes = $this->Clientes->paginate('per_page: 20', "page: $page");
 
     }
 
     }
 
</source>
 
</source>
  
 
'''views/clientes/index.phtml'''
 
'''views/clientes/index.phtml'''
 +
 
<source lang="php">
 
<source lang="php">
<?php
+
<?php View::content() ?>
    View::content();
+
<?php View::helpers('dataGrid'); ?>
    View::helpers('dataGrid');
+
<?php
     $dataGrid = new dataGrid();
+
     $dataGrid = new dataGrid($clientes);
     $dataGrid->setFieldsAndHeaders('rut: RUT', 'dv: DV', 'nombre: NOMBRE/RAZON SOCIAL', 'giro: GIRO',
+
     $dataGrid->setValue('ciudades_id', 'nombre');
     'direccion: DIRECCION', 'ciudades_nombre: CIUDAD');
+
    $dataGrid->setTextLower('nombre');
     $dataGrid->edit = $controller_name . '/edit';
+
    $dataGrid->setTypeImage('photo');
     $dataGrid->delete = $controller_name . '/delete';
+
    $dataGrid->setMimes('xls: verXls');
     $dataGrid->delete_confirm = '¿Desea eliminar este registro {rut}-{dv}, {nombre}?';
+
    $dataGrid->ignore('id');
$dataGrid->order_fields = true;
+
     $dataGrid->setCaption('ciudades_id', 'CIUDAD');
    $dataGrid->data_source = $clientes;
+
     $dataGrid->delete = $controller_name . '/delete';
    View::partial('dataGrid/default',false,array('dataGrid'=>$dataGrid));
+
     $dataGrid->edit = $controller_name . '/edit';
 +
     $dataGrid->delete_confirm = 'Eliminar el registro {rut}-{dv}';
 
?>
 
?>
 +
<?php View::partial('datagrid/default',false,array('dataGrid'=>$dataGrid)); ?>
 
</source>
 
</source>
  
 +
===Screenshots===
 +
Modelo Paises
 +
 +
[[Archivo:Model_paises.gif]]
 +
 +
[[Archivo:DataGrid2.png]]
  
[[Archivo:dataGrid.jpg]]
+
===Descargar===
 +
[https://sourceforge.net/projects/helperdatagrid/files/dataGrid%20Jquery-ui%20Beta1%20rc0.9.tar.gz/download Descargar] para '''Spirit v1.0 beta1''' con temas de jquery-ui
  
  
[https://sourceforge.net/projects/helperdatagrid/ Descargar]
 
  
  
  
 
[[Categoría:Helpers]]
 
[[Categoría:Helpers]]
 +
[[Categoría:Tutoriales KumbiaPHP]]

Revisión actual del 16:00 16 abr 2020

DATAGRID FACIL DE USAR.[editar]

Invocando el helper datagrid y pasando el model se crea automáticamente una grilla con los campos (fields). La forma de modificar el diseño del datagrid es 100% hoja estilo 'CSS'. También con un poco de programación podrás ocultar campos, cambiar los titulos de los campos, crear link por fila el cual llamara una acción pasando el id como parámetro, link para editar y eliminar, personalizar mensajes de advertencias. asignar el tipo de campo que se está visualizando (moneda, número, porcentaje o una imagen). crear paginado.


setValue($field_id, $field)[editar]

Asigna un campo a mostrar de la tabla _id $field_id: campo_id del modelo. $field: nombre del campo que se encuentra en la tabla relacionada

$dataGrid	=	new($Clientes);
$dataGrid->setValue('paises_id', 'nombre');


$dataGrid	=	new($Usuarios);
$dataGrid->setValue('roles_id', 'rol');
$dataGrid->setValue('paises_id', 'nombre');
$dataGrid->setValue('ciudades_id', 'ciudad');


setCaption($field, $title)[editar]

Cambia el nombre de una columna $field: campo del modelo $title: nombre a mostrar en la columna.

$dataGrid	=	new($Clientes);
$dataGrid->setCaption('id', 'COD');
$dataGrid->setCaption('paises_id', 'PAIS');


setTextUpper($field)[editar]

Transforma toda la cadena de texto en letras Mayúsculas. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTextUpper('nombres');


setTextLower($field)[editar]

Transforma toda la cadena de texto en letras minúsculas. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTextLower('nombres');


setTextUpperFirst($field)[editar]

Transforma en mayúscula la primera letra de la cadena de texto. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTextUpperFirst('nombres');

setTextUpperWords($field)[editar]

Transforma en mayúscula la primera letra de cada palabra de la cadena de texto. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTextUpperWords('nombres');


setTypeDate($field)[editar]

Formato de salida d/m/Y (01/01/2002) para base de datos mysql $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTypeDate('fecha');

setTypeDateTime($field)[editar]

Formato de salida d/m/Y H:m:s (01/01/2002 12:00:00) para base de datos mysql $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTypeDate('fecha');

setTypeImage($field)[editar]

Muestra una imagen que se encuentra en la carpeta img/, es decir, solo se almacena el nombre de la imagen en formato jpg, gif o png. Debe existir un subdirectorio llamdo thumbs el cual almacena las imagenes redimencionadas. El archivo config/datagrid.ini tiene información del tamaño de la imagen redimensionada. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTypeImage('photo');

setTypeMoney($field)[editar]

Formato de salida de un campo numerico El archivo config/datagrid.ini tiene información para el signo y separadores. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTypeMoney('monto');

setTypeNumeric($field)[editar]

Formato de salida de un campo numerico El archivo config/datagrid.ini tiene información para los separadores. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTypeNumeric('cantidad');


setTypePercent($field)[editar]

Formato de salida de un campo numerico El archivo config/datagrid.ini tiene información adicional. $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->setTypePercent('porcentaje');

setMimes($params=array())[editar]

Visualiza un icono con un link a una accion al final de la fila para cada registro.

array $params: array de parametros

el primer paramtro es el nombre de la imagen que se encuentra en la carpeta img/ con extensión gif. 'xls:' el siguiente es el nombre de la accion que se encuetra en el mismo controlador creada la grilla, envia el id. ej: http://dominio.com/kumbia/clientes/verExcel/11


$dataGrid	=	new($Clientes);
$dataGrid->setMimes('xls: verExcel', 'pdf: verPdf');

setAlias($fields, $data=array())[editar]

Crea alias a los datos que se encuentran en la tabla

$field: nombre del campo $data: array de parametros


$dataGrid	=	new($Clientes);
$dataGrid->setAlias('status', array('A'=>'Activo', 'D'=>'Desactivo'));

o

$dataGrid	=	new($Clientes);
$dataGrid->setAlias('numeros', array('0'=>'Cero', '1'=>'Uno', '2'=>'Dos', '3'=>'Tres', '4'=>'Cuatro', '5'=>'Cinco'));

setImage($fields, $data=array())[editar]

Coloca una imagen según el campo. La imagen puede ser cualquier formato soportado y debe estar almacenada en img/datagrid/


$field: nombre del campo $data: array de parametros


$dataGrid	=	new($Clientes);
$dataGrid->setAlias('status', array('A'=>'Activo.png', 'D'=>'Desactivo.png'));

o

$dataGrid	=	new($Clientes);
$dataGrid->setAlias('numeros', array('0'=>'Cero.gif', '1'=>'Uno.gif', '2'=>'Dos.gif', '3'=>'Tres.gif', '4'=>'Cuatro.gif', '5'=>'Cinco.gif'));

setClass($fields, $data=array())[editar]

Asigna una clase "CSS" al campo que se despliega según su valor


$field: nombre del campo $data: array de parametros


$dataGrid	=	new($Clientes);
$dataGrid->setClass('status', array('P'=>'text-color-red', 'A'=>'text-color-green', 'R'=>'text-bold'));

auto_filter = true[editar]

Genera por cada celda un select o combo para realizar búsquedas en la misma grilla.

$dataGrid	=	new($Clientes);
$dataGrid->auto_filter = true;

ignoreAutoFilter(array($campos))[editar]

Cuando se realiza un autofiltro, con esta funcion se puede eliminar filtros de una columna.

$dataGrid	=	new($Clientes);
$dataGrid->auto_filter = true;
$dataGrid->ignoreAutoFilter(array('id', 'status'));

ignore($field)[editar]

No muestra un campo del molelo en la grilla $field: campo del modelo

$dataGrid	=	new($Clientes);
$dataGrid->ignore('id');

createCol($caption, $html)[editar]

Crea una nueva columna a la grilla

$caption: Nombre de la columna.

$html: crea un html para ser visualizado

$dataGrid	=	new($Clientes);
$dataGrid->createCol('APROBAR', '<div id="div_a_{id}">' . Html::img('yes.gif', 'APROBAR', 'onclick=aprobar({id}); class="manito" id="img_a_{id}"') . '</div>');

o

$dataGrid	=	new($Clientes);
$dataGrid->createCol('PRIMER V°B°', '');

create = $url[editar]

Visualiza una imagen sobre la grilla y crea un link a la accion crear

$url: nombre del controlador más la accion

ej: http://dominio.com/kumbia/clientes/create


$dataGrid	=	new($Clientes);
$dataGrid->edit	=	$controller_name . '/create';


edit = $url[editar]

Visualiza un icono con un link a una accion al final de la fila para cada registro.

$url: nombre del controlador más la accion, es devuelta con su id

ej: http://dominio.com/kumbia/clientes/edit/11


$dataGrid	=	new($Clientes);
$dataGrid->edit	=	$controller_name . '/edit';

delete = $url[editar]

Visualiza un icono con un link a una accion al final de la fila para cada registro.

$url: nombre del controlador más la accion, es devuelta con su id

ej: http://dominio.com/kumbia/clientes/delete/11


$dataGrid		=	new($Clientes);
$dataGrid->delete	=	controller_name . '/delete';


delete_confirm = $msg[editar]

Mensaje de alerta para la accion delete. $msg: se puede visualizar el valor de un campo pasandoselo entre llaves {$field}.

$dataGrid			=	new($Clientes);
$dataGrid->delete		=	$controller_name . '/delete';
$dataGrid->delete_confirm	=	'Desea elimina el registro {id}';


$dataGrid			=	new($Clientes);
$dataGrid->delete		=	$controller_name . '/delete';
$dataGrid->delete_confirm	=	'¿Desea elmimar este registro {nombre}, {apellido}?';

paginator_name = $paginador[editar]

$paginador: Nombre del paginador para la grilla por defecto usa el default puede incluir paginadores del kumbia.

  Classic -   Digg -   Extended -   Punbb -   Simple
$dataGrid			=	new($Clientes->paginate('per_page: 20'));
$dataGrid->paginator_name	=	'classic';


url = $url[editar]

Si utiliza paginator la grilla se debe indicar la url para el paginado, sino se indica por defecto obtiene el nombre del controlador y su accion de donde fue creado el dataGrid.

$dataGrid		=	new($Clientes->paginate('per_page: 20'));
$dataGrid->url		=	'usurios/index';

show = 10[editar]

número de paginas que se mostraran en el paginador, por defecto 10.

$dataGrid		=	new($Clientes->paginate('per_page: 20'));
$dataGrid->show		=	10;

style = $name[editar]

$name: nombre de la hoja de estilo ubicado en public/css/

$dataGrid		=	new($Clientes->paginate('per_page: 20'));
$dataGrid->style	=	'default';

Ejemplo 1 de Uso[editar]

controller_clientes.php

public function index()
{
	$this->clientes 	=	$this->Clientes->find("order: nombre");;
}

views/clientes/index.phtml

    	View::content();
    	View::helpers('dataGrid');
    	$dataGrid			=	new dataGrid($clientes);
    	View::partial('datagrid/default',false,array('dataGrid'=>$dataGrid));

Ejemplo 2 de Uso[editar]

controller_clientes.php

    public function index($page=1)
    {
    	$this->clientes	= $this->Clientes->paginate('per_page: 20', "page: $page");
    }

views/clientes/index.phtml

<?php View::content() ?>
<?php View::helpers('dataGrid'); ?>
<?php 
    	$dataGrid					=	new dataGrid($clientes);
    	$dataGrid->setValue('ciudades_id', 'nombre');
    	$dataGrid->setTextLower('nombre');
    	$dataGrid->setTypeImage('photo');
    	$dataGrid->setMimes('xls: verXls');
    	$dataGrid->ignore('id');
    	$dataGrid->setCaption('ciudades_id', 'CIUDAD');
    	$dataGrid->delete	=	$controller_name . '/delete';
    	$dataGrid->edit		=	$controller_name . '/edit';
    	$dataGrid->delete_confirm	=	'Eliminar el registro {rut}-{dv}';
?>
<?php View::partial('datagrid/default',false,array('dataGrid'=>$dataGrid)); ?>

Screenshots[editar]

Modelo Paises

Model paises.gif

DataGrid2.png

Descargar[editar]

Descargar para Spirit v1.0 beta1 con temas de jquery-ui