mirror of
https://github.com/silverstripe/silverstripe-userforms.git
synced 2024-09-29 20:59:15 +02:00
f6f1085029
BUGFIX Check for readonly when checking edit and delete permissions on FieldEditor BUGFIX Don't just show "None" when the page is in readonly mode and showing the Fields tab, instead show a readonly representation of the field editor
390 lines
10 KiB
PHP
Executable File
390 lines
10 KiB
PHP
Executable File
<?php
|
|
/**
|
|
* Represents the base class of a editable form field
|
|
* object like {@link EditableTextField}.
|
|
*
|
|
* @package userforms
|
|
*/
|
|
class EditableFormField extends DataObject {
|
|
|
|
static $default_sort = "Sort";
|
|
|
|
static $db = array(
|
|
"Name" => "Varchar",
|
|
"Title" => "Varchar(255)",
|
|
"Default" => "Varchar",
|
|
"Sort" => "Int",
|
|
"Required" => "Boolean",
|
|
"CanDelete" => "Boolean",
|
|
"CustomErrorMessage" => "Varchar(255)",
|
|
"CustomRules" => "Text",
|
|
"CustomSettings" => "Text"
|
|
);
|
|
|
|
static $defaults = array(
|
|
"CanDelete" => "1",
|
|
"ShowOnLoad" => "1"
|
|
);
|
|
|
|
static $has_one = array(
|
|
"Parent" => "SiteTree",
|
|
);
|
|
|
|
/**
|
|
* @var FieldEditor The current editor
|
|
*/
|
|
protected $editor;
|
|
|
|
protected $readonly;
|
|
|
|
/**
|
|
* Construct a new EditableFormField Object.
|
|
*
|
|
* @param array|null $record This will be null for a new database record.
|
|
* @param boolean $isSingleton This this to true if this is a singleton() object, a stub for calling methods.
|
|
*/
|
|
public function __construct($record = null, $isSingleton = false) {
|
|
parent::__construct($record, $isSingleton);
|
|
}
|
|
|
|
/**
|
|
* Set the FieldEditor object for this field.
|
|
*
|
|
* @param FieldEditor The Editor window you wish to use
|
|
*/
|
|
public function setEditor($editor) {
|
|
$this->editor = $editor;
|
|
}
|
|
|
|
/**
|
|
* Set this formfield to readonly
|
|
*/
|
|
public function setReadonly() {
|
|
$this->readonly = true;
|
|
}
|
|
|
|
/**
|
|
* Is this multipleoption field readonly to the user
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function isReadonly() {
|
|
return $this->readonly;
|
|
}
|
|
|
|
function EditSegment() {
|
|
return $this->renderWith('EditableFormField');
|
|
}
|
|
|
|
function ClassName() {
|
|
return $this->class;
|
|
}
|
|
|
|
/**
|
|
* Return whether a user can delete this form field
|
|
* based on whether they can edit the page
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function canDelete() {
|
|
return $this->Parent()->canEdit();
|
|
}
|
|
|
|
/**
|
|
* Return whether a user can edit this form field
|
|
* based on whether they can edit the page
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function canEdit() {
|
|
return $this->Parent()->canEdit();
|
|
}
|
|
|
|
/**
|
|
* Show this form on load or not
|
|
*
|
|
* @return bool
|
|
*/
|
|
function ShowOnLoad() {
|
|
return ($this->getSetting('ShowOnLoad') == "Show" || $this->getSetting('ShowOnLoad') == '') ? true : false;
|
|
}
|
|
|
|
/**
|
|
* To prevent having tables for each fields minor settings we store it as
|
|
* a serialized array in the database.
|
|
*
|
|
* @return Array Return all the Settings
|
|
*/
|
|
protected function getFieldSettings() {
|
|
return (isset($this->CustomSettings)) ? unserialize($this->CustomSettings) : array();
|
|
}
|
|
|
|
/**
|
|
* Set the custom settings for this field as we store the minor details in
|
|
* a serialized array in the database
|
|
*
|
|
* @param Array the custom settings
|
|
*/
|
|
protected function setFieldSettings($settings = array()) {
|
|
$this->CustomSettings = serialize($settings);
|
|
}
|
|
|
|
/**
|
|
* Return just one custom setting or empty string if it does
|
|
* not exist
|
|
*
|
|
* @param String Value to use as key
|
|
* @return String
|
|
*/
|
|
public function getSetting($setting) {
|
|
$settings = $this->getFieldSettings();
|
|
if(isset($settings) && count($settings) > 0) {
|
|
if(isset($settings[$setting])) {
|
|
return $settings[$setting];
|
|
}
|
|
}
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* Get the path to the icon for this field type, relative to the site root.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function Icon() {
|
|
return 'userforms/images/' . strtolower($this->class) . '.png';
|
|
}
|
|
|
|
/**
|
|
* Return whether or not this field has addable options
|
|
* such as a dropdown field or radio set
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getHasAddableOptions() {
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Return whether or not this field needs to show the extra
|
|
* options dropdown list
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function showExtraOptions() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Return the Custom Validation fields for this
|
|
* field for the CMS
|
|
*
|
|
* @return array
|
|
*/
|
|
public function Dependencies() {
|
|
return ($this->CustomRules) ? unserialize($this->CustomRules) : array();
|
|
}
|
|
/**
|
|
* Return the custom validation fields for the field
|
|
*
|
|
* @return DataObjectSet
|
|
*/
|
|
public function CustomRules() {
|
|
$output = new DataObjectSet();
|
|
$fields = $this->Parent()->Fields();
|
|
|
|
// check for existing ones
|
|
if($this->CustomRules) {
|
|
$rules = unserialize($this->CustomRules);
|
|
|
|
if($rules) {
|
|
foreach($rules as $rule => $data) {
|
|
// recreate all the field object to prevent caching
|
|
$outputFields = new DataObjectSet();
|
|
foreach($fields as $field) {
|
|
$new = clone $field;
|
|
$new->isSelected = ($new->Name == $data['ConditionField']) ? true : false;
|
|
$outputFields->push($new);
|
|
}
|
|
$output->push(new ArrayData(array(
|
|
'FieldName' => $this->FieldName(),
|
|
'Display' => $data['Display'],
|
|
'Fields' => $outputFields,
|
|
'ConditionField' => $data['ConditionField'],
|
|
'ConditionOption' => $data['ConditionOption'],
|
|
'Value' => $data['Value']
|
|
)));
|
|
}
|
|
}
|
|
}
|
|
return $output;
|
|
}
|
|
|
|
function TitleField() {
|
|
$titleAttr = Convert::raw2att($this->Title);
|
|
$readOnlyAttr = (!$this->canEdit()) ? ' disabled="disabled"' : '';
|
|
|
|
return "<input type=\"text\" class=\"text\" title=\"("._t('EditableFormField.ENTERQUESTION', 'Enter Question').")\" value=\"$titleAttr\" name=\"Fields[{$this->ID}][Title]\"$readOnlyAttr />";
|
|
}
|
|
|
|
/**
|
|
* Return the base name for this form field in the
|
|
* form builder
|
|
*
|
|
* @return String
|
|
*/
|
|
public function FieldName() {
|
|
return "Fields[".$this->ID."]";
|
|
}
|
|
|
|
/**
|
|
* @todo Fix this - shouldn't name be returning name?!?
|
|
*/
|
|
public function BaseName() {
|
|
return $this->Name;
|
|
}
|
|
|
|
/**
|
|
* How to save the data submitted in this field into
|
|
* the database object which this field represents.
|
|
*
|
|
* Any class's which call this should also call
|
|
* {@link parent::populateFromPostData()} to ensure
|
|
* that this method is called
|
|
*
|
|
* @access public
|
|
*/
|
|
public function populateFromPostData($data) {
|
|
$this->Title = (isset($data['Title'])) ? $data['Title']: "";
|
|
$this->Default = (isset($data['Default'])) ? $data['Default'] : "";
|
|
$this->Sort = (isset($data['Sort'])) ? $data['Sort'] : null;
|
|
$this->CustomParameter = isset($data['CustomParameter']) ? $data['CustomParameter'] : null;
|
|
$this->Required = !empty($data['Required']) ? 1 : 0;
|
|
$this->CanDelete = (isset($data['CanDelete']) && !$data['CanDelete']) ? 0 : 1;
|
|
$this->Name = $this->class.$this->ID;
|
|
$this->CustomErrorMessage = (isset($data['CustomErrorMessage'])) ? $data['CustomErrorMessage'] : "";
|
|
$this->CustomRules = "";
|
|
$this->CustomSettings = "";
|
|
$this->ShowOnLoad = (isset($data['ShowOnLoad']) && $data['ShowOnLoad'] == "Show") ? 1 : 0;
|
|
|
|
// custom settings
|
|
if(isset($data['CustomSettings'])) {
|
|
$this->setFieldSettings($data['CustomSettings']);
|
|
}
|
|
|
|
// custom validation
|
|
if(isset($data['CustomRules'])) {
|
|
$rules = array();
|
|
foreach($data['CustomRules'] as $key => $value) {
|
|
|
|
if(is_array($value)) {
|
|
$fieldValue = (isset($value['Value'])) ? $value['Value'] : '';
|
|
if(isset($value['ConditionOption']) && $value['ConditionOption'] == "Blank" || $value['ConditionOption'] == "NotBlank") {
|
|
$fieldValue = "";
|
|
}
|
|
$rules[] = array(
|
|
'Display' => (isset($value['Display'])) ? $value['Display'] : "",
|
|
'ConditionField' => (isset($value['ConditionField'])) ? $value['ConditionField'] : "",
|
|
'ConditionOption' => (isset($value['ConditionOption'])) ? $value['ConditionOption'] : "",
|
|
'Value' => $fieldValue
|
|
);
|
|
}
|
|
}
|
|
$this->CustomRules = serialize($rules);
|
|
}
|
|
$this->write();
|
|
}
|
|
|
|
/**
|
|
* Implement custom field Configuration on this field. Includes such things as
|
|
* settings and options of a given editable form field
|
|
*
|
|
* @return FieldSet
|
|
*/
|
|
public function getFieldConfiguration() {
|
|
return new FieldSet();
|
|
}
|
|
|
|
/**
|
|
* Append custom validation fields to the default 'Validation'
|
|
* section in the editable options view
|
|
*
|
|
* @return FieldSet
|
|
*/
|
|
public function getFieldValidationOptions() {
|
|
$fields = new FieldSet(
|
|
new CheckboxField("Fields[$this->ID][Required]", _t('EditableFormField.REQUIRED', 'Is this field Required?'), $this->Required),
|
|
new TextField("Fields[$this->ID][CustomErrorMessage]", _t('EditableFormField.CUSTOMERROR','Custom Error Message'), $this->CustomErrorMessage)
|
|
);
|
|
|
|
if(!$this->canEdit()) {
|
|
foreach($fields as $field) {
|
|
$fields->performReadonlyTransformation();
|
|
}
|
|
}
|
|
return $fields;
|
|
}
|
|
|
|
/**
|
|
* Return a FormField to appear on the front end. Implement on
|
|
* your subclass
|
|
*
|
|
* @return FormField
|
|
*/
|
|
public function getFormField() {
|
|
user_error("Please implement a getFormField() on your EditableFormClass ". $this->ClassName, E_USER_ERROR);
|
|
}
|
|
|
|
function showInReports() {
|
|
return true;
|
|
}
|
|
|
|
function prepopulate($value) {
|
|
$this->prepopulateFromMap($this->parsePrepopulateValue($value));
|
|
}
|
|
|
|
protected function parsePrepopulateValue($value) {
|
|
$paramList = explode(',', $value);
|
|
$paramMap = array();
|
|
|
|
foreach($paramList as $param) {
|
|
|
|
if(preg_match( '/([^=]+)=(.+)/', $param, $match)) {
|
|
if(isset($paramMap[$match[1]]) && is_array($paramMap[$match[1]])) {
|
|
$paramMap[$match[1]][] = $match[2];
|
|
} else if(isset( $paramMap[$match[1]])) {
|
|
$paramMap[$match[1]] = array($paramMap[$match[1]]);
|
|
$paramMap[$match[1]][] = $match[2];
|
|
} else {
|
|
$paramMap[$match[1]] = $match[2];
|
|
}
|
|
}
|
|
}
|
|
return $paramMap;
|
|
}
|
|
|
|
protected function prepopulateFromMap($paramMap) {
|
|
foreach($paramMap as $field => $fieldValue) {
|
|
if(!is_array($fieldValue)) {
|
|
$this->$field = $fieldValue;
|
|
}
|
|
}
|
|
}
|
|
|
|
function Type() {
|
|
return $this->class;
|
|
}
|
|
|
|
/**
|
|
* Return the validation information related to this field. This is
|
|
* interrupted as a JSON object for validate plugin and used in the
|
|
* PHP.
|
|
*
|
|
* @see http://docs.jquery.com/Plugins/Validation/Methods
|
|
* @return Array
|
|
*/
|
|
public function getValidation() {
|
|
return array();
|
|
}
|
|
}
|
|
?>
|