| Linux hosting5.siteguarding.com 3.10.0-962.3.2.lve1.5.88.el7.x86_64 #1 SMP Fri Sep 26 14:06:42 UTC 2025 x86_64 Path : /home/devsafetybis/op4103.dev.safetybis.com/admin1qw/model/user/ |
| Current File : /home/devsafetybis/op4103.dev.safetybis.com/admin1qw/model/user/user_group.php |
<?php
namespace Opencart\Admin\Model\User;
/**
* Class User Group
*
* Can be loaded using $this->load->model('user/user_group');
*
* @package Opencart\Admin\Model\User
*/
class UserGroup extends \Opencart\System\Engine\Model {
/**
* Add User Group
*
* Create a new user group record in the database.
*
* @param array<string, mixed> $data array of data
*
* @return int
*
* @example
*
* $user_group_data = [
* 'name' => 'User Group Name',
* 'permission' => ''
* ];
*
* $this->load->model('user/user_group');
*
* $user_group_id = $this->model_user_user_group->addUserGroup($user_group_data);
*/
public function addUserGroup(array $data): int {
$this->db->query("INSERT INTO `" . DB_PREFIX . "user_group` SET `name` = '" . $this->db->escape((string)$data['name']) . "', `permission` = '" . (isset($data['permission']) ? $this->db->escape(json_encode($data['permission'])) : '') . "'");
return $this->db->getLastId();
}
/**
* Edit User Group
*
* Edit user group record in the database.
*
* @param int $user_group_id primary key of the user group record
* @param array<string, mixed> $data array of data
*
* @return void
*
* @example
*
* $user_group_data = [
* 'name' => 'User Group Name',
* 'permission' => ''
* ];
*
* $this->load->model('user/user_group');
*
* $this->model_user_user_group->editUserGroup($user_group_id, $user_group_data);
*/
public function editUserGroup(int $user_group_id, array $data): void {
$this->db->query("UPDATE `" . DB_PREFIX . "user_group` SET `name` = '" . $this->db->escape((string)$data['name']) . "', `permission` = '" . (isset($data['permission']) ? $this->db->escape(json_encode($data['permission'])) : '') . "' WHERE `user_group_id` = '" . (int)$user_group_id . "'");
}
/**
* Delete User Group
*
* Delete user group record in the database.
*
* @param int $user_group_id primary key of the user group record
*
* @return void
*
* @example
*
* $this->load->model('user/user_group');
*
* $this->model_user_user_group->deleteUserGroup($user_group_id);
*/
public function deleteUserGroup(int $user_group_id): void {
$this->db->query("DELETE FROM `" . DB_PREFIX . "user_group` WHERE `user_group_id` = '" . (int)$user_group_id . "'");
}
/**
* Get User Group
*
* Get the record of the user group record in the database.
*
* @param int $user_group_id primary key of the user group record
*
* @return array<string, mixed> user group record that has user group ID
*
* @example
*
* $this->load->model('user/user_group');
*
* $user_group_info = $this->model_user_user_group->getUserGroup($user_group_id);
*/
public function getUserGroup(int $user_group_id): array {
$query = $this->db->query("SELECT DISTINCT * FROM `" . DB_PREFIX . "user_group` WHERE `user_group_id` = '" . (int)$user_group_id . "'");
return ['permission' => $query->row['permission'] ? json_decode($query->row['permission'], true) : []] + $query->row;
}
/**
* Get User Groups
*
* Get the record of the user group records in the database.
*
* @param array<string, mixed> $data array of filters
*
* @return array<int, array<string, mixed>> user group records
*
* @example
*
* $filter_data = [
* 'sort' => 'name',
* 'order' => 'DESC',
* 'start' => 0,
* 'limit' => 10
* ];
*
* $this->load->model('user/user_group');
*
* $results = $this->model_user_user_group->getUserGroups($filter_data);
*/
public function getUserGroups(array $data = []): array {
$sql = "SELECT * FROM `" . DB_PREFIX . "user_group` ORDER BY `name`";
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 User Groups
*
* Get the total number of total user group records in the database.
*
* @return int total number of user group records
*
* @example
*
* $this->load->model('user/user_group');
*
* $user_group_total = $this->model_user_user_group->getTotalUserGroups();
*/
public function getTotalUserGroups(): int {
$query = $this->db->query("SELECT COUNT(*) AS `total` FROM `" . DB_PREFIX . "user_group`");
return (int)$query->row['total'];
}
/**
* Add Permission
*
* Create and edit new user permission record in the database.
*
* @param int $user_group_id primary key of the user group record
* @param string $type
* @param string $route
*
* @return void
*
* @example
*
* $this->load->model('user/user_group');
*
* $this->model_user_user_group->addPermission($user_group_id, $type, $route);
*/
public function addPermission(int $user_group_id, string $type, string $route): void {
$user_group_query = $this->db->query("SELECT DISTINCT * FROM `" . DB_PREFIX . "user_group` WHERE `user_group_id` = '" . (int)$user_group_id . "'");
if ($user_group_query->num_rows) {
$data = $user_group_query->row['permission'] ? json_decode($user_group_query->row['permission'], true) : [];
$data[$type][] = $route;
$this->db->query("UPDATE `" . DB_PREFIX . "user_group` SET `permission` = '" . $this->db->escape(json_encode($data)) . "' WHERE `user_group_id` = '" . (int)$user_group_id . "'");
}
}
/**
* Remove Permission
*
* Delete user permission record in the database.
*
* @param int $user_group_id primary key of the user group record
* @param string $type
* @param string $route
*
* @return void
*
* @example
*
* $this->load->model('user/user_group');
*
* $this->model_user_user_group->removePermission($user_group_id, $type, $route);
*/
public function removePermission(int $user_group_id, string $type, string $route): void {
$user_group_query = $this->db->query("SELECT DISTINCT * FROM `" . DB_PREFIX . "user_group` WHERE `user_group_id` = '" . (int)$user_group_id . "'");
if ($user_group_query->num_rows) {
$data = $user_group_query->row['permission'] ? json_decode($user_group_query->row['permission'], true) : [];
if (isset($data[$type])) {
$data[$type] = array_diff($data[$type], [$route]);
}
$this->db->query("UPDATE `" . DB_PREFIX . "user_group` SET `permission` = '" . $this->db->escape(json_encode($data)) . "' WHERE `user_group_id` = '" . (int)$user_group_id . "'");
}
}
}