sortField = $sortField; $this->immediateUpdate = $this->config()->default_immediate_update; } /** * @return string */ public function getSortField() { return $this->sortField; } /** * Sets the field used to specify the sort. * * @param string $sortField * @return GridFieldOrderableRows $this */ public function setSortField($field) { $this->sortField = $field; return $this; } /** * @return boolean */ public function getImmediateUpdate() { return $this->immediateUpdate; } /** * @see $immediateUpdate * @param boolean $immediateUpdate * @return GridFieldOrderableRows $this */ public function setImmediateUpdate($bool) { $this->immediateUpdate = $bool; return $this; } /** * @return string|array */ public function getExtraSortFields() { return $this->extraSortFields; } /** * Checks to see if the relationship list is for a type of many_many * * @param SS_List $list * * @return bool */ protected function isManyMany(SS_List $list) { return $list instanceof ManyManyList || $list instanceof ManyManyThroughList; } /** * Sets extra sort fields to apply before the sort field. * * @param string|array $fields * @return GridFieldOrderableRows $this */ public function setExtraSortFields($fields) { $this->extraSortFields = $fields; return $this; } /** * @return int */ public function getReorderColumnNumber() { return $this->reorderColumnNumber; } /** * Sets the number of the column containing the reorder handles. * * @param int $colno * @return GridFieldOrderableRows $this */ public function setReorderColumnNumber($colno) { $this->reorderColumnNumber = $colno; return $this; } /** * Validates sortable list * * @param SS_List $list * @throws Exception */ public function validateSortField(SS_List $list) { $field = $this->getSortField(); // Check extra fields on many many relation types if ($list instanceof ManyManyList) { $extra = $list->getExtraFields(); if ($extra && array_key_exists($field, $extra)) { return; } } elseif ($list instanceof ManyManyThroughList) { $manipulator = $this->getManyManyInspector($list); $fieldTable = DataObject::getSchema()->tableForField($manipulator->getJoinClass(), $field); if ($fieldTable) { return; } } $classes = ClassInfo::dataClassesFor($list->dataClass()); foreach ($classes as $class) { if (singleton($class)->hasDataBaseField($field)) { return; } } throw new Exception("Couldn't find the sort field '" . $field . "'"); } /** * Gets the table which contains the sort field. * * @param DataList $list * @return string */ public function getSortTable(SS_List $list) { $field = $this->getSortField(); if ($list instanceof ManyManyList) { $extra = $list->getExtraFields(); $table = $list->getJoinTable(); if ($extra && array_key_exists($field, $extra)) { return $table; } } elseif ($list instanceof ManyManyThroughList) { return $this->getManyManyInspector($list)->getJoinAlias(); } $classes = ClassInfo::dataClassesFor($list->dataClass()); foreach ($classes as $class) { if (singleton($class)->hasDataBaseField($field)) { return DataObject::getSchema()->tableName($class); } } throw new Exception("Couldn't find the sort field '$field'"); } public function getURLHandlers($grid) { return array( 'POST reorder' => 'handleReorder', 'POST movetopage' => 'handleMoveToPage' ); } /** * @param GridField $field */ public function getHTMLFragments($field) { GridFieldExtensions::include_requirements(); $field->addExtraClass('ss-gridfield-orderable'); $field->setAttribute('data-immediate-update', (string)(int)$this->immediateUpdate); $field->setAttribute('data-url-reorder', $field->Link('reorder')); $field->setAttribute('data-url-movetopage', $field->Link('movetopage')); } public function augmentColumns($grid, &$cols) { if (!in_array('Reorder', $cols) && $grid->getState()->GridFieldOrderableRows->enabled) { array_splice($cols, $this->reorderColumnNumber, 0, 'Reorder'); } } public function getColumnsHandled($grid) { return array('Reorder'); } public function getColumnContent($grid, $record, $col) { // In case you are using GridFieldEditableColumns, this ensures that // the correct sort order is saved. If you are not using that component, // this will be ignored by other components, but will still work for this. $sortFieldName = sprintf( '%s[GridFieldEditableColumns][%s][%s]', $grid->getName(), $record->ID, $this->getSortField() ); // Default: Get the sort field directly from the current record $currentSortValue = $record->getField($this->getSortField()); $list = $grid->getList(); if ($list instanceof ManyManyThroughList) { // In a many many through list we should get the current sort order from the relationship // if it exists, not directly from the record $throughListSorts = $this->getSortValuesFromManyManyThroughList($list, $this->getSortField()); if (array_key_exists($record->ID, $throughListSorts)) { $currentSortValue = $throughListSorts[$record->ID]; } } $sortField = HiddenField::create($sortFieldName, false, $currentSortValue); $sortField->addExtraClass('ss-orderable-hidden-sort'); $sortField->setForm($grid->getForm()); return ViewableData::create()->customise(array( 'SortField' => $sortField ))->renderWith('Symbiote\\GridFieldExtensions\\GridFieldOrderableRowsDragHandle'); } public function getColumnAttributes($grid, $record, $col) { return array('class' => 'col-reorder'); } public function getColumnMetadata($grid, $col) { if ($fieldLabels = singleton($grid->getModelClass())->fieldLabels()) { return array('title' => isset($fieldLabels['Reorder']) ? $fieldLabels['Reorder'] : ''); } return array('title' => ''); } public function getManipulatedData(GridField $grid, SS_List $list) { $state = $grid->getState(); $sorted = (bool) ((string) $state->GridFieldSortableHeader->SortColumn); // If the data has not been sorted by the user, then sort it by the // sort column, otherwise disable reordering. $state->GridFieldOrderableRows->enabled = !$sorted; if (!$sorted) { $sortterm = ''; if ($this->extraSortFields) { if (is_array($this->extraSortFields)) { foreach ($this->extraSortFields as $col => $dir) { $sortterm .= "$col $dir, "; } } else { $sortterm = $this->extraSortFields.', '; } } if ($list instanceof ArrayList) { // Fix bug in 3.1.3+ where ArrayList doesn't account for quotes $sortterm .= $this->getSortTable($list).'.'.$this->getSortField(); } else { $sortterm .= '"'.$this->getSortTable($list).'"."'.$this->getSortField().'"'; if ($list instanceof DataList) { $classname = $list->dataClass(); if ($defaultSort = Config::inst()->get($classname, 'default_sort')) { // Append the default sort to the end of the sort string // This may result in redundancy... but it seems to work $sortterm .= ($sortterm ? ', ' : '') . $defaultSort; } } } return $list->sort($sortterm); } return $list; } /** * Handles requests to reorder a set of IDs in a specific order. * * @param GridField $grid * @param HTTPRequest $request * @return string * @throws HTTPResponse_Exception */ public function handleReorder($grid, $request) { if (!$this->immediateUpdate) { $this->httpError(400); } $list = $grid->getList(); $modelClass = $grid->getModelClass(); $isManyMany = $this->isManyMany($list); if ($isManyMany && !singleton($modelClass)->canView()) { $this->httpError(403); } elseif (!$isManyMany && !singleton($modelClass)->canEdit()) { $this->httpError(403); } // Save any un-committed changes to the gridfield if (($form = $grid->getForm()) && ($record = $form->getRecord())) { $form->loadDataFrom($request->requestVars(), true); $grid->saveInto($record); } // Get records from the `GridFieldEditableColumns` column $gridFieldName = $grid->getName(); if (strpos($gridFieldName, '.') !== false) { $gridFieldName = str_replace('.', '_', $gridFieldName); } $data = $request->postVar($gridFieldName); $sortedIDs = $this->getSortedIDs($data); if (!$this->executeReorder($grid, $sortedIDs)) { $this->httpError(400); } Controller::curr()->getResponse()->addHeader('X-Status', rawurlencode('Records reordered.')); return $grid->FieldHolder(); } /** * Get mapping of sort value to item ID from posted data (gridfield list state), ordered by sort value. * * @param array $data Raw posted data * @return array [sortIndex => recordID] */ protected function getSortedIDs($data) { if (empty($data['GridFieldEditableColumns'])) { return array(); } $sortedIDs = array(); foreach ($data['GridFieldEditableColumns'] as $id => $recordData) { $sortValue = $recordData[$this->sortField]; $sortedIDs[$sortValue] = $id; } ksort($sortedIDs); return $sortedIDs; } /** * Handles requests to move an item to the previous or next page. */ public function handleMoveToPage(GridField $grid, $request) { if (!$paginator = $grid->getConfig()->getComponentByType(GridFieldPaginator::class)) { $this->httpError(404, 'Paginator component not found'); } $move = $request->postVar('move'); $field = $this->getSortField(); $list = $grid->getList(); $manip = $grid->getManipulatedList(); $existing = $manip->map('ID', $field)->toArray(); $values = $existing; $order = array(); $id = isset($move['id']) ? (int) $move['id'] : null; $to = isset($move['page']) ? $move['page'] : null; if (!isset($values[$id])) { $this->httpError(400, 'Invalid item ID'); } $this->populateSortValues($list); $page = ((int) $grid->getState()->GridFieldPaginator->currentPage) ?: 1; $per = $paginator->getItemsPerPage(); if ($to == 'prev') { $swap = $list->limit(1, ($page - 1) * $per - 1)->first(); $values[$swap->ID] = $swap->$field; $order[] = $id; $order[] = $swap->ID; foreach ($existing as $_id => $sort) { if ($id != $_id) { $order[] = $_id; } } } elseif ($to == 'next') { $swap = $list->limit(1, $page * $per)->first(); $values[$swap->ID] = $swap->$field; foreach ($existing as $_id => $sort) { if ($id != $_id) { $order[] = $_id; } } $order[] = $swap->ID; $order[] = $id; } else { $this->httpError(400, 'Invalid page target'); } $this->reorderItems($list, $values, $order); return $grid->FieldHolder(); } /** * Handle saving when 'immediateUpdate' is disabled, otherwise this isn't * necessary for the default sort mode. */ public function handleSave(GridField $grid, DataObjectInterface $record) { if (!$this->immediateUpdate) { $value = $grid->Value(); $sortedIDs = $this->getSortedIDs($value); if ($sortedIDs) { $this->executeReorder($grid, $sortedIDs); } } } /** * @param GridField $grid * @param array $sortedIDs List of IDS, where the key is the sort field value to save * @return bool */ protected function executeReorder(GridField $grid, $sortedIDs) { if (!is_array($sortedIDs) || empty($sortedIDs)) { return false; } $sortField = $this->getSortField(); $sortterm = ''; if ($this->extraSortFields) { if (is_array($this->extraSortFields)) { foreach ($this->extraSortFields as $col => $dir) { $sortterm .= "$col $dir, "; } } else { $sortterm = $this->extraSortFields.', '; } } $list = $grid->getList(); $sortterm .= '"'.$this->getSortTable($list).'"."'.$sortField.'"'; $items = $list->filter('ID', $sortedIDs)->sort($sortterm); // Ensure that each provided ID corresponded to an actual object. if (count($items) != count($sortedIDs)) { return false; } // Populate each object we are sorting with a sort value. $this->populateSortValues($items); // Generate the current sort values. if ($items instanceof ManyManyList) { $current = array(); foreach ($items->toArray() as $record) { // NOTE: _SortColumn0 is the first ->sort() field // used by SS when functions are detected in a SELECT // or CASE WHEN. if (isset($record->_SortColumn0)) { $current[$record->ID] = $record->_SortColumn0; } else { $current[$record->ID] = $record->$sortField; } } } elseif ($items instanceof ManyManyThroughList) { $current = $this->getSortValuesFromManyManyThroughList($list, $sortField); } else { $current = $items->map('ID', $sortField)->toArray(); } // Perform the actual re-ordering. $this->reorderItems($list, $current, $sortedIDs); return true; } /** * @param SS_List $list * @param array $values **UNUSED** [listItemID => currentSortValue]; * @param array $sortedIDs [newSortValue => listItemID] */ protected function reorderItems($list, array $values, array $sortedIDs) { // setup $sortField = $this->getSortField(); $class = $list->dataClass(); // The problem is that $sortedIDs is a list of the _related_ item IDs, which causes trouble // with ManyManyThrough, where we need the ID of the _join_ item in order to set the value. $itemToSortReference = ($list instanceof ManyManyThroughList) ? 'getJoin' : 'Me'; $currentSortList = $list->map('ID', $itemToSortReference)->toArray(); // sanity check. $this->validateSortField($list); $isVersioned = false; // check if sort column is present on the model provided by dataClass() and if it's versioned // cases: // Model has sort column and is versioned - handle as versioned // Model has sort column and is NOT versioned - handle as NOT versioned // Model doesn't have sort column because sort column is on ManyManyList - handle as NOT versioned // Model doesn't have sort column because sort column is on ManyManyThroughList - inspect through object if ($list instanceof ManyManyThroughList) { // We'll be updating the join class, not the relation class. $class = $this->getManyManyInspector($list)->getJoinClass(); $isVersioned = $class::create()->hasExtension(Versioned::class); } elseif (!$this->isManyMany($list)) { $isVersioned = $class::create()->hasExtension(Versioned::class); } // Loop through each item, and update the sort values which do not // match to order the objects. if (!$isVersioned) { $sortTable = $this->getSortTable($list); $now = DBDatetime::now()->Rfc2822(); $additionalSQL = ''; $baseTable = DataObject::getSchema()->baseDataTable($class); $isBaseTable = ($baseTable == $sortTable); if (!$list instanceof ManyManyList && $isBaseTable) { $additionalSQL = ", \"LastEdited\" = '$now'"; } foreach ($sortedIDs as $newSortValue => $targetRecordID) { if ($currentSortList[$targetRecordID]->$sortField != $newSortValue) { DB::query(sprintf( 'UPDATE "%s" SET "%s" = %d%s WHERE %s', $sortTable, $sortField, $newSortValue, $additionalSQL, $this->getSortTableClauseForIds($list, $targetRecordID) )); if (!$isBaseTable && !$list instanceof ManyManyList) { DB::query(sprintf( 'UPDATE "%s" SET "LastEdited" = \'%s\' WHERE %s', $baseTable, $now, $this->getSortTableClauseForIds($list, $targetRecordID) )); } } } } else { // For versioned objects, modify them with the ORM so that the // *_Versions table is updated. This ensures re-ordering works // similar to the SiteTree where you change the position, and then // you go into the record and publish it. foreach ($sortedIDs as $newSortValue => $targetRecordID) { // either the list data class (has_many, (belongs_)many_many) // or the intermediary join class (many_many through) $record = $currentSortList[$targetRecordID]; if ($record->$sortField != $newSortValue) { $record->$sortField = $newSortValue; $record->write(); } } } $this->extend('onAfterReorderItems', $list, $values, $sortedIDs); } protected function populateSortValues(DataList $list) { $list = clone $list; $field = $this->getSortField(); $table = $this->getSortTable($list); $clause = sprintf('"%s"."%s" = 0', $table, $this->getSortField()); $now = DBDatetime::now()->Rfc2822(); $additionalSQL = ''; $baseTable = DataObject::getSchema()->baseDataTable($list->dataClass()); $isBaseTable = ($baseTable == $table); if (!$list instanceof ManyManyList && $isBaseTable) { $additionalSQL = ", \"LastEdited\" = '$now'"; } foreach ($list->where($clause)->column('ID') as $id) { $max = DB::query(sprintf('SELECT MAX("%s") + 1 FROM "%s"', $field, $table)); $max = $max->value(); DB::query(sprintf( 'UPDATE "%s" SET "%s" = %d%s WHERE %s', $table, $field, $max, $additionalSQL, $this->getSortTableClauseForIds($list, $id) )); if (!$isBaseTable && !$this->isManyMany($list)) { DB::query(sprintf( 'UPDATE "%s" SET "LastEdited" = \'%s\' WHERE %s', $baseTable, $now, $this->getSortTableClauseForIds($list, $id) )); } } } /** * Forms a WHERE clause for the table the sort column is defined on. * e.g. ID = 5 * e.g. ID IN(5, 8, 10) * e.g. SortOrder = 5 AND RelatedThing.ID = 3 * e.g. SortOrder IN(5, 8, 10) AND RelatedThing.ID = 3 * * @param DataList $list * @param int|string|array $ids a single number, or array of numbers * * @return string */ protected function getSortTableClauseForIds(DataList $list, $ids) { if (is_array($ids)) { $value = 'IN (' . implode(', ', array_map('intval', $ids)) . ')'; } else { $value = '= ' . (int) $ids; } if ($this->isManyMany($list)) { $introspector = $this->getManyManyInspector($list); $extra = $list instanceof ManyManyList ? $introspector->getExtraFields() : DataObjectSchema::create()->fieldSpecs($introspector->getJoinClass(), DataObjectSchema::DB_ONLY); $key = $introspector->getLocalKey(); $foreignKey = $this->getManyManyInspectorForeignKey($introspector); $foreignID = (int) $list->getForeignID(); if ($extra && array_key_exists($this->getSortField(), $extra)) { return sprintf( '"%s" %s AND "%s" = %d', $key, $value, $foreignKey, $foreignID ); } } return "\"ID\" $value"; } /** * A ManyManyList defines functions such as getLocalKey, however on ManyManyThroughList * these functions are moved to ManyManyThroughQueryManipulator, but otherwise retain * the same signature. * * @param ManyManyList|ManyManyThroughList $list * * @return ManyManyList|ManyManyThroughQueryManipulator */ protected function getManyManyInspector($list) { $inspector = $list; if ($list instanceof ManyManyThroughList) { foreach ($list->dataQuery()->getDataQueryManipulators() as $manipulator) { if ($manipulator instanceof ManyManyThroughQueryManipulator) { $inspector = $manipulator; break; } } } return $inspector; } /** * Depending on the list inspector and the list itself (ManyMany vs ManyManyThrough), the method to obtain * the foreign key may be different. * * @param $inspector * @return string */ private function getManyManyInspectorForeignKey($inspector) { if (($inspector instanceof ManyManyThroughQueryManipulator) && (method_exists($inspector, 'getForeignIDKey'))) { // This method has been introduced in framework 4.1 return $inspector->getForeignIDKey(); } return $inspector->getForeignKey(); } /** * Used to get sort orders from a many many through list relationship record, rather than the current * record itself. * * @param ManyManyList|ManyManyThroughList $list * @return int[] Sort orders for the */ protected function getSortValuesFromManyManyThroughList($list, $sortField) { $manipulator = $this->getManyManyInspector($list); // Find the foreign key name, ID and class to look up $joinClass = $manipulator->getJoinClass(); $fromRelationName = $this->getManyManyInspectorForeignKey($manipulator); $toRelationName = $manipulator->getLocalKey(); // Create a list of the MMTL relations $sortlist = DataList::create($joinClass)->filter([ $toRelationName => $list->column('ID'), // first() is safe as there are earlier checks to ensure our list to sort is valid $fromRelationName => $list->first()->getJoin()->$fromRelationName, ]); return $sortlist->map($toRelationName, $sortField)->toArray(); } }