Eloy Lafuente (stronk7)
aa8c07276b
This includes 2 change to the order date(time) elements are filled,
each one addressing one type of problem, where current order is
problematic and can lead to unexpected dates.
1) Changing date, when current month only has X days and target
month has more than X days. Example, being 1 April, change
the date to 31 May.
This is solved by changing the order of introduction
from current D => M => Y to Y => M => D.
2) Changing date, when target month only has X days and current
month has more that X days. Example, being 31 March, change
the date to 28 Feb.
This is solved by always setting the D to 1, before the
Y => M => D sequence commented @ 1) begins.
117 lines
4.8 KiB
PHP
117 lines
4.8 KiB
PHP
<?php
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// Moodle is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
/**
|
|
* Date form field class.
|
|
*
|
|
* @package core_form
|
|
* @category test
|
|
* @copyright 2013 David Monllaó
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
// NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php.
|
|
|
|
require_once(__DIR__ . '/behat_form_group.php');
|
|
|
|
use Behat\Mink\Exception\ExpectationException;
|
|
|
|
/**
|
|
* Date form field.
|
|
*
|
|
* This class will be refactored in case we are interested in
|
|
* creating more complex formats to fill date and date-time fields.
|
|
*
|
|
* @package core_form
|
|
* @category test
|
|
* @copyright 2013 David Monllaó
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class behat_form_date extends behat_form_group {
|
|
|
|
/**
|
|
* Sets the value to a date field.
|
|
*
|
|
* @param string $value The value to be assigned to the date selector field. The string value must be either
|
|
* parsable into a UNIX timestamp or equal to 'disabled' (if disabling the date selector).
|
|
* @return void
|
|
* @throws ExpectationException If the value is invalid.
|
|
*/
|
|
public function set_value($value) {
|
|
|
|
if ($value === 'disabled') {
|
|
// Disable the given date selector field.
|
|
$this->set_child_field_value('enabled', false);
|
|
} else if (is_numeric($value)) { // The value is numeric (unix timestamp).
|
|
// First, reset the day always to an existing one (1st). Without that
|
|
// undesired modifications (JS) happens when changing of month and day if
|
|
// the interim combination doesn't exists (for example, 31 March => 01 April).
|
|
// Note that instead of always setting the day to 1, this could be a little more
|
|
// clever, for example only changing when the day > 28, or only when the
|
|
// months (current or changed) have less days that the other. But that would
|
|
// require more complex calculations than the simpler line below.
|
|
$this->set_child_field_value('day', 1);
|
|
// Assign the mapped values to each form element in the date selector field.
|
|
foreach ($this->get_mapped_fields($value) as $childname => $childvalue) {
|
|
$this->set_child_field_value($childname, $childvalue);
|
|
}
|
|
} else { // Invalid value.
|
|
// Get the name of the field.
|
|
$fieldname = $this->field->find('css', 'legend')->getHtml();
|
|
throw new ExpectationException("Invalid value for '{$fieldname}'", $this->session);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the date field identifiers and the values that should be assigned to them.
|
|
*
|
|
* @param int $timestamp The UNIX timestamp
|
|
* @return array
|
|
*/
|
|
protected function get_mapped_fields(int $timestamp): array {
|
|
// Order is important, first enable, and then year -> month -> day
|
|
// (other order can lead to some transitions not working as expected,
|
|
// for example, changing from 15 June to 31 August, Behat ends with
|
|
// date being 1 August if the modification order is day, then month).
|
|
// Note that the behaviour described above is 100% reproducible
|
|
// manually, with the form (JS) auto-fixing things in the middle and
|
|
// leading to undesired final dates.
|
|
return [
|
|
'enabled' => true,
|
|
'year' => date('Y', $timestamp),
|
|
'month' => date('n', $timestamp),
|
|
'day' => date('j', $timestamp),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Sets a value to a child element in the date form field.
|
|
*
|
|
* @param string $childname The name of the child field
|
|
* @param string|bool $childvalue The value
|
|
*/
|
|
private function set_child_field_value(string $childname, $childvalue) {
|
|
// Find the given child form element in the date selector field.
|
|
$childelement = $this->field->find('css', "*[name$='[{$childname}]']");
|
|
if ($childelement) {
|
|
// Get the field instance for the given child form element.
|
|
$childinstance = $this->get_field_instance_for_element($childelement);
|
|
// Set the value to the child form element.
|
|
$childinstance->set_value($childvalue);
|
|
}
|
|
}
|
|
}
|