ReadonlyField

Complexity

Total Complexity

14

Size/Duplication

Total Lines	83
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Importance

Changes

0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	setIncludeHiddenField()	0	3	1
A	performReadonlyTransformation()	0	3	1
A	Field()	0	11	3
A	Value()	0	4	2
A	castingHelper()	0	10	4
A	getAttributes()	0	9	2
A	Type()	0	3	1

<?php
/**
 * Read-only field to display a non-editable value with a label.
 * Consider using an {@link LabelField} if you just need a label-less
 * value display.
 *
 * @package forms
 * @subpackage fields-basic
 */
class ReadonlyField extends FormField {

	protected $readonly = true;

	/**
	 * Include a hidden field in the HTML for the readonly field
	 * @var boolean
	 */
	protected $includeHiddenField = false;

	/**
	 * If true, a hidden field will be included in the HTML for the readonly field.
	 *
	 * This can be useful if you need to pass the data through on the form submission, as
	 * long as it's okay than an attacker could change the data before it's submitted.
	 *
	 * This is disabled by default as it can introduce security holes if the data is not
	 * allowed to be modified by the user.
	 *
	 * @param boolean $includeHiddenField
	 */
	public function setIncludeHiddenField($includeHiddenField) {
		$this->includeHiddenField = $includeHiddenField;
	}

	public function performReadonlyTransformation() {
		return clone $this;
	}

	/**
	 * @param array $properties
	 * @return HTMLText
	 */
	public function Field($properties = array()) {
		// Include a hidden field in the HTML
		if($this->includeHiddenField && $this->readonly) {
			$hidden = clone $this;
			$hidden->setReadonly(false);
			return parent::Field($properties) . $hidden->Field($properties);

		} else {
			return parent::Field($properties);
		}
	}

	public function Value() {
		if($this->value) return $this->value;
		else return '<i>(' . _t('FormField.NONE', 'none') . ')</i>';
	}

	/**
	 * This is a legacy fix to ensure that the `dontEscape` flag has an impact on readonly fields
	 * now that we've moved to casting template values more rigidly
	 *
	 * @param string $field
	 * @return string
	 */
	public function castingHelper($field) {
		if (
			(strcasecmp($field, 'Value') === 0)
			&& ($this->dontEscape || empty($this->value))
		) {
			// Value is either empty, or unescaped
			return 'HTMLText';
		}
		return parent::castingHelper($field);
	}

	public function getAttributes() {
		return array_merge(
			parent::getAttributes(),
			array(
				'type' => 'hidden',
				'value' => $this->readonly ? null : $this->value,
			)
		);
	}

	public function Type() {
		return 'readonly';
	}

}