* $action = new GridFieldDeleteAction(); // delete objects permanently * * // removes the relation to object instead of deleting * $action = new GridFieldDeleteAction(true); * * * @package forms * @subpackage fields-gridfield */ class GridFieldDeleteAction implements GridField_ColumnProvider, GridField_ActionProvider { /** * If this is set to true, this {@link GridField_ActionProvider} will * remove the object from the list, instead of deleting. * * In the case of a has one, has many or many many list it will uncouple * the item from the list. * * @var boolean */ protected $removeRelation = false; /** * * @param boolean $removeRelation - true if removing the item from the list, but not deleting it */ public function __construct($removeRelation = false) { $this->removeRelation = $removeRelation; } /** * Add a column 'Delete' * * @param GridField $gridField * @param array $columns */ public function augmentColumns($gridField, &$columns) { if(!in_array('Actions', $columns)) { $columns[] = 'Actions'; } } /** * Return any special attributes that will be used for FormField::create_tag() * * @param GridField $gridField * @param DataObject $record * @param string $columnName * @return array */ public function getColumnAttributes($gridField, $record, $columnName) { return array('class' => 'grid-field__col-compact'); } /** * Add the title * * @param GridField $gridField * @param string $columnName * @return array */ public function getColumnMetadata($gridField, $columnName) { if($columnName == 'Actions') { return array('title' => ''); } } /** * Which columns are handled by this component * * @param GridField $gridField * @return array */ public function getColumnsHandled($gridField) { return array('Actions'); } /** * Which GridField actions are this component handling * * @param GridField $gridField * @return array */ public function getActions($gridField) { return array('deleterecord', 'unlinkrelation'); } /** * * @param GridField $gridField * @param DataObject $record * @param string $columnName * @return string - the HTML for the column */ public function getColumnContent($gridField, $record, $columnName) { if($this->removeRelation) { if(!$record->canEdit()) return; $field = GridField_FormAction::create($gridField, 'UnlinkRelation'.$record->ID, false, "unlinkrelation", array('RecordID' => $record->ID)) ->addExtraClass('btn btn--no-text btn--icon-md font-icon-link-broken grid-field__icon-action gridfield-button-unlink') ->setAttribute('title', _t('GridAction.UnlinkRelation', "Unlink")); } else { if(!$record->canDelete()) return; $field = GridField_FormAction::create($gridField, 'DeleteRecord'.$record->ID, false, "deleterecord", array('RecordID' => $record->ID)) ->addExtraClass('gridfield-button-delete btn--icon-md font-icon-trash-bin btn--no-text grid-field__icon-action') ->setAttribute('title', _t('GridAction.Delete', "Delete")) ->setDescription(_t('GridAction.DELETE_DESCRIPTION','Delete')); } return $field->Field(); } /** * Handle the actions and apply any changes to the GridField * * @param GridField $gridField * @param string $actionName * @param mixed $arguments * @param array $data - form data * @return void */ public function handleAction(GridField $gridField, $actionName, $arguments, $data) { if($actionName == 'deleterecord' || $actionName == 'unlinkrelation') { $item = $gridField->getList()->byID($arguments['RecordID']); if(!$item) { return; } if($actionName == 'deleterecord') { if(!$item->canDelete()) { throw new ValidationException( _t('GridFieldAction_Delete.DeletePermissionsFailure',"No delete permissions"),0); } $item->delete(); } else { if(!$item->canEdit()) { throw new ValidationException( _t('GridFieldAction_Delete.EditPermissionsFailure',"No permission to unlink record"),0); } $gridField->getList()->remove($item); } } } }