aboutsummaryrefslogtreecommitdiffstats
path: root/lib/public/IGroupManager.php
diff options
context:
space:
mode:
Diffstat (limited to 'lib/public/IGroupManager.php')
-rw-r--r--lib/public/IGroupManager.php57
1 files changed, 26 insertions, 31 deletions
diff --git a/lib/public/IGroupManager.php b/lib/public/IGroupManager.php
index d942caac9b4..ee88990df79 100644
--- a/lib/public/IGroupManager.php
+++ b/lib/public/IGroupManager.php
@@ -1,32 +1,9 @@
<?php
+
/**
- * @copyright Copyright (c) 2016, ownCloud, Inc.
- *
- * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
- * @author Bernhard Posselt <dev@bernhard-posselt.com>
- * @author Joas Schilling <coding@schilljs.com>
- * @author Jörn Friedrich Dreyer <jfd@butonic.de>
- * @author Lukas Reschke <lukas@statuscode.ch>
- * @author Morris Jobke <hey@morrisjobke.de>
- * @author Robin Appelman <robin@icewind.nl>
- * @author Roeland Jago Douma <roeland@famdouma.nl>
- * @author Thomas Müller <thomas.mueller@tmit.eu>
- * @author Vinicius Cubas Brand <vinicius@eita.org.br>
- *
- * @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,
- * along with this program. If not, see <http://www.gnu.org/licenses/>
- *
+ * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2016 ownCloud, Inc.
+ * SPDX-License-Identifier: AGPL-3.0-only
*/
namespace OCP;
@@ -96,19 +73,19 @@ interface IGroupManager {
/**
* @param string $search
- * @param int $limit
- * @param int $offset
+ * @param ?int $limit
+ * @param ?int $offset
* @return \OCP\IGroup[]
* @since 8.0.0
*/
- public function search($search, $limit = null, $offset = null);
+ public function search(string $search, ?int $limit = null, ?int $offset = 0);
/**
* @param \OCP\IUser|null $user
* @return \OCP\IGroup[]
* @since 8.0.0
*/
- public function getUserGroups(IUser $user = null);
+ public function getUserGroups(?IUser $user = null);
/**
* @param \OCP\IUser $user
@@ -138,6 +115,14 @@ interface IGroupManager {
public function isAdmin($userId);
/**
+ * Checks if a userId is eligible to users administration delegation
+ * @param string $userId
+ * @return bool if delegated admin
+ * @since 30.0.0
+ */
+ public function isDelegatedAdmin(string $userId): bool;
+
+ /**
* Checks if a userId is in a group
* @param string $userId
* @param string $group
@@ -145,4 +130,14 @@ interface IGroupManager {
* @since 8.0.0
*/
public function isInGroup($userId, $group);
+
+ /**
+ * Get the display name of a Nextcloud group
+ *
+ * @param string $groupId
+ * @return ?string display name, if any
+ *
+ * @since 26.0.0
+ */
+ public function getDisplayName(string $groupId): ?string;
}