EmailMarketing
Use this API to create, update and delete e-mail marketing messages.
Methods
Invoke via \Components\Marketing\EmailMarketing::method()
Click a method name to copy it.
Returns whether the current visitor may view the web version of a message (/community/email/{id}/)
Administrators always can. Anyone can once it has been sent to all contacts. Otherwise it must have been sent to the current contact — identified by login or by the tracking cookie set when a tracked email link is clicked.
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.
Returns all the columns this component supports
Deletes a record from the database
Parameters:
- $iEmailMessageId
int
A record's email_message_id
Return
Returns true if record existed and was deleted, otherwise false
Gets a record from the database
Parameters:
- $iEmailMessageId
int
A record's email_message_id
Return a set of records from the database
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.
Gets a single field from a record
Parameters:
- $iEmailMessageId
int
A record's email_message_id
Returns the number of records in the database (matching the filter if specified)
Returns the currently sending message id
Return
or NULL when not currently sending
Returns a link to the currently sending message
Useful for linking to a "View Online" function inside an email.
Return
URL of email preview
Resolve an e-mail design, falling back to the configured e-mail design or No Design.
Saves a record into the database
Saves a specific column of a row into a database
Parameters:
- $iEmailMessageId
int
A record's email_message_id