Inheritance diagram for BxDolConnection:

Public Member Functions
	init ()
	getType ()
	getTable ()
	isProfileInitiator ()
	isProfileContent ()
	checkAllowedConnect ($iInitiator, $iContent, $isPerformAction=false, $isMutual=false, $isInvertResult=false, $isSwap=false, $isCheckExists=true)
	checkAllowedAddConnection ($iInitiator, $iContent, $isPerformAction=false, $isMutual=false, $isInvertResult=false, $isSwap=false, $isCheckExists=true)
	checkAllowedRemoveConnection ($iInitiator, $iContent, $isPerformAction=false, $isMutual=false, $isInvertResult=false, $isSwap=false, $isCheckExists=true)
	actionAdd ($iContent=0, $iInitiator=false)
	actionRemove ($iContent=0, $iInitiator=false)
	actionReject ($iContent=0, $iInitiator=false)
	outputActionResult ($mixed, $sFormat='json')
	addConnection ($iInitiator, $iContent, $aParams=array())
	onAdded ($iInitiator, $iContent, $iMutual)
	removeConnection ($iInitiator, $iContent)
	onRemoved ($iInitiator, $iContent, $iMutual)
	getConnectionsAsArray ($sContentType, $iId1, $iId2, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getCommonContent ($iInitiator1, $iInitiator2, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getCommonContentCount ($iInitiator1, $iInitiator2, $isMutual=false)
	getConnectedContentCount ($iInitiator, $isMutual=false, $iFromDate=0)
	getConnectedContentCountExt ($iInitiator, $isMutual=false, $aParams=[])
	getConnectedInitiatorsCount ($iContent, $isMutual=false)
	getConnectedContent ($iInitiator, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getConnectedContentByType ($iInitiator, $mixedType, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getConnectedContentSince ($iInitiator, $iDate, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getConnectedInitiators ($iContent, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getConnectedInitiatorsByType ($iContent, $mixedType, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getConnectedInitiatorsSince ($iContent, $iDate, $isMutual=false, $iStart=0, $iLimit=BX_CONNECTIONS_LIST_LIMIT, $iOrder=BX_CONNECTIONS_ORDER_NONE)
	getConnectionsAsSQLParts ($sContentType, $sContentTable, $sContentField, $iId1, $iId2, $isMutual=false)
	getCommonContentAsSQLParts ($sContentTable, $sContentField, $iInitiator1, $iInitiator2, $isMutual=false)
	getConnectedContentAsSQLParts ($sContentTable, $sContentField, $iInitiator, $isMutual=false)
	getConnectedContentAsSQLPartsExt ($sContentTable, $sContentField, $iInitiator, $isMutual=false)
	getConnectedContentAsSQLPartsMultiple ($sContentTable, $sContentField, $sInitiatorTable, $sInitiatorField, $isMutual=false)
	getConnectedInitiatorsAsSQLParts ($sInitiatorTable, $sInitiatorField, $iContent, $isMutual=false)
	getConnectedInitiatorsAsSQLPartsMultiple ($sInitiatorTable, $sInitiatorField, $sContentTable, $sContentField, $isMutual=false)
	getConnectionsAsCondition ($sContentType, $sContentField, $iId1, $iId2, $isMutual=false)
	getCommonContentAsCondition ($sContentField, $iInitiator1, $iInitiator2, $iMutual=false)
	getConnectedContentAsCondition ($sContentField, $iInitiator, $iMutual=false)
	getConnectedInitiatorsAsCondition ($sContentField, $iContent, $iMutual=false)
	isConnected ($iInitiator, $iContent, $isMutual=false)
	isConnectedNotMutual ($iInitiator, $iContent)
	getConnection ($iInitiator, $iContent)
	getConnectionById ($iId)
	onDeleteInitiatorAndContent ($iId)
	onDeleteInitiator ($iIdInitiator)
	onDeleteContent ($iIdContent)
	onModuleDeleteInitiatorAndContent ($sTable, $sFieldId)
	onModuleDeleteInitiator ($sTable, $sFieldId)
	onModuleDeleteContent ($sTable, $sFieldId)
	onModuleProfileDeleteInitiatorAndContent ($sModuleName)
	onModuleProfileDeleteInitiator ($sModuleName)
	onModuleProfileDeleteContent ($sModuleName)

Static Public Member Functions
static	getObjectInstance ($sObject)

Protected Member Functions
	__construct ($aObject)
	_action ($iInitiator, $iContent, $sMethod, $sErrorKey, $isMutual=false, $isInvert=false)
	_checkAllowedConnect ($iInitiator, $iContent, $isPerformAction=false, $isMutual=false, $isInvertResult=false, $isSwap=false, $isCheckExists=true)
	_checkAllowedConnectInitiator ($oInitiator, $isPerformAction=false)
	_checkAllowedConnectContent ($oContent)
	_isTriggerable ($mixedMutual)
	_updateTriggerValue ($iInitiator, $iContent, $iValue)
	_getTriggerValueByContentType ($sContentType, $iParticipantId)
	_getTriggerObject ($sType, $iInitiator, $iContent)

Protected Attributes
	$_oQuery
	$_sObject
	$_aObject
	$_iInitiator
	$_iContent
	$_sType
	$_bMutual
	$_aTriggerTypes

Detailed Description

Connection is usefull when you need to organize some sorts of connections between different content, for example: friends, contacts, favorites, block lists, subscriptions, etc.

Two types of connections are supported one way connections (block list, favourites) and mutual (friends).

For automatic handling of connections (like, add/remove connection in frontend) refer to JS function:

See also: bx_conn_action()

Creating the Connection object:

Step 1: Add record to 'sys_objects_connection' table:

object: name of the connection object, in the format: vendor prefix, underscore, module prefix, underscore, internal identifier or nothing; for example: bx_blogs_favorites - favorite blogs for users in blogs module.
table: table name with connections, see step 2
type: 'one-way' or 'mutual'
override_class_name: user defined class name which is derived from one of base classes.
override_class_file: the location of the user defined class, leave it empty if class is located in system folders.

Step 2: Create table for connections:

CREATE TABLE `my_sample_connections` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `initiator` int(11) NOT NULL,
  `content` int(11) NOT NULL,
  `mutual` tinyint(4) NOT NULL, -- can re removed for one-way connections
  `added` int(10) unsigned NOT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `initiator` (`initiator`,`content`),
  KEY `content` (`content`)
)

Example of usage

Check if two profiles are friends:

$oConnectionFriends = BxDolConnection::getObjectInstance('bx_profiles_friends'); // get friends connections object
if ($oConnectionFriends) // check if connections is available for using
   echo $oConnectionFriends->isConnected (100, 200, true) ? "100 and 200 are friends" : "100 and 200 aren't friends"; // check if profiles with IDs 100 and 200 have mutual connections

Get mutual content IDs (friends IDs)

$oConnectionFriends = BxDolConnection::getObjectInstance('bx_profiles_friends'); // get friends connections object
if ($oConnectionFriends) // check if connections is available for using
    print_r($oConnection->getConnectedContent(100, 1)); // print array of friends IDs of 100's profile

Constructor & Destructor Documentation

◆ __construct()

BxDolConnection::__construct ( $aObject )

protected

Constructor

Parameters

$aObject array of connection options

Reimplemented in BxBaseConnection, BxBaseConnectionFriend, BxBaseConnectionRelation, BxBaseConnectionSubscription, BxBaseModGroupsConnectionFans, BxCoursesConnectionFans, BxDolConnectionBan, BxDolConnectionFriend, BxDolConnectionRelation, BxDolConnectionSubscription, BxEventsConnectionFans, BxGroupsConnectionFans, BxJobsConnectionFans, BxOrgsConnectionFans, BxSpacesConnectionFans, BxTemplConnection, BxTemplConnectionFriend, BxTemplConnectionRelation, and BxTemplConnectionSubscription.

Member Function Documentation

◆ _getTriggerObject()

BxDolConnection::_getTriggerObject	(	$sType,
		$iInitiator,
		$iContent )

protected

Should be overwritten in Connection class which uses triggerable fields.

Reimplemented in BxBaseModGroupsConnectionFans.

◆ actionAdd()

BxDolConnection::actionAdd	(		$iContent = 0,
			$iInitiator = false )

Add new connection.

Parameters

$iContent content to make connection to, in most cases some content id, or other profile id in case of friends

Returns: array

Reimplemented in BxDolConnectionRelation.

◆ actionReject()

BxDolConnection::actionReject	(		$iContent = 0,
			$iInitiator = false )

Reject connection request. This method is wrapper for

See also: removeConnection to be called from; conn.php upon AJAX request to this file.

Parameters

$iContent content to make connection to, in most cases some content id, or other profile id in case of friends

Returns: array

Reimplemented in BxBaseModGroupsConnectionFans.

◆ actionRemove()

BxDolConnection::actionRemove	(		$iContent = 0,
			$iInitiator = false )

Remove connection. This method is wrapper for

See also: removeConnection to be called from; conn.php upon AJAX request to this file.

Parameters

$iContent content to make connection to, in most cases some content id, or other profile id in case of friends

Returns: array

Reimplemented in BxBaseModGroupsConnectionFans, and BxDolConnectionRelation.

◆ addConnection()

BxDolConnection::addConnection	(	$iInitiator,
		$iContent,
		$aParams = array() )

Add new connection.

Parameters

$iInitiator	initiator of the connection, in most cases some profile id
$iContent	content to make connection to, in most cases some content id, or other profile id in case of friends

Returns: true - if connection was added, false - if connection already exists or error occured

Hooks:

'{object_name}', 'connection_before_add' - hook before connection was added. Connection params can be overridden

$unit_name - connection object name
$action - equals connection_before_add
$object_id - not used
$sender_id - logged in profile id
$extra_params - array of additional params with the following array keys:
- initiator - [int] by ref, profile id who is creating the connection, can be overridden in hook processing
- content - [int] by ref, profile id with whom the connection is creating, can be overridden in hook processing
- mutual - [int] by ref, if the relation is mutual or not, can be overridden in hook processing
- object - [object] an instance of connection object,
  See also
  BxDolConnection
- object_name - [string] connection object name
- override_result - [boolean] by ref, stop adding and return specified result
  HOOKS
  '{object_name}', 'connection_before_add' - hook before connection was added. Connection params can be overridden

Hooks:

'{object_name}', 'connection_added' - hook after connection was added. Connection params can be overridden

It's equivalent to '{object_name}', 'connection_before_add' - hook before connection was added. Connection params can be overridden

HOOKS: '{object_name}', 'connection_added' - hook after connection was added. Connection params can be overridden

Reimplemented in BxDolConnectionBan, and BxDolConnectionRelation.

◆ checkAllowedConnect()

BxDolConnection::checkAllowedConnect	(	$iInitiator,
		$iContent,
		$isPerformAction = false,
		$isMutual = false,
		$isInvertResult = false,
		$isSwap = false,
		$isCheckExists = true )

Check whether connection between Initiator and Content can be established.

Reimplemented in BxDolConnectionRelation.

◆ getCommonContent()

BxDolConnection::getCommonContent	(	$iInitiator1,
		$iInitiator2,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Get common content IDs between two initiators

Parameters

$iInitiator1	one initiator
$iInitiator2	second initiator
$isMutual	get mutual connections only

Returns: array of available connections

◆ getCommonContentAsCondition()

BxDolConnection::getCommonContentAsCondition	(	$sContentField,
		$iInitiator1,
		$iInitiator2,
		$iMutual = false )

Get necessary condition array to use connections in search classes

Parameters

$sContentField	content table field name
$iInitiator	initiator of the connection
$iMutual	get mutual connections only

Returns: array of conditions, for now with 'restriction' and 'join' parts

◆ getCommonContentAsSQLParts()

BxDolConnection::getCommonContentAsSQLParts	(	$sContentTable,
		$sContentField,
		$iInitiator1,
		$iInitiator2,
		$isMutual = false )

Get necessary parts of SQL query to use connections in other queries

Parameters

$sContentTable	content table or alias
$sContentField	content table field or field alias
$iInitiator	initiator of the connection
$isMutual	get mutual connections only

Returns: array of SQL string parts, for now 'join' part only is returned

◆ getCommonContentCount()

BxDolConnection::getCommonContentCount	(	$iInitiator1,
		$iInitiator2,
		$isMutual = false )

Get common content count between two initiators

Parameters

$iInitiator1	one initiator
$iInitiator2	second initiator
$isMutual	get mutual connections only

Returns: number of connections

◆ getConnectedContent()

BxDolConnection::getConnectedContent	(	$iInitiator,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Get connected content IDs

Parameters

$iInitiator	initiator of the connection
$isMutual	get mutual connections only

Returns: array of available connections

◆ getConnectedContentAsCondition()

BxDolConnection::getConnectedContentAsCondition	(	$sContentField,
		$iInitiator,
		$iMutual = false )

Get necessary condition array to use connections in search classes

Parameters

$sContentField	content table field name
$iInitiator	initiator of the connection
$iMutual	get mutual connections only

Returns: array of conditions, for now with 'restriction' and 'join' parts

Reimplemented in BxJobsConnectionFans.

◆ getConnectedContentAsSQLParts()

BxDolConnection::getConnectedContentAsSQLParts	(	$sContentTable,
		$sContentField,
		$iInitiator,
		$isMutual = false )

Get necessary parts of SQL query to use connections in other queries

Parameters

$sContentTable	content table or alias
$sContentField	content table field or field alias
$iInitiator	initiator of the connection
$isMutual	get mutual connections only

Returns: array of SQL string parts, for now 'join' part only is returned

◆ getConnectedContentAsSQLPartsMultiple()

BxDolConnection::getConnectedContentAsSQLPartsMultiple	(	$sContentTable,
		$sContentField,
		$sInitiatorTable,
		$sInitiatorField,
		$isMutual = false )

Get necessary parts of SQL query to use connections in other queries

Parameters

$sContentTable	content table or alias
$sContentField	content table field or field alias
$sInitiatorTable	initiator table or alias
$sInitiatorField	initiator table field or field alias
$iInitiator	initiator of the connection
$isMutual	get mutual connections only

Returns: array of SQL string parts, for now 'join' part only is returned

◆ getConnectedContentByType()

BxDolConnection::getConnectedContentByType	(	$iInitiator,
		$mixedType,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Get connected content IDs for specified type

Parameters

$iInitiator	initiator of the connection
$mixedType	type of content or an array of types
$isMutual	get mutual connections only

Returns: array of available connections

◆ getConnectedContentCount()

BxDolConnection::getConnectedContentCount	(	$iInitiator,
		$isMutual = false,
		$iFromDate = 0 )

Get connected content count

Parameters

$iInitiator	initiator of the connection
$isMutual	get mutual connections only

Returns: number of connections

◆ getConnectedContentCountExt()

BxDolConnection::getConnectedContentCountExt	(	$iInitiator,
		$isMutual = false,
		$aParams = [] )

Get connected content count

Parameters

$iInitiator	initiator of the connection
$isMutual	get mutual connections only
$aParams	additional params

Returns: number of connections

◆ getConnectedContentSince()

BxDolConnection::getConnectedContentSince	(	$iInitiator,
		$iDate,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Get connected content IDs for specified type

Parameters

$iInitiator	initiator of the connection
$iDate	get connections appeared since this date
$isMutual	get mutual connections only

Returns: array of available connections

◆ getConnectedInitiators()

BxDolConnection::getConnectedInitiators	(	$iContent,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Get connected initiators IDs

Parameters

$iContent	content of the connection
$isMutual	get mutual connections only

Returns: array of available connections

Reimplemented in BxJobsConnectionFans.

◆ getConnectedInitiatorsAsCondition()

BxDolConnection::getConnectedInitiatorsAsCondition	(	$sContentField,
		$iContent,
		$iMutual = false )

Get necessary condition array to use connections in search classes

Parameters

$sContentField	content table field name
$iInitiator	initiator of the connection
$iMutual	get mutual connections only

Returns: array of conditions, for now with 'restriction' and 'join' parts

◆ getConnectedInitiatorsAsSQLParts()

BxDolConnection::getConnectedInitiatorsAsSQLParts	(	$sInitiatorTable,
		$sInitiatorField,
		$iContent,
		$isMutual = false )

Get necessary parts of SQL query to use connections in other queries

Parameters

$sInitiatorTable	initiator table or alias
$sInitiatorField	initiator table field or field alias
$iContent	content of the connection
$isMutual	get mutual connections only

Returns: array of SQL string parts, for now 'join' part only is returned

◆ getConnectedInitiatorsAsSQLPartsMultiple()

BxDolConnection::getConnectedInitiatorsAsSQLPartsMultiple	(	$sInitiatorTable,
		$sInitiatorField,
		$sContentTable,
		$sContentField,
		$isMutual = false )

Get necessary parts of SQL query to use connections in other queries

Parameters

$sInitiatorTable	initiator table or alias
$sInitiatorField	initiator table field or field alias
$sContentTable	content table or alias
$sContentField	content table field or field alias
$isMutual	get mutual connections only

Returns: array of SQL string parts, for now 'join' part only is returned

◆ getConnectedInitiatorsByType()

BxDolConnection::getConnectedInitiatorsByType	(	$iContent,
		$mixedType,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Get connected initiators IDs

Parameters

$iContent	content of the connection
$mixedType	type of content or an array of types
$isMutual	get mutual connections only

Returns: array of available connections

◆ getConnectedInitiatorsCount()

BxDolConnection::getConnectedInitiatorsCount	(		$iContent,
			$isMutual = false )

Get connected initiators count

Parameters

$iContent	content of the connection
$isMutual	get mutual connections only

Returns: number of connections

Reimplemented in BxJobsConnectionFans.

◆ getConnectedInitiatorsSince()

BxDolConnection::getConnectedInitiatorsSince	(	$iContent,
		$iDate,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Get connected initiators IDs

Parameters

$iContent	content of the connection
$iDate	get connections appeared since this date
$isMutual	get mutual connections only

Returns: array of available connections

◆ getConnectionsAsArray()

BxDolConnection::getConnectionsAsArray	(	$sContentType,
		$iId1,
		$iId2,
		$isMutual = false,
		$iStart = 0,
		$iLimit = BX_CONNECTIONS_LIST_LIMIT,
		$iOrder = BX_CONNECTIONS_ORDER_NONE )

Compound function, which calls getCommonContent, getConnectedContent or getConnectedInitiators depending on $sContentType

Parameters

$sContentType	content type to get BX_CONNECTIONS_CONTENT_TYPE_CONTENT, BX_CONNECTIONS_CONTENT_TYPE_INITIATORS or BX_CONNECTIONS_CONTENT_TYPE_COMMON
$iId1	one content or initiator
$iId2	second content or initiator only in case of BX_CONNECTIONS_CONTENT_TYPE_COMMON content type
$isMutual	get mutual connections only

Returns: array of available connections

◆ getConnectionsAsCondition()

BxDolConnection::getConnectionsAsCondition	(	$sContentType,
		$sContentField,
		$iId1,
		$iId2,
		$isMutual = false )

Similar to getConnectionsAsArray, but for getCommonContentAsCondition, getConnectedContentAsCondition or getConnectedInitiatorsAsCondition methods

See also: getConnectionsAsArray

◆ getConnectionsAsSQLParts()

BxDolConnection::getConnectionsAsSQLParts	(	$sContentType,
		$sContentTable,
		$sContentField,
		$iId1,
		$iId2,
		$isMutual = false )

Similar to getConnectionsAsArray, but for getCommonContentAsSQLParts, getConnectedContentAsSQLParts or getConnectedInitiatorsAsSQLParts methods

See also: getConnectionsAsArray

◆ getObjectInstance()

BxDolConnection::getObjectInstance ( $sObject )

static

Get connection object instance by object name

Parameters

$sObject object name

Returns: object instance or false on error

Implements iBxDolFactoryObject.

◆ getTable()

BxDolConnection::getTable ( )

Get connection table. return string with table name.

◆ getType()

BxDolConnection::getType ( )

Get connection type. return BX_CONNECTIONS_TYPE_ONE_WAY or BX_CONNECTIONS_TYPE_MUTUAL

◆ init()

BxDolConnection::init ( )

Init something here if it's needed.

Reimplemented in BxBaseModGroupsConnectionFans.

◆ isConnected()

BxDolConnection::isConnected	(	$iInitiator,
		$iContent,
		$isMutual = false )

Check if initiator and content are connected. In case if friends this function in conjunction with isMutual parameter can be used to check pending friend requests.

Parameters

$iInitiator	initiator of the connection
$iContent	connected content or other profile id in case of friends

Returns: true - if content and initiator are connected or false - in all other cases

◆ isConnectedNotMutual()

BxDolConnection::isConnectedNotMutual	(		$iInitiator,
			$iContent )

Check if initiator and content are connected but connetion is not mutual, for checking pending connection requests. This method makes sense only when type of connection is mutual.

Parameters

$iInitiator	initiator of the connection
$iContent	connected content or other profile id in case of friends

Returns: true - if content and initiator are connected but connection is not mutual or false in all other cases

◆ isProfileContent()

BxDolConnection::isProfileContent ( )

Checks whether connection's Content is profile or not. return boolean.

◆ isProfileInitiator()

BxDolConnection::isProfileInitiator ( )

Checks whether connection's Initiator is profile or not. return boolean.

◆ onAdded()

BxDolConnection::onAdded	(	$iInitiator,
		$iContent,
		$iMutual )

Call socket.

Update recommendations.

◆ onDeleteContent()

BxDolConnection::onDeleteContent ( $iIdContent )

Must be called when some content is deleted which can have connections as 'content', to delete any associated data

Parameters

$iIdInitiator initiator id

Returns: true if some connections were deleted

Hooks:

'{object_name}', 'connection_removed_all' - hook after all connections with deleted 'initiator' were removed.

$unit_name - connection object name
$action - equals connection_removed_all
$object_id - not used
$sender_id - logged in profile id
$extra_params - array of additional params with the following array keys:
- content - [int] profile id with whom the connection was created
- object - [object] an instance of relation,
  See also
  BxDolConnection
  
  HOOKS
  '{object_name}', 'connection_removed_all' - hook after all connections with deleted 'initiator' were removed.

◆ onDeleteInitiator()

BxDolConnection::onDeleteInitiator ( $iIdInitiator )

Must be called when some content is deleted which can have connections as 'initiator', to delete any associated data

Parameters

$iIdInitiator initiator id

Returns: true if some connections were deleted

Hooks:

'{object_name}', 'connection_removed_all' - hook after all connections with deleted 'initiator' were removed.

$unit_name - connection object name
$action - equals connection_removed_all
$object_id - not used
$sender_id - logged in profile id
$extra_params - array of additional params with the following array keys:
- initiator - [int] profile id who created the connection
- object - [object] an instance of relation,
  See also
  BxDolConnection
  
  HOOKS
  '{object_name}', 'connection_removed_all' - hook after all connections with deleted 'initiator' were removed.

◆ onDeleteInitiatorAndContent()

BxDolConnection::onDeleteInitiatorAndContent ( $iId )

Must be called when some content is deleted which can have connections as 'content' or as 'initiator', to delete any associated data

Parameters

$iId	which can be as conetnt ot initiator

Returns: true if some connections were deleted

◆ onModuleDeleteContent()

BxDolConnection::onModuleDeleteContent	(		$sTable,
			$sFieldId )

Must be called when module (which can have connections as 'content') is deleted, to delete any associated data. This method call may be automated via

See also: BxBaseModGeneralInstaller::_aConnections property.

Parameters

$sTable	table name with data which have assiciations with the connection
$sFieldId	id field name which is associated with the connection

Returns: number of deleted connections

◆ onModuleDeleteInitiator()

BxDolConnection::onModuleDeleteInitiator	(		$sTable,
			$sFieldId )

Must be called when module (which can have connections as 'initiator') is deleted, to delete any associated data. This method call may be automated via

See also: BxBaseModGeneralInstaller::_aConnections property.

Parameters

$sTable	table name with data which have assiciations with the connection
$sFieldId	id field name which is associated with the connection

Returns: number of deleted connections

◆ onModuleDeleteInitiatorAndContent()

BxDolConnection::onModuleDeleteInitiatorAndContent	(		$sTable,
			$sFieldId )

Must be called when module (which can have connections as 'content' or as 'initiator') is deleted, to delete any associated data. This method call may be automated via

See also: BxBaseModGeneralInstaller::_aConnections property.

Parameters

$sTable	table name with data which have assiciations with the connection
$sFieldId	id field name which is associated with the connection

Returns: number of deleted connections

◆ onModuleProfileDeleteContent()

BxDolConnection::onModuleProfileDeleteContent ( $sModuleName )

Must be called when module (which can have connections as 'content' with 'sys_profiles' table) is deleted, to delete any associated data. This method call may be automated via

See also: BxBaseModGeneralInstaller::_aConnections property.

Parameters

$sModuleName module name to delete connections for

Returns: number of deleted connections

◆ onModuleProfileDeleteInitiator()

BxDolConnection::onModuleProfileDeleteInitiator ( $sModuleName )

Must be called when module (which can have connections as 'initiator' with 'sys_profiles' table) is deleted, to delete any associated data. This method call may be automated via

See also: BxBaseModGeneralInstaller::_aConnections property.

Parameters

$sModuleName module name to delete connections for

Returns: number of deleted connections

◆ onModuleProfileDeleteInitiatorAndContent()

BxDolConnection::onModuleProfileDeleteInitiatorAndContent ( $sModuleName )

Must be called when module (which can have connections as 'content' or as 'initiator' with 'sys_profiles' table) is deleted, to delete any associated data. This method call may be automated via

See also: BxBaseModGeneralInstaller::_aConnections property.

Parameters

$sModuleName module name to delete connections for

Returns: number of deleted connections

◆ onRemoved()

BxDolConnection::onRemoved	(	$iInitiator,
		$iContent,
		$iMutual )

Call socket.

◆ removeConnection()

BxDolConnection::removeConnection	(		$iInitiator,
			$iContent )

Remove connection.

Parameters

$iInitiator	initiator of the connection
$iContent	connected content or other profile id in case of friends

Returns: true - if connection was removed, false - if connection isn't exist or error occured

Hooks:

'{object_name}', 'connection_before_remove' - hook before connection was removed. Connection params can be overridden

$unit_name - connection object name
$action - equals connection_before_remove
$object_id - not used
$sender_id - logged in profile id
$extra_params - array of additional params with the following array keys:
- initiator - [int] by ref, profile id who is removing the connection, can be overridden in hook processing
- content - [int] by ref, profile id with whom the connection is removing, can be overridden in hook processing
- mutual - [int] by ref, if the relation is mutual or not, can be overridden in hook processing
- object - [object] an instance of relation,
  See also
  BxDolConnection
  
  HOOKS
  '{object_name}', 'connection_before_remove' - hook before connection was removed. Connection params can be overridden

Hooks:

'{object_name}', 'connection_removed' - hook after a connection was removed.

It's equivalent to '{object_name}', 'connection_before_remove' - hook before connection was removed. Connection params can be overridden

HOOKS: '{object_name}', 'connection_removed' - hook after a connection was removed.

The documentation for this class was generated from the following file:

inc/classes/BxDolConnection.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Creating the Connection object:

Example of usage

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _getTriggerObject()

◆ actionAdd()

◆ actionReject()

◆ actionRemove()

◆ addConnection()

Hooks:

'{object_name}', 'connection_before_add' - hook before connection was added. Connection params can be overridden

Hooks:

'{object_name}', 'connection_added' - hook after connection was added. Connection params can be overridden

◆ checkAllowedConnect()

◆ getCommonContent()

◆ getCommonContentAsCondition()

◆ getCommonContentAsSQLParts()

◆ getCommonContentCount()

◆ getConnectedContent()

◆ getConnectedContentAsCondition()

◆ getConnectedContentAsSQLParts()

◆ getConnectedContentAsSQLPartsMultiple()

◆ getConnectedContentByType()

◆ getConnectedContentCount()

◆ getConnectedContentCountExt()

◆ getConnectedContentSince()

◆ getConnectedInitiators()

◆ getConnectedInitiatorsAsCondition()

◆ getConnectedInitiatorsAsSQLParts()

◆ getConnectedInitiatorsAsSQLPartsMultiple()

◆ getConnectedInitiatorsByType()

◆ getConnectedInitiatorsCount()

◆ getConnectedInitiatorsSince()

◆ getConnectionsAsArray()

◆ getConnectionsAsCondition()

◆ getConnectionsAsSQLParts()

◆ getObjectInstance()

◆ getTable()

◆ getType()

◆ init()

◆ isConnected()

◆ isConnectedNotMutual()

◆ isProfileContent()

◆ isProfileInitiator()

◆ onAdded()

◆ onDeleteContent()

Hooks:

'{object_name}', 'connection_removed_all' - hook after all connections with deleted 'initiator' were removed.

◆ onDeleteInitiator()

Hooks:

'{object_name}', 'connection_removed_all' - hook after all connections with deleted 'initiator' were removed.

◆ onDeleteInitiatorAndContent()

◆ onModuleDeleteContent()

◆ onModuleDeleteInitiator()

◆ onModuleDeleteInitiatorAndContent()

◆ onModuleProfileDeleteContent()

◆ onModuleProfileDeleteInitiator()

◆ onModuleProfileDeleteInitiatorAndContent()

◆ onRemoved()

◆ removeConnection()

Hooks:

'{object_name}', 'connection_before_remove' - hook before connection was removed. Connection params can be overridden

Hooks:

'{object_name}', 'connection_removed' - hook after a connection was removed.