\Customers\Groups
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
METHODS
Marketing
\Components\Marketing\EmailMarketing \Components\Marketing\Events \Components\Marketing\Events\Attendees \Components\Marketing\Events\Categories \Components\Marketing\Events\Locations \Components\Marketing\Events\Recurring \Components\Marketing\Events\Recurring\Rules \Components\Marketing\SMSMarketing
Commerce
\Components\Commerce\Carts \Components\Commerce\Carts\Current \Components\Commerce\Discounts \Components\Commerce\Products \Components\Commerce\Products\Brands \Components\Commerce\Products\Categories \Components\Commerce\Products\Inventory \Components\Commerce\RecurringSales\Items \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\DOM\CurrentContext \Framework\HTML\Converters \Framework\HTTP\Cookies \Framework\HTTP\Redirection \Framework\HTTP\Request \Framework\HTTP\Session \Framework\HTTP\TabState \Framework\HTTP\UserAgent \Framework\I18N\CompanyTypes \Framework\I18N\Countries \Framework\I18N\Languages

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
- ` \Iterator dbGetAllIterable($arrQuery) `
Returns the raw rows dbGetAll() would return as an iterator, without building them all into an array

The dbGetAll() counterpart of getAllIterable(), for scans over every stored row of a large table (eg: the site-wide content scans in \Framework\Developer\Refactoring). Rows are as stored - JSON fields are not decoded - and are not entity-cached. Because it bypasses getAll(), components that override getAll() are iterated; search queries and components overriding dbGetAll() are refused.
Parameters:
- $arrQuery
mixed
Return
Yields Groups
- ` array fieldsGetAll($bCached) `
Returns all the columns this component supports
Parameters:
- $bCached
mixed
Return
array
- ` array get($strGroupId) `
Gets a record from the database
Parameters:
- $strGroupId
string
A record's group_id
Return
- ` 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
- ` 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
- ` \Iterator getAllIterable($arrQuery) `
Returns the entities getAll() would return as an iterator, without building them all into an array

For result sets too large to hold as arrays (eg: every recipient of a marketing send) - only the database driver's compact buffer of the result is held, a fraction of getAll()'s memory. Runs the same SQL as getAll(), and runs it now, as getAll() would; rows are decoded as you iterate.
Search queries are not supported, rows are not entity-cached, and components that override getAll() or dbGetAll() (eg: merging in defaults) are refused rather than iterated without their extra rows.
Parameters:
- $arrQuery
mixed
Return
Yields Groups
- ` 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)