db->table('suppliers'); $builder->join('people', 'people.person_id = suppliers.person_id'); $builder->where('suppliers.person_id', $person_id); return ($builder->get()->getNumRows() == 1); // TODO: === } /** * Gets total of rows */ public function get_total_rows(): int { $builder = $this->db->table('suppliers'); $builder->where('deleted', 0); return $builder->countAllResults(); } /** * Returns all the suppliers */ public function get_all(int $limit = 0, int $offset = 0, int $category = GOODS_SUPPLIER): ResultInterface { $builder = $this->db->table('suppliers'); $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->where('category', $category); $builder->where('deleted', 0); $builder->orderBy('company_name', 'asc'); if ($limit > 0) { $builder->limit($limit, $offset); } return $builder->get(); } /** * Gets information about a particular supplier */ public function get_info(?int $person_id): object { $builder = $this->db->table('suppliers'); $builder->join('people', 'people.person_id = suppliers.person_id'); $builder->where('suppliers.person_id', $person_id); $query = $builder->get(); if ($query->getNumRows() == 1) { // TODO: === return $query->getRow(); } else { // Get empty base parent object, as $supplier_id is NOT a supplier $person_obj = parent::get_info(NEW_ENTRY); // Get all the fields from supplier table // Append those fields to base parent object, we have a complete empty object foreach ($this->db->getFieldNames('suppliers') as $field) { $person_obj->$field = ''; } return $person_obj; } } /** * Gets information about multiple suppliers */ public function get_multiple_info(array $person_ids): ResultInterface { $builder = $this->db->table('suppliers'); $builder->join('people', 'people.person_id = suppliers.person_id'); $builder->whereIn('suppliers.person_id', $person_ids); $builder->orderBy('last_name', 'asc'); return $builder->get(); } /** * Inserts or updates a suppliers */ public function save_supplier(array &$person_data, array &$supplier_data, int $supplier_id = NEW_ENTRY): bool { $success = false; // Run these queries as a transaction, we want to make sure we do all or nothing $this->db->transStart(); if (parent::save_value($person_data, $supplier_id)) { $builder = $this->db->table('suppliers'); if ($supplier_id == NEW_ENTRY || !$this->exists($supplier_id)) { $supplier_data['person_id'] = $person_data['person_id']; $success = $builder->insert($supplier_data); } else { $builder->where('person_id', $supplier_id); $success = $builder->update($supplier_data); } } $this->db->transComplete(); $success &= $this->db->transStatus(); return $success; } /** * Deletes one supplier */ public function delete($supplier_id = null, bool $purge = false): bool { $builder = $this->db->table('suppliers'); $builder->where('person_id', $supplier_id); return $builder->update(['deleted' => 1]); } /** * Deletes a list of suppliers */ public function delete_list(array $person_ids): bool { $builder = $this->db->table('suppliers'); $builder->whereIn('person_id', $person_ids); return $builder->update(['deleted' => 1]); } /** * Get search suggestions to find suppliers */ public function get_search_suggestions(string $search, int $limit = 25, bool $unique = false): array // TODO: Parent is looking for the 2nd parameter to be an int { $suggestions = []; $builder = $this->db->table('suppliers'); $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->where('deleted', 0); $builder->like('company_name', $search); $builder->orderBy('company_name', 'asc'); foreach ($builder->get()->getResult() as $row) { $suggestions[] = ['value' => $row->person_id, 'label' => $row->company_name]; } $builder = $this->db->table('suppliers'); $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->where('deleted', 0); $builder->distinct(); $builder->like('agency_name', $search); $builder->where('agency_name IS NOT NULL'); $builder->orderBy('agency_name', 'asc'); foreach ($builder->get()->getResult() as $row) { $suggestions[] = ['value' => $row->person_id, 'label' => $row->agency_name]; } $builder = $this->db->table('suppliers'); $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->groupStart(); $builder->like('first_name', $search); $builder->orLike('last_name', $search); $builder->orLike('CONCAT(first_name, " ", last_name)', $search); $builder->groupEnd(); $builder->where('deleted', 0); $builder->orderBy('last_name', 'asc'); foreach ($builder->get()->getResult() as $row) { $suggestions[] = ['value' => $row->person_id, 'label' => $row->first_name . ' ' . $row->last_name]; } if (!$unique) { $builder = $this->db->table('suppliers'); $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->where('deleted', 0); $builder->like('email', $search); $builder->orderBy('email', 'asc'); foreach ($builder->get()->getResult() as $row) { $suggestions[] = ['value' => $row->person_id, 'label' => $row->email]; } $builder = $this->db->table('suppliers'); $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->where('deleted', 0); $builder->like('phone_number', $search); $builder->orderBy('phone_number', 'asc'); foreach ($builder->get()->getResult() as $row) { $suggestions[] = ['value' => $row->person_id, 'label' => $row->phone_number]; } $builder = $this->db->table('suppliers'); $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->where('deleted', 0); $builder->like('account_number', $search); $builder->orderBy('account_number', 'asc'); foreach ($builder->get()->getResult() as $row) { $suggestions[] = ['value' => $row->person_id, 'label' => $row->account_number]; } } // Only return $limit suggestions if (count($suggestions) > $limit) { // TODO: this can be replaced with return count($suggestions) > $limit ? array_slice($suggestions, 0, $limit) : $suggestions $suggestions = array_slice($suggestions, 0, $limit); } return $suggestions; } /** * Gets rows */ public function get_found_rows(string $search): int { return $this->search($search, 0, 0, 'last_name', 'asc', true); } /** * Perform a search on suppliers */ public function search(string $search, ?int $rows = 25, ?int $limit_from = 0, ?string $sort = 'last_name', ?string $order = 'asc', ?bool $count_only = false) { // Set default values on null $rows = $rows ?? 25; $limit_from = $limit_from ?? 0; $sort = $sort ?? 'last_name'; $order = $order ?? 'asc'; $count_only = $count_only ?? false; $builder = $this->db->table('suppliers AS suppliers'); // get_found_rows case if ($count_only) { $builder->select('COUNT(suppliers.person_id) as count'); } $builder->join('people', 'suppliers.person_id = people.person_id'); $builder->groupStart(); $builder->like('first_name', $search); $builder->orLike('last_name', $search); $builder->orLike('company_name', $search); $builder->orLike('agency_name', $search); $builder->orLike('email', $search); $builder->orLike('phone_number', $search); $builder->orLike('account_number', $search); $builder->orLike('CONCAT(first_name, " ", last_name)', $search); // TODO: According to PHPStorm, this line down to the return is repeated in Customer.php and Employee.php... perhaps refactoring a method in a library could be helpful? $builder->groupEnd(); $builder->where('deleted', 0); if ($count_only) { return $builder->get()->getRow()->count; } $builder->orderBy($sort, $order); if ($rows > 0) { $builder->limit($rows, $limit_from); } return $builder->get(); } /** * Return supplier categories */ public function get_categories(): array { return [ GOODS_SUPPLIER => lang('Suppliers.goods'), COST_SUPPLIER => lang('Suppliers.cost') ]; } /** * Return a category name given its id. * @param int $supplier_type Constant representing the type of supplier. * @return string Language string for the given supplier type. */ public function get_category_name(int $supplier_type): string { if ($supplier_type == 0) { return lang('Suppliers.goods'); } else { return lang('Suppliers.cost'); } } }