Se agrega la posibilidad de pasarle mas de un campo a un callback en addRowsData

[mecon/meconlib.git] / lib / MECON / HTML / TablaDB.php

diff --git a/lib/MECON/HTML/TablaDB.php b/lib/MECON/HTML/TablaDB.php
index fb13bf6742b3bc4f8951aa866e15203dcfd30dc3..c91c82fb50969d5c541123b9f72896e84e1d03eb 100644 (file)
--- a/lib/MECON/HTML/TablaDB.php
+++ b/lib/MECON/HTML/TablaDB.php
@@ -47,6 +47,8 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
      * 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.
+     * Cuando se utiliza una callback para "dibujar" el campo, el campo puede
+     * ser un array de campos de la base que se quiere pasar a la callback.
      */
     var $_prependRowsData = array();
 
@@ -318,6 +320,21 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
      *      array('nombre', 'nombre', 'apellido'));
      * // Agrega resultados de la tabla.
      * $tabla->addRows($result, array('nombre', 'apellido'));
+     * 
+     * 
+     * //Ejemplo utilizando una funcion callback con varios parametros obtenidos
+     * //de la DB.
+     * $tabla->addRowsData (
+     *      'Mi nombre es: %s, por lo tanto %s', //Formato de la columna a agregar.
+     *      array(                               //Array de campos a incluir en el formato
+     *          'nombre',                        //El dato de este campo reemplazara el primer %s
+     *          //El resultado de la llamada a la funcion nombre_callback que tomo
+     *          //como paramteros los campos de la db que estan dentro del array
+     *          //reemplazara al segundo %s
+     *          array(array('nombre', 'apellido'), 'nombre_callback') 
+     *      )
+     *  );
+     * 
      * $tabla->display();
      *
      * // Funcion callback para darle formato al campo 'activo'.
@@ -326,6 +343,18 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
      * function checked_callback($activo) {
      *      return $activo ? 'checked' : '';
      * }
+     *
+     * //Funcion callback que acepta mas de un parametro en un array
+     * function nombre_callback($parametros) {
+     *      if ($parametros['nombre'] == 'Juan Carlos' &&
+     *      $parametros['apellido'] == 'Gomez') {
+     *          return 'soy Charly';
+     *      }
+     *      else {
+     *          return 'no soy Charly';
+     *      }
+     * }
+     * 
      * @endcode
      *
      * @param mixed $format Si es un string, especifica el formato a usar al
@@ -357,15 +386,19 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
      *                      un campo a usar:
      *                      @code $tabla->addRowsData('%s',
      *      array('campo1', 'campo2'); @endcode
-     *                      o un array cuyo primer elemento es el nombre del
-     *                      campo a usar y el segundo argumento es una funcion
-     *                      callback a llamar con el valor del campo como
+     *                      o un array cuyo primer elemento es un string o un
+     *                      array con los nombres de los campos de la db a utilizar
+     *                      y el segundo argumento es una funcion
+     *                      callback a llamar con el valor del campo (o los
+     *                      campos si se paso un array de campos) como
      *                      argumento para darle formato:
      *                      @code $tabla->addRowsData('%s',
-     *      array('campo1', 'campo2', array('campo3', 'callback_campo3'))));
-     * function callback_campo3($campo3) {
-     *      return strtoupper($campo3);
+     *      array('campo1', array(array('campo2', 'campo3'), 'callback_campo_2_3'))));
+     * function callback_campo_2_3($campos) {
+     *      return strtoupper($campos['campo2']) . ', ' . strtolower($campos['campo3']);
      * } @endcode
+     *                      Para ver un ejemplo de una callback con muchos
+     *                      parametros ver la descripcion detallada de esta funcion.
      *                      Si no se encuentra la funcion callback, se toma como
      *                      un string para formatear el campo con sprintf():
      *                      @code $tabla->addRowsData('%s', array('campo1',
@@ -401,7 +434,7 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
      *
      * @param array $data Datos sobre la columna, en el formato especificado
      *                    para un elemento del array usado en _prependRowsData.
-     * @param mixed $row Fila de un resultado de una base de dotos. Puede ser un
+     * @param mixed $row Fila de un resultado de una base de datos. Puede ser un
      *                   array asociativo o un objeto (en cuyo caso cada campo
      *                   debe ser un atributo del mismo).
      *
@@ -428,15 +461,37 @@ class MECON_HTML_TablaDB extends MECON_HTML_Tabla {
                     list($campo, $callback) = $campo;
                 }
                 if (is_array($row)) {
-                    $campo = $row[$campo]; // Es un campo de un array.
-                } else {
-                    $campo = $row->$campo; // Es un atributo de un objeto.
+                    if (is_array($campo)) {
+                        foreach ($campo as $c) {
+                            $tmp[$c] = $row[$c];
+                        }
+                        $campo = $tmp;
+                    }
+                    else {
+                        $campo = $row[$campo]; // Es un campo de un array.
+                    }
+                } else { //$row es un objeto
+                    if (is_array($campo)) {
+                        foreach ($campo as $c) {
+                            $tmp[$c] = $row->$c;
+                        }
+                        $campo = $tmp;
+                    }
+                    else {
+                        $campo = $row->$campo; // Es un atributo de un objeto.
+                    }
                 }
                 // Si usa callback, cambio el campo por el resultado del
                 // llamado a su callback.
                 if (isset($callback) and function_exists($callback)) {
                     $campo = $callback($campo);
                 }
+                else {
+                    //Si no existe la funcion de callback usa el callback como
+                    //formato y los campos como argumentos para el sprintf
+                    array_unshift($campo, $callback);
+                    $campo = call_user_func_array('sprintf', $campo);
+                }
                 // Agrego argumento procesado a la lista de argumentos.
                 $args[] = $campo;
             }