tonyair
/
sortablegridfield
mirror of https://github.com/UndefinedOffset/SortableGridField.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge remote-tracking branch 'UndefinedOffset/master'

This commit is contained in:
Tomáš Bílek 2013-01-03 15:12:08 +01:00
parent f07d31af29 ee001c388c
commit 0ea3730cf7
3 changed files with 23 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
README.md
View File

@ -1,10 +1,10 @@
SortableGridField
=================
Adds drag and drop functionality to SilverStripe 3.0's GridField
Adds drag and drop functionality to SilverStripe 3's GridField
## Requirments
* SilverStripe 3.0
## Requirements
* SilverStripe 3.x
## Installation
* Download the module from here https://github.com/UndefinedOffset/SortableGridField/downloads
@ -13,7 +13,7 @@ Adds drag and drop functionality to SilverStripe 3.0's GridField
* Upon entering the cms and using GridFieldSortableRows component for the first time you make need to add ?flush=all to the end of the address to force the templates to regenerate
## Usage
To enable sorting on a has_many relationship set up an interger field on your data object. Also for has_many relationships make sure to set the $default_sort on the dataobject to this new interger field to ensure that the sort order is applied when the relationship is requested. For many_many relationships you must add a $many_many_extraFields static to the data object defining the relationship, see the SilverStripe documentation for more information on this. If you are using a many_many relationship you will need to do a custom getter to set the sort order of this relationship for use on the front end see bellow for an example. For new DataObjects you do not need to increment the Sort order yourself in your DataObject GridFieldSortableRows will automatically do this the next time the grid is displayed.
To enable sorting on a has_many relationship set up an integer field on your data object. Also for has_many relationships make sure to set the $default_sort on the dataobject to this new integer field to ensure that the sort order is applied when the relationship is requested. For many_many relationships you must add a $many_many_extraFields static to the data object defining the relationship, see the SilverStripe documentation for more information on this. If you are using a many_many relationship you will need to do a custom getter to set the sort order of this relationship for use on the front end see bellow for an example. For new DataObjects you do not need to increment the Sort order yourself in your DataObject GridFieldSortableRows will automatically do this the next time the grid is displayed.
```php
public function getMyManyManyRelationship() {
@ -31,5 +31,16 @@ $myGridConfig->addComponent(new GridFieldSortableRows('{Column to store sort}'))
To move an item to another page drag the row over the respective page button and release.
#### Full code Examples
* [has_many relationship] (https://github.com/UndefinedOffset/SortableGridField/blob/master/docs/HasManyExample.md)
* [many_many relationship] (https://github.com/UndefinedOffset/SortableGridField/blob/master/docs/ManyManyExample.md)
## Migrating from SilverStripe 2.4 and Data Object Manager's SortableDataObject
SortableGridField is not the same as SortableDataObject, since it is only a component of GridField it does not have the ability to catch the object when it is saved for the first time. So SortableGridField uses 1 as the first sort index because 0 is the default for an integer field/column in the database. For migrations from 2.4 with SortableDataObject you need to setup your DataObject based on the instructions above however you must name your sort column "SortOrder" to maintain your sort indexes defined by SortableDataObject. Then you need to run the following query on the table containing your sort field, for many_many relationships this will be something like {RelationshipClass}_{RelationshipName}. This query will maintain your sort order from SortableDataObject but increment the index by 1 giving it a starting number of 1.
```sql
UPDATE YourTable SET SortOrder=SortOrder+1;
```
## @TODO
* Optimize re-ordering of a has_many relationship when sorting on a single page

5
code/forms/GridFieldSortableRows.php
View File

@ -115,7 +115,10 @@ class GridFieldSortableRows implements GridField_HTMLProvider, GridField_ActionP
*/
protected function fixSortColumn($gridField, SS_List $dataList) {
$list=clone $dataList;
$list->dataQuery()->limit(array());
$list=$list->alterDataQuery(function($query, SS_List $tmplist) {
$query->limit(array());
return $query;
});
$many_many = ($list instanceof ManyManyList);
if (!$many_many) {

7
composer.json
View File

@ -7,12 +7,13 @@
{
"name": "Ed Chipman",
"homepage": "http://www.edchipman.ca",
"role": "Developer"
"role": "Developer"
}
],
"require":
{
"silverstripe/framework": "3.*"
"silverstripe/framework": "3.*",
"composer/installers": "*"
}
}
}