2014-04-17 20:25:54 +04:00
|
|
|
<?php
|
|
|
|
/**
|
2016-07-21 18:07:57 +03:00
|
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
|
|
|
*
|
2016-05-26 20:56:05 +03:00
|
|
|
* @author Arthur Schiwon <blizzz@arthur-schiwon.de>
|
2020-03-31 11:49:10 +03:00
|
|
|
* @author Christoph Wurst <christoph@winzerhof-wurst.at>
|
2016-07-21 18:07:57 +03:00
|
|
|
* @author Joas Schilling <coding@schilljs.com>
|
2019-12-03 21:57:53 +03:00
|
|
|
* @author John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
|
2016-05-26 20:56:05 +03:00
|
|
|
* @author Lukas Reschke <lukas@statuscode.ch>
|
2015-03-26 13:44:34 +03:00
|
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
2019-12-03 21:57:53 +03:00
|
|
|
* @author Robin Appelman <robin@icewind.nl>
|
|
|
|
* @author Roeland Jago Douma <roeland@famdouma.nl>
|
2015-03-26 13:44:34 +03:00
|
|
|
* @author Stephan Peijnik <speijnik@anexia-it.com>
|
|
|
|
* @author Thomas Müller <thomas.mueller@tmit.eu>
|
|
|
|
*
|
|
|
|
* @license AGPL-3.0
|
|
|
|
*
|
|
|
|
* This code is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
|
|
* as published by the Free Software Foundation.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License, version 3,
|
2019-12-03 21:57:53 +03:00
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
2015-03-26 13:44:34 +03:00
|
|
|
*
|
2014-04-17 20:25:54 +04:00
|
|
|
*/
|
2015-02-26 13:37:37 +03:00
|
|
|
|
2014-04-17 20:25:54 +04:00
|
|
|
namespace OC\Group;
|
|
|
|
|
2018-05-16 13:32:56 +03:00
|
|
|
use OCP\IGroupManager;
|
2019-11-22 22:52:10 +03:00
|
|
|
use OCP\IUserSession;
|
2015-10-27 16:09:45 +03:00
|
|
|
|
2014-04-17 20:25:54 +04:00
|
|
|
class MetaData {
|
|
|
|
const SORT_NONE = 0;
|
2015-05-18 13:23:12 +03:00
|
|
|
const SORT_USERCOUNT = 1; // May have performance issues on LDAP backends
|
|
|
|
const SORT_GROUPNAME = 2;
|
2014-04-17 20:25:54 +04:00
|
|
|
|
2015-10-27 16:09:45 +03:00
|
|
|
/** @var string */
|
2014-04-17 20:25:54 +04:00
|
|
|
protected $user;
|
2015-10-27 16:09:45 +03:00
|
|
|
/** @var bool */
|
2014-04-17 20:25:54 +04:00
|
|
|
protected $isAdmin;
|
2015-10-27 16:09:45 +03:00
|
|
|
/** @var array */
|
2020-03-26 11:30:18 +03:00
|
|
|
protected $metaData = [];
|
2018-05-16 13:32:56 +03:00
|
|
|
/** @var IGroupManager */
|
2014-04-17 20:25:54 +04:00
|
|
|
protected $groupManager;
|
2015-10-27 16:09:45 +03:00
|
|
|
/** @var bool */
|
2014-04-17 20:25:54 +04:00
|
|
|
protected $sorting = false;
|
2015-10-27 16:09:45 +03:00
|
|
|
/** @var IUserSession */
|
|
|
|
protected $userSession;
|
2014-04-17 20:25:54 +04:00
|
|
|
|
|
|
|
/**
|
2014-07-14 23:19:08 +04:00
|
|
|
* @param string $user the uid of the current user
|
|
|
|
* @param bool $isAdmin whether the current users is an admin
|
2018-05-16 13:32:56 +03:00
|
|
|
* @param IGroupManager $groupManager
|
|
|
|
* @param IUserManager $userManager
|
2015-10-27 16:09:45 +03:00
|
|
|
* @param IUserSession $userSession
|
2014-04-17 20:25:54 +04:00
|
|
|
*/
|
|
|
|
public function __construct(
|
|
|
|
$user,
|
|
|
|
$isAdmin,
|
2018-05-16 13:32:56 +03:00
|
|
|
IGroupManager $groupManager,
|
2015-10-27 16:09:45 +03:00
|
|
|
IUserSession $userSession
|
2014-04-17 20:25:54 +04:00
|
|
|
) {
|
|
|
|
$this->user = $user;
|
|
|
|
$this->isAdmin = (bool)$isAdmin;
|
|
|
|
$this->groupManager = $groupManager;
|
2015-10-27 16:09:45 +03:00
|
|
|
$this->userSession = $userSession;
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* returns an array with meta data about all available groups
|
|
|
|
* the array is structured as follows:
|
|
|
|
* [0] array containing meta data about admin groups
|
|
|
|
* [1] array containing meta data about unprivileged groups
|
2014-07-09 14:19:50 +04:00
|
|
|
* @param string $groupSearch only effective when instance was created with
|
|
|
|
* isAdmin being true
|
|
|
|
* @param string $userSearch the pattern users are search for
|
2014-04-17 20:25:54 +04:00
|
|
|
* @return array
|
|
|
|
*/
|
2014-07-09 14:19:50 +04:00
|
|
|
public function get($groupSearch = '', $userSearch = '') {
|
|
|
|
$key = $groupSearch . '::' . $userSearch;
|
2020-04-10 15:19:56 +03:00
|
|
|
if (isset($this->metaData[$key])) {
|
2014-07-09 14:19:50 +04:00
|
|
|
return $this->metaData[$key];
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
$adminGroups = [];
|
|
|
|
$groups = [];
|
2014-04-17 20:25:54 +04:00
|
|
|
$sortGroupsIndex = 0;
|
2020-03-26 11:30:18 +03:00
|
|
|
$sortGroupsKeys = [];
|
2014-04-17 20:25:54 +04:00
|
|
|
$sortAdminGroupsIndex = 0;
|
2020-03-26 11:30:18 +03:00
|
|
|
$sortAdminGroupsKeys = [];
|
2014-04-17 20:25:54 +04:00
|
|
|
|
2020-04-10 15:19:56 +03:00
|
|
|
foreach ($this->getGroups($groupSearch) as $group) {
|
2014-07-09 14:19:50 +04:00
|
|
|
$groupMetaData = $this->generateGroupMetaData($group, $userSearch);
|
2014-04-22 21:41:35 +04:00
|
|
|
if (strtolower($group->getGID()) !== 'admin') {
|
2014-04-17 20:25:54 +04:00
|
|
|
$this->addEntry(
|
|
|
|
$groups,
|
|
|
|
$sortGroupsKeys,
|
|
|
|
$sortGroupsIndex,
|
|
|
|
$groupMetaData);
|
|
|
|
} else {
|
|
|
|
//admin group is hard coded to 'admin' for now. In future,
|
|
|
|
//backends may define admin groups too. Then the if statement
|
|
|
|
//has to be adjusted accordingly.
|
|
|
|
$this->addEntry(
|
|
|
|
$adminGroups,
|
|
|
|
$sortAdminGroupsKeys,
|
|
|
|
$sortAdminGroupsIndex,
|
|
|
|
$groupMetaData);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
//whether sorting is necessary is will be checked in sort()
|
|
|
|
$this->sort($groups, $sortGroupsKeys);
|
|
|
|
$this->sort($adminGroups, $sortAdminGroupsKeys);
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
$this->metaData[$key] = [$adminGroups, $groups];
|
2014-07-09 14:19:50 +04:00
|
|
|
return $this->metaData[$key];
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2015-05-18 13:23:12 +03:00
|
|
|
* sets the sort mode, see SORT_* constants for supported modes
|
|
|
|
*
|
|
|
|
* @param int $sortMode
|
2014-04-17 20:25:54 +04:00
|
|
|
*/
|
|
|
|
public function setSorting($sortMode) {
|
2015-05-18 13:23:12 +03:00
|
|
|
switch ($sortMode) {
|
|
|
|
case self::SORT_USERCOUNT:
|
|
|
|
case self::SORT_GROUPNAME:
|
|
|
|
$this->sorting = $sortMode;
|
|
|
|
break;
|
|
|
|
|
|
|
|
default:
|
|
|
|
$this->sorting = self::SORT_NONE;
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-07-14 23:19:08 +04:00
|
|
|
* adds an group entry to the resulting array
|
|
|
|
* @param array $entries the resulting array, by reference
|
|
|
|
* @param array $sortKeys the sort key array, by reference
|
|
|
|
* @param int $sortIndex the sort key index, by reference
|
|
|
|
* @param array $data the group's meta data as returned by generateGroupMetaData()
|
2014-04-17 20:25:54 +04:00
|
|
|
*/
|
|
|
|
private function addEntry(&$entries, &$sortKeys, &$sortIndex, $data) {
|
|
|
|
$entries[] = $data;
|
2015-05-18 13:23:12 +03:00
|
|
|
if ($this->sorting === self::SORT_USERCOUNT) {
|
2014-04-17 20:25:54 +04:00
|
|
|
$sortKeys[$sortIndex] = $data['usercount'];
|
|
|
|
$sortIndex++;
|
2020-04-10 11:35:09 +03:00
|
|
|
} elseif ($this->sorting === self::SORT_GROUPNAME) {
|
2015-05-18 13:23:12 +03:00
|
|
|
$sortKeys[$sortIndex] = $data['name'];
|
|
|
|
$sortIndex++;
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-07-14 23:19:08 +04:00
|
|
|
* creates an array containing the group meta data
|
2015-05-18 13:23:12 +03:00
|
|
|
* @param \OCP\IGroup $group
|
2014-07-09 14:19:50 +04:00
|
|
|
* @param string $userSearch
|
2018-05-16 13:32:56 +03:00
|
|
|
* @return array with the keys 'id', 'name', 'usercount' and 'disabled'
|
2014-04-17 20:25:54 +04:00
|
|
|
*/
|
2015-05-18 13:23:12 +03:00
|
|
|
private function generateGroupMetaData(\OCP\IGroup $group, $userSearch) {
|
2020-03-26 11:30:18 +03:00
|
|
|
return [
|
2020-04-09 10:22:29 +03:00
|
|
|
'id' => $group->getGID(),
|
|
|
|
'name' => $group->getDisplayName(),
|
|
|
|
'usercount' => $this->sorting === self::SORT_USERCOUNT ? $group->count($userSearch) : 0,
|
|
|
|
'disabled' => $group->countDisabled(),
|
|
|
|
'canAdd' => $group->canAddUser(),
|
|
|
|
'canRemove' => $group->canRemoveUser(),
|
|
|
|
];
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-07-14 23:19:08 +04:00
|
|
|
* sorts the result array, if applicable
|
|
|
|
* @param array $entries the result array, by reference
|
|
|
|
* @param array $sortKeys the array containing the sort keys
|
2014-04-17 20:25:54 +04:00
|
|
|
* @param return null
|
|
|
|
*/
|
|
|
|
private function sort(&$entries, $sortKeys) {
|
2015-05-18 13:23:12 +03:00
|
|
|
if ($this->sorting === self::SORT_USERCOUNT) {
|
2014-04-17 20:25:54 +04:00
|
|
|
array_multisort($sortKeys, SORT_DESC, $entries);
|
2020-04-10 11:35:09 +03:00
|
|
|
} elseif ($this->sorting === self::SORT_GROUPNAME) {
|
2015-05-18 13:23:12 +03:00
|
|
|
array_multisort($sortKeys, SORT_ASC, $entries);
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-07-14 23:19:08 +04:00
|
|
|
* returns the available groups
|
|
|
|
* @param string $search a search string
|
2015-05-18 13:23:12 +03:00
|
|
|
* @return \OCP\IGroup[]
|
2014-04-17 20:25:54 +04:00
|
|
|
*/
|
2018-05-24 12:29:48 +03:00
|
|
|
public function getGroups($search = '') {
|
2020-04-10 15:19:56 +03:00
|
|
|
if ($this->isAdmin) {
|
2014-07-09 14:19:50 +04:00
|
|
|
return $this->groupManager->search($search);
|
2014-04-17 20:25:54 +04:00
|
|
|
} else {
|
2015-10-27 16:09:45 +03:00
|
|
|
$userObject = $this->userSession->getUser();
|
2020-04-10 15:19:56 +03:00
|
|
|
if ($userObject !== null) {
|
2015-10-27 16:09:45 +03:00
|
|
|
$groups = $this->groupManager->getSubAdmin()->getSubAdminsGroups($userObject);
|
|
|
|
} else {
|
|
|
|
$groups = [];
|
2014-07-11 09:12:04 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
return $groups;
|
2014-04-17 20:25:54 +04:00
|
|
|
}
|
|
|
|
}
|
2014-05-09 21:03:05 +04:00
|
|
|
}
|