required = ArrayLib::valuekey($required); } else { $this->required = []; } parent::__construct(); } /** * Clears all the validation from this object. * * @return $this */ public function removeValidation() { parent::removeValidation(); $this->required = []; return $this; } /** * Debug helper * @return string */ public function debug() { if (!is_array($this->required)) { return false; } $result = "

"; foreach ($this->required as $name) { $result .= "
• $name
"; } $result .= "

"; return $result; } /** * Allows validation of fields via specification of a php function for * validation which is executed after the form is submitted. * * @param array $data * * @return boolean */ public function php($data) { $valid = true; $fields = $this->form->Fields(); foreach ($fields as $field) { $valid = ($field->validate($this) && $valid); } if (!$this->required) { return $valid; } foreach ($this->required as $fieldName) { if (!$fieldName) { continue; } if ($fieldName instanceof FormField) { $formField = $fieldName; $fieldName = $fieldName->getName(); } else { $formField = $fields->dataFieldByName($fieldName); } // submitted data for file upload fields come back as an array $value = isset($data[$fieldName]) ? $data[$fieldName] : null; if (is_array($value)) { if ($formField instanceof FileField && isset($value['error']) && $value['error']) { $error = true; } else { $error = (count($value ?? [])) ? false : true; } } else { $stringValue = (string) $value; if ($formField instanceof TreeDropdownField) { // test for blank string as well as '0' because older versions of silverstripe/admin FormBuilder // forms created using redux-form would have a value of null for unsaved records // the null value will have been converted to '' by the time it gets to this point $error = in_array($stringValue, ['0', '']); } else { $error = strlen($stringValue) > 0 ? false : true; } } if ($formField && $error) { $errorMessage = _t( 'SilverStripe\\Forms\\Form.FIELDISREQUIRED', '{name} is required', [ 'name' => strip_tags( '"' . ($formField->Title() ? $formField->Title() : $fieldName) . '"' ) ] ); if ($msg = $formField->getCustomValidationMessage()) { $errorMessage = $msg; } $this->validationError( $fieldName, $errorMessage, "required" ); $valid = false; } } return $valid; } /** * Adds a single required field to required fields stack. * * @param string $field * * @return $this */ public function addRequiredField($field) { $this->required[$field] = $field; return $this; } /** * Removes a required field * * @param string $field * * @return $this */ public function removeRequiredField($field) { unset($this->required[$field]); return $this; } /** * Add {@link RequiredField} objects together * * @param RequiredFields $requiredFields * @return $this */ public function appendRequiredFields($requiredFields) { $this->required = $this->required + ArrayLib::valuekey( $requiredFields->getRequired() ); return $this; } /** * Returns true if the named field is "required". * * Used by {@link FormField} to return a value for FormField::Required(), * to do things like show *s on the form template. * * @param string $fieldName * * @return boolean */ public function fieldIsRequired($fieldName) { return isset($this->required[$fieldName]); } /** * Return the required fields * * @return array */ public function getRequired() { return array_values($this->required ?? []); } /** * @return bool */ public function canBeCached(): bool { return count($this->getRequired() ?? []) === 0; } }