lib/MECON/HTML/TablaDB.php

   1 <?php /* vim: set binary expandtab tabstop=4 shiftwidth=4 textwidth=80:
   2 -------------------------------------------------------------------------------
   3                              Ministerio de Economía
   4                                     meconlib
   5 -------------------------------------------------------------------------------
   6 This file is part of meconlib.
   7
   8 meconlib is free software; you can redistribute it and/or modify it under
   9 the terms of the GNU General Public License as published by the Free
  10 Software Foundation; either version 2 of the License, or (at your option)
  11 any later version.
  12
  13 meconlib is distributed in the hope that it will be useful, but WITHOUT
  14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  15 FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License; if not,
  18 write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  19 Boston, MA  02111-1307  USA
  20 -------------------------------------------------------------------------------
  21 Creado: fri mar 21 ART 2003
  22 Autor:  Martin Marrese <mmarre@mecon.gov.ar>
  23 -------------------------------------------------------------------------------
  24 $Id$
  25 -----------------------------------------------------------------------------*/
  26
  27 require_once 'MECON/DB/Pager.php';
  28 require_once 'MECON/HTML/Tabla.php';
  29
  30 /**
  31  * Libreria para le manejo de las tablas de los sistemas de intranet.
  32  *
  33  */
  34 class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
  35
  36     /**
  37      * Agrega un páginador a la tabla, basado en un resultado de una base de datos.
  38      * Ejemplo:
  39      * @code
  40      * $tabla = new MECON_HTML_Tabla();
  41      * $result = $db->query('SELECT * FROM tabla');
  42      * if (DB::isError($result)) {
  43      *      die('Error');
  44      * }
  45      * $pager = $tabla->addPager($result);
  46      * $tabla->addRow(array('Nombre', 'Apellido'), 'cabecera');
  47      * if ($pager->numRows()) {
  48      *      while ($row = $pager->fetchRow(DB_FETCHMODE_ASSOC)) {
  49      *          $tabla->addRow(array($row['nombre'], $row['apellido']));
  50      *      }
  51      * } else {
  52      *      $tabla->addRow(array(new MECON_HTML_Error('No se encontraron agentes.')),
  53      *          array('colspan' => 2));
  54      * }
  55      * $tabla->display();
  56      * @endcode
  57      *
  58      * @param DB_Result $result Resultado de una consulta de base de datos.
  59      * @param mixed $tipo Tipo de link(s) a agregar. Puede ser:
  60      *                    <ul>
  61      *                      <li><tt>'anterior'</tt></li>
  62      *                      <li><tt>'siguiente'</tt></li>
  63      *                      <li><tt>'paginas'</tt></li>
  64      *                      <li><tt>'total'</tt></li>
  65      *                      <li><tt>'info'</tt></li>
  66      *                    </ul>
  67      *                    Puede pasarse uno solo como un string o varios como un
  68      *                    array. Si se pasa <tt>'todo'</tt>, se incluyen todos.
  69      *                    Si se pasa null, se incluyen <tt>'anterior'</tt>,
  70      *                    <tt>'siguiente'</tt> y <tt>'paginas'</tt>.
  71      * @param mixed $link Dirección a la que apuntan los links generados. Puede
  72      *                    ser un MECON_HTML_Link (para poder pasar variables por
  73      *                    GET) o un string.
  74      * @param int $limit Parámetro usado para crear el MECON_DB_Pager.
  75      * @param int $maxpages Parámetro usado para crear el MECON_DB_Pager.
  76      *
  77      * @return MECON_DB_Pager Pager que se puede usar para realizar los fetch de
  78      *         los resultados de la página actual.
  79      *
  80      * @see MECON_DB_Pager
  81      */
  82     function addPager($result, $tipo = null, $link = null, $limit = 10, $maxpages = 21) {
  83         // Creo el pager con el resultado.
  84         $pager = new MECON_DB_Pager($result, @$_GET['pager_from'], $limit, $maxpages);
  85         // Obtengo un link válido.
  86         if (!$link) {
  87             $link = @$_SERVER['PHP_SELF'];
  88         }
  89         if (is_string($link)) {
  90             $link = new MECON_HTML_Link($link, '');
  91         }
  92         // Si es el tipo por defecto pone paginador nada más.
  93         if (!$tipo) {
  94             $tipo = array('anterior', 'paginas', 'siguiente');
  95         }
  96         // Convierte tipo a array.
  97         if (!is_array($tipo)) {
  98             $tipo = array($tipo);
  99         }
 100         // Si se quiere mostrar todas las decoraciones del paginador.
 101         if (in_array('todo', $tipo)) {
 102             $tipo = array('anterior', 'paginas', 'siguiente', 'total', 'info');
 103         }
 104         // Me fijo si tiene cada uno de los elementos y los agrego.
 105         if (in_array('anterior', $tipo) and $pager->numRows() and $pager->currentpage != 1) {
 106             $link->setGetVar('pager_from', $pager->prev);
 107             $this->addLink('anterior', $link);
 108         }
 109         if (in_array('siguiente', $tipo) and $pager->numRows() and $pager->currentpage != $pager->numpages) {
 110             $link->setGetVar('pager_from', $pager->next);
 111             $this->addLink('siguiente', $link);
 112         }
 113         if (in_array('paginas', $tipo) and $pager->numRows() and $pager->numpages > 1) {
 114             $from = @$_GET['pager_from'];
 115             $pags = '';
 116             $lnk = $link->getContents();
 117             foreach ($pager->pages as $page => $start_row) {
 118                 if ($start_row == $from) {
 119                     $pags .= $page;
 120                 } else {
 121                     $link->setGetVar('pager_from', $start_row);
 122                     $link->setContents($page);
 123                     $pags .= $link->toHtml();
 124                 }
 125                 if ($page != $pager->lastpage) {
 126                     $pags .= ' | ';
 127                 }
 128             }
 129             $link->setContents($lnk);
 130             $this->updatePie($pags, 'centro');
 131         }
 132         if (in_array('total', $tipo) and $pager->numRows()) {
 133             $this->updateCabecera('Se encontraron ' . $pager->numrows . ' resultados.', 'izquierda');
 134         }
 135         if (in_array('info', $tipo) and $pager->numRows()) {
 136             $this->updateCabecera('Página ' . $pager->currentpage . ' de ' . $pager->numpages
 137                 . ' - ' . $pager->limit . ' resultados por página.', 'derecha');
 138         }
 139         return $pager;
 140     }
 141
 142 }
 143
 144 ?>