Edición de «Helper Tabla»

== 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.

<source lang="php">
Tabla::cabeceras('cedula','nombres','apellidos');
</source>



===anchoCols('ancho 1','ancho 2','ancho N')===

Asigna los anchos que tendrán cada una de las columnas de la tabla.

<source lang="php">
Tabla::anchoCols('100px','100px','');
</source>



===campos('campo1','campo2','campoN')===

Establece los campos del modelo que se mostraran en la Tabla.

<source lang="php">
Tabla::campos('cedula','nombre','activo');
</source>



===modelo($modelo)===

indica el modelo con los datos a mostrar en la tabla.

<source lang="php">
Tabla::modelo($usuarios); // Donde $usuarios es el resultado de una consulta, ejemplo $usuarios = new Usuarios()->find();
</source>



===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.

<source lang="php">
Tabla::link('usuarios/editar','editar');
Tabla::link('usuarios/eliminar','eliminar','eliminar.png');
</source>



===urlPaginador($url)===

En caso de que el resultado de la consulta esté paginado, se debe especificar la url del paginador.

<source lang="php">
Tabla::urlPaginador('usuarios/index');
</source>



===crear()===

crea la tabla segun los parametros antes especificados

<source lang="php">
echo Tabla::crear();
</source>



==Ejemplo de Uso sin paginador==

====En el controlador====
<source lang="php">
public function index(){
     $this->usuarios = new Usuarios()->find();
}
</source>

====En la vista====
<source lang="php">
<?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();
?>
}
</source>



==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====
<source lang="php">
class Usuarios extends ActiveRecord{
    public function getNombreCompleto(){
        return $this->nombres . ' ' . $this->apellidos ; 
    }
}
</source>

====En el controlador====
<source lang="php">
public function index($pagina = 1){
     $this->usuarios = new Usuarios()->paginate("page: $pagina","per_page: 10");
}
</source>

====En la vista====
<source lang="php">
<?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();
?>
}
</source>


==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====
<source lang="php">
class Sesiones extends ActiveRecord{
    public function initialize() {
        $this->belongs_to('usuarios','fk: id_usuario');
    }

    public function getHoraFecha(){
        return $this->hora . ' , ' . $this->fecha ; 
    }
}
</source>

====En el controlador====
<source lang="php">
public function index($pagina = 1){
     $this->sesiones = new Sesiones()->find();
}
</source>

====En la vista====
<source lang="php">
<?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();
?>
}
</source>


==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====
<source lang="php">
public function index($pagina = 1){
     $this->sesiones = new Sesiones()->find();
}
</source>

====En la vista====
<source lang="php">
<?php echo View::content() ?>
<?php
   Tabla::modelo($sesiones);
   echo Tabla::crear();
?>
}
</source>

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

<source lang="php">
<?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 .= '&nbsp;&nbsp;';
        }
        for ($x = 1; $x <= self::$_paginador->total; ++$x) {
            $html .= self::$_paginador->current == $x ? '<strong>' . $x . '</strong>' : Html::link(self::$_urlPaginador . $x, $x);
            $html .= '&nbsp;&nbsp;';
        }
        if (self::$_paginador->next) {
            $html .= Html::link(self::$_urlPaginador . self::$_paginador->next, 'Siguiente', 'title="Ir a la pág. siguiente" class="nextprev"');
        }
        return $html;
    }

}
</source>
@@ Línea 1: / Línea 1: @@
-[[Categoría:Helpers]]
 == Creando Tablas Facilmente con el Helper Tabla (beta2) ==
@@ Línea 266: / Línea 264: @@
       */
      protected static $_mensajeSinRegistros = 'La Consulta No Arrojó Ningun Registro';
-    /**
-     * clases para los tr de la tabla, para dar un formato de cebra
-     *
-     * @var string
-     */
-    protected static $_clases = array();
-    /**
-     * posicion actual del arreglo $_clases
-     *
-     * @var int
-     */
-    private static $_posClass = 0;
      /**
@@ Línea 286: / Línea 272: @@
              if (sizeof(self::$_modelo)) {
                  self::$_campos = self::$_cabeceras = self::$_modelo[0]->non_primary;
-             } else {
+             }else{
                  return '';
              }
@@ Línea 313: / Línea 299: @@
          $html .= '      </tr></thead><tbody>';
          foreach (self::$_modelo as $fila) {
-             $html .= '<tr class="' . self::sigClass() . '">';
+             $html .= '<tr>';
              if (self::$_check) {
                  $html .= '<td>' . Form::check(self::$_check['nombre'] . '.' . $fila->id, $fila->id) . '</td>';
@@ Línea 540: / Línea 526: @@
      public static function urlPaginador($url) {
          self::$_urlPaginador = $url . '/';
-    }
-    /**
-     *  establece las clases que tendran las filas de la tabla
-     * para crear un efecto de cebra
-     *
-     * @param array $array arreglo con los nombres de las clases
-     * @param string $strings cadenas con los nombres de las clases
-     */
-    public static function clases() {
-        $parametros = Util::getParams(func_get_args());
-        if (is_array($parametros[0])) {
-            self::$_clases = $parametros[0];
-        } else {
-            self::$_clases = $parametros;
-        }
-    }
-    protected static function sigClass() {
-        if (sizeof(self::$_clases)) {
-            if (self::$_posClass == sizeof(self::$_clases)) {
-                self::$_posClass = 0;
-            }
-            return self::$_clases[self::$_posClass++];
-        }  else {
-            return '';
-        }
      }
@@ Línea 586: / Línea 545: @@
 }
 </source>