Symphony.

void __construct(mixed $parent)

Construct a new instance of this field.

Parameters

• $parent mixedThe class that created this Field object, usually the FieldManager, passed by reference.

boolean allowDatasourceParamOutput()

Test whether this field supports data-source parameter output. This default implementation prohibits parameter output. Data-source parameter output allows this field to be provided as a parameter to other data-sources or XSLT. Subclasses should override this if parameter output is supported.

Returns

true if this supports data-source parameter output, false otherwise.

void appendFormattedElement(XMLElement $wrapper, array $data, bool $encode, string $mode, integer $entry_id)

Append the formatted xml output of this field as utilized as a data source.

Parameters

• $wrapper XMLElementthe xml element to append the xml representation of this to.

• $data arraythe current set of values for this field. the values are structured as for displayPublishPanel.

• $encode bool(optional) flag as to whether this should be html encoded prior to output. this defaults to false.

• $mode stringA field can provide ways to output this field's data. For instance a mode could be 'items' or 'full' and then the function would display the data in a different way depending on what was selected in the datasource included elements.

• $entry_id integer(optional) the identifier of this field entry instance. defaults to null.

boolean buildDSRetrievalSQL(array $data, string $joins, string $where, bool $andOperation)

Construct the SQL statement fragments to use to retrieve the data of this field when utilized as a data source.

Parameters

• $data arraythe supplied form data to use to construct the query from

• $joins stringthe join sql statement fragment to append the additional join sql to.

• $where stringthe where condition sql statement fragment to which the additional where conditions will be appended.

• $andOperation bool(optional) true if the values of the input data should be appended as part of the where condition. this defaults to false.

Returns

true if the construction of the sql was successful, false otherwise.

boolean canFilter()

Test whether this field can be filtered. This default implementation prohibits filtering. Filtering allows the xml output results to be limited according to an input parameter. Subclasses should override this if filtering is supported.

Returns

true if this can be filtered, false otherwise.

boolean canImport()

Test whether this field can be imported. This default implementation prohibits importing. Subclasses should override this is importing is supported.

Returns

true if this can be imported, false otherwise.

Deprecated

This function will be removed in the next major release. It is unused by Symphony.

boolean canPrePopulate()

Test whether this field can be prepopulated with data. This default implementation does not support pre-population and, thus, returns false.

Returns

true if this can be pre-populated, false otherwise.

boolean commit()

Commit the settings of this field from the section editor to create an instance of this field in a section.

Returns

true if the commit was successful, false otherwise.

boolean createTable()

The default field table construction method. This constructs the bare minimum set of columns for a valid field table. Subclasses are expected to overload this method to create a table structure that contains additional columns to store the specific data created by the field.

void displayDatasourceFilterPanel(XMLElement $wrapper, mixed $data, mixed $errors, mixed $fieldnamePrefix, mixed $fieldnamePostfix, string $fieldNamePrefix, string $fieldNameSuffix)

Display the default data-source filter panel.

Parameters

• $wrapper XMLElementthe input XMLElement to which the display of this will be appended.

• $data mixed(optional) the input data. this defaults to null.

• $errors mixed(optional) the input error collection. this defaults to null.

• $fieldNamePrefix stringthe prefix to apply to the display of this.

• $fieldNameSuffix stringthe suffix to apply to the display of this.

void displayPublishPanel(XMLElement $wrapper, array $data, mixed $flagWithError, string $fieldnamePrefix, mixed $fieldnamePostfix, integer $entry_id, string $fieldnameSuffix)

Display the publish panel for this field. The display panel is the interface shown to Authors that allow them to input data into this field for an Entry.

Parameters

• $wrapper XMLElementthe xml element to append the html defined user interface to this field.

• $data array(optional) any existing data that has been supplied for this field instance. this is encoded as an array of columns, each column maps to an array of row indexes to the contents of that column. this defaults to null.

• $flagWithError mixed(optional) flag with error defaults to null.

• $fieldnamePrefix string(optional) the string to be prepended to the display of the name of this field. this defaults to null.

• $fieldnameSuffix string(optional) the string to be appended to the display of the name of this field. this defaults to null.

• $entry_id integer(optional) the entry id of this field. this defaults to null.

void displaySettingsPanel(XMLElement $wrapper, mixed $errors)

Display the default settings panel, calls the buildSummaryBlock function after basic field settings are added to the wrapper.

Parameters

• $wrapper XMLElementthe input XMLElement to which the display of this will be appended.

• $errors mixed(optional) the input error collection. this defaults to null.

See Also

• buildSummaryBlock()

void findAllTags()

void findDefaults(mixed $fields, array $settings)

Allows a field to set default settings.

Parameters

• $settings arraythe array of settings to populate with their defaults.

string prepareTableValue(array $data, XMLElement $link)

Format this field value for display in the publish index tables. By default, Symphony will truncate the value to the configuration setting cell_truncation_length. This function will attempt to use PHP's mbstring functions if they are available.

Parameters

• $data arrayan associative array of data for this string. At minimum this requires a key of 'value'.

• $link XMLElement(optional) an xml link structure to append the content of this to provided it is not null. it defaults to null.

Returns

the formatted string summary of the values of this field instance.

array processRawFieldData(mixed $data, integer $status, bool $simulate, mixed $entry_id)

Process the raw field data.

Parameters

• $data mixedpost data from the entry form

• $status integerthe status code resultant from processing the data.

• $simulate bool(optional) true if this will tell the CF's to simulate data creation, false otherwise. this defaults to false. this is important if clients will be deleting or adding data outside of the main entry object commit function.

• $entry_id mixed(optional) the current entry. defaults to null.

Returns

the processed field data.

boolean requiresSQLGrouping()

Test whether this field requires grouping. This default implementation returns false.

Returns

true if this field requires grouping, false otherwise.

void set(mixed $field, mixed $value, string $setting)

Fields have settings that define how that field will act in a section, including if it's required, any validators, if it can be shown on the entries tableetc. This function will set a setting to a value. This function will set a setting to a value overwriting any existing value for this setting

Parameters

• $setting stringthe setting key.

• $value mixedthe value of the setting.