Layout improvements
[fa-stable.git] / includes / db_pager.inc
index 90f61ec347908c6a2aadd039e8799f980273b86d..819b4757f5c7e3381b749f9bc3d7073b8ea187ec 100644 (file)
@@ -1,4 +1,14 @@
 <?php
+/**********************************************************************
+    Copyright (C) FrontAccounting, LLC.
+       Released under the terms of the GNU General Public License, GPL, 
+       as published by the Free Software Foundation, either version 3 
+       of the License, or (at your option) any later version.
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
+    See the License here <http://www.gnu.org/licenses/gpl-3.0.html>.
+***********************************************************************/
 //
 //     Controler part of database table pager with column sort.
 //     To display actual html object call display_db_pager($name) inside
@@ -16,6 +26,7 @@ class db_pager {
        var $marker_txt;        
        var $marker_class;
        var $notice_class;
+       var $width;                     // table width (default '95%')
        var $header_fun;        // additional row between title and body
        var $header_class;
        var $footer_fun;
@@ -35,17 +46,20 @@ class db_pager {
        var $select,
                $where,
            $from,
-               $group;
+               $group,
+               $order;
        var     $extra_where;
        
        var $ready = false; // this var is false after change in sql before first
                                                // and before first query.
 
        //  db_pager constructor
-       //  accepts $sql like 'SELECT .... FROM .... [WHERE ...] [GROUP ...]'
+       //  accepts $sql like 'SELECT ...[FROM ...][WHERE ...][GROUP ...][ORDER ...]'
        //      $name is base name for pager controls
        function db_pager($sql, $name, $page_len=0) 
        {
+               global $table_style;
+               $this->width = "95%";
                if ($page_len == 0) $page_len = user_query_size();
                $this->name = $name;
                $this->page_len = $page_len;
@@ -59,49 +73,44 @@ class db_pager {
                if ($sql != $this->sql) {
                    $this->sql = $sql;
                    $this->ready = false;
-                       $select = $sql;
-                       $from = $where = $group = '';
+               $parts = preg_split('/\sORDER\s*BY\s/si', $sql, 2);
+                       if(count($parts) == 2) {
+                               $sql = $parts[0];
+                               $this->order = $parts[1];
+                       }
+               $parts = preg_split('/\sGROUP\s*BY\s/si', $sql, 2);
+                       if(count($parts) == 2) {
+                               $sql = $parts[0];
+                               $this->group = $parts[1];
+                       }
+               $parts = preg_split('/\sWHERE\s/si', $sql, 2);
+                       if(count($parts) == 2) {
+                               $sql = $parts[0];
+                               $this->where = $parts[1];
+                       }
                $parts = preg_split('/\sFROM\s/si', $sql, 2);
                        if(count($parts) == 2) {
-                               $select = $parts[0];
-                               $from = $parts[1];
-                       $parts = preg_split('/\sWHERE\s/si', $from, 2);
-                               if(count($parts) == 2) {
-                                       $from = $parts[0];
-                                       $where = $parts[1];
-                               $parts = preg_split('/\sGROUP\s*BY\s/si', $where, 2);
-                                       if(count($parts) == 2) {
-                                               $where = $parts[0];
-                                               $group = $parts[1];
-                                       }
-                               }
+                               $sql = $parts[0];
+                               $this->from = $parts[1];
                        }
-                       $this->select = $select;
-                       $this->from = $from;
-                       $this->where = $where;
-                       $this->group = $group;
-/*
-               display_error("sql: $sql");
-               display_error($select);
-               display_error("FROM $from");
-               display_error("WHERE $where");
-               display_error("GROUP BY $group");
-*/
+                       $this->select = $sql;
                }
        }
        //
        //      Set additional constraint on record set
        //
-       function set_where($where
+       function set_where($where = null)
        {
-           if (!is_array($where))
-                 $where = array($where);
+               if ($where) {
+               if (!is_array($where))
+                         $where = array($where);
 
-           if (count($where) != count($this->extra_where) || 
-                       count(array_diff($this->extra_where, $where))) {
-                               $this->extra_where = $where;
-                               $this->ready = false;
-           }
+                   if (count($where) == count($this->extra_where) &&
+                               !count(array_diff($this->extra_where, $where)))
+                                return;
+               }
+               $this->extra_where = $where;
+               $this->ready = false;
        }
        //
        //      Set query result page
@@ -239,12 +248,13 @@ class db_pager {
                $from = $this->from;
                $where = $this->where;
                $group = $this->group;          
+               $order = $this->order;
 
                if(count($this->extra_where)) {
                    $where .= ($where=='' ? '' : ' AND ')
                                .implode( $this->extra_where, ' AND ');
                }
-               if ($where) $where = " WHERE($where)";
+               if ($where) $where = " WHERE ($where)";
 
                if ($count) {
                        $group = $group == '' ? "*" : "DISTINCT $group";
@@ -253,10 +263,10 @@ class db_pager {
                }
 
                $sql = "$select FROM $from $where";
-               if($group) $sql.= " GROUP BY $group";
+               if ($group) $sql.= " GROUP BY $group";
            $ord = array();
 
-           foreach$this->columns as $col) {
+           foreach ($this->columns as $col) {
                if (isset($col['ord'])) {
                        if ( $col['ord'] != '' && isset($col['name'])) {
                            $ord[] = $col['name'] .' '. $col['ord'];
@@ -264,8 +274,12 @@ class db_pager {
                        }
            }
                                
-           if (count($ord)) 
+           if (count($ord)) {
                        $sql .= " ORDER BY " . implode($ord, ',');
+               } else {
+                       if($order)
+                               $sql .= " ORDER BY $order"; // original base query order
+               }
 
            $page_len = $this->page_len;
            $offset = ($this->curr_page - 1) * $page_len;
@@ -280,6 +294,8 @@ class db_pager {
        //
        function _init() 
        {
+               global $go_debug;
+               
            if ($this->ready == false ) {
                        $sql = $this->_sql_gen(true);
                        $result = db_query($sql, 'Error reading record set');
@@ -287,7 +303,20 @@ class db_pager {
                                return false;
                        $row = db_fetch_row($result);
                        $this->rec_count = $row[0];
-                       $this->max_page = ceil($this->rec_count/$this->page_len);
+                       $this->max_page = $this->page_len ?
+                               ceil($this->rec_count/$this->page_len) : 0;
+               
+                       if ($go_debug) { // FIX - need column name parsing, but for now:
+                               // check if field names are set explicite in col def
+                               // for all initially ordered columns
+                           foreach ($this->columns as $col) {
+                               if (isset($col['ord']) && $col['ord'] != '' 
+                                               &&  !isset($col['name'])) {
+                                                       display_warning("Result field names must be set
+                                                               for all intially ordered db_pager columns.");
+                               }
+                               }
+               }
                        $this->set_page(1);
                        $this->ready = true;
            }
@@ -375,14 +404,22 @@ function &new_db_pager($name, $sql, $coldef, $page_len = 0)  {
     if ($_SERVER['REQUEST_METHOD'] == 'GET')
                unset($_SESSION[$name]); // kill old pager if any exists on first page call
 
-       if (!isset($_SESSION[$name]))
+       if (!isset($_SESSION[$name])) {
            $_SESSION[$name] =& new db_pager($sql, $name, $page_len);
+               $_SESSION[$name]->set_sql($sql);
+               $_SESSION[$name]->set_columns($coldef);
+       }
        
        $ret = &$_SESSION[$name];
-    $ret->set_sql($sql);
-    $ret->set_columns($coldef);
 
     return $ret;
 }
-
+//
+//     Force pager initialization.
+//
+function refresh_pager($name)
+{
+       if (isset($_SESSION[$name]))
+               $_SESSION[$name]->ready = false;
+}
 ?>
\ No newline at end of file