Small fix in session.inc and extension of reference incrementation algorithm
[fa-stable.git] / includes / references.inc
1 <?php
2 /**********************************************************************
3     Copyright (C) FrontAccounting, LLC.
4         Released under the terms of the GNU General Public License, GPL, 
5         as published by the Free Software Foundation, either version 3 
6         of the License, or (at your option) any later version.
7     This program is distributed in the hope that it will be useful,
8     but WITHOUT ANY WARRANTY; without even the implied warranty of
9     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
10     See the License here <http://www.gnu.org/licenses/gpl-3.0.html>.
11 ***********************************************************************/
12 include_once($path_to_root . "/includes/db/references_db.inc");
13
14 class references 
15 {
16         
17         function save($type, $id, $reference) 
18         {
19                 add_reference($type, $id, $reference);
20                 if ($reference != 'auto')
21                         $this->save_last($reference, $type);
22         }
23         
24         function get($type, $id) 
25         {
26                 return get_reference($type, $id);
27         }       
28         
29         function delete($type, $id) 
30         {
31                 delete_reference($type, $id);
32         }       
33         
34         function update($type, $id, $reference) 
35         {
36             update_reference($type, $id, $reference);
37                 if ($reference != 'auto')
38                         $this->save_last($reference, $type);
39         }
40         
41         function exists($type, $reference) 
42         {
43                 return (find_reference($type, $reference) != null);
44         }
45         
46         function save_last($reference, $type) 
47         {
48                 $next = $this->increment($reference);
49                 save_next_reference($type, $next);
50         }
51         
52         function get_next($type) 
53         {
54                 return get_next_reference($type);
55         }
56         
57         //------------------------------------
58
59         function is_valid($reference) 
60         {
61                 return strlen(trim($reference)) > 0;
62         }
63         
64         function increment($reference) 
65         {
66                 // New method done by Pete. So f.i. WA036 will increment to WA037 and so on.
67         // If $reference contains at least one group of digits,
68         // extract first didgits group and add 1, then put all together.
69         // NB. preg_match returns 1 if the regex matches completely 
70         // also $result[0] holds entire string, 1 the first captured, 2 the 2nd etc.
71         //
72         if (preg_match('/^(\D*?)(\d+)(.*)/', $reference, $result) == 1) 
73         {
74                         list($all, $prefix, $number, $postfix) = $result;
75                         $dig_count = strlen($number); // How many digits? eg. 0003 = 4
76                         $fmt = '%0' . $dig_count . 'd'; // Make a format string - leading zeroes
77                         $nextval =  sprintf($fmt, intval($number + 1)); // Add one on, and put prefix back on
78
79                         return $prefix.$nextval.$postfix;
80         }
81         else 
82             return $reference;
83         }
84         
85         //------------------------------------
86 }
87
88 //----------------------------------------------------------------------------
89
90 function is_new_reference($ref, $type)
91 {
92         $db_info = get_systype_db_info($type);
93         $db_name = $db_info[0];
94         $db_type = $db_info[1];
95         $db_ref = $db_info[3];
96         
97         if ($db_ref != null) 
98         {
99                 $sql = "SELECT $db_ref FROM $db_name WHERE $db_ref='$ref'";
100                 if ($db_type != null)
101                         $sql .= " AND $db_type=$type";
102                          
103                 $result = db_query($sql, "could not test for unique reference");
104                 
105                 return (db_num_rows($result) == 0);
106         }
107         
108         // it's a type that doesn't use references - shouldn't be calling here, but say yes anyways
109         return true;
110 }
111
112 ?>