2010-07-21 19:53:51 +04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
/**
|
|
|
|
* ownCloud
|
|
|
|
*
|
|
|
|
* @author Frank Karlitschek
|
|
|
|
* @copyright 2010 Frank Karlitschek karlitschek@kde.org
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 3 of the License, or any later version.
|
|
|
|
*
|
|
|
|
* This library 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 Lesser General Public
|
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Base class for user management
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
abstract class OC_USER_BACKEND {
|
|
|
|
|
|
|
|
/**
|
2010-07-23 01:42:18 +04:00
|
|
|
* Check if the login button is pressed and log the user in
|
2010-07-21 19:53:51 +04:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
abstract public static function loginLisener();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Try to create a new user
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username The username of the user to create
|
|
|
|
* @param string $password The password of the new user
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function createUser($username, $password);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Try to login a user
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username The username of the user to log in
|
|
|
|
* @param string $password The password of the user
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function login($username, $password);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if the logout button is pressed and logout the user
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
abstract public static function logoutLisener();
|
|
|
|
|
|
|
|
/**
|
2010-07-23 01:42:18 +04:00
|
|
|
* Check if some user is logged in
|
2010-07-21 19:53:51 +04:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
abstract public static function isLoggedIn();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Try to create a new group
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $groupName The name of the group to create
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function createGroup($groupName);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the ID of a user
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username Name of the user to find the ID
|
|
|
|
* @param boolean $noCache If false the cache is used to find the ID
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function getUserId($username, $noCache=false);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the ID of a group
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $groupName Name of the group to find the ID
|
|
|
|
* @param boolean $noCache If false the cache is used to find the ID
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function getGroupId($groupName, $noCache=false);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the name of a group
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $groupId ID of the group
|
|
|
|
* @param boolean $noCache If false the cache is used to find the name of the group
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function getGroupName($groupId, $noCache=false);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if a user belongs to a group
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username Name of the user to check
|
|
|
|
* @param string $groupName Name of the group
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function inGroup($username, $groupName);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add a user to a group
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username Name of the user to add to group
|
|
|
|
* @param string $groupName Name of the group in which add the user
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function addToGroup($username, $groupName);
|
|
|
|
|
2010-09-20 22:27:43 +04:00
|
|
|
/**
|
|
|
|
* Remove a user from a group
|
|
|
|
*
|
|
|
|
* @param string $username Name of the user to remove from group
|
|
|
|
* @param string $groupName Name of the group from which remove the user
|
|
|
|
*/
|
|
|
|
abstract public static function removeFromGroup($username,$groupName);
|
|
|
|
|
2010-07-21 19:53:51 +04:00
|
|
|
/**
|
|
|
|
* Generate a random password
|
|
|
|
*/
|
|
|
|
abstract public static function generatePassword();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get all groups the user belongs to
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username Name of the user
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function getUserGroups($username);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the password of a user
|
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username User who password will be changed
|
|
|
|
* @param string $password The new password for the user
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function setPassword($username, $password);
|
|
|
|
|
|
|
|
/**
|
2010-07-23 01:42:18 +04:00
|
|
|
* Check if the password of the user is correct
|
2010-07-21 19:53:51 +04:00
|
|
|
*
|
2010-07-23 01:42:18 +04:00
|
|
|
* @param string $username Name of the user
|
|
|
|
* @param string $password Password of the user
|
2010-07-21 19:53:51 +04:00
|
|
|
*/
|
|
|
|
abstract public static function checkPassword($username, $password);
|
|
|
|
|
2010-09-15 20:24:14 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* get a list of all users
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
abstract public static function getUsers();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* get a list of all groups
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
abstract public static function getGroups();
|
2010-07-21 19:53:51 +04:00
|
|
|
}
|