load->model('setting/extension'); * * @package Opencart\Admin\Model\Setting */ class Extension extends \Opencart\System\Engine\Model { /** * Get Extensions * * Get the record of the extension records in the database. * * @return array> extension records * * @example * * $this->load->model('setting/extension'); * * $results = $this->model_setting_extension->getExtensions(); */ public function getExtensions(): array { $query = $this->db->query("SELECT DISTINCT `extension` FROM `" . DB_PREFIX . "extension`"); return $query->rows; } /** * Get Extensions By Type * * @param string $type * * @return array> * * @example * * $this->load->model('setting/extension'); * * $results = $this->model_setting_extension->getExtensionsByType($type); */ public function getExtensionsByType(string $type): array { $query = $this->db->query("SELECT * FROM `" . DB_PREFIX . "extension` WHERE `type` = '" . $this->db->escape($type) . "' ORDER BY `code` ASC"); return $query->rows; } /** * Get Extension By Code * * @param string $type * @param string $code * * @return array * * @example * * $this->load->model('setting/extension'); * * $extension_info = $this->model_setting_extension->getExtensionByCode($type, $code); */ public function getExtensionByCode(string $type, string $code): array { $query = $this->db->query("SELECT * FROM `" . DB_PREFIX . "extension` WHERE `type` = '" . $this->db->escape($type) . "' AND `code` = '" . $this->db->escape($code) . "'"); return $query->row; } /** * Get Total Extensions By Extension * * Get the total number of total extensions by extension records in the database. * * @param string $extension * * @return int total number of extension records that have extension ID * * @example * * $this->load->model('setting/extension'); * * $extension_total = $this->model_setting_extension->getTotalExtensionsByExtension($extension); */ public function getTotalExtensionsByExtension(string $extension): int { $query = $this->db->query("SELECT COUNT(*) AS `total` FROM `" . DB_PREFIX . "extension` WHERE `extension` = '" . $this->db->escape($extension) . "'"); return (int)$query->row['total']; } /** * Install * * Create a new extension record in the database. * * @param string $type * @param string $extension * @param string $code * * @return void * * @example * * $this->load->model('setting/extension'); * * $this->model_setting_extension->install($type, $extension, $code); */ public function install(string $type, string $extension, string $code): void { $extensions = $this->getExtensionsByType($type); $codes = array_column($extensions, 'code'); if (!in_array($code, $codes)) { $this->db->query("INSERT INTO `" . DB_PREFIX . "extension` SET `extension` = '" . $this->db->escape($extension) . "', `type` = '" . $this->db->escape($type) . "', `code` = '" . $this->db->escape($code) . "'"); } } /** * Uninstall * * Delete extension record in the database. * * @param string $type * @param string $code * * @return void * * @example * * $this->load->model('setting/extension'); * * $this->model_setting_extension->uninstall($type, $code); */ public function uninstall(string $type, string $code): void { $this->db->query("DELETE FROM `" . DB_PREFIX . "extension` WHERE `type` = '" . $this->db->escape($type) . "' AND `code` = '" . $this->db->escape($code) . "'"); // Setting $this->load->model('setting/setting'); $this->model_setting_setting->deleteSettingsByCode($type . '_' . $code); } /** * Add Install * * Create a new extension install record in the database. * * @param array $data array of data * * @return int returns the primary key of the new extension install record * * @example * * $extension_install_data = [ * 'extension_id' => 1, * 'extension_download_id' => 1, * 'name' => 'Extension Install Name', * 'description' => 'Extension Install Description', * 'code' => 'Extension Install Code', * 'version' => '1.00', * 'author' => 'Author Name', * 'link' => '', * 'status' => 0 * ]; * * $this->load->model('setting/extension'); * * $this->model_setting_extension->addInstall($extension_install_data); */ public function addInstall(array $data): int { $this->db->query("INSERT INTO `" . DB_PREFIX . "extension_install` SET `extension_id` = '" . (int)$data['extension_id'] . "', `extension_download_id` = '" . (int)$data['extension_download_id'] . "', `name` = '" . $this->db->escape($data['name']) . "', `description` = '" . $this->db->escape($data['description']) . "', `code` = '" . $this->db->escape($data['code']) . "', `version` = '" . $this->db->escape($data['version']) . "', `author` = '" . $this->db->escape($data['author']) . "', `link` = '" . $this->db->escape($data['link']) . "', `status` = '0', `date_added` = NOW()"); return $this->db->getLastId(); } /** * Delete Install * * Delete extension install record in the database. * * @param int $extension_install_id primary key of the extension install record * * @return void * * @example * * $this->load->model('setting/extension'); * * $this->model_setting_extension->deleteInstall($extension_install_id); */ public function deleteInstall(int $extension_install_id): void { $this->db->query("DELETE FROM `" . DB_PREFIX . "extension_install` WHERE `extension_install_id` = '" . (int)$extension_install_id . "'"); } /** * Edit Status * * Edit extension install record in the database. * * Edit extension install status record in the database. * * @param int $extension_install_id primary key of the extension install record * @param bool $status * * @return void * * @example * * $this->load->model('setting/extension'); * * $this->model_setting_extension->editStatus($extension_install_id, $status); */ public function editStatus(int $extension_install_id, bool $status): void { $this->db->query("UPDATE `" . DB_PREFIX . "extension_install` SET `status` = '" . (bool)$status . "' WHERE `extension_install_id` = '" . (int)$extension_install_id . "'"); } /** * Get Install * * Get the record of the extension install record in the database. * * @param int $extension_install_id primary key of the extension install record * * @return array install record that has extension install ID * * @example * * $this->load->model('setting/extension'); * * $extension_install_info = $this->model_setting_extension->getInstall($extension_install_id); */ public function getInstall(int $extension_install_id): array { $query = $this->db->query("SELECT * FROM `" . DB_PREFIX . "extension_install` WHERE `extension_install_id` = '" . (int)$extension_install_id . "'"); return $query->row; } /** * Get Install By Extension Download ID * * Get the record of the extension install by download record in the database. * * @param int $extension_download_id primary key of the extension download record * * @return array install record that has extension download ID * * @example * * $this->load->model('setting/extension'); * * $extension_install_info = $this->model_setting_extension->getInstallByExtensionDownloadId($extension_download_id); */ public function getInstallByExtensionDownloadId(int $extension_download_id): array { $query = $this->db->query("SELECT * FROM `" . DB_PREFIX . "extension_install` WHERE `extension_download_id` = '" . (int)$extension_download_id . "'"); return $query->row; } /** * Get Install By Code * * @param string $code * * @return array * * @example * * $this->load->model('setting/extension'); * * $install_info = $this->model_setting_extension->getInstallByCode($code); */ public function getInstallByCode(string $code): array { $query = $this->db->query("SELECT * FROM `" . DB_PREFIX . "extension_install` WHERE `code` = '" . $this->db->escape($code) . "'"); return $query->row; } /** * Get Installs * * Get the record of the extension install records in the database. * * @param array $data array of filters * * @return array> install records * * @example * * $filter_data = [ * 'filter_extension_download_id' => 1, * 'sort' => 'name', * 'order' => 'DESC', * 'start' => 0, * 'limit' => 10 * ]; * * $this->load->model('setting/extension'); * * $results = $this->model_setting_extension->getInstalls($filter_data); */ public function getInstalls(array $data = []): array { $sql = "SELECT * FROM `" . DB_PREFIX . "extension_install`"; if (!empty($data['filter_extension_download_id'])) { $sql .= " WHERE `extension_download_id` = '" . (int)$data['filter_extension_download_id'] . "'"; } $sort_data = [ 'name', 'version', 'date_added' ]; if (isset($data['sort']) && in_array($data['sort'], $sort_data)) { $sql .= " ORDER BY " . $data['sort']; } else { $sql .= " ORDER BY `date_added`"; } if (isset($data['order']) && ($data['order'] == 'DESC')) { $sql .= " DESC"; } else { $sql .= " ASC"; } if (isset($data['start']) || isset($data['limit'])) { if ($data['start'] < 0) { $data['start'] = 0; } if ($data['limit'] < 1) { $data['limit'] = 20; } $sql .= " LIMIT " . (int)$data['start'] . "," . (int)$data['limit']; } $query = $this->db->query($sql); return $query->rows; } /** * Get Total Installs * * Get the total number of total extension install records in the database. * * @param array $data array of filters * * @return int total number of install records * * @example * * $filter_data = [ * 'filter_extension_download_id' => 1, * 'sort' => 'name', * 'order' => 'DESC', * 'start' => 0, * 'limit' => 10 * ]; * * $this->load->model('setting/extension'); * * $extension_total = $this->model_setting_extension->getTotalInstalls($filter_data); */ public function getTotalInstalls(array $data = []): int { $sql = "SELECT COUNT(*) AS `total` FROM `" . DB_PREFIX . "extension_install`"; if (!empty($data['filter_extension_download_id'])) { $sql .= " WHERE `extension_download_id` = '" . (int)$data['filter_extension_download_id'] . "'"; } $query = $this->db->query($sql); return (int)$query->row['total']; } /** * Add Path * * Create a new extension path record in the database. * * @param int $extension_install_id primary key of the extension install record * @param string $path * * @return void * * @example * * $this->load->model('setting/extension'); * * $this->model_setting_extension->addPath($extension_install_id, $path); */ public function addPath(int $extension_install_id, string $path): void { $this->db->query("INSERT INTO `" . DB_PREFIX . "extension_path` SET `extension_install_id` = '" . (int)$extension_install_id . "', `path` = '" . $this->db->escape($path) . "'"); } /** * Delete Path * * Delete extension path record in the database. * * @param int $extension_path_id primary key of the extension path record * * @return void * * @example * * $this->load->model('setting/extension'); * * $this->model_setting_extension->deletePath($extension_path_id); */ public function deletePath(int $extension_path_id): void { $this->db->query("DELETE FROM `" . DB_PREFIX . "extension_path` WHERE `extension_path_id` = '" . (int)$extension_path_id . "'"); } /** * Get Paths By Extension Install ID * * Get the record of the extension paths by install records in the database. * * @param int $extension_install_id primary key of the extension install record * * @return array> path records that have extension install ID * * @example * * $this->load->model('setting/extension'); * * $results = $this->model_setting_extension->getPathsByExtensionInstallId($extension_install_id); */ public function getPathsByExtensionInstallId(int $extension_install_id): array { $query = $this->db->query("SELECT * FROM `" . DB_PREFIX . "extension_path` WHERE `extension_install_id` = '" . (int)$extension_install_id . "' ORDER BY `extension_path_id` ASC"); return $query->rows; } /** * Get Paths * * Get the record of the extension path records in the database. * * @param string $path * * @return array> * * @example * * $this->load->model('setting/extension'); * * $paths = $this->model_setting_extension->getPaths($path); */ public function getPaths(string $path): array { $query = $this->db->query("SELECT * FROM `" . DB_PREFIX . "extension_path` WHERE `path` LIKE '" . $this->db->escape($path) . "' ORDER BY `path` ASC"); return $query->rows; } /** * Get Total Paths * * Get the total number of total extension path records in the database. * * @param string $path * * @return int * * @example * * $this->load->model('setting/extension'); * * $path_total = $this->model_setting_extension->getTotalPaths($path); */ public function getTotalPaths(string $path): int { $query = $this->db->query("SELECT COUNT(*) AS `total` FROM `" . DB_PREFIX . "extension_path` WHERE `path` LIKE '" . $this->db->escape($path) . "'"); return (int)$query->row['total']; } }