Menu
Home
Controls API
Components API
Tutorials
Templating
Global Functions
Website
\Components\Website\Designs
\Components\Website\Media
\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\Categories
\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\CustomFields
\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
\Framework\Data\Util
\Framework\HTML\Bleacher
\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
addContactToGroup()
delete()
get()
getAll()
getAllForContact()
getAllIdsForContact()
getChildren()
getColumn()
getContactsInGroup()
getContactsInGroupCount()
getCount()
isContactInGroup()
removeContactFromGroup()
save()
saveColumn()
search()
Fields
\Components\Customers\
Groups::
Use this API to create, update and delete groups; and manage their contacts.
Methods
Invoke via
\Components\Customers\Groups::method()
Click a method name to copy it.
void
addContactToGroup(
$iContactId, $arrGroupIds
)
Adds a contact to a group
Parameters
$iContactId
mixed
$arrGroupIds
mixed
bool
delete(
$strGroupId, $bDeleteMedia
)
Deletes a record from the database
Parameters
$strGroupId
string
A record's group_id
$bDeleteMedia
mixed
Return
Returns true if record existed and was deleted, otherwise false
array
get(
$strGroupId
)
Gets a record from the database
Parameters
$strGroupId
string
A record's group_id
Return
Groups
array
getAll(
$arrQuery
)
Return a set of records from the database
Parameters
$arrQuery
mixed
Return
Array of
Groups
array
getAllForContact(
$iContactId, $arrQuery
)
Returns all groups for a contact
Parameters
$iContactId
mixed
$arrQuery
mixed
Return
Array of
Groups
array
getAllIdsForContact(
$iContactId
)
Returns all group ids for a contact
Parameters
$iContactId
mixed
Return
array
array
getChildren(
$strGroupId, $arrQuery
)
Returns all groups nested directly under a group
Parameters
$strGroupId
mixed
$arrQuery
mixed
Return
Array of
Groups
mixed
getColumn(
$strGroupId, $strColumn
)
Gets a single field from a record
Parameters
$strGroupId
string
A record's group_id
$strColumn
mixed
Return
mixed
array
getContactsInGroup(
$arrGroupIds, $arrQuery
)
Returns all of the contacts in a specific group
Parameters
$arrGroupIds
mixed
$arrQuery
mixed
Return
array
int
getContactsInGroupCount(
$arrGroupIds, $arrFilter
)
Returns the number of contacts in a group
Parameters
$arrGroupIds
mixed
$arrFilter
mixed
Return
int
int
getCount(
$arrFilter
)
Returns the number of records in the database (matching the filter if specified)
Parameters
$arrFilter
mixed
Return
int
bool
isContactInGroup(
$iContactId, $arrGroupIds
)
Determines whether a contact is a part of a group
Parameters
$iContactId
mixed
$arrGroupIds
mixed
Return
Is contact in group
void
removeContactFromGroup(
$iContactId, $arrGroupIds
)
Removes a contact from a group
Parameters
$iContactId
mixed
$arrGroupIds
mixed
string|int
save(
$arrEntity
)
Saves a record into the database
Parameters
$arrEntity
mixed
Return
string|int
void
saveColumn(
$strGroupId, $strColumn, $strValue
)
Saves a specific column of a row into a database
Parameters
$strGroupId
string
A record's group_id
$strColumn
mixed
$strValue
mixed
array
search(
$strSearch, $arrQuery
)
Performs a search
Parameters
$strSearch
mixed
$arrQuery
mixed
Return
Array of
Groups
that match the search query.
Database Fields
The following fields are used when retrieving and saving entities.
group_id
string (255)
group_date
datetime
group_title
string (255)
group_description
string (16777215)
group_table
string (64)
group_is_unsubscribable
0 or 1
group_contact_count
int unsigned (10)
group_marketing_link
string (255)
group_order
int unsigned
group_parent_id
string (255)