silverstripe-userforms/code/editor/EditableFormField.php

<?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",
		"ShowOnLoad" => "Boolean"
	);
    
	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
	 */
	public function getFieldSettings() {
		return (!empty($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
	 */
	public 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->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();
	}
}
?>