]> git.llucax.com Git - mecon/meconlib.git/blobdiff - lib/MECON/HTML/TablaDB.php
Se corrige pequeño bug a Link.
[mecon/meconlib.git] / lib / MECON / HTML / TablaDB.php
index 9a0d15ed86f0ee1e3a862b9702461b24b27c683e..6876e947aa8120f8d08af2a5573989e5345f06ed 100644 (file)
@@ -24,7 +24,10 @@ Autor:  Martin Marrese <mmarre@mecon.gov.ar>
 $Id$
 -----------------------------------------------------------------------------*/
 
 $Id$
 -----------------------------------------------------------------------------*/
 
+require_once 'DB.php';
 require_once 'MECON/DB/Pager.php';
 require_once 'MECON/DB/Pager.php';
+require_once 'MECON/HTML/Error.php';
+require_once 'MECON/HTML/Link.php';
 require_once 'MECON/HTML/Tabla.php';
 
 /**
 require_once 'MECON/HTML/Tabla.php';
 
 /**
@@ -33,25 +36,77 @@ require_once 'MECON/HTML/Tabla.php';
  */
 class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
 
  */
 class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
 
+    /**
+     * Descripción de los elementos listados.
+     * Se utiliza en mensajes del paginador y otros mensajes.
+     */
+    var $_desc = 'resultados';
+
+    /**
+     * Datos a agregar delante de cada fila que se agregue desde una base de datos.
+     * Cada elemento del array es a su vez un array cuyo primer elemento es el
+     * formato del texto a agregar (tipo printf()) y el segundo es un array con los
+     * campos de la DB a utilizar para ese formato en una fila dada.
+     */
+    var $_prependRowsData = array();
+
+    /**
+     * Datos a agregar al final de cada fila que se agregue desde una base de datos.
+     * El formato es el mismo que el de _prependRowsData.
+     */
+    var $_appendRowsData = array();
+
+    /**
+     * Prefijo a usar para las variables GET que genera la tabla.
+     */
+    var $_getVarPrefix = 'tabladb_';
+
+    /**
+     * Constructor. 
+     * Puede recibir como parametro un string con los atributos que se 
+     * quieren dar a la tabla en cuestion. Estos atributos estan
+     * seteados por default segun el archivo de configuracion.
+     * Ademas puede recibir la indicacion de algun estilo en particular.
+     *
+     * @param string $desc Descripción de los elementos listados.
+     * @param mixed $attrs Atributos diferentes a los estandares para la tabla
+     * @param string $estilo Tipo de tabla
+     * 
+     * @access public
+     */
+    function MECON_HTML_TablaDB($desc = null, $attrs = null, $estilo = 'comun') {
+        if ($desc) {
+            $this->_desc = $desc;
+        }
+        parent::MECON_HTML_Tabla($attrs, $estilo);
+    }    
+
+    /**
+     * Establece el prefijo usado para las variables de GET que genera la tabla.
+     */
+    function setGetVarPrefix($prefix) {
+        $this->_getVarPrefix = $prefix;
+    }
+
+    /**
+     * Obtiene el prefijo usado para las variables de GET que genera la tabla.
+     */
+    function getGetVarPrefix() {
+        return $this->_getVarPrefix;
+    }
+
     /**
      * Agrega un páginador a la tabla, basado en un resultado de una base de datos.
      * Ejemplo:
      * @code
     /**
      * Agrega un páginador a la tabla, basado en un resultado de una base de datos.
      * Ejemplo:
      * @code
-     * $tabla = new MECON_HTML_Tabla();
-     * $result = $db->query('SELECT * FROM tabla');
+     * $tabla = new MECON_HTML_TablaDB('personas', array('width' => '100%'));
+     * $result = $db->query('SELECT nombre, apellido FROM tabla');
      * if (DB::isError($result)) {
      *      die('Error');
      * }
      * $pager = $tabla->addPager($result);
      * $tabla->addRow(array('Nombre', 'Apellido'), 'cabecera');
      * if (DB::isError($result)) {
      *      die('Error');
      * }
      * $pager = $tabla->addPager($result);
      * $tabla->addRow(array('Nombre', 'Apellido'), 'cabecera');
-     * if ($pager->numRows()) {
-     *      while ($row = $pager->fetchRow(DB_FETCHMODE_ASSOC)) {
-     *          $tabla->addRow(array($row['nombre'], $row['apellido']));
-     *      }       
-     * } else {
-     *      $tabla->addRow(array(new MECON_HTML_Error('No se encontraron agentes.')),
-     *          array('colspan' => 2));
-     * }   
+     * $tabla->addRows($result, array('nombre', 'apellido'));
      * $tabla->display();
      * @endcode
      *
      * $tabla->display();
      * @endcode
      *
@@ -73,15 +128,17 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
      *                    GET) o un string.
      * @param int $limit Parámetro usado para crear el MECON_DB_Pager.
      * @param int $maxpages Parámetro usado para crear el MECON_DB_Pager.
      *                    GET) o un string.
      * @param int $limit Parámetro usado para crear el MECON_DB_Pager.
      * @param int $maxpages Parámetro usado para crear el MECON_DB_Pager.
+     * @param string $getvar Nombre de la variable GET a usar para indicar el número
+     *               de página actual (se le pone el \ref setGetPrefix prefijo)
      *
      * @return MECON_DB_Pager Pager que se puede usar para realizar los fetch de
      *         los resultados de la página actual.
      *
      *
      * @return MECON_DB_Pager Pager que se puede usar para realizar los fetch de
      *         los resultados de la página actual.
      *
-     * @see MECON_DB_Pager
+     * @see MECON_DB_Pager.
      */
      */
