1 <?php
  2 class Services_Model extends CI_Model {
  3     /**
  4      * Class Constructor
  5      */
  6     function __construct() {
  7         parent::__construct();
  8     }
  9     
 10     /**
 11      * Add (insert or update) a service record on the database
 12      * 
 13      * @param array $service Contains the service data. If an 'id' value is provided then
 14      * the record will be updated.
 15      * @return numeric Returns the record id.
 16      */
 17     public function add($service) {
 18         $this->validate($service);
 19         
 20         if (!isset($service['id'])) {
 21             $service['id'] = $this->insert($service);
 22         } else {
 23             $this->update($service);
 24         }
 25         
 26         return intval($service['id']);
 27     }
 28     
 29     /**
 30      * Insert service record into database.
 31      * 
 32      * @param array $service Contains the service record data.
 33      * @return int Returns the new service record id.
 34      */
 35     public function insert($service) {
 36         if (!$this->db->insert('ea_services', $service)) {
 37             throw new Exception('Could not insert service record.');
 38         }
 39         return intval($this->db->insert_id());
 40     }
 41     
 42     /**
 43      * Update service record.
 44      * 
 45      * @param array $service Contains the service data. The record id needs to be included in 
 46      * the array.
 47      */
 48     public function update($service) {
 49        $this->db->where('id', $service['id']);
 50        if (!$this->db->update('ea_services', $service)) {
 51            throw new Exception('Could not update service record');
 52        }
 53     }
 54     
 55     /**
 56      * Checks whether an service record already exists in the database.
 57      * 
 58      * @param array $service Contains the service data. Name, duration and price values 
 59      * are mandatory in order to perform the checks.
 60      */
 61     public function exists($service) {
 62         if (!isset($service['name']) 
 63                 || !isset($service['duration']) 
 64                 || !isset($service['price'])) {
 65             throw new Exception('Not all service fields are provided in order to check whether '
 66                     . 'a service record already exists: ' . print_r($service, TRUE));
 67         }
 68         
 69         $num_rows = $this->db->get_where('ea_services', array(
 70             'name' => $service['name'],
 71             'duration' => $service['duration'],
 72             'price' => $service['price']
 73         ))->num_rows();
 74         
 75         return ($num_rows > 0) ? TRUE : FALSE;
 76     }
 77     
 78     /**
 79      * Validate a service record data.
 80      * 
 81      * @param array $service Contains the service data.
 82      * @return bool Returns the validation result.
 83      */
 84     public function validate($service) {
 85         $this->load->helper('data_validation');
 86         
 87         // If record id is provided we need to check whether the record exists
 88         // in the database.
 89         if (isset($service['id'])) {
 90             $num_rows = $this->db->get_where('ea_services', array('id' => $service['id']))
 91                     ->num_rows();
 92             if ($num_rows == 0) {
 93                 throw new Exception('Provided service id does not exist in the database.');
 94             }
 95         }
 96 
 97         // Check if service category id is valid (only when present)
 98         if ($service['id_service_categories'] != NULL) {
 99             $num_rows = $this->db->get_where('ea_service_categories', 
100                     array('id' => $service['id_service_categories']))->num_rows();
101             if ($num_rows == 0) {
102                 throw new Exception('Provided service category id does not exist in database.');
103             }
104         }
105 
106         // Check for required fields
107         if ($service['name'] == '') {
108             throw new Exception('Not all required service fields where provided: ' 
109                     . print_r($service, TRUE));
110         }
111 
112         // Duration must be numeric
113         if ($service['duration'] !== NULL) {
114             if (!is_numeric($service['duration'])) {
115                 throw new Exception('Service duration is not numeric.');
116             }
117         }
118 
119         if ($service['price'] !== NULL) {
120             if (!is_numeric($service['price'])) {
121                 throw new Exception('Service price is not numeric.');
122             }
123         }
124 
125         return TRUE;
126     }
127     
128     /**
129      * Get the record id of an existing record. 
130      * 
131      * NOTICE! The record must exist, otherwise an exeption will be raised.
132      * 
133      * @param array $service Contains the service record data. Name, duration and price values
134      * are mandatory for this method to complete.
135      */
136     public function find_record_id($service) {
137         if (!isset($service['name'])
138                 || !isset($service['duration'])
139                 || !isset($service['price'])) {
140             throw new Exception('Not all required fields where provided in order to find the '
141                     . 'service record id.');
142         }
143         
144         $result = $this->db->get_where('ea_services', array(
145             'name' => $service['name'],
146             'duration' => $service['duration'],
147             'price' => $service['price']
148         ));
149         
150         if ($result->num_rows() == 0) {
151             throw new Exception('Cound not find service record id');
152         }
153         
154         return $result->row()->id;
155     }
156     
157     /**
158      * Delete a service record from database.
159      * 
160      * @param numeric $service_id Record id to be deleted.
161      * @return bool Returns the delete operation result.
162      */
163     public function delete($service_id) {
164         if (!is_numeric($service_id)) {
165             throw new Exception('Invalid argument type $service_id (value:"' . $service_id . '"');
166         }
167         
168         $num_rows = $this->db->get_where('ea_services', array('id' => $service_id))->num_rows();
169         if ($num_rows == 0) {
170             return FALSE; // Record does not exist
171         }
172         
173         return $this->db->delete('ea_services', array('id' => $service_id));
174     }
175     
176     /**
177      * Get a specific row from the services db table.
178      * 
179      * @param numeric $service_id The record's id to be returned.
180      * @return array Returns an associative array with the selected
181      * record's data. Each key has the same name as the database 
182      * field names.
183      */
184     public function get_row($service_id) {
185         if (!is_numeric($service_id)) {
186             throw new Exception('$service_id argument is not an numeric (value: "' . $service_id . '")');
187         }
188         return $this->db->get_where('ea_services', array('id' => $service_id))->row_array();
189     }
190     
191     /**
192      * Get a specific field value from the database.
193      * 
194      * @param string $field_name The field name of the value to be
195      * returned.
196      * @param int $service_id The selected record's id.
197      * @return string Returns the records value from the database.
198      */
199     public function get_value($field_name, $service_id) {
200         if (!is_numeric($service_id)) {
201             throw new Exception('Invalid argument provided as $service_id : ' . $service_id);
202         }
203         
204         if (!is_string($field_name)) {
205             throw new Exception('$field_name argument is not a string : ' . $field_name);
206         }
207         
208         if ($this->db->get_where('ea_services', array('id' => $service_id))->num_rows() == 0) {
209             throw new Exception('The record with the $service_id argument does not exist in the database : ' . $service_id);
210         }
211         
212         $row_data = $this->db->get_where('ea_services', array('id' => $service_id))->row_array();
213         if (!isset($row_data[$field_name])) {
214             throw new Exception('The given $field_name argument does not exist in the database : ' . $field_name);
215         }
216         
217         $setting = $this->db->get_where('ea_services', array('id' => $service_id))->row_array();
218         return $setting[$field_name];
219     }
220     
221     /**
222      * Get all, or specific records from service's table.
223      * 
224      * @example $this->Model->getBatch('id = ' . $recordId);
225      * 
226      * @param string $whereClause (OPTIONAL) The WHERE clause of  
227      * the query to be executed. DO NOT INCLUDE 'WHERE' KEYWORD.
228      * @return array Returns the rows from the database.
229      */
230     public function get_batch($where_clause = NULL) {
231         if ($where_clause != NULL) {
232             $this->db->where($where_clause);
233         }
234         
235         return $this->db->get('ea_services')->result_array();
236     }
237     
238     /**
239      * This method returns all the services from the database.
240      * 
241      * @return array Returns an object array with all the 
242      * database services.
243      */
244     public function get_available_services() {
245         $this->db->distinct();
246         return $this->db
247                 ->select('ea_services.*, ea_service_categories.name AS category_name, '
248                         . 'ea_service_categories.id AS category_id')
249                 ->from('ea_services')
250                 ->join('ea_services_providers', 
251                         'ea_services_providers.id_services = ea_services.id', 'inner')
252                 ->join('ea_service_categories',
253                         'ea_service_categories.id = ea_services.id_service_categories', 'left')
254                 ->get()->result_array();
255     }
256     
257     /**
258      * Add (insert or update) a service category record into database.
259      * 
260      * @param array $category Containst the service category data.
261      * @return int Returns the record id.s
262      */
263     public function add_category($category) {
264         if (!$this->validate_category($category)) {
265             throw new Exception('Service category data are invalid.');
266         }
267         
268         if (!isset($category['id'])) {
269             $this->db->insert('ea_service_categories', $category);
270             $category['id'] = $this->db->insert_id();
271         } else {
272             $this->db->where('id', $category['id']);
273             $this->db->update('ea_service_categories', $category);
274         }
275         
276         return intval($category['id']);
277     }
278     
279     /**
280      * Delete a service category record from the database.
281      * 
282      * @param numeric $category_id Record id to be deleted.
283      * @return bool Returns the delete operation result.
284      */
285     public function delete_category($category_id) {
286         if (!is_numeric($category_id)) {
287             throw new Exception('Invalid argument given for $category_id: ' . $category_id);
288         }
289         
290         $num_rows = $this->db->get_where('ea_service_categories', array('id' => $category_id))
291                 ->num_rows();
292         if ($num_rows == 0) {
293             throw new Exception('Service category record not found in database.');
294         }
295         
296         $this->db->where('id', $category_id);
297         return $this->db->delete('ea_service_categories');
298     }
299     
300     /**
301      * Get a service category record data.
302      * 
303      * @param numeric $category_id Record id to be retrieved.
304      * @return array Returns the record data from the database.
305      */
306     public function get_category($category_id) {
307         if (!is_numeric($category_id)) {
308             throw new Exception('Invalid argument type given $category_id: ' . $category_id);
309         }
310         
311         $result = $this->db->get_where('ea_service_categories', array('id' => $category_id));
312         
313         if ($result->num_rows() == 0) {
314             throw new Exception('Service category record does not exist.');
315         }
316         
317         return $result->row_array();
318     }
319     
320     /**
321      * Get all service category records from database.
322      * 
323      * @return array Returns an array that contains all the service category records.
324      */
325     public function get_all_categories($where = '') {
326         if ($where !== '') $this->db->where($where);
327         return $this->db->get('ea_service_categories')->result_array();
328     }
329     
330     /**
331      * Validate a service category record data. This method must be used before adding 
332      * a service category record into database in order to secure the record integrity.
333      * 
334      * @param array $category Contains the service category data.
335      * @return bool Returns the validation result.
336      */
337     public function validate_category($category) {
338         try {
339             // Required Fields
340             if (!isset($category['name'])) {
341                 throw new Exception('Not all required fields where provided ');
342             }
343             
344             if ($category['name'] == '' || $category['name'] == NULL) {
345                 throw new Exception('Required fields cannot be empty or null ($category: ' 
346                         . print_r($category, TRUE) . ')');
347             }
348             
349             return TRUE;
350         } catch(Exception $exc) {
351             return FALSE;
352         }
353             
354     }
355 }
356 
357 /* End of file services_model.php */
358 /* Location: ./application/models/services_model.php */

API documentation generated by ApiGen