oldkid/friendica
1
0
Fork 0
mirror of https://git.sekbaer.de/Friendica/friendica.git synced 2025-06-12 01:54:26 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Fix PHPDoc comments project-wide

Browse source
This commit is contained in:
Hypolite Petovan 2019-01-06 16:06:53 -05:00
parent 6077aa5847
commit 3282ce5389
113 changed files with 1703 additions and 795 deletions
Download patch file Download diff file Expand all files Collapse all files

51
src/Model/Group.php
View file

@ -22,9 +22,10 @@ class Group extends BaseObject
*
* Note: If we found a deleted group with the same name, we restore it
*
* @param int $uid
* @param int $uid
* @param string $name
* @return boolean
* @throws \Exception
*/
public static function create($uid, $name)
{
@ -56,10 +57,11 @@ class Group extends BaseObject
/**
* Update group information.
*
* @param int $id Group ID
* @param int $id Group ID
* @param string $name Group name
*
* @return bool Was the update successful?
* @throws \Exception
*/
public static function update($id, $name)
{
@ -71,6 +73,7 @@ class Group extends BaseObject
*
* @param int $cid
* @return array
* @throws \Exception
*/
public static function getIdsByContactId($cid)
{
@ -92,9 +95,10 @@ class Group extends BaseObject
* Count unread items of each groups of the local user
*
* @return array
* 'id' => group id
* 'name' => group name
* 'count' => counted unseen group items
* 'id' => group id
* 'name' => group name
* 'count' => counted unseen group items
* @throws \Exception
*/
public static function countUnseen()
{
@ -121,9 +125,10 @@ class Group extends BaseObject
*
* Returns false if no group has been found.
*
* @param int $uid
* @param int $uid
* @param string $name
* @return int|boolean
* @throws \Exception
*/
public static function getIdByName($uid, $name)
{
@ -144,6 +149,7 @@ class Group extends BaseObject
*
* @param int $gid
* @return boolean
* @throws \Exception
*/
public static function remove($gid) {
if (! $gid) {
@ -188,13 +194,14 @@ class Group extends BaseObject
}
/**
* @brief Mark a group as deleted based on its name
* @brief Mark a group as deleted based on its name
*
* @deprecated Use Group::remove instead
*
* @param int $uid
* @param int $uid
* @param string $name
* @return bool
* @throws \Exception
*/
public static function removeByName($uid, $name) {
$return = false;
@ -213,6 +220,7 @@ class Group extends BaseObject
* @param int $gid
* @param int $cid
* @return boolean
* @throws \Exception
*/
public static function addMember($gid, $cid)
{
@ -237,6 +245,7 @@ class Group extends BaseObject
* @param int $gid
* @param int $cid
* @return boolean
* @throws \Exception
*/
public static function removeMember($gid, $cid)
{
@ -250,14 +259,15 @@ class Group extends BaseObject
}
/**
* @brief Removes a contact from a group based on its name
* @brief Removes a contact from a group based on its name
*
* @deprecated Use Group::removeMember instead
*
* @param int $uid
* @param int $uid
* @param string $name
* @param int $cid
* @param int $cid
* @return boolean
* @throws \Exception
*/
public static function removeMemberByName($uid, $name, $cid)
{
@ -271,9 +281,10 @@ class Group extends BaseObject
/**
* @brief Returns the combined list of contact ids from a group id list
*
* @param array $group_ids
* @param array $group_ids
* @param boolean $check_dead
* @return array
* @throws \Exception
*/
public static function expand($group_ids, $check_dead = false)
{
@ -298,10 +309,11 @@ class Group extends BaseObject
/**
* @brief Returns a templated group selection list
*
* @param int $uid
* @param int $gid An optional pre-selected group
* @param int $uid
* @param int $gid An optional pre-selected group
* @param string $label An optional label of the list
* @return string
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
public static function displayGroupSelection($uid, $gid = 0, $label = '')
{
@ -342,12 +354,13 @@ class Group extends BaseObject
* @param string $every
* @param string $each
* @param string $editmode
* 'standard' => include link 'Edit groups'
* 'extended' => include link 'Create new group'
* 'full' => include link 'Create new group' and provide for each group a link to edit this group
* @param int $group_id
* @param int $cid
* 'standard' => include link 'Edit groups'
* 'extended' => include link 'Create new group'
* 'full' => include link 'Create new group' and provide for each group a link to edit this group
* @param string $group_id
* @param int $cid
* @return string
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
public static function sidebarWidget($every = 'contact', $each = 'group', $editmode = 'standard', $group_id = '', $cid = 0)
{