X-Git-Url: https://git.llucax.com/mecon/meconlib.git/blobdiff_plain/b6ce5f0536503a2dc458c2b7a857dea6b324d97e..0f0e41a6f47093189c050a7beeac79144ed8c0d6:/lib/MECON/HTML/TablaDB.php diff --git a/lib/MECON/HTML/TablaDB.php b/lib/MECON/HTML/TablaDB.php index 9a0d15e..6876e94 100644 --- a/lib/MECON/HTML/TablaDB.php +++ b/lib/MECON/HTML/TablaDB.php @@ -24,7 +24,10 @@ Autor: Martin Marrese $Id$ -----------------------------------------------------------------------------*/ +require_once 'DB.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'; /** @@ -33,25 +36,77 @@ require_once 'MECON/HTML/Tabla.php'; */ 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 - * $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 ($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 * @@ -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. + * @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. * - * @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. - $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']; @@ -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) { - $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) { - $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) { - $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 { - $link->setGetVar('pager_from', $start_row); + $link->setGetVar($this->_getVarPrefix.$getvar, $start_row); $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->updateCabecera('Se encontraron ' . $pager->numrows . ' resultados.', 'izquierda'); + $this->updateCabecera("Se encontraron {$pager->numrows} {$this->_desc}.", 'izquierda'); } 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; } + /** + * 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
"; + // 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'."); + } + } + } ?>