Saving * * This field saves a {@link ComponentSet} object which is present on the {@link DataObject} passed by the form, * returned by calling a function with the same name as the field. The Join is updated by running setByIDList on the * {@link ComponentSet} * * Customizing Save Behaviour * * Before the data is saved, you can modify the ID list sent to the {@link ComponentSet} by specifying a function on * the {@link DataObject} called "onChange[fieldname](&items)". This will be passed by reference the IDlist (an array * of ID's) from the Treefield to be saved to the component set. * * Returning false on this method will prevent treemultiselect from saving to the {@link ComponentSet} of the given * {@link DataObject} * * * // Called when we try and set the Parents() component set * // by Tree Multiselect Field in the administration. * function onChangeParents(&$items) { * // This ensures this DataObject can never be a parent of itself * if($items){ * foreach($items as $k => $id){ * if($id == $this->ID){ * unset($items[$k]); * } * } * } * return true; * } * * * @see TreeDropdownField for the sample implementation, but only allowing single selects */ class TreeMultiselectField extends TreeDropdownField { public function __construct( $name, $title = null, $sourceObject = Group::class, $keyField = "ID", $labelField = "Title" ) { parent::__construct($name, $title, $sourceObject, $keyField, $labelField); $this->removeExtraClass('single'); $this->addExtraClass('multiple'); $this->value = 'unchanged'; } public function getSchemaDataDefaults() { $data = parent::getSchemaDataDefaults(); $data['data'] = array_merge($data['data'], [ 'hasEmptyDefault' => false, 'multiple' => true, ]); return $data; } public function getSchemaStateDefaults() { $data = parent::getSchemaStateDefaults(); unset($data['data']['valueObject']); $items = $this->getItems(); $values = []; foreach ($items as $item) { if ($item instanceof DataObject) { $values[] = [ 'id' => $item->obj($this->getKeyField())->getValue(), 'title' => $item->obj($this->getTitleField())->getValue(), 'parentid' => $item->ParentID, 'treetitle' => $item->obj($this->getLabelField())->getSchemaValue(), ]; } else { $values[] = $item; } } $data['data']['valueObjects'] = $values; // cannot rely on $this->value as this could be a many-many relationship $value = array_column($values, 'id'); if ($value) { sort($value); $data['value'] = $value; } else { $data['value'] = 'unchanged'; } return $data; } /** * Return this field's linked items * @return ArrayList|DataList $items */ public function getItems() { $items = new ArrayList(); // If the value has been set, use that if ($this->value != 'unchanged') { $sourceObject = $this->getSourceObject(); if (is_array($sourceObject)) { $values = is_array($this->value) ? $this->value : preg_split('/ *, */', trim($this->value)); foreach ($values as $value) { $item = new stdClass; $item->ID = $value; $item->Title = $sourceObject[$value]; $items->push($item); } return $items; } // Otherwise, look data up from the linked relation if (is_string($this->value)) { $ids = explode(',', $this->value); foreach ($ids as $id) { if (!is_numeric($id)) { continue; } $item = DataObject::get_by_id($sourceObject, $id); if ($item) { $items->push($item); } } return $items; } } if ($this->form) { $fieldName = $this->name; $record = $this->form->getRecord(); if (is_object($record) && $record->hasMethod($fieldName)) { return $record->$fieldName(); } } return $items; } /** * We overwrite the field attribute to add our hidden fields, as this * formfield can contain multiple values. * * @param array $properties * @return DBHTMLText */ public function Field($properties = array()) { $value = ''; $titleArray = array(); $idArray = array(); $items = $this->getItems(); $emptyTitle = _t('SilverStripe\\Forms\\DropdownField.CHOOSE', '(Choose)', 'start value of a dropdown'); if ($items && count($items)) { foreach ($items as $item) { $idArray[] = $item->ID; $titleArray[] = ($item instanceof ViewableData) ? $item->obj($this->getLabelField())->forTemplate() : Convert::raw2xml($item->{$this->getLabelField()}); } $title = implode(", ", $titleArray); sort($idArray); $value = implode(",", $idArray); } else { $title = $emptyTitle; } $dataUrlTree = ''; if ($this->form) { $dataUrlTree = $this->Link('tree'); if (!empty($idArray)) { $dataUrlTree = Controller::join_links($dataUrlTree, '?forceValue=' . implode(',', $idArray)); } } $properties = array_merge( $properties, array( 'Title' => $title, 'EmptyTitle' => $emptyTitle, 'Link' => $dataUrlTree, 'Value' => $value ) ); return FormField::Field($properties); } /** * Save the results into the form * Calls function $record->onChange($items) before saving to the assummed * Component set. * * @param DataObjectInterface $record */ public function saveInto(DataObjectInterface $record) { $items = []; $fieldName = $this->name; $saveDest = $record->$fieldName(); if (!$saveDest) { $recordClass = get_class($record); user_error( "TreeMultiselectField::saveInto() Field '$fieldName' not found on" . " {$recordClass}.{$record->ID}", E_USER_ERROR ); } // Detect whether this field has actually been updated if ($this->value !== 'unchanged') { if (is_array($this->value)) { $items = $this->value; } elseif ($this->value) { $items = preg_split("/ *, */", trim($this->value)); } } // Allows you to modify the items on your object before save $funcName = "onChange$fieldName"; if ($record->hasMethod($funcName)) { $result = $record->$funcName($items); if (!$result) { return; } } $saveDest->setByIDList($items); } /** * Changes this field to the readonly field. */ public function performReadonlyTransformation() { /** @var TreeMultiselectField_Readonly $copy */ $copy = $this->castedCopy(TreeMultiselectField_Readonly::class); $copy->setKeyField($this->getKeyField()); $copy->setLabelField($this->getLabelField()); $copy->setSourceObject($this->getSourceObject()); $copy->setTitleField($this->getTitleField()); return $copy; } /** * {@inheritdoc} * * @internal To be removed in 5.0 */ protected function objectForKey($key) { /** * Fixes https://github.com/silverstripe/silverstripe-framework/issues/8332 * * Due to historic reasons, the default (empty) value for this field is 'unchanged', even though * the field is usually integer on the database side. * MySQL handles that gracefully and returns an empty result in that case, * whereas some other databases (e.g. PostgreSQL) do not support comparison * of numeric types with string values, issuing a database error. * * This fix is not ideal, but supposed to keep backward compatibility for SS4. * * In 5.0 this method to be removed and NULL should be used instead of 'unchanged' (or an empty array. to be decided). * In 5.0 this class to be refactored so that $this->value is always an array of values (or null) */ if ($this->getKeyField() === 'ID' && $key === 'unchanged') { $key = null; } elseif (is_string($key)) { $key = preg_split('/\s*,\s*/', trim($key)); } return parent::objectForKey($key); } }