Documentation

Folks_Friends
in package

Folks_Friends:: defines an API for implementing storage backends for Friends.

Copyright Obala d.o.o. (www.obala.si)

See the enclosed file LICENSE for license information (GPL). If you did not receive this file, see http://www.horde.org/licenses/gpl.

Tags
author

Duck duck@obala.net

Table of Contents

$_cache  : Horde_Cache
String cache reference
$_params  : array<string|int, mixed>
Hash containing connection parameters.
$_user  : string
String containing user
$instances  : mixed
Friends instances
addBlacklisted()  : mixed
Add user to a blacklist list
addFriend()  : mixed
Add user to a friend list
approveFriend()  : mixed
Approve our friend to add us to his userlist
friendOf()  : array<string|int, mixed>
Get users who have us on their friendlist
getBlacklist()  : array<string|int, mixed>
Get user blacklist
getFriends()  : array<string|int, mixed>
Get user friends
getGroupOwner()  : mixed
Get user owning group
getGroups()  : mixed
Get user groups
getPossibleFriends()  : array<string|int, mixed>
Return all friends of out frends and make a top list of common users
hasCapability()  : bool
Queries the current object to find out if it supports the given capability.
isBlacklisted()  : bool
Check if user is on blacklist
isFriend()  : bool
Check if user is on blacklist
needsApproval()  : bool
Check if a users requies his approval to be added as a friend
removeBlacklisted()  : mixed
Remove user from blacklist list
removeFriend()  : mixed
Remove user from a fiend list
sendNotification()  : bool
Send user a nofication or approve request
singleton()  : mixed
Singleton for driver object
waitingApprovalFor()  : mixed
User that we do not confirm them user yet
waitingApprovalFrom()  : mixed
Get friends that does not confirm the current user yet
__construct()  : mixed
Construct object
_approveFriend()  : mixed
Approve our friend to add us to his userlist
_getAdmins()  : mixed
Get administartor usernames
factory()  : Folks_Friends
Attempts to return a concrete Folks_Friends instance based on $friends.

Properties

$_cache

String cache reference

protected Horde_Cache $_cache

$_params

Hash containing connection parameters.

protected array<string|int, mixed> $_params = array()

$_user

String containing user

protected string $_user

$instances

Friends instances

private static mixed $instances = array()

Methods

addBlacklisted()

Add user to a blacklist list

public addBlacklisted(string $user) : mixed
Parameters
$user : string

Usersame

Return values
mixed

addFriend()

Add user to a friend list

public addFriend(string $friend[, string $group = null ]) : mixed
Parameters
$friend : string

Friend's usersame

$group : string = null

Group to add friend to

Return values
mixed

approveFriend()

Approve our friend to add us to his userlist

public approveFriend(string $friend) : mixed
Parameters
$friend : string

Friend username

Return values
mixed

friendOf()

Get users who have us on their friendlist

public friendOf() : array<string|int, mixed>
Return values
array<string|int, mixed>

users

getBlacklist()

Get user blacklist

public getBlacklist() : array<string|int, mixed>
Return values
array<string|int, mixed>

of users blacklist

getFriends()

Get user friends

public getFriends([string $group = null ]) : array<string|int, mixed>
Parameters
$group : string = null

Get friens only from this group

Return values
array<string|int, mixed>

of users (in group)

getGroupOwner()

Get user owning group

public getGroupOwner(mixed $group) : mixed
Parameters
$group : mixed
Return values
mixed

getGroups()

Get user groups

public getGroups() : mixed
Return values
mixed

getPossibleFriends()

Return all friends of out frends and make a top list of common users

public getPossibleFriends(int $limit) : array<string|int, mixed>
Parameters
$limit : int

Users

Return values
array<string|int, mixed>

users

hasCapability()

Queries the current object to find out if it supports the given capability.

public hasCapability(string $capability) : bool
Parameters
$capability : string

The capability to test for.

Return values
bool

Whether or not the capability is supported.

isBlacklisted()

Check if user is on blacklist

public isBlacklisted(string $user) : bool
Parameters
$user : string

User to check

Return values
bool

isFriend()

Check if user is on blacklist

public isFriend(string $user) : bool
Parameters
$user : string

User to check

Return values
bool

needsApproval()

Check if a users requies his approval to be added as a friend

public needsApproval(string $user) : bool
Parameters
$user : string

Usersame

Return values
bool

removeBlacklisted()

Remove user from blacklist list

public removeBlacklisted(string $user) : mixed
Parameters
$user : string

Usersame

Return values
mixed

removeFriend()

Remove user from a fiend list

public removeFriend(string $friend[, string $group = null ]) : mixed
Parameters
$friend : string

Friend's usersame

$group : string = null

Group to remove friend from

Return values
mixed

sendNotification()

Send user a nofication or approve request

public sendNotification(string $user, string $title, string $body) : bool
Parameters
$user : string

Usersame

$title : string

Title of notification

$body : string

Content of notification

Return values
bool

singleton()

Singleton for driver object

public static singleton([mixed $driver = null ][, array<string|int, mixed> $params = null ]) : mixed
Parameters
$driver : mixed = null
$params : array<string|int, mixed> = null

A hash containing any additional configuration or connection parameters a subclass might need.

Return values
mixed

waitingApprovalFor()

User that we do not confirm them user yet

public waitingApprovalFor() : mixed
Return values
mixed

waitingApprovalFrom()

Get friends that does not confirm the current user yet

public waitingApprovalFrom() : mixed
Return values
mixed

__construct()

Construct object

protected __construct(array<string|int, mixed> $params) : mixed
Parameters
$params : array<string|int, mixed>

A hash containing any additional configuration or connection parameters a subclass might need.

Return values
mixed

_approveFriend()

Approve our friend to add us to his userlist

protected _approveFriend(string $friend) : mixed
Parameters
$friend : string

Friedn username

Return values
mixed

_getAdmins()

Get administartor usernames

private _getAdmins() : mixed
Return values
mixed

factory()

Attempts to return a concrete Folks_Friends instance based on $friends.

private static factory([mixed $driver = null ][, array<string|int, mixed> $params = null ]) : Folks_Friends
Parameters
$driver : mixed = null
$params : array<string|int, mixed> = null

A hash containing any additional configuration or connection parameters a subclass might need.

Return values
Folks_Friends

The newly created concrete Folks_Friends instance, or false on an error.

Search results