filter()}, * e.g. "Name:EndsWith". * * If multiple fields are provided, the filtering is performed non-exclusive. * If no fields are provided, tries to auto-detect fields from * {@link DataObject->searchableFields()}. * * The fields support "dot-notation" for relationships, e.g. * a entry called "Team.Name" will search through the names of * a "Team" relationship. * * @example * array( * 'Name', * 'Email:StartsWith', * 'Team.Name' * ) * * @var Array */ protected $searchFields = array(); /** * @var string SSViewer template to render the results presentation */ protected $resultsFormat = '$Title'; /** * @var String Text shown on the search field, instructing what to search for. */ protected $placeholderText; /** * @var int */ protected $resultsLimit = 20; /** * * @param array $searchFields Which fields on the object in the list should be searched */ public function __construct($targetFragment = 'before', $searchFields = null) { $this->targetFragment = $targetFragment; $this->searchFields = (array)$searchFields; } /** * * @param GridField $gridField * @return string - HTML */ public function getHTMLFragments($gridField) { $dataClass = $gridField->getList()->dataClass(); $forTemplate = new ArrayData(array()); $forTemplate->Fields = new FieldList(); $searchField = new TextField('gridfield_relationsearch', _t('GridField.RelationSearch', "Relation search")); $searchField->setAttribute('data-search-url', Controller::join_links($gridField->Link('search'))); $searchField->setAttribute('placeholder', $this->getPlaceholderText($dataClass)); $searchField->addExtraClass('relation-search no-change-track action_gridfield_relationsearch'); $findAction = new GridField_FormAction($gridField, 'gridfield_relationfind', _t('GridField.Find', "Find"), 'find', 'find'); $findAction->setAttribute('data-icon', 'relationfind'); $findAction->addExtraClass('action_gridfield_relationfind'); $addAction = new GridField_FormAction($gridField, 'gridfield_relationadd', _t('GridField.LinkExisting', "Link Existing"), 'addto', 'addto'); $addAction->setAttribute('data-icon', 'chain--plus'); $addAction->addExtraClass('action_gridfield_relationadd'); // If an object is not found, disable the action if(!is_int($gridField->State->GridFieldAddRelation(null))) { $addAction->setReadonly(true); } $forTemplate->Fields->push($searchField); $forTemplate->Fields->push($findAction); $forTemplate->Fields->push($addAction); if($form = $gridField->getForm()) { $forTemplate->Fields->setForm($form); } return array( $this->targetFragment => $forTemplate->renderWith($this->itemClass) ); } /** * * @param GridField $gridField * @return array */ public function getActions($gridField) { return array('addto'); } /** * Manipulate the state to add a new relation * * @param GridField $gridField * @param string $actionName Action identifier, see {@link getActions()}. * @param array $arguments Arguments relevant for this * @param array $data All form data */ public function handleAction(GridField $gridField, $actionName, $arguments, $data) { switch($actionName) { case 'addto': if(isset($data['relationID']) && $data['relationID']){ $gridField->State->GridFieldAddRelation = $data['relationID']; } break; } } /** * If an object ID is set, add the object to the list * * @param GridField $gridField * @param SS_List $dataList * @return SS_List */ public function getManipulatedData(GridField $gridField, SS_List $dataList) { $objectID = $gridField->State->GridFieldAddRelation(null); if(empty($objectID)) { return $dataList; } $object = DataObject::get_by_id($dataList->dataclass(), $objectID); if($object) { $dataList->add($object); } $gridField->State->GridFieldAddRelation = null; return $dataList; } /** * * @param GridField $gridField * @return array */ public function getURLHandlers($gridField) { return array( 'search' => 'doSearch', ); } /** * Returns a json array of a search results that can be used by for example Jquery.ui.autosuggestion * * @param GridField $gridField * @param SS_HTTPRequest $request */ public function doSearch($gridField, $request) { $dataClass = $gridField->getList()->dataClass(); $allList = $this->searchList ? $this->searchList : DataList::create($dataClass); $searchFields = ($this->getSearchFields()) ? $this->getSearchFields() : $this->scaffoldSearchFields($dataClass); if(!$searchFields) { throw new LogicException( sprintf('GridFieldAddExistingAutocompleter: No searchable fields could be found for class "%s"', $dataClass)); } $params = array(); foreach($searchFields as $searchField) { $name = (strpos($searchField, ':') !== FALSE) ? $searchField : "$searchField:StartsWith"; $params[$name] = $request->getVar('gridfield_relationsearch'); } $results = $allList ->subtract($gridField->getList()) ->filterAny($params) ->sort(strtok($searchFields[0], ':'), 'ASC') ->limit($this->getResultsLimit()); $json = array(); $originalSourceFileComments = Config::inst()->get('SSViewer', 'source_file_comments'); Config::inst()->update('SSViewer', 'source_file_comments', false); foreach($results as $result) { $title = html_entity_decode(SSViewer::fromString($this->resultsFormat)->process($result)); $json[] = array( 'label' => $title, 'value' => $title, 'id' => $result->ID, ); } Config::inst()->update('SSViewer', 'source_file_comments', $originalSourceFileComments); return Convert::array2json($json); } /** * @param string $format * @return $this */ public function setResultsFormat($format) { $this->resultsFormat = $format; return $this; } /** * @return String */ public function getResultsFormat() { return $this->resultsFormat; } /** * Sets the base list instance which will be used for the autocomplete * search. * * @param SS_List $list */ public function setSearchList(SS_List $list) { $this->searchList = $list; } /** * @param Array */ public function setSearchFields($fields) { $this->searchFields = $fields; return $this; } /** * @return Array */ public function getSearchFields() { return $this->searchFields; } /** * Detect searchable fields and searchable relations. * Falls back to {@link DataObject->summaryFields()} if * no custom search fields are defined. * * @param String the class name * @return Array|null names of the searchable fields */ public function scaffoldSearchFields($dataClass) { $obj = singleton($dataClass); $fields = null; if($fieldSpecs = $obj->searchableFields()) { $customSearchableFields = $obj->stat('searchable_fields'); foreach($fieldSpecs as $name => $spec) { if(is_array($spec) && array_key_exists('filter', $spec)) { // The searchableFields() spec defaults to PartialMatch, // so we need to check the original setting. // If the field is defined $searchable_fields = array('MyField'), // then default to StartsWith filter, which makes more sense in this context. if(!$customSearchableFields || array_search($name, $customSearchableFields)) { $filter = 'StartsWith'; } else { $filter = preg_replace('/Filter$/', '', $spec['filter']); } $fields[] = "{$name}:{$filter}"; } else { $fields[] = $name; } } } if (is_null($fields)) { if ($obj->hasDatabaseField('Title')) { $fields = array('Title'); } elseif ($obj->hasDatabaseField('Name')) { $fields = array('Name'); } } return $fields; } /** * @param String The class of the object being searched for * @return String */ public function getPlaceholderText($dataClass) { $searchFields = ($this->getSearchFields()) ? $this->getSearchFields() : $this->scaffoldSearchFields($dataClass); if($this->placeholderText) { return $this->placeholderText; } else { $labels = array(); if($searchFields) foreach($searchFields as $searchField) { $searchField = explode(':', $searchField); $label = singleton($dataClass)->fieldLabel($searchField[0]); if($label) $labels[] = $label; } if($labels) { return _t( 'GridField.PlaceHolderWithLabels', 'Find {type} by {name}', array('type' => singleton($dataClass)->i18n_plural_name(), 'name' => implode(', ', $labels)) ); } else { return _t( 'GridField.PlaceHolder', 'Find {type}', array('type' => singleton($dataClass)->i18n_plural_name()) ); } } } /** * @param String */ public function setPlaceholderText($text) { $this->placeholderText = $text; } /** * Gets the maximum number of autocomplete results to display. * * @return int */ public function getResultsLimit() { return $this->resultsLimit; } /** * @param int $limit */ public function setResultsLimit($limit) { $this->resultsLimit = $limit; } }