Menu
Home
Controls API
Components API
Tutorials
Templating
Global Functions
Website
\Components\Website\Designs
\Components\Website\Pages
\Components\Website\Pages\Forms
\Components\Website\Posts
\Components\Website\Posts\Categories
Customers
\Components\Customers\Contacts
\Components\Customers\Contacts\Relationships
\Components\Customers\Contacts\Relationships\Types
\Components\Customers\Groups
Marketing
\Components\Marketing\EmailMarketing
\Components\Marketing\Events
\Components\Marketing\Events\Attendees
\Components\Marketing\Events\Locations
Commerce
\Components\Commerce\Carts
\Components\Commerce\Carts\Current
\Components\Commerce\Configuration\PaymentMethods
\Components\Commerce\Configuration\ShippingMethods
\Components\Commerce\Discounts
\Components\Commerce\Products
\Components\Commerce\Products\Brands
\Components\Commerce\Products\Categories
\Components\Commerce\Products\Inventory
\Components\Commerce\Sales
\Components\Commerce\Sales\Items
\Components\Commerce\Sales\Receipts
\Components\Commerce\Sales\Receipts\Allocations
Settings
\Components\Settings\Administrators
\Components\Settings\Domains
Other Apps
\Components\Website\Comments
\Components\Commerce\Affiliates
\Components\Commerce\Affiliates\Administrators
\Components\Commerce\Affiliates\Commissions
\Components\Commerce\Affiliates\Payments
\Components\Commerce\RecurringSales
\Components\Commerce\RecurringSales\StoredCards
Framework
\Framework\Caching\FileBased
\Framework\Data\Util
\Framework\HTML\Converters
\Framework\HTTP\Cookies
\Framework\HTTP\Redirection
\Framework\HTTP\Request
\Framework\HTTP\Session
\Framework\HTTP\UserAgent
\Framework\I18N\CompanyTypes
\Framework\I18N\Countries
\Framework\I18N\Languages
\Framework\Network\GeoIP
Description
Methods
contactHasEditingRights()
get()
getAll()
getAllContactsInRelationshipWith()
getAllForContact()
getColumn()
getCount()
save()
saveColumn()
search()
delete()
Fields
\Components\Customers\Contacts\
Relationships::
Use this API to create, update and delete relationships between contacts.
Methods
Invoke via
\Components\Customers\Contacts\Relationships::method()
Click a method name to copy it.
boolean
contactHasEditingRights(
$iContactId1, $iContactId2
)
Determines if a contact 1 has editing rights over contact 2
Parameters
$iContactId1
int
$iContactId2
int
Return
boolean
array
get(
$iRelationshipId
)
Gets a record from the database
Parameters
$iRelationshipId
int unsigned
A record's relationship_id
Return
Relationships
array
getAll(
$arrQuery
)
Return a set of records from the database
Parameters
$arrQuery
array|null
Query Array
Return
Array of
Relationships
array
getAllContactsInRelationshipWith(
$iContactId, $strRelationshipTypeId
)
Retrieves all contacts who are in a direct relationship of type $strRelationshipTypeId with a specific contact
Parameters
$iContactId
int
$strRelationshipTypeId
string
Return
array
array
getAllForContact(
$iContactId, $strRelationshipType, $arrQuery
)
Retrieves all direct relationships for a specific contact
Parameters
$iContactId
int
$strRelationshipType
string|null
$arrQuery
array|null
Query Array
Return
Array of
Relationships
mixed
getColumn(
$iRelationshipId, $strColumn
)
Gets a single field from a record
Parameters
$iRelationshipId
int unsigned
A record's relationship_id
$strColumn
string
Return
mixed
int
getCount(
$arrFilter
)
Returns the number of records in the database (matching the filter if specified)
Parameters
$arrFilter
array|null
Filter Array
Return
int
int unsigned
save(
$arrEntity
)
Saves a record into the database
Parameters
$arrEntity
array
Return
The record's relationship_id
void
saveColumn(
$iRelationshipId, $strColumn, $strValue
)
Saves a specific column of a row into a database
Parameters
$iRelationshipId
int unsigned
A record's relationship_id
$strColumn
string
$strValue
string
array
search(
$strSearch, $arrQuery
)
Performs a search
Parameters
$strSearch
string
Search query
$arrQuery
array|null
Query Array
Return
Array of
Relationships
that match the search query.
bool
delete(
$iRelationshipId, $bDeleteMedia
)
Deletes a record from the database
Parameters
$iRelationshipId
int unsigned
A record's relationship_id
$bDeleteMedia
bool
Return
Returns true if record existed and was deleted, otherwise false
Database Fields
The following fields are used when retrieving and saving entities.
relationship_id
int unsigned (10)
contact_id_1
int (10)
contact_id_2
int (10)
contact1_can_edit_contact2
0 or 1
contact2_can_edit_contact1
0 or 1
relationship_type_id
string (255)