MINOR: Add Previous, Next and Create New actions in edit form

If the form is opened via a grid field, the filters will be retained so the previous/next record opened will be correct

_config/buttons.yml

@@ -0,0 +1,8 @@
+---
+Name: buttons
+---
+SilverStripe\Forms\GridField\GridFieldDetailForm_ItemRequest:
+  formActions:
+    showPrevious: true
+    showNext: true
+    showAdd: true

docs/en/02_Developer_Guides/15_Customising_the_Admin_Interface/How_Tos/Customise_CMS_Menu.md

@@ -124,6 +124,17 @@ SilverStripe\Admin\LeftAndMain:
     'Feedback': ''
 ```
 
+## Customising the CMS form actions
+
+The `Previous`, `Next` and `Add` actions on the edit form are visible by default but can be hidden by adding the following `.yml` config:
+
+```yml
+FormActions:
+  showPrevious: false
+  showNext: false
+  showAdd: false
+```
+
 ## Related
 
  * [How to extend the CMS interface](extend_cms_interface)

src/Forms/GridField/GridFieldDetailForm.php

@@ -93,6 +93,10 @@ public function __construct($name = 'DetailForm')
      */
     public function handleItem($gridField, $request)
     {
+        if ($gridStateStr = $request->getVar('gridState')) {
+            $gridField->getState(false)->setValue($gridStateStr);
+        }
+
         // Our getController could either give us a true Controller, if this is the top-level GridField.
         // It could also give us a RequestHandler in the form of GridFieldDetailForm_ItemRequest if this is a
         // nested GridField.

src/Forms/GridField/GridFieldDetailForm_ItemRequest.php

@@ -7,9 +7,12 @@
 use SilverStripe\Control\HTTPRequest;
 use SilverStripe\Control\HTTPResponse;
 use SilverStripe\Control\RequestHandler;
+use SilverStripe\Core\Config\Config;
+use SilverStripe\Forms\CompositeField;
 use SilverStripe\Forms\FieldList;
 use SilverStripe\Forms\Form;
 use SilverStripe\Forms\FormAction;
+use SilverStripe\Forms\HiddenField;
 use SilverStripe\Forms\LiteralField;
 use SilverStripe\ORM\ArrayList;
 use SilverStripe\ORM\DataObject;
@@ -278,6 +281,7 @@ protected function getFormActions()
         $canEdit = $this->record->canEdit();
         $canDelete = $this->record->canDelete();
         $actions = new FieldList();
+
         if ($this->record->ID !== 0) {
             if ($canEdit) {
                 $actions->push(FormAction::create('doSave', _t('SilverStripe\\Forms\\GridField\\GridFieldDetailForm.Save', 'Save'))
@@ -290,6 +294,52 @@ protected function getFormActions()
                     ->setUseButtonTag(true)
                     ->addExtraClass('btn-outline-danger btn-hide-outline font-icon-trash-bin action--delete'));
             }
+
+            $gridStateStr = $this->getRequest()->requestVar('gridState');
+
+            $this->gridField->getState(false)->setValue($gridStateStr);
+            $actions->push(HiddenField::create('gridState', null, $gridStateStr));
+
+            $rightGroup = CompositeField::create()->setName('RightGroup');
+            $rightGroup->addExtraClass('right');
+            $rightGroup->setFieldHolderTemplate(get_class($rightGroup) . '_holder_buttongroup');
+
+            $previousAndNextGroup = CompositeField::create()->setName('PreviousAndNextGroup');
+            $previousAndNextGroup->addExtraClass('rounded');
+            $previousAndNextGroup->setFieldHolderTemplate(get_class($previousAndNextGroup) . '_holder_buttongroup');
+
+            $formActionsConfig = $this->config()->get("formActions");
+            $showPrevious = $formActionsConfig["showPrevious"];
+            $showNext = $formActionsConfig["showNext"];
+            $showAdd = $formActionsConfig["showAdd"];
+
+            if ($showPrevious) {
+                $previousAndNextGroup->push(FormAction::create('doPrev')
+                    ->setUseButtonTag(true)
+                    ->setAttribute('data-grid-state', $gridStateStr)
+                    ->setDisabled(!$this->getPreviousRecordID())
+                    ->setAttribute('data-text-alternate', 'Previous')
+                    ->addExtraClass('btn btn-secondary font-icon-left-open action--previous'));
+            }
+
+            if ($showNext) {
+                $previousAndNextGroup->push(FormAction::create('doNext')
+                    ->setUseButtonTag(true)
+                    ->setAttribute('data-grid-state', $gridStateStr)
+                    ->setDisabled(!$this->getNextRecordID())
+                    ->setAttribute('data-text-alternate', 'Next')
+                    ->addExtraClass('btn btn-secondary font-icon-right-open action--next'));
+            }
+
+            $rightGroup->push($previousAndNextGroup);
+
+
+            if ($showAdd) {
+                $rightGroup->push(FormAction::create('doNew')
+                    ->setUseButtonTag(true)
+                    ->setAttribute('data-grid-state', $this->getRequest()->getVar('gridState'))
+                    ->addExtraClass('btn btn-primary font-icon-plus rounded'));
+            }
         } else { // adding new record
             //Change the Save label to 'Create'
             $actions->push(FormAction::create('doSave', _t('SilverStripe\\Forms\\GridField\\GridFieldDetailForm.Create', 'Create'))
@@ -309,7 +359,13 @@ protected function getFormActions()
                 $actions->push(new LiteralField('cancelbutton', $text));
             }
         }
+
         $this->extend('updateFormActions', $actions);
+
+        if (isset($rightGroup)) {
+            $actions->push($rightGroup);
+        }
+
         return $actions;
     }
 
@@ -410,6 +466,94 @@ public function doSave($data, $form)
         return $this->redirectAfterSave($isNewRecord);
     }
 
+    /**
+     * Goes to the next record
+     * @param  array $data The form data
+     * @param  Form $form The Form object
+     * @return HTTPResponse
+     */
+    public function doNext($data, $form)
+    {
+        Controller::curr()->getResponse()->addHeader("X-Pjax", "Content");
+        $link = $this->getEditLink($this->getNextRecordID());
+        return Controller::curr()->redirect($link);
+    }
+
+    /**
+     * Goes to the previous record
+     * @param  array $data The form data
+     * @param  Form $form The Form object
+     * @return HTTPResponse
+     */
+    public function doPrev($data, $form)
+    {
+        Controller::curr()->getResponse()->addHeader("X-Pjax", "Content");
+        $link = $this->getEditLink($this->getPreviousRecordID());
+        return Controller::curr()->redirect($link);
+    }
+
+    /**
+     * Creates a new record. If you're already creating a new record,
+     * this forces the URL to change.
+     *
+     * @param  array $data The form data
+     * @param  Form $form The Form object
+     * @return HTTPResponse
+     */
+    public function doNew($data, $form)
+    {
+        return Controller::curr()->redirect($this->Link('addnew'));
+    }
+
+    /**
+     * Gets the edit link for a record
+     *
+     * @param  int $id The ID of the record in the GridField
+     * @return string
+     */
+    public function getEditLink($id)
+    {
+        return Controller::join_links(
+            $this->gridField->Link(),
+            "item",
+            $id,
+            // todo: use http header instead
+            '?gridState=' . urlencode($this->gridField->getState(false)->Value())
+        );
+    }
+
+    /**
+     * Gets the ID of the previous record in the list.
+     *
+     * @return int
+     */
+    public function getPreviousRecordID()
+    {
+        $gridField = $this->gridField;
+        $gridStateStr = $this->getRequest()->postVar('gridState');
+        $gridField->getState(false)->setValue($gridStateStr);
+
+        $map = $gridField->getManipulatedList()->limit(PHP_INT_MAX, 0)->column('ID');
+        $offset = array_search($this->record->ID, $map);
+        return isset($map[$offset-1]) ? $map[$offset-1] : false;
+    }
+
+    /**
+     * Gets the ID of the next record in the list.
+     *
+     * @return int
+     */
+    public function getNextRecordID()
+    {
+        $gridField = $this->gridField;
+        $gridStateStr = $this->getRequest()->postVar('gridState');
+        $gridField->getState(false)->setValue($gridStateStr);
+
+        $map = $gridField->getManipulatedList()->limit(PHP_INT_MAX, 0)->column('ID');
+        $offset = array_search($this->record->ID, $map);
+        return isset($map[$offset+1]) ? $map[$offset+1] : false;
+    }
+
     /**
      * Response object for this request after a successful save
      *

src/Forms/GridField/GridFieldEditButton.php

@@ -62,7 +62,12 @@ public function getExtraData($gridField, $record, $columnName)
      */
     public function getUrl($gridField, $record, $columnName)
     {
-        return Controller::join_links($gridField->Link('item'), $record->ID, 'edit');
+        return Controller::join_links(
+            $gridField->Link('item'),
+            $record->ID,
+            'edit',
+            '?gridState=' . urlencode($gridField->getState(false)->Value())
+        );
     }
 
     /**