mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-22 14:05:37 +02:00
559abecd56
Introduced new FormField->castedCopy() method which tries to replicate the existing form field instance as closely as possible. Primarily, the fix was targeted at consistently passing through FormField->description to all of its variations.
350 lines
11 KiB
PHP
350 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* A composite field for date and time entry,
|
|
* based on {@link DateField} and {@link TimeField}.
|
|
* Usually saves into a single {@link SS_Datetime} database column.
|
|
* If you want to save into {@link Date} or {@link Time} columns,
|
|
* please instanciate the fields separately.
|
|
*
|
|
* # Configuration
|
|
*
|
|
* The {@link setConfig()} method is only used to configure common properties of this field.
|
|
* To configure the {@link DateField} and {@link TimeField} instances contained within, use their own
|
|
* {@link setConfig()} methods.
|
|
*
|
|
* Example:
|
|
* <code>
|
|
* $field = new DatetimeField('Name', 'Label');
|
|
* $field->setConfig('datavalueformat', 'YYYY-MM-dd HH:mm'); // global setting
|
|
* $field->getDateField()->setConfig('showcalendar', 1); // field-specific setting
|
|
* </code>
|
|
*
|
|
* - "timezone": Set a different timezone for viewing. {@link dataValue()} will still save
|
|
* the time in PHP's default timezone (date_default_timezone_get()), its only a view setting.
|
|
* Note that the sub-fields ({@link getDateField()} and {@link getTimeField()})
|
|
* are not timezone aware, and will have their values set in local time, rather than server time.
|
|
* - "datetimeorder": An sprintf() template to determine in which order the date and time values will
|
|
* be combined. This is necessary as those separate formats are set in their invididual fields.
|
|
*
|
|
* @package framework
|
|
* @subpackage forms
|
|
*/
|
|
class DatetimeField extends FormField {
|
|
|
|
/**
|
|
* @var DateField
|
|
*/
|
|
protected $dateField = null;
|
|
|
|
/**
|
|
* @var TimeField
|
|
*/
|
|
protected $timeField = null;
|
|
|
|
/**
|
|
* @var array
|
|
*/
|
|
static $default_config = array(
|
|
'datavalueformat' => 'YYYY-MM-dd HH:mm:ss',
|
|
'usertimezone' => null,
|
|
'datetimeorder' => '%s %s',
|
|
);
|
|
|
|
/**
|
|
* @var array
|
|
*/
|
|
protected $config;
|
|
|
|
public function __construct($name, $title = null, $value = ""){
|
|
$this->config = self::$default_config;
|
|
|
|
$this->dateField = DateField::create($name . '[date]', false);
|
|
$this->timeField = TimeField::create($name . '[time]', false);
|
|
$this->timezoneField = new HiddenField($this->getName() . '[timezone]');
|
|
|
|
parent::__construct($name, $title, $value);
|
|
}
|
|
|
|
public function setForm($form) {
|
|
parent::setForm($form);
|
|
|
|
$this->dateField->setForm($form);
|
|
$this->timeField->setForm($form);
|
|
$this->timezoneField->setForm($form);
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function FieldHolder($properties = array()) {
|
|
$config = array(
|
|
'datetimeorder' => $this->getConfig('datetimeorder'),
|
|
);
|
|
$config = array_filter($config);
|
|
$this->addExtraClass(Convert::raw2json($config));
|
|
|
|
return parent::FieldHolder($properties);
|
|
}
|
|
|
|
public function Field($properties = array()) {
|
|
Requirements::css(FRAMEWORK_DIR . '/css/DatetimeField.css');
|
|
|
|
$tzField = ($this->getConfig('usertimezone')) ? $this->timezoneField->FieldHolder() : '';
|
|
return $this->dateField->FieldHolder() .
|
|
$this->timeField->FieldHolder() .
|
|
$tzField .
|
|
'<div class="clear"><!-- --></div>';
|
|
}
|
|
|
|
/**
|
|
* Sets the internal value to ISO date format, based on either a database value in ISO date format,
|
|
* or a form submssion in the user date format. Uses the individual date and time fields
|
|
* to take care of the actual formatting and value conversion.
|
|
*
|
|
* Value setting happens *before* validation, so we have to set the value even if its not valid.
|
|
*
|
|
* Caution: Only converts user timezones when value is passed as array data (= form submission).
|
|
* Weak indication, but unfortunately the framework doesn't support a distinction between
|
|
* setting a value from the database, application logic, and user input.
|
|
*
|
|
* @param string|array $val String expects an ISO date format. Array notation with 'date' and 'time'
|
|
* keys can contain localized strings. If the 'dmyfields' option is used for {@link DateField},
|
|
* the 'date' value may contain array notation was well (see {@link DateField->setValue()}).
|
|
*/
|
|
public function setValue($val) {
|
|
// If timezones are enabled, assume user data needs to be reverted to server timezone
|
|
if($this->getConfig('usertimezone')) {
|
|
// Accept user input on timezone, but only when timezone support is enabled
|
|
$userTz = (is_array($val) && array_key_exists('timezone', $val)) ? $val['timezone'] : null;
|
|
if(!$userTz) $userTz = $this->getConfig('usertimezone'); // fall back to defined timezone
|
|
} else {
|
|
$userTz = null;
|
|
}
|
|
|
|
if(empty($val)) {
|
|
$this->value = null;
|
|
$this->dateField->setValue(null);
|
|
$this->timeField->setValue(null);
|
|
} else {
|
|
// Case 1: String setting from database, in ISO date format
|
|
if(is_string($val) && Zend_Date::isDate($val, $this->getConfig('datavalueformat'), $this->locale)) {
|
|
$this->value = $val;
|
|
}
|
|
// Case 2: Array form submission with user date format
|
|
elseif(is_array($val) && array_key_exists('date', $val) && array_key_exists('time', $val)) {
|
|
|
|
$dataTz = date_default_timezone_get();
|
|
// If timezones are enabled, assume user data needs to be converted to server timezone
|
|
if($userTz) date_default_timezone_set($userTz);
|
|
|
|
// Uses sub-fields to temporarily write values and delegate dealing with their normalization,
|
|
// actual sub-field value setting happens later
|
|
$this->dateField->setValue($val['date']);
|
|
$this->timeField->setValue($val['time']);
|
|
if($this->dateField->dataValue() && $this->timeField->dataValue()) {
|
|
$userValueObj = new Zend_Date(null, null, $this->locale);
|
|
$userValueObj->setDate($this->dateField->dataValue(),
|
|
$this->dateField->getConfig('datavalueformat'));
|
|
$userValueObj->setTime($this->timeField->dataValue(),
|
|
$this->timeField->getConfig('datavalueformat'));
|
|
if($userTz) $userValueObj->setTimezone($dataTz);
|
|
$this->value = $userValueObj->get($this->getConfig('datavalueformat'), $this->locale);
|
|
unset($userValueObj);
|
|
} else {
|
|
// Validation happens later, so set the raw string in case Zend_Date doesn't accept it
|
|
$this->value = trim(sprintf($this->getConfig('datetimeorder'), $val['date'], $val['time']));
|
|
}
|
|
|
|
if($userTz) date_default_timezone_set($dataTz);
|
|
}
|
|
// Case 3: Value is invalid, but set it anyway to allow validation by the fields later on
|
|
else {
|
|
$this->dateField->setValue($val);
|
|
if(is_string($val) )$this->timeField->setValue($val);
|
|
$this->value = $val;
|
|
}
|
|
|
|
// view settings (dates might differ from $this->value based on user timezone settings)
|
|
if (Zend_Date::isDate($this->value, $this->getConfig('datavalueformat'), $this->locale)) {
|
|
$valueObj = new Zend_Date($this->value, $this->getConfig('datavalueformat'), $this->locale);
|
|
if($userTz) $valueObj->setTimezone($userTz);
|
|
|
|
// Set view values in sub-fields
|
|
if($this->dateField->getConfig('dmyfields')) {
|
|
$this->dateField->setValue($valueObj->toArray());
|
|
} else {
|
|
$this->dateField->setValue(
|
|
$valueObj->get($this->dateField->getConfig('dateformat'), $this->locale));
|
|
}
|
|
$this->timeField->setValue($valueObj->get($this->timeField->getConfig('timeformat'), $this->locale));
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function Value() {
|
|
$valDate = $this->dateField->Value();
|
|
$valTime = $this->timeField->Value();
|
|
if(!$valTime) $valTime = '00:00:00';
|
|
|
|
return sprintf($this->getConfig('datetimeorder'), $valDate, $valTime);
|
|
}
|
|
|
|
public function setDisabled($bool) {
|
|
parent::setDisabled($bool);
|
|
$this->dateField->setDisabled($bool);
|
|
$this->timeField->setDisabled($bool);
|
|
if($this->timezoneField) $this->timezoneField->setDisabled($bool);
|
|
return $this;
|
|
}
|
|
|
|
public function setReadonly($bool) {
|
|
parent::setReadonly($bool);
|
|
$this->dateField->setReadonly($bool);
|
|
$this->timeField->setReadonly($bool);
|
|
if($this->timezoneField) $this->timezoneField->setReadonly($bool);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @return DateField
|
|
*/
|
|
public function getDateField() {
|
|
return $this->dateField;
|
|
}
|
|
|
|
/**
|
|
* @return TimeField
|
|
*/
|
|
public function getTimeField() {
|
|
return $this->timeField;
|
|
}
|
|
|
|
/**
|
|
* @return FormField
|
|
*/
|
|
public function getTimezoneField() {
|
|
return $this->timezoneField;
|
|
}
|
|
|
|
public function setLocale($locale) {
|
|
$this->dateField->setLocale($locale);
|
|
$this->timeField->setLocale($locale);
|
|
return $this;
|
|
}
|
|
|
|
public function getLocale() {
|
|
return $this->dateField->getLocale();
|
|
}
|
|
|
|
public function setDescription($description) {
|
|
parent::setDescription($description);
|
|
|
|
$this->dateField->setDescription($description);
|
|
$this->timeField->setDescription($description);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Note: Use {@link getDateField()} and {@link getTimeField()}
|
|
* to set field-specific config options.
|
|
*
|
|
* @param string $name
|
|
* @param mixed $val
|
|
*/
|
|
public function setConfig($name, $val) {
|
|
$this->config[$name] = $val;
|
|
|
|
if($name == 'usertimezone') {
|
|
$this->timezoneField->setValue($val);
|
|
$this->setValue($this->dataValue());
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Note: Use {@link getDateField()} and {@link getTimeField()}
|
|
* to get field-specific config options.
|
|
*
|
|
* @param String $name Optional, returns the whole configuration array if empty
|
|
* @return mixed
|
|
*/
|
|
public function getConfig($name = null) {
|
|
return $name ? $this->config[$name] : $this->config;
|
|
}
|
|
|
|
public function validate($validator) {
|
|
$dateValid = $this->dateField->validate($validator);
|
|
$timeValid = $this->timeField->validate($validator);
|
|
|
|
return ($dateValid && $timeValid);
|
|
}
|
|
|
|
public function performReadonlyTransformation() {
|
|
$field = $this->castedCopy('DatetimeField_Readonly');
|
|
$field->setValue($this->dataValue());
|
|
|
|
$dateFieldConfig = $this->getDateField()->getConfig();
|
|
if($dateFieldConfig) {
|
|
foreach($dateFieldConfig as $k => $v) {
|
|
$field->getDateField()->setConfig($k, $v);
|
|
}
|
|
}
|
|
|
|
$timeFieldConfig = $this->getTimeField()->getConfig();
|
|
if($timeFieldConfig) {
|
|
foreach($timeFieldConfig as $k => $v) {
|
|
$field->getTimeField()->setConfig($k, $v);
|
|
}
|
|
}
|
|
|
|
return $field;
|
|
}
|
|
|
|
public function __clone() {
|
|
$this->dateField = clone $this->dateField;
|
|
$this->timeField = clone $this->timeField;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The readonly class for our {@link DatetimeField}.
|
|
*
|
|
* @package forms
|
|
* @subpackage fields-datetime
|
|
*/
|
|
class DatetimeField_Readonly extends DatetimeField {
|
|
|
|
protected $readonly = true;
|
|
|
|
public function Field($properties = array()) {
|
|
$valDate = $this->dateField->dataValue();
|
|
$valTime = $this->timeField->dataValue();
|
|
|
|
if($valDate && $valTime) {
|
|
$format = sprintf(
|
|
$this->getConfig('datetimeorder'),
|
|
$this->dateField->getConfig('dateformat'),
|
|
$this->timeField->getConfig('timeformat')
|
|
);
|
|
$valueObj = new Zend_Date(
|
|
sprintf($this->getConfig('datetimeorder'), $valDate, $valTime),
|
|
$this->getConfig('datavalueformat'),
|
|
$this->dateField->getLocale()
|
|
);
|
|
$val = $valueObj->toString($format);
|
|
|
|
} else {
|
|
$val = sprintf('<em>%s</em>', _t('DatetimeField.NOTSET', 'Not set'));
|
|
}
|
|
|
|
return "<span class=\"readonly\" id=\"" . $this->id() . "\">$val</span>";
|
|
}
|
|
|
|
public function validate($validator) {
|
|
return true;
|
|
}
|
|
}
|