2011-12-06 01:56:24 +01:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* GridFieldSortableHeader adds column headers to a gridfield that can also sort the columns
|
|
|
|
*
|
|
|
|
* @see GridField
|
|
|
|
*
|
|
|
|
* @package sapphire
|
|
|
|
* @subpackage fields-relational
|
|
|
|
*/
|
|
|
|
class GridFieldSortableHeader implements GridField_HTMLProvider, GridField_DataManipulator, GridField_ActionProvider {
|
2012-03-09 02:32:16 +01:00
|
|
|
|
|
|
|
/**
|
2012-03-10 02:44:12 +01:00
|
|
|
* See {@link setThrowExceptionOnBadDataType()}
|
2012-03-09 02:32:16 +01:00
|
|
|
*/
|
|
|
|
protected $throwExceptionOnBadDataType = true;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Determine what happens when this component is used with a list that isn't {@link SS_Filterable}.
|
|
|
|
*
|
|
|
|
* - true: An exception is thrown
|
|
|
|
* - false: This component will be ignored - it won't make any changes to the GridField.
|
|
|
|
*
|
|
|
|
* By default, this is set to true so that it's clearer what's happening, but the predefined
|
|
|
|
* {@link GridFieldConfig} subclasses set this to false for flexibility.
|
|
|
|
*/
|
2012-03-10 02:44:12 +01:00
|
|
|
public function setThrowExceptionOnBadDataType($throwExceptionOnBadDataType) {
|
2012-03-09 02:32:16 +01:00
|
|
|
$this->throwExceptionOnBadDataType = $throwExceptionOnBadDataType;
|
|
|
|
}
|
2012-03-10 02:44:12 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* See {@link setThrowExceptionOnBadDataType()}
|
|
|
|
*/
|
|
|
|
public function getThrowExceptionOnBadDataType() {
|
|
|
|
return $this->throwExceptionOnBadDataType;
|
|
|
|
}
|
2012-03-09 02:32:16 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Check that this dataList is of the right data type.
|
|
|
|
* Returns false if it's a bad data type, and if appropriate, throws an exception.
|
|
|
|
*/
|
|
|
|
protected function checkDataType($dataList) {
|
|
|
|
if($dataList instanceof SS_Sortable) {
|
|
|
|
return true;
|
|
|
|
} else {
|
|
|
|
if($this->throwExceptionOnBadDataType) {
|
|
|
|
throw new LogicException(get_class($this) . " expects an SS_Sortable list to be passed to the GridField.");
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
2011-12-06 01:56:24 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the header row providing titles with sort buttons
|
|
|
|
*/
|
|
|
|
public function getHTMLFragments($gridField) {
|
2012-03-09 02:32:16 +01:00
|
|
|
if(!$this->checkDataType($gridField->getList())) return;
|
|
|
|
|
2011-12-06 01:56:24 +01:00
|
|
|
$forTemplate = new ArrayData(array());
|
|
|
|
$forTemplate->Fields = new ArrayList;
|
|
|
|
|
|
|
|
$state = $gridField->State->GridFieldSortableHeader;
|
|
|
|
$columns = $gridField->getColumns();
|
|
|
|
|
|
|
|
foreach($columns as $columnField) {
|
|
|
|
$metadata = $gridField->getColumnMetadata($columnField);
|
|
|
|
$title = $metadata['title'];
|
|
|
|
if($title && $gridField->getList()->canSortBy($columnField)) {
|
|
|
|
$dir = 'asc';
|
|
|
|
if($state->SortColumn == $columnField && $state->SortDirection == 'asc') {
|
|
|
|
$dir = 'desc';
|
|
|
|
}
|
|
|
|
|
2012-03-06 16:58:13 +01:00
|
|
|
$field = Object::create(
|
2012-03-06 12:51:57 +01:00
|
|
|
'GridField_FormAction', $gridField, 'SetOrder'.$columnField, $title,
|
2012-03-06 16:58:13 +01:00
|
|
|
"sort$dir", array('SortColumn' => $columnField)
|
|
|
|
)->addExtraClass('ss-gridfield-sort');
|
2011-12-06 01:56:24 +01:00
|
|
|
|
|
|
|
if($state->SortColumn == $columnField){
|
|
|
|
$field->addExtraClass('ss-gridfield-sorted');
|
2012-02-29 02:34:06 +01:00
|
|
|
|
|
|
|
if($state->SortDirection == 'asc')
|
|
|
|
$field->addExtraClass('ss-gridfield-sorted-asc');
|
|
|
|
else
|
|
|
|
$field->addExtraClass('ss-gridfield-sorted-desc');
|
2011-12-06 01:56:24 +01:00
|
|
|
}
|
|
|
|
} else {
|
2012-03-01 23:06:24 +01:00
|
|
|
$field = new LiteralField($columnField, '<span class="non-sortable">' . $title . '</span>');
|
2011-12-06 01:56:24 +01:00
|
|
|
}
|
|
|
|
$forTemplate->Fields->push($field);
|
|
|
|
}
|
|
|
|
|
|
|
|
return array(
|
|
|
|
'header' => $forTemplate->renderWith('GridFieldSortableHeader_Row'),
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
*
|
|
|
|
* @param GridField $gridField
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
public function getActions($gridField) {
|
2012-03-09 02:32:16 +01:00
|
|
|
if(!$this->checkDataType($gridField->getList())) return;
|
|
|
|
|
2011-12-06 01:56:24 +01:00
|
|
|
return array('sortasc', 'sortdesc');
|
|
|
|
}
|
|
|
|
|
|
|
|
function handleAction(GridField $gridField, $actionName, $arguments, $data) {
|
2012-03-09 02:32:16 +01:00
|
|
|
if(!$this->checkDataType($gridField->getList())) return;
|
|
|
|
|
2011-12-06 01:56:24 +01:00
|
|
|
$state = $gridField->State->GridFieldSortableHeader;
|
|
|
|
switch($actionName) {
|
|
|
|
case 'sortasc':
|
|
|
|
$state->SortColumn = $arguments['SortColumn'];
|
|
|
|
$state->SortDirection = 'asc';
|
|
|
|
break;
|
|
|
|
|
|
|
|
case 'sortdesc':
|
|
|
|
$state->SortColumn = $arguments['SortColumn'];
|
|
|
|
$state->SortDirection = 'desc';
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public function getManipulatedData(GridField $gridField, SS_List $dataList) {
|
2012-03-09 02:32:16 +01:00
|
|
|
if(!$this->checkDataType($dataList)) return $dataList;
|
|
|
|
|
2011-12-06 01:56:24 +01:00
|
|
|
$state = $gridField->State->GridFieldSortableHeader;
|
|
|
|
if ($state->SortColumn == "") {
|
|
|
|
return $dataList;
|
|
|
|
}
|
|
|
|
return $dataList->sort($state->SortColumn, $state->SortDirection);
|
|
|
|
}
|
2012-03-24 04:04:52 +01:00
|
|
|
}
|