\Settings\CustomFields
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\DOM\CurrentContext \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

CustomFields

Methods

Invoke via \Components\Settings\CustomFields::method()
Click a method name to copy it.
bool delete($iCustomFieldId, $bDeleteMedia)
Deletes a record from the database
Parameters
$iCustomFieldId
int
A record's custom_field_id
$bDeleteMedia
mixed
Return
Returns true if record existed and was deleted, otherwise false
array get($iCustomFieldId)
Gets a record from the database
Parameters
$iCustomFieldId
int
A record's custom_field_id
Return
CustomFields
array getAll($arrQuery)
Return a set of records from the database
Parameters
$arrQuery
mixed
Return
Array of CustomFields
array|null getByComponentAndField($strComponent, $strField)
Returns a custom field from its component and field name
Parameters
$strComponent
mixed
$strField
mixed
Return
array|null
mixed getColumn($iCustomFieldId, $strColumn)
Gets a single field from a record
Parameters
$iCustomFieldId
int
A record's custom_field_id
$strColumn
mixed
Return
mixed
int getCount($arrFilter)
Returns the number of records in the database (matching the filter if specified)
Parameters
$arrFilter
mixed
Return
int
string|null getForm($strComponent, $strField)
Returns the form for a custom field
Parameters
$strComponent
mixed
$strField
mixed
Return
string|null
array|null getOptions($strComponent, $strField)
If the custom field contains options, return them as an array
Parameters
$strComponent
mixed
$strField
mixed
Return
array|null
string|int save($arrEntity)
Saves a record into the database
Parameters
$arrEntity
mixed
Return
string|int
void saveColumn($iCustomFieldId, $strColumn, $strValue)
Saves a specific column of a row into a database
Parameters
$iCustomFieldId
int
A record's custom_field_id
$strColumn
mixed
$strValue
mixed
array search($strSearch, $arrQuery)
Performs a search
Parameters
$strSearch
mixed
$arrQuery
mixed
Return
Array of CustomFields that match the search query.
string uniquifyDataColumns($strForm, $strSuffix)
Suffix all datacolumn's in the supplied form with the supplied string, allowing the custom field form to be unique when included in certain contexts such as
Automation conditions.
Parameters
$strForm
mixed
$strSuffix
mixed
Return
The uniquified form.
string uniquifyIDs($strForm, $strSuffix)
Suffix all id's in the supplied form with the supplied Id, allowing the custom field form to be unique when included in certain contexts such as
Automation conditions.
Parameters
$strForm
mixed
$strSuffix
mixed
Return
The uniquified form.

Database Fields

The following fields are used when retrieving and saving entities.
custom_field_id
int (11)
custom_field_component
string (255)
custom_field_table
string (255)
custom_field_is_editable
0 or 1
Default value: 1
field_id
string (255)
field_label
string (255)
field_description
string (255)
field_ui_type
string (255)
field_type
string (31)
field_default_value
string (31)
field_value_options
string (65535)
field_form
string (16777215)
field_is_mandatory
0 or 1
field_is_searchable
0 or 1
field_is_public
0 or 1
field_is_shown_in_lists
0 or 1
field_is_shown_in_checkout
0 or 1
field_is_shown_in_manual_sales
0 or 1
field_display
string (16777215)
field_order
int unsigned

Examples

Custom Fields Combobox

Fill the values of a Combobox from a Custom Field

HTML Code:

<forms:row label="Select Relevant Industry Category"> <forms:combobox id="contact_industry" datasource="\Components\Settings\CustomFields::getOptions('\Components\Customers\Contacts', 'contact_industry')" as="industry" datatitle="$industry" datavalue="$industry" /> </forms:row>

Display a Custom Field Value using Logic Parse

HTML Code:

<logic:parse text="[? \Components\Settings\CustomFields::getForm('\Components\Customers\Contacts', 'contact_industry') ?]" />