Merge pull request #6077 from owncloud/fix-api-documentation
API doc for contacts manager, server container and share
This commit is contained in:
commit
a03ba06dcd
|
@ -119,11 +119,15 @@ namespace OCP\Contacts {
|
||||||
function isEnabled();
|
function isEnabled();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Registers an address book
|
||||||
|
*
|
||||||
* @param \OCP\IAddressBook $address_book
|
* @param \OCP\IAddressBook $address_book
|
||||||
*/
|
*/
|
||||||
function registerAddressBook(\OCP\IAddressBook $address_book);
|
function registerAddressBook(\OCP\IAddressBook $address_book);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Unregisters an address book
|
||||||
|
*
|
||||||
* @param \OCP\IAddressBook $address_book
|
* @param \OCP\IAddressBook $address_book
|
||||||
*/
|
*/
|
||||||
function unregisterAddressBook(\OCP\IAddressBook $address_book);
|
function unregisterAddressBook(\OCP\IAddressBook $address_book);
|
||||||
|
|
|
@ -100,11 +100,15 @@ interface IServerContainer {
|
||||||
function getUserSession();
|
function getUserSession();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Returns the navigation manager
|
||||||
|
*
|
||||||
* @return \OCP\INavigationManager
|
* @return \OCP\INavigationManager
|
||||||
*/
|
*/
|
||||||
function getNavigationManager();
|
function getNavigationManager();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Returns the config manager
|
||||||
|
*
|
||||||
* @return \OCP\IConfig
|
* @return \OCP\IConfig
|
||||||
*/
|
*/
|
||||||
function getConfig();
|
function getConfig();
|
||||||
|
@ -117,11 +121,15 @@ interface IServerContainer {
|
||||||
function getL10N($app);
|
function getL10N($app);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Returns the URL generator
|
||||||
|
*
|
||||||
* @return \OCP\IURLGenerator
|
* @return \OCP\IURLGenerator
|
||||||
*/
|
*/
|
||||||
function getURLGenerator();
|
function getURLGenerator();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Returns the Helper
|
||||||
|
*
|
||||||
* @return \OCP\IHelper
|
* @return \OCP\IHelper
|
||||||
*/
|
*/
|
||||||
function getHelper();
|
function getHelper();
|
||||||
|
@ -155,7 +163,8 @@ interface IServerContainer {
|
||||||
function getDatabaseConnection();
|
function getDatabaseConnection();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Returns an avatar manager, used for avatar functionality
|
* Returns an avatar manager, used for avatar functionality
|
||||||
|
*
|
||||||
* @return \OCP\IAvatarManager
|
* @return \OCP\IAvatarManager
|
||||||
*/
|
*/
|
||||||
function getAvatarManager();
|
function getAvatarManager();
|
||||||
|
|
|
@ -244,7 +244,9 @@ class Share {
|
||||||
* Get the items of item type shared with the current user
|
* Get the items of item type shared with the current user
|
||||||
* @param string Item type
|
* @param string Item type
|
||||||
* @param int Format (optional) Format type must be defined by the backend
|
* @param int Format (optional) Format type must be defined by the backend
|
||||||
|
* @param mixed Parameters (optional)
|
||||||
* @param int Number of items to return (optional) Returns all by default
|
* @param int Number of items to return (optional) Returns all by default
|
||||||
|
* @param bool include collections (optional)
|
||||||
* @return Return depends on format
|
* @return Return depends on format
|
||||||
*/
|
*/
|
||||||
public static function getItemsSharedWith($itemType, $format = self::FORMAT_NONE,
|
public static function getItemsSharedWith($itemType, $format = self::FORMAT_NONE,
|
||||||
|
@ -258,6 +260,8 @@ class Share {
|
||||||
* @param string $itemType
|
* @param string $itemType
|
||||||
* @param string $itemTarget
|
* @param string $itemTarget
|
||||||
* @param int $format (optional) Format type must be defined by the backend
|
* @param int $format (optional) Format type must be defined by the backend
|
||||||
|
* @param mixed Parameters (optional)
|
||||||
|
* @param bool include collections (optional)
|
||||||
* @return Return depends on format
|
* @return Return depends on format
|
||||||
*/
|
*/
|
||||||
public static function getItemSharedWith($itemType, $itemTarget, $format = self::FORMAT_NONE,
|
public static function getItemSharedWith($itemType, $itemTarget, $format = self::FORMAT_NONE,
|
||||||
|
@ -954,6 +958,7 @@ class Share {
|
||||||
* @param mixed Parameters to pass to formatItems()
|
* @param mixed Parameters to pass to formatItems()
|
||||||
* @param int Number of items to return, -1 to return all matches (optional)
|
* @param int Number of items to return, -1 to return all matches (optional)
|
||||||
* @param bool Include collection item types (optional)
|
* @param bool Include collection item types (optional)
|
||||||
|
* @param bool TODO (optional)
|
||||||
* @return mixed
|
* @return mixed
|
||||||
*
|
*
|
||||||
* See public functions getItem(s)... for parameter usage
|
* See public functions getItem(s)... for parameter usage
|
||||||
|
@ -1354,8 +1359,11 @@ class Share {
|
||||||
* @param string Item source
|
* @param string Item source
|
||||||
* @param int SHARE_TYPE_USER, SHARE_TYPE_GROUP, or SHARE_TYPE_LINK
|
* @param int SHARE_TYPE_USER, SHARE_TYPE_GROUP, or SHARE_TYPE_LINK
|
||||||
* @param string User or group the item is being shared with
|
* @param string User or group the item is being shared with
|
||||||
|
* @param string User that is the owner of shared item
|
||||||
* @param int CRUDS permissions
|
* @param int CRUDS permissions
|
||||||
* @param bool|array Parent folder target (optional)
|
* @param bool|array Parent folder target (optional)
|
||||||
|
* @param string token (optional)
|
||||||
|
* @param string name of the source item (optional)
|
||||||
* @return bool Returns true on success or false on failure
|
* @return bool Returns true on success or false on failure
|
||||||
*/
|
*/
|
||||||
private static function put($itemType, $itemSource, $shareType, $shareWith, $uidOwner,
|
private static function put($itemType, $itemSource, $shareType, $shareWith, $uidOwner,
|
||||||
|
@ -1593,6 +1601,7 @@ class Share {
|
||||||
* @param string Item source
|
* @param string Item source
|
||||||
* @param int SHARE_TYPE_USER, SHARE_TYPE_GROUP, or SHARE_TYPE_LINK
|
* @param int SHARE_TYPE_USER, SHARE_TYPE_GROUP, or SHARE_TYPE_LINK
|
||||||
* @param string User or group the item is being shared with
|
* @param string User or group the item is being shared with
|
||||||
|
* @param string User that is the owner of shared item
|
||||||
* @param string The suggested target originating from a reshare (optional)
|
* @param string The suggested target originating from a reshare (optional)
|
||||||
* @param int The id of the parent group share (optional)
|
* @param int The id of the parent group share (optional)
|
||||||
* @return string Item target
|
* @return string Item target
|
||||||
|
@ -1780,6 +1789,7 @@ class Share {
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Function that is called after a user is deleted. Cleans up the shares of that user.
|
||||||
* @param array arguments
|
* @param array arguments
|
||||||
*/
|
*/
|
||||||
public static function post_deleteUser($arguments) {
|
public static function post_deleteUser($arguments) {
|
||||||
|
@ -1796,6 +1806,8 @@ class Share {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Function that is called after a user is added to a group.
|
||||||
|
* TODO what does it do?
|
||||||
* @param array arguments
|
* @param array arguments
|
||||||
*/
|
*/
|
||||||
public static function post_addToGroup($arguments) {
|
public static function post_addToGroup($arguments) {
|
||||||
|
@ -1829,6 +1841,7 @@ class Share {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Function that is called after a user is removed from a group. Shares are cleaned up.
|
||||||
* @param array arguments
|
* @param array arguments
|
||||||
*/
|
*/
|
||||||
public static function post_removeFromGroup($arguments) {
|
public static function post_removeFromGroup($arguments) {
|
||||||
|
@ -1848,6 +1861,7 @@ class Share {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
* Function that is called after a group is removed. Cleans up the shares to that group.
|
||||||
* @param array arguments
|
* @param array arguments
|
||||||
*/
|
*/
|
||||||
public static function post_deleteGroup($arguments) {
|
public static function post_deleteGroup($arguments) {
|
||||||
|
@ -1894,7 +1908,7 @@ interface Share_Backend {
|
||||||
* Converts the shared item sources back into the item in the specified format
|
* Converts the shared item sources back into the item in the specified format
|
||||||
* @param array Shared items
|
* @param array Shared items
|
||||||
* @param int Format
|
* @param int Format
|
||||||
* @return ?
|
* @return TODO
|
||||||
*
|
*
|
||||||
* The items array is a 3-dimensional array with the item_source as the
|
* The items array is a 3-dimensional array with the item_source as the
|
||||||
* first key and the share id as the second key to an array with the share
|
* first key and the share id as the second key to an array with the share
|
||||||
|
@ -1923,6 +1937,8 @@ interface Share_Backend_File_Dependent extends Share_Backend {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Get the file path of the item
|
* Get the file path of the item
|
||||||
|
* @param string Item source
|
||||||
|
* @param string User that is the owner of shared item
|
||||||
*/
|
*/
|
||||||
public function getFilePath($itemSource, $uidOwner);
|
public function getFilePath($itemSource, $uidOwner);
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue