field name of the $has_one Model Image relation * 'editableFields' => fields editable on the Model * 'fieldsClassBlacklist' => field types that will be removed from the automatic form generation * 'fieldsNameBlacklist' => fields that will be removed from the automatic form generation * * @var array */ protected $config = array( 'editableFields' => null, 'fieldsClassBlacklist' => array(), 'fieldsNameBlacklist' => array(), 'actions' => array() ); /** * Holds any class that should not be used as they break the component * These cannot be removed from the blacklist */ protected $forbiddenFieldsClasses = array( 'GridField', 'UploadField' ); public function __construct($editableFields = null, $defaultActions = true) { if ( $editableFields != null ) $this->setConfig ( 'editableFields', $editableFields ); $this->config['fieldsClassBlacklist'] = $this->forbiddenFieldsClasses; if ( $defaultActions ) { $this->config['actions'] = array( 'edit' => array( 'label' => _t('GridFieldBulkTools.EDIT_SELECT_LABEL', 'Edit'), 'handler' => 'GridFieldBulkManager_Request' ), 'unlink' => array( 'label' => _t('GridFieldBulkTools.UNLINK_SELECT_LABEL', 'UnLink'), 'handler' => 'GridFieldBulkManager_Request' ), 'delete' => array( 'label' => _t('GridFieldBulkTools.DELETE_SELECT_LABEL', 'Delete'), 'handler' => 'GridFieldBulkManager_Request' ) ); } } /** * Set a component configuration parameter * * @param string $reference * @param mixed $value */ function setConfig ( $reference, $value ) { if (!key_exists($reference, $this->config) ) { user_error("Unknown option reference: $reference", E_USER_ERROR); } if ( $reference == 'actions' ) { user_error("Bulk actions must be edited via addBulkAction() and removeBulkAction()", E_USER_ERROR); } if ( ($reference == 'fieldsClassBlacklist' || $reference == 'fieldsClassBlacklist' || $reference == 'editableFields') && !is_array($value) ) { $value = array($value); } //makes sure $forbiddenFieldsClasses are in no matter what if ( $reference == 'fieldsClassBlacklist' ) { $value = array_unique( array_merge($value, $this->forbiddenFieldsClasses) ); } $this->config[$reference] = $value; return $this; } /** * Returns one $config parameter of the full $config * * @param string $reference $congif parameter to return * @return mixed */ function getConfig ( $reference = false ) { if ( $reference ) return $this->config[$reference]; else return $this->config; } /** * Add a field to the editable fields blacklist * * @param string $fieldName * @return boolean */ function addFieldNameToBlacklist ( $fieldName ) { return array_push( $this->config['fieldsNameBlacklist'], $fieldName); } /** * Add a class to the editable fields blacklist * * @param string $className * @return boolean */ function addClassToBlacklist ( $className ) { return array_push( $this->config['fieldsClassBlacklist'], $className); } /** * Remove a field to the editable fields blacklist * * @param string $fieldName * @return boolean */ function removeFieldNameFromBlacklist ( $fieldName ) { if (key_exists($fieldName, $this->config['fieldsNameBlacklist'])) { return delete( $this->config['fieldsNameBlacklist'][$fieldName] ); }else{ return false; } } /** * Remove a class to the editable fields blacklist * * @param string $className * @return boolean */ function removeClassFromBlacklist ( $className ) { if (key_exists($className, $this->config['fieldsNameBlacklist']) && !in_array($className, $this->forbiddenFieldsClasses)) { return delete( $this->config['fieldsNameBlacklist'][$className] ); }else{ return false; } } /** * Lets you add custom bulk actions to the bulk manager interface * * @todo add config options for front-end: isAjax, icon * * @param string $name Bulk action's name. Used by RequestHandler. * @param string $label Dropdown menu action's label. Default to ucfirst($name). * @param string $handler RequestHandler class name for this action. Default to 'GridFieldBulkAction'.ucfirst($name).'Handler' * @return GridFieldBulkManager Current GridFieldBulkManager instance */ function addBulkAction(string $name, $label = null, $handler = null) { if ( array_key_exists($name, $this->config['actions']) ) { user_error("Bulk action $name already exists.", E_USER_ERROR); } $name = strtolower($name); if ( !$label ) { $label = ucfirst($name); } if ( !$handler ) { $handler = 'GridFieldBulkAction'.ucfirst($name).'Handler'; } if ( !ClassInfo::exists( $handler ) ) { user_error("Bulk action handler for $name not found: $handler", E_USER_ERROR); } $this->config['actions'][$name] = array( 'label' => $label, 'handler' => $handler ); return $this; } /** * Removes a bulk actions from the bulk manager interface * * @param string $name Bulk action's name * @return GridFieldBulkManager Current GridFieldBulkManager instance */ function removeBulkAction(string $name) { if ( !array_key_exists($name, $this->config['actions']) ) { user_error("Bulk action $name doesn't exists.", E_USER_ERROR); } unset( $this->config['actions'][$name] ); return $this; } /* GridField_ColumnProvider */ function augmentColumns($gridField, &$columns) { if(!in_array('BulkSelect', $columns)) $columns[] = 'BulkSelect'; } function getColumnsHandled($gridField) { return array('BulkSelect'); } function getColumnContent($gridField, $record, $columnName) { $cb = CheckboxField::create('bulkSelect_'.$record->ID) ->addExtraClass('bulkSelect no-change-track'); return $cb->Field(); } function getColumnAttributes($gridField, $record, $columnName) { return array('class' => 'col-bulkSelect'); } function getColumnMetadata($gridField, $columnName) { if($columnName == 'BulkSelect') { return array('title' => 'Select'); } } /* // GridField_ColumnProvider */ /** * * @param GridField $gridField * @return array */ public function getHTMLFragments($gridField) { Requirements::css(BULK_EDIT_TOOLS_PATH . '/css/GridFieldBulkManager.css'); Requirements::javascript(BULK_EDIT_TOOLS_PATH . '/javascript/GridFieldBulkManager.js'); if ( !count($this->config['actions']) ) { user_error("Trying to use GridFieldBulkManager without any bulk action.", E_USER_ERROR); } $actionsListSource = array(); foreach ($this->config['actions'] as $action => $actionData) { $actionsListSource[$action] = $actionData['label']; } $dropDownActionsList = DropdownField::create('bulkActionName', '') ->setSource( $actionsListSource ) ->setAttribute('class', 'bulkActionName no-change-track') ->setAttribute('id', ''); $templateData = new ArrayData(array( 'Menu' => $dropDownActionsList->FieldHolder(), 'Button' => array( 'Label' => _t('GridFieldBulkTools.ACTION_BTN_LABEL', 'Go'), 'DataURL' => $gridField->Link('bulkaction') ), 'Select' => array( 'Label' => _t('GridFieldBulkTools.SELECT_ALL_LABEL', 'Select all') ) )); $args = array('Colspan' => count($gridField->getColumns())-1); return array( 'header' => $templateData->renderWith('BulkManagerButtons', $args) ); } /** * * @param GridField $gridField * @return array */ public function getURLHandlers($gridField) { return array( 'bulkaction' => 'handlebulkaction' ); } /** * Pass control over to the RequestHandler * * @param GridField $gridField * @param SS_HTTPRequest $request * @return mixed */ public function handlebulkaction($gridField, $request) { $bulkAction = strtolower( $request->remaining() ); $controller = $gridField->getForm()->Controller(); if ( isset($this->config['actions'][$bulkAction]) ) { $handlerClass = $this->config['actions'][$bulkAction]['handler']; $handler = Injector::inst()->create($handlerClass, $gridField, $this, $controller); return $handler->handleRequest($request, DataModel::inst()); } } }