include/SugarFields/Fields/Base/SugarFieldBase.php
Package: SugarCRMSugarFieldBase translates and displays fields from a vardef definition into different formats
including DetailView, ListView, EditView. It also provides Search Inputs and database queries
to handle searching
- Children
- \SugarFieldLink
- \SugarFieldHtml
- \SugarFieldEnum
- \SugarFieldCollection
- \SugarFieldDatetimecombo
- \SugarFieldHtml
- \SugarFieldAddress
- \SugarFieldPassword
- \SugarFieldTeamset
- \SugarFieldFile
- \SugarFieldId
- \SugarFieldRelate
- \SugarFieldRadioenum
- \SugarFieldBool
- \SugarFieldText
- \SugarFieldAssigned_user_name
- \SugarFieldReadonly
- \SugarFieldDatetime
- \SugarFieldPhone
- \SugarFieldDownload
- \SugarFieldUsername
- \SugarFieldImage
- \SugarFieldTime
- \SugarFieldInt
- \SugarFieldFullname
- \SugarFieldEncrypt
Properties
Methods
getDetailViewSmarty(
\parentFieldArray $parentFieldArray, \vardef $vardef, \displayParam $displayParams, $tabindex
)
:
void
Returns a smarty template for the DetailViews
Parameters
Name |
Type |
Description |
$parentFieldArray |
\parentFieldArray |
string name of the variable in the parent template for the bean's data
|
$vardef |
\vardef |
vardef field defintion |
$displayParams |
\displayParam |
parameters for display available paramters are: * labelSpan - column span for the label * fieldSpan - column span for the field
|
$tabindex |
|
|
getSearchInput(
\$key $key
=
'', \$args $args
=
array()
)
:
\$value
This function allows the SugarFields to handle returning the search input value given arguments (typically from $_REQUEST/$_POST)
and a search string.
Parameters
Name |
Type |
Description |
$key |
\$key |
String value of key to search for |
$args |
\$args |
Mixed value containing haystack to search for value in |
Returns
Type |
Description |
\$value |
Mixed value that the SugarField should return |
getSearchWhereValue(
\$value $value
)
:
Mixed
Checks and returns a sane value based on the field type that can be used when building the where clause in a
search form.
Parameters
Name |
Type |
Description |
$value |
\$value |
Mixed value being searched on |
Returns
Type |
Description |
Mixed |
the value for the where clause used in search |
importSanitize(
\$value $value, \$vardefs $vardef, \$focus $focus, \$settings $settings
)
:
string
Handles import field sanitizing for an field type
Parameters
Name |
Type |
Description |
$value |
\$value |
string value to be sanitized |
$vardef |
\$vardefs |
array |
$focus |
\$focus |
SugarBean object |
$settings |
\$settings |
ImportFieldSanitize object |
Returns
Type |
Description |
string |
sanitized value or boolean false if there's a problem with the value |
isRangeSearchView(
array $vardef
)
:
boolean
isRangeSearchView
This method helps determine whether or not to display the range search view code for the sugar field
Parameters
Name |
Type |
Description |
$vardef |
array |
entry representing the sugar field's definition
|
Returns
Type |
Description |
boolean |
true if range search view should be displayed, false otherwise |
isTrimmable(
string $type
)
:
boolean
Check if the field is allowed to be trimmed
Parameters
Name |
Type |
Description |
$type |
string |
|
Returns
save(
\SugarBean $bean, array $params, $field, $properties, $prefix
=
''
)
:
void
This should be called when the bean is saved. The bean itself will be passed by reference
Parameters
Name |
Type |
Description |
$bean |
\SugarBean |
bean - the bean performing the save
|
$params |
array |
params - an array of paramester relevant to the save, most likely will be $_REQUEST
|
$field |
|
|
$properties |
|
|
$prefix |
|
|
setup(
$parentFieldArray, $vardef, $displayParams, $tabindex, $twopass
=
true
)
:
void
Setup function to assign values to the smarty template, should be called before every display function
Parameters
Name |
Type |
Description |
$parentFieldArray |
|
|
$vardef |
|
|
$displayParams |
|
|
$tabindex |
|
|
$twopass |
|
|
setupFieldArray(
mixed $parentFieldArray, array $vardef
)
:
array
setupFieldArray
This method takes the $parentFieldArray mixed variable which may be an Array or object and attempts
to call any custom fieldSpecific formatting to the value depending on the field type.
Parameters
Name |
Type |
Description |
$parentFieldArray |
mixed |
Array or Object of data where the field's value comes from
|
$vardef |
array |
The vardef entry linked to the SugarField instance |
Returns
Type |
Description |
array |
$parentFieldArray The formatted $parentFieldArray with the formatField method possibly applied |
Details
- See
- \SugarFieldEnum.php,