* @copyright Copyright (c) 2013 - 2017, Alex Tselegidis * @license http://opensource.org/licenses/GPL-3.0 - GPLv3 * @link http://easyappointments.org * @since v1.0.0 * ---------------------------------------------------------------------------- */ /** * Customers Model * * @package Models */ class Customers_Model extends CI_Model { /** * Add a customer record to the database. * * This method adds a customer to the database. If the customer * doesn't exists it is going to be inserted, otherwise the * record is going to be updated. * * @param array $customer Associative array with the customer's * data. Each key has the same name with the database fields. * @return int Returns the customer id. */ public function add($customer) { // Validate the customer data before doing anything. $this->validate($customer); // :: CHECK IF CUSTOMER ALREADY EXIST (FROM EMAIL). if ($this->exists($customer) && !isset($customer['id'])) { // Find the customer id from the database. $customer['id'] = $this->find_record_id($customer); } // :: INSERT OR UPDATE CUSTOMER RECORD if (!isset($customer['id'])) { $customer['id'] = $this->_insert($customer); } else { $this->_update($customer); } return $customer['id']; } /** * Check if a particular customer record already exists. * * This method checks whether the given customer already exists in * the database. It doesn't search with the id, but with the following * fields: "email" * * @param array $customer Associative array with the customer's * data. Each key has the same name with the database fields. * @return bool Returns whether the record exists or not. */ public function exists($customer) { if (!isset($customer['email'])) { throw new Exception('Customer\'s email is not provided.'); } // This method shouldn't depend on another method of this class. $num_rows = $this->db ->select('*') ->from('ea_users') ->join('ea_roles', 'ea_roles.id = ea_users.id_roles', 'inner') ->where('ea_users.email', $customer['email']) ->where('ea_roles.slug', DB_SLUG_CUSTOMER) ->get()->num_rows(); return ($num_rows > 0) ? TRUE : FALSE; } /** * Insert a new customer record to the database. * * @param array $customer Associative array with the customer's * data. Each key has the same name with the database fields. * @return int Returns the id of the new record. */ protected function _insert($customer) { // Before inserting the customer we need to get the customer's role id // from the database and assign it to the new record as a foreign key. $customer_role_id = $this->db ->select('id') ->from('ea_roles') ->where('slug', DB_SLUG_CUSTOMER) ->get()->row()->id; $customer['id_roles'] = $customer_role_id; if (!$this->db->insert('ea_users', $customer)) { throw new Exception('Could not insert customer to the database.'); } return intval($this->db->insert_id()); } /** * Update an existing customer record in the database. * * The customer data argument should already include the record * id in order to process the update operation. * * @param array $customer Associative array with the customer's * data. Each key has the same name with the database fields. * @return int Returns the updated record id. */ protected function _update($customer) { // Do not update empty string values. foreach ($customer as $key => $value) { if ($value === '') unset($customer[$key]); } $this->db->where('id', $customer['id']); if (!$this->db->update('ea_users', $customer)) { throw new Exception('Could not update customer to the database.'); } return intval($customer['id']); } /** * Find the database id of a customer record. * * The customer data should include the following fields in order to * get the unique id from the database: "email" * * IMPORTANT! The record must already exists in the * database, otherwise an exception is raised. * * @param array $customer Array with the customer data. The * keys of the array should have the same names as the db fields. * @return int Returns the id. */ public function find_record_id($customer) { if (!isset($customer['email'])) { throw new Exception('Customer\'s email was not provided: ' . print_r($customer, TRUE)); } // Get customer's role id $result = $this->db ->select('ea_users.id') ->from('ea_users') ->join('ea_roles', 'ea_roles.id = ea_users.id_roles', 'inner') ->where('ea_users.email', $customer['email']) ->where('ea_roles.slug', DB_SLUG_CUSTOMER) ->get(); if ($result->num_rows() == 0) { throw new Exception('Could not find customer record id.'); } return $result->row()->id; } /** * Validate customer data before the insert or update operation is executed. * * @param array $customer Contains the customer data. * @return bool Returns the validation result. */ public function validate($customer) { $this->load->helper('data_validation'); // If a customer id is provided, check whether the record // exist in the database. if (isset($customer['id'])) { $num_rows = $this->db->get_where('ea_users', array('id' => $customer['id']))->num_rows(); if ($num_rows == 0) { throw new Exception('Provided customer id does not ' . 'exist in the database.'); } } // Validate required fields if (!isset($customer['last_name']) || !isset($customer['email']) || !isset($customer['phone_number'])) { throw new Exception('Not all required fields are provided: ' . print_r($customer, TRUE)); } // Validate email address if (!filter_var($customer['email'], FILTER_VALIDATE_EMAIL)) { throw new Exception('Invalid email address provided: ' . $customer['email']); } // When inserting a record the email address must be unique. $customer_id = (isset($customer['id'])) ? $customer['id'] : ''; $num_rows = $this->db ->select('*') ->from('ea_users') ->join('ea_roles', 'ea_roles.id = ea_users.id_roles', 'inner') ->where('ea_roles.slug', DB_SLUG_CUSTOMER) ->where('ea_users.email', $customer['email']) ->where('ea_users.id <>', $customer_id) ->get() ->num_rows(); if ($num_rows > 0) { throw new Exception('Given email address belongs to another customer record. ' . 'Please use a different email.'); } return TRUE; } /** * Delete an existing customer record from the database. * * @param numeric $customer_id The record id to be deleted. * @return bool Returns the delete operation result. */ public function delete($customer_id) { if (!is_numeric($customer_id)) { throw new Exception('Invalid argument type $customer_id: ' . $customer_id); } $num_rows = $this->db->get_where('ea_users', array('id' => $customer_id))->num_rows(); if ($num_rows == 0) { return FALSE; } return $this->db->delete('ea_users', array('id' => $customer_id)); } /** * Get a specific row from the appointments table. * * @param numeric $customer_id The record's id to be returned. * @return array Returns an associative array with the selected * record's data. Each key has the same name as the database * field names. */ public function get_row($customer_id) { if (!is_numeric($customer_id)) { throw new Exception('Invalid argument provided as $customer_id : ' . $customer_id); } return $this->db->get_where('ea_users', array('id' => $customer_id))->row_array(); } /** * Get a specific field value from the database. * * @param string $field_name The field name of the value to be * returned. * @param int $customer_id The selected record's id. * @return string Returns the records value from the database. */ public function get_value($field_name, $customer_id) { if (!is_numeric($customer_id)) { throw new Exception('Invalid argument provided as $customer_id: ' . $customer_id); } if (!is_string($field_name)) { throw new Exception('$field_name argument is not a string: ' . $field_name); } if ($this->db->get_where('ea_users', array('id' => $customer_id))->num_rows() == 0) { throw new Exception('The record with the $customer_id argument ' . 'does not exist in the database: ' . $customer_id); } $row_data = $this->db->get_where('ea_users', array('id' => $customer_id) )->row_array(); if (!isset($row_data[$field_name])) { throw new Exception('The given $field_name argument does not' . 'exist in the database: ' . $field_name); } $customer = $this->db->get_where('ea_users', array('id' => $customer_id))->row_array(); return $customer[$field_name]; } /** * Get all, or specific records from appointment's table. * * @example $this->Model->getBatch('id = ' . $recordId); * * @param string $whereClause (OPTIONAL) The WHERE clause of * the query to be executed. DO NOT INCLUDE 'WHERE' KEYWORD. * @return array Returns the rows from the database. */ public function get_batch($where_clause = '') { $customers_role_id = $this->get_customers_role_id(); if ($where_clause != '') { $this->db->where($where_clause); } $this->db->where('id_roles', $customers_role_id); return $this->db->get('ea_users')->result_array(); } /** * Get the customers role id from the database. * * @return int Returns the role id for the customer records. */ public function get_customers_role_id() { return $this->db->get_where('ea_roles', array('slug' => DB_SLUG_CUSTOMER))->row()->id; } }