-    function addPager($result, $tipo = null, $link = null, $limit = 10, $maxpages = 21) {
+    function addPager($result, $tipo = null, $link = null, $limit = 10, $maxpages = 21, $getvar = 'from') {
         // Creo el pager con el resultado.
         // Creo el pager con el resultado.
-        $pager = new MECON_DB_Pager($result, @$_GET['pager_from'], $limit, $maxpages);
+        $pager = new MECON_DB_Pager($result, @$_GET[$this->_getVarPrefix.$getvar], $limit, $maxpages);
         // Obtengo un link válido.
         if (!$link) {
             $link = @$_SERVER['PHP_SELF'];
         // Obtengo un link válido.
         if (!$link) {
             $link = @$_SERVER['PHP_SELF'];
@@ -103,22 +160,22 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
         }
         // Me fijo si tiene cada uno de los elementos y los agrego.
         if (in_array('anterior', $tipo) and $pager->numRows() and $pager->currentpage != 1) {
         }
         // Me fijo si tiene cada uno de los elementos y los agrego.
         if (in_array('anterior', $tipo) and $pager->numRows() and $pager->currentpage != 1) {
-            $link->setGetVar('pager_from', $pager->prev);
+            $link->setGetVar($this->_getVarPrefix.$getvar, $pager->prev);
             $this->addLink('anterior', $link);
         }
         if (in_array('siguiente', $tipo) and $pager->numRows() and $pager->currentpage != $pager->numpages) {
             $this->addLink('anterior', $link);
         }
         if (in_array('siguiente', $tipo) and $pager->numRows() and $pager->currentpage != $pager->numpages) {
-            $link->setGetVar('pager_from', $pager->next);
+            $link->setGetVar($this->_getVarPrefix.$getvar, $pager->next);
             $this->addLink('siguiente', $link);
         }
         if (in_array('paginas', $tipo) and $pager->numRows() and $pager->numpages > 1) {
             $this->addLink('siguiente', $link);
         }
         if (in_array('paginas', $tipo) and $pager->numRows() and $pager->numpages > 1) {
-            $from = @$_GET['pager_from'];
+            $from = @$_GET[$this->_getVarPrefix.$getvar];
             $pags = '';
             $lnk = $link->getContents();
             foreach ($pager->pages as $page => $start_row) {
                 if ($start_row == $from) {
                     $pags .= $page;
                 } else {
             $pags = '';
             $lnk = $link->getContents();
             foreach ($pager->pages as $page => $start_row) {
                 if ($start_row == $from) {
                     $pags .= $page;
                 } else {
-                    $link->setGetVar('pager_from', $start_row);
+                    $link->setGetVar($this->_getVarPrefix.$getvar, $start_row);
                     $link->setContents($page);
                     $pags .= $link->toHtml();
                 }
                     $link->setContents($page);
                     $pags .= $link->toHtml();
                 }
@@ -130,15 +187,194 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
             $this->updatePie($pags, 'centro');
         }
         if (in_array('total', $tipo) and $pager->numRows()) {
             $this->updatePie($pags, 'centro');
         }
         if (in_array('total', $tipo) and $pager->numRows()) {
-            $this->updateCabecera('Se encontraron ' . $pager->numrows . ' resultados.', 'izquierda');
+            $this->updateCabecera("Se encontraron {$pager->numrows} {$this->_desc}.", 'izquierda');
         }
         if (in_array('info', $tipo) and $pager->numRows()) {
         }
         if (in_array('info', $tipo) and $pager->numRows()) {
-            $this->updateCabecera('Página ' . $pager->currentpage . ' de ' . $pager->numpages
-                . ' - ' . $pager->limit . ' resultados por página.', 'derecha');
+            $this->updateCabecera("'Página {$pager->currentpage} de {$pager->numpages} - "
+                . "{$pager->limit} {$this->_desc} por página.", 'derecha');
         }
         return $pager;
     }
 
         }
         return $pager;
     }
 
+    /**
+     * Agrega filas desde el resultado de una consulta a una base de datos.
+     * Si no hay resultados, muestra un mensaje. Dependiendo de si es se pasa
+     * un objeto a usar o no, llama a addRowsObject() o addRowsResult()
+     * respectivamente.
+     * Ejemplo:
+     * @code
+     * @endcode
+     *
+     * @param DB_Result $result Resultados de una consulta.
+     * @param array $campos Propiedades del objeto a mostrar.
+     * @param mixed $obj Objeto a usar. Puede ser un objeto instanciado o un
+     *                   string con el nombre de la clase.
+     *
+     * @see Ejemplo en addPager();
+     */
+    function addRows($result, $campos, $obj = null) {
+        if ($result->numRows()) {
+            if ($obj) {
+                $this->addRowsObject($result, $campos, $obj);
+            } else {
+                $this->addRowsResult($result, $campos, $obj);
+            }
+        } else {
+            $id = $this->addRow(array(new MECON_HTML_Error("No se encontraron {$this->_desc}.")));
+            $this->updateCellAttributes($id, 0, array('colspan' => count($campos)));
+        }
+    }
+
+    /**
+     * Agrega filas usando un resultado.
+     *
+     * @param DB_Result $result Resultados de una consulta.
+     * @param array $campos Campos de la base de datos a mostrar.
+     */
+    function addRowsResult($result, $campos) {
+        while ($row = $result->fetchRow(DB_FETCHMODE_ASSOC)) {
+            $datos = array();
+            if ($this->_prependRowsData) {
+                $datos = $this->_buildRowsData($datos, $row, $this->_prependRowsData);
+            }
+            foreach ($campos as $campo) {
+                $datos[] = $row[$campo];
+            }
+            if ($this->_appendRowsData) {
+                $datos = $this->_buildRowsData($datos, $row, $this->_appendRowsData);
+            }
+            $this->addRow($datos);
+        }
+    }
+
+    /**
+     * Agrega filas usando un objeto.
+     * El objeto debe tener un método llamado cargar que acepte como primer (y
+     * único obligatorio) parámetro un DB_Result para cargar sus datos desde una
+     * base de datos.
+     *
+     * @param DB_Result $result Resultados de una consulta.
+     * @param array $campos Propiedades del objeto a mostrar.
+     * @param mixed $obj Objeto a usar. Puede ser un objeto instanciado o un
+     *                   string con el nombre de la clase.
+     *
+     * @see La interfaz MECON_DBO que tiene el método MECON_DBO::cargar().
+     */
+    function addRowsObject($result, $campos, $obj) {
+        if (is_string($obj)) {
+            $obj = new $obj;
+        }
+        if (!method_exists($obj, 'cargar')) {
+            $this->raiseError('La clase ' . get_class($obj) . ' no tiene un metodo cargar().');
+        }
+        while ($obj->cargar($result)) {
+            $datos = array();
+            foreach ($campos as $campo) {
+                $datos[] = $obj->$campo;
+            }
+            $this->addRow($datos);
+        }
+    }
+
+    function addRowsData($format, $campos = array(), $lugar = 'append') {
+        if (!is_array($campos)) {
+            $campos = array($campos);
+        }
+        switch (strtolower($lugar)) {
+            case 'prepend':
+                $this->_prependRowsData[] = array($format, $campos);
+                break;
+            case 'append':
+                $this->_appendRowsData[] = array($format, $campos);
+                break;
+            default:
+                $this->raiseError('Lugar incorrecto. Lugares soportados: append, prepend.');
+        }
+    }
+
+    function _buildRowsData($datos, $row, $array) {
+        if ($array) {
+            foreach ($array as $data) {
+                list($format, $fields) = $data;
+                // Si tiene formatos y argumentos.
+                if ($fields) {
+                    $args = array($format);
+                    foreach ($fields as $field) {
+                        if (is_array($row)) {
+                            $args[] = $row[$field];
+                        } else {
+                            $args[] = $row->$field;
+                        }
+                    }
+                    $datos[] = call_user_func_array('sprintf', $args);
+                // Si tiene solo formato.
+                } else {
+                    #echo "TAG: $format<br>";
+                    // Si es un link, traduce las variables GET.
+                    if (is_a($format, 'mecon_html_link')) {
+                        $vars = $format->getGetVars();
+                        foreach ($vars as $var => $val) {
+                            if (preg_match("/^{$this->_getVarPrefix}(.+)$/", $var, $m)
+                                    and ($val === null)) {
+                                $format->setGetVar($var, $row[$m[1]]);
+                            }
+                        }
+                    }
+                    $datos[] = $format;
+                }
+            }
+        }
+        return $datos;
+    }
+
+    function addRowsIcon($id, $campos = array(), $link = null, $lugar = 'append') {
+        if (is_string($campos)) {
+            $campos = array($campos);
+        }
+        if (!$link) {
+            $link = @$_SERVER['PHP_SELF'];
+        }
+        if (is_string($link)) {
+            $link = new MECON_HTML_Link($link, '');
+        }
+        switch ($id) {
+            case 'modificar':
+                $img = new MECON_HTML_Image('/MECON/images/general_modificar', '(M)');
+                $link->addContents($img);
+                foreach ($campos as $campo) {
+                    $link->setGetVar($this->_getVarPrefix.$campo, null);
+                }
+                $this->addRowsData($link, array(), $lugar);
+                break;
+            case 'no_modificar':
+                $img = new MECON_HTML_Image('/MECON/images/general_modificar_des', '(-)');
+                $this->addRowsData($img, array(), $lugar);
+                break;
+            case 'borrar':
+                $img = new MECON_HTML_Image('/MECON/images/general_eliminar', '(B)');
+                $link->addContents($img);
+                foreach ($campos as $campo) {
+                    $link->setGetVar($this->_getVarPrefix.$campo, null);
+                }
+                $this->addRowsData($link, array(), $lugar);
+                break;
+            case 'no_borrar':
+                $img = new MECON_HTML_Image('/MECON/images/general_eliminar_des', '(-)');
+                $this->addRowsData($img, array(), $lugar);
+                break;
+            case 'ir':
+                $img = new MECON_HTML_Image('/MECON/images/general_ir4', '->');
+                $link->addContents($img);
+                foreach ($campos as $campo) {
+                    $link->setGetVar($this->_getVarPrefix.$campo, null);
+                }
+                $this->addRowsData($link, array(), $lugar);
+                break;
+            default:
+                $this->raiseError("No hay un ícono predefinido llamado '$id'.");
+        }
+    }
+
 }
 
 ?>
 }
 
 ?>