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)

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

DataList
getManipulatedData(GridField $gridField, SS_List $dataList)

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

getURLHandlers($gridField)

No description

doSearch(GridField $gridField, SS_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.

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 85
__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 95
array getHTMLFragments($gridField)

Parameters

$gridField

Return Value

array

at line 139
Array getActions(GridField $gridField)

Parameters

GridField $gridField

Return Value

Array with action identifier strings.

at line 151
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 168
DataList 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

DataList

at line 186
getURLHandlers($gridField)

Parameters

$gridField

at line 198
doSearch(GridField $gridField, SS_HTTPRequest $request)

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

Parameters

GridField $gridField
SS_HTTPRequest $request

at line 238
$this setResultsFormat(string $format)

Parameters

string $format

Return Value

$this

at line 246
string getResultsFormat()

Return Value

string

at line 256
setSearchList(SS_List $list)

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

Parameters

SS_List $list

at line 264
setSearchFields(array $fields)

Parameters

array $fields

at line 272
array getSearchFields()

Return Value

array

at line 284
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 322
string getPlaceholderText(string $dataClass)

Parameters

string $dataClass The class of the object being searched for

Return Value

string

at line 356
$this setPlaceholderText(string $text)

Parameters

string $text

Return Value

$this

at line 366
int getResultsLimit()

Gets the maximum number of autocomplete results to display.

Return Value

int

at line 375
$this setResultsLimit(int $limit)

Parameters

int $limit

Return Value

$this