Helper Tabla
De KumbiaPHP Framework Wiki
Revisión del 16:37 21 jul 2011 de Manuel j555 (discusión | contribuciones)
Sumario
Creando Tablas Facilmente con el Helper Tabla (beta2)
Con este helper se pueden crear tablas facilmente a partir de un modelo Activerecord y especificando los campos que se desean mostrar del mismo.
cabeceras('columna 1','columna 2','columna N')
Asigna los nombres de las columnas que tendrá la tabla.
Tabla::cabeceras('cedula','nombres','apellidos');
anchoCols('ancho 1','ancho 2','ancho N')
Asigna los anchos que tendrán cada una de las columnas de la tabla.
Tabla::anchoCols('100px','100px','');
campos('campo1','campo2','campoN')
Establece los campos del modelo que se mostraran en la Tabla.
Tabla::campos('cedula','nombre','activo');
modelo($modelo)
indica el modelo con los datos a mostrar en la tabla.
Tabla::modelo($usuarios); // Donde $usuarios es el resultado de una consulta, ejemplo $usuarios = new Usuarios()->find();
link($url,$texto,$img = false)
Crea una columna al final de la tabla con un link hacia la url especificada, ademas se puede pasar la direccion de una imagen.
Tabla::link('usuarios/editar','editar');
Tabla::link('usuarios/eliminar','eliminar','eliminar.png');
urlPaginador($url)
En caso de que el resultado de la consulta esté paginado, se debe especificar la url del paginador.
Tabla::urlPaginador('usuarios/index');
crear()
crea la tabla segun los parametros antes especificados
echo Tabla::crear();
Ejemplo de Uso sin paginador
En el controlador
public function index(){
$this->usuarios = new Usuarios()->find();
}En la vista
<?php echo View::content() ?>
<?php
Tabla::cabeceras('cedula','nombres','apellidos','fecha de nacimiento'); //especifico los nombres de las columnas
Tabla::anchoCols('100px' , '200px' , '200px' , '120px' , '120px'); // el ancho de mas será usado para el link que se mostrará
Tabla::campos('cedula','nombres','apellidos','fecha_nac');
Tabla::link('usuarios/editar','editar');
Tabla::modelo($usuarios);
echo Tabla::crear();
?>
}
Ejemplo de Uso con paginador y llamando a un metodo del modelo
Se puede especificar un metodo del modelo en vez de un campo , el helper automaticamente llamará a ese metodo si existe en el modelo
En el modelo
class Usuarios extends ActiveRecord{
public function getNombreCompleto(){
return $this->nombres . ' ' . $this->apellidos ;
}
}En el controlador
public function index($pagina = 1){
$this->usuarios = new Usuarios()->paginate("page: $pagina","per_page: 10");
}En la vista
<?php echo View::content() ?>
<?php
Tabla::cabeceras('cedula','nombres y apellidos','fecha de nacimiento'); //especifico los nombres de las columnas
Tabla::anchoCols('100px' , '300px' , '120px' , '120px'); // el ancho de mas será usado para el link que se mostrará
Tabla::campos('cedula','getNombreCompleto','fecha_nac');
Tabla::link('usuarios/editar','editar');
Tabla::modelo($usuarios);
Tabla::urlPaginador('usuarios/index');
echo Tabla::crear();
?>
}
Ejemplo de Uso Llamando a un campo de una tabla secundaria
Se pueden especificar campos de tablas relacionadas , indicando el nombre de la tabla, un punto, y el nombre del campo ó metodo de la tabla secundaria, ejemplo: "usuarios.cedula"
En el modelo
class Sesiones extends ActiveRecord{
public function initialize() {
$this->belongs_to('usuarios','fk: id_usuario');
}
public function getHoraFecha(){
return $this->hora . ' , ' . $this->fecha ;
}
}En el controlador
public function index($pagina = 1){
$this->sesiones = new Sesiones()->find();
}En la vista
<?php echo View::content() ?>
<?php
Tabla::cabeceras('Cedula de Usuario','Nombre del Usuario','Hora y Fecha','Acción Realizada'); //especifico los nombres de las columnas
Tabla::anchoCols( '120px' , '250px' , '200px' , '' );
Tabla::campos('usuarios.cedula','usuarios.getNombreCompleto','getHoraFecha','accion'); //llamo a los campos y metodos de otras tablas y del modelo
Tabla::modelo($sesiones);
Tabla::urlPaginador('sesiones/index');
echo Tabla::crear();
?>
}
Ejemplo de Uso sin especificar columnas ni campos
En este caso se crea una tabla con todos los campos no primarios del modelo:
En el controlador
public function index($pagina = 1){
$this->sesiones = new Sesiones()->find();
}En la vista
<?php echo View::content() ?>
<?php
Tabla::modelo($sesiones);
echo Tabla::crear();
?>
}Código del Helper
Pasos para Usar: copiar el código a continuacion, y pegarlo en un archivo con el nombre tabla.php en el directorio default/app/extensions/helpers de tu proyecto ó en el directorio de los helpers del core de kumbiaphp
<?php
/**
* Description of Tabla
*
* @author manuel
*/
class Tabla {
/**
* nombres de las columnas de la tabla
*
* @var array
*/
protected static $_cabeceras = array();
/**
* anchos de las columnas de la tabla
*
* @var array
*/
protected static $_anchuras = array();
/**
* campos a mostrar de la Tabla de la bd
*
* @var array
*/
protected static $_campos = array();
/**
* Consulta con los datos a mostrar en la tabla
*
* @var ActiveRecord
*/
protected static $_modelo;
/**
* acciones que puede realizar el usuario, ejemplo: editar, eliminar, etc
*
* @var array
*/
protected static $_acciones = array();
/**
* para que se muestre un checkbox en la primera columna de la tabla
*
* @var array
*/
protected static $_check = null;
/**
* paginador de los resultados de la consulta
*
* @var ActiveRecord
*/
protected static $_paginador = null;
/**
* url paginador de los resultados de la consulta
*
* @var string
*/
protected static $_urlPaginador = null;
/**
* mensaje a mostrar cuando no allá registros que mostrar en la tabla
*
* @var string
*/
protected static $_mensajeSinRegistros = 'La Consulta No Arrojó Ningun Registro';
/**
* crea la tabla
*/
public static function crear() {
if (!sizeof(self::$_campos)) {
if (sizeof(self::$_modelo)) {
self::$_campos = self::$_cabeceras = self::$_modelo[0]->non_primary;
}else{
return '';
}
}
return self::crearTabla();
}
/**
* crea la tabla con las columnas especificadas
*/
protected static function crearTabla() {
$x = 0;
$html = '<table class="tabla">';
$html .= ' <thead>';
$html .= ' <tr>';
if (self::$_check) {
$html .= '<th style="width:30px">Selec.</th>';
}
for (; $x < sizeof(self::$_cabeceras); ++$x) {
$html .= ' <th style="width:' . @self::$_anchuras[$x] . '">' . h(strtoupper(self::$_cabeceras[$x])) . '</th>';
}
foreach (self::$_acciones as $accion) {
$html .= '<th style="width:' . @self::$_anchuras[$x] . '">-------</th>';
++$x;
}
$html .= ' </tr></thead><tbody>';
foreach (self::$_modelo as $fila) {
$html .= '<tr>';
if (self::$_check) {
$html .= '<td>' . Form::check(self::$_check['nombre'] . '.' . $fila->id, $fila->id) . '</td>';
}
foreach (self::$_campos as $campo) {
if (is_array($campo)) {
if (method_exists($fila->$campo[0](), "{$campo[1]}")) {
$html .= '<td>' . $fila->$campo[0]()->$campo[1]() . '</td>';
} else {
$html .= '<td>' . $fila->$campo[0]()->$campo[1] . '</td>';
}
} else {
if (method_exists($fila, "{$campo}")) {
$html .= '<td>' . $fila->$campo() . '</td>';
} else if (isset($fila->$campo)) {
$html .= '<td>' . $fila->$campo . '</td>';
} else {
$html .= '<td>' . $campo . '</td>';
}
}
}
foreach (self::$_acciones as $accion) {
$html .= '<td><a href="' . $accion['url'] . '/' . $fila->id . '" ' . $accion['atributos'] . '>';
$html .= $accion['img'] . $accion['texto'] . '</a></td>';
}
$html .= '</tr>';
}
$html .= ' </tbody>';
if (sizeof(self::$_modelo)) {
if (self::$_paginador) {
$html .= ' <tfoot><tr><td colspan="100">';
$html .= self::paginador();
$html .= '</td></tr></tfoot>';
}
} else {
$html .= ' <tfoot><tr><td colspan="100">';
$html .= self::$_mensajeSinRegistros;
$html .= '</td></tr></tfoot>';
}
$html .= '</table>';
return $html;
}
/**
* Separa los campos del modelo, de los campos de las subTablas
* ...espero otro lo pueda explicar mejor :P
*
* @param array $campos campos y subTablas de la base de datos
*/
protected static function extraerCampos($campos) {
for ($x = 0; $x < sizeof($campos); ++$x) {
if (sizeof($temp = explode('.', $campos[$x])) > 1) {
$tabla = 'get' . ucfirst($temp[0]);
$campos[$x] = array($tabla, $temp[1]);
}
}
self::$_campos = $campos;
}
/**
* asigna un mensaje a mostrar cuando la consulta no arroje resultados
*
* @param $string $mensaje mensaje a mostrar
*/
public static function mensaje($mensaje) {
self::$_mensajeSinRegistros = $mensaje;
}
/**
* establece los nombres de las columnas que se mostraran en la tabla
*
* @param array $array arreglo con los nombres de las cabeceras
* @param string $strings nombres de las cabeceras
*/
public static function cabeceras() {
$parametros = Util::getParams(func_get_args());
if (is_array($parametros[0])) {
self::$_cabeceras = $parametros[0];
} else {
self::$_cabeceras = $parametros;
}
}
/**
* establece los anchos de las columnas que de la tabla
*
* @param array $array arreglo con los anchos de las columnas
* @param string $strings anchos de las columnas
*/
public static function anchoColumnas() {
$parametros = Util::getParams(func_get_args());
if (is_array($parametros[0])) {
self::$_anchuras = $parametros[0];
} else {
self::$_anchuras = $parametros;
}
}
/**
* establece los anchos de las columnas que de la tabla
*
* @param array $array arreglo con los anchos de las columnas
* @param string $strings anchos de las columnas
*/
public static function anchoCols() {
$parametros = Util::getParams(func_get_args());
if (is_array($parametros[0])) {
self::$_anchuras = $parametros[0];
} else {
self::$_anchuras = $parametros;
}
}
/**
* Establece los campos a mostrar de las tablas
*
* @param array $array arreglo con los campos de las tablas
* @param string $strings campos de las tablas
*
* @return void
* ejemplos:
*
* llamando solo a los campos de la tabla
*
* Tabla::campos(array('cedula','email','nombres'));
* Tabla::campos('cedula','email','nombres');
*
* llamando a tablas q estan relacionadas
*
* Tabla::campos(array('cedula','email','nombres','direcciones.ciudad'));
* Tabla::campos('cedula','email','nombres','direcciones.ciudad');
*
* llamando a metodos en vez de a campos
*
* Tabla::campos(array('cedula','getNombres','direcciones.getCiudad'));
* Tabla::campos('cedula','getNombres','direcciones.getCiudad');
*
* no llamando a ningun metodo ni miembro de ningun modelo
* sino que creando un enlace
*
* Tabla::campos('cedula','nombres',Html::link('index','holaaa'));
*
*/
public static function campos() {
$parametros = Util::getParams(func_get_args());
if (is_array($parametros[0])) {
self::extraerCampos($parametros[0]);
} else {
self::extraerCampos($parametros);
}
}
/**
* agrega un link al final de la tabla
*
* @param string $url url hacia donde llevará el link
* @param string $texto texto a mostrar
* @param string $img url de la imagen a mostrar
*/
public static function link($url, $texto, $img = false) {
if ($img) {
$img = '<img src="' . PUBLIC_PATH . 'img/' . $img . '" width="15px" align="left" style="margin-right:10px;" />';
} else {
$img = '';
}
self::$_acciones[] = array(
'url' => PUBLIC_PATH . $url,
'atributos' => '',
'texto' => $texto,
'img' => $img
);
}
/**
* agrega un check al principio de la tabla
*
* @param string $nombre nombre del check
*/
public static function check($nombre) {
self::$_check = array(
'nombre' => $nombre,
);
}
/**
* agrega una accion con mensaje de confirmacion al final de la tabla
*
* @param string $url url hacia donde llevará el link
* @param string $texto texto a mostrar
* @param string $confirm texto a mostrar
* @param string $img url de la imagen a mostrar
*/
public static function linkConfirm($url, $texto, $confim = '¿ Está Seguro ?', $img = false) {
if ($img) {
$img = '<img src="' . PUBLIC_PATH . 'img/' . $img . '" width="15px" align="left" style="margin-right:10px;" />';
} else {
$img = '';
}
self::$_acciones[] = array(
'url' => PUBLIC_PATH . $url,
'atributos' => 'class= "js-confirm" title="' . $confim . '"',
'texto' => $texto,
'img' => $img
);
}
/**
* resultado de la consulta que se mostrara en la tabla
*
* @param ActiveRecord $modelo resultado de una consulta
*/
public static function modelo($modelo) {
if (isset($modelo->items)) {
self::$_modelo = $modelo->items;
self::$_paginador = $modelo;
} else {
self::$_modelo = $modelo;
}
}
/**
* asigna el url que usará el paginador
*
* @param strin $uel url del paginador
*/
public static function urlPaginador($url) {
self::$_urlPaginador = $url . '/';
}
protected static function paginador() {
$html = '';
if (self::$_paginador->prev) {
$html .= Html::link(self::$_urlPaginador . self::$_paginador->prev, 'Anterior', 'title="Ir a la pág. anterior" class="nextprev"');
$html .= ' ';
}
for ($x = 1; $x <= self::$_paginador->total; ++$x) {
$html .= self::$_paginador->current == $x ? '<strong>' . $x . '</strong>' : Html::link(self::$_urlPaginador . $x, $x);
$html .= ' ';
}
if (self::$_paginador->next) {
$html .= Html::link(self::$_urlPaginador . self::$_paginador->next, 'Siguiente', 'title="Ir a la pág. siguiente" class="nextprev"');
}
return $html;
}
}