1. class
  2. SilverStripe
  3. \
  4. Forms
  5. \
  6. GridField
  7. \
  8. GridFieldAddExistingAutocompleter

GridFieldAddExistingAutocompleter

class GridFieldAddExistingAutocompleter implements GridField_HTMLProvider, GridField_ActionProvider, GridField_DataManipulator, GridField_URLHandler

This class is is responsible for adding objects to another object's has_many and many_many relation, as defined by the {@link RelationList} passed to the {@link GridField} constructor.

Objects can be searched through an input field (partially matching one or more fields).

Selecting from the results will add the object to the relation.

Often used alongside {@link GridFieldDeleteAction} for detaching existing records from a relationship.

For easier setup, have a look at a sample configuration in {@link GridFieldConfig_RelationEditor}.

Methods

__construct(string $targetFragment = 'before', array $searchFields = null)

No description

array
getHTMLFragments(GridField $gridField)

No description

array
getActions(GridField $gridField)

No description

handleAction(GridField $gridField, string $actionName, array $arguments, array $data)

Manipulate the state to add a new relation

SS_List
getManipulatedData(GridField $gridField, SS_List $dataList)

If an object ID is set, add the object to the list

array
getURLHandlers(GridField $gridField)

No description

string
doSearch(GridField $gridField, HTTPRequest $request)

Returns a json array of a search results that can be used by for example Jquery.ui.autosuggestion

$this
setResultsFormat(string $format)

No description

string
getResultsFormat()

No description

setSearchList(SS_List $list)

Sets the base list instance which will be used for the autocomplete search.

$this
setSearchFields(array $fields)

No description

array
getSearchFields()

No description

array|null
scaffoldSearchFields(string $dataClass)

Detect searchable fields and searchable relations.

string
getPlaceholderText(string $dataClass)

No description

$this
setPlaceholderText(string $text)

No description

int
getResultsLimit()

Gets the maximum number of autocomplete results to display.

$this
setResultsLimit(int $limit)

No description

Details

at line 97
__construct(string $targetFragment = 'before', array $searchFields = null)

Parameters

string $targetFragment
array $searchFields Which fields on the object in the list should be searched

at line 108
array getHTMLFragments(GridField $gridField)

Parameters

GridField $gridField

Return Value

array

at line 167
array getActions(GridField $gridField)

Parameters

GridField $gridField

Return Value

array with action identifier strings.

at line 180
handleAction(GridField $gridField, string $actionName, array $arguments, array $data)

Manipulate the state to add a new relation

Parameters

GridField $gridField
string $actionName Action identifier, see {@link getActions()}.
array $arguments Arguments relevant for this
array $data All form data

at line 198
SS_List getManipulatedData(GridField $gridField, SS_List $dataList)

If an object ID is set, add the object to the list

Parameters

GridField $gridField
SS_List $dataList

Return Value

SS_List

at line 217
array getURLHandlers(GridField $gridField)

Parameters

GridField $gridField

Return Value

array

at line 231
string doSearch(GridField $gridField, HTTPRequest $request)

Returns a json array of a search results that can be used by for example Jquery.ui.autosuggestion

Parameters

GridField $gridField
HTTPRequest $request

Return Value

string

at line 282
$this setResultsFormat(string $format)

Parameters

string $format

Return Value

$this

at line 291
string getResultsFormat()

Return Value

string

at line 302
setSearchList(SS_List $list)

Sets the base list instance which will be used for the autocomplete search.

Parameters

SS_List $list

at line 312
$this setSearchFields(array $fields)

Parameters

array $fields

Return Value

$this

at line 321
array getSearchFields()

Return Value

array

at line 334
array|null scaffoldSearchFields(string $dataClass)

Detect searchable fields and searchable relations.

Falls back to {@link DataObject->summaryFields()} if no custom search fields are defined.

Parameters

string $dataClass The class name

Return Value

array|null names of the searchable fields

at line 373
string getPlaceholderText(string $dataClass)

Parameters

string $dataClass The class of the object being searched for

Return Value

string

at line 413
$this setPlaceholderText(string $text)

Parameters

string $text

Return Value

$this

at line 424
int getResultsLimit()

Gets the maximum number of autocomplete results to display.

Return Value

int

at line 434
$this setResultsLimit(int $limit)

Parameters

int $limit

Return Value

$this