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
)
:
voidReturns 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
)
:
stringHandles 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
)
:
booleanisRangeSearchView
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
)
:
booleanCheck if the field is allowed to be trimmed
Parameters
| Name |
Type |
Description |
| $type |
string |
|
Returns



save(
\SugarBean $bean, array $params, $field, $properties, $prefix
=
''
)
:
voidThis 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
)
:
voidSetup 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
)
:
arraysetupFieldArray
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,