2 // This file is part of Moodle - http://moodle.org/
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 // GNU General Public License for more details.
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
19 * Group of date input element
21 * Contains class for a group of elements used to input a date.
24 * @copyright 2007 Jamie Pratt <me@jamiep.org>
25 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
29 require_once($CFG->libdir
. '/form/group.php');
30 require_once($CFG->libdir
. '/formslib.php');
33 * Class for a group of elements used to input a date.
35 * Emulates moodle print_date_selector function
39 * @copyright 2007 Jamie Pratt <me@jamiep.org>
40 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
42 class MoodleQuickForm_date_selector
extends MoodleQuickForm_group
{
45 * Control the fieldnames for form elements.
47 * startyear => int start of range of years that can be selected
48 * stopyear => int last year that can be selected
49 * timezone => int|float|string (optional) timezone modifier used for edge case only.
50 * If not specified, then date is caclulated based on current user timezone.
51 * Note: dst will be calculated for string timezones only
52 * {@link http://docs.moodle.org/dev/Time_API#Timezone}
53 * optional => if true, show a checkbox beside the date to turn it on (or off)
56 protected $_options = array();
59 * @var array These complement separators, they are appended to the resultant HTML.
61 protected $_wrap = array('', '');
64 * @var null|bool Keeps track of whether the date selector was initialised using createElement
65 * or addElement. If true, createElement was used signifying the element has been
66 * added to a group - see MDL-39187.
68 protected $_usedcreateelement = true;
73 * @param string $elementName Element's name
74 * @param mixed $elementLabel Label(s) for an element
75 * @param array $options Options to control the element's display
76 * @param mixed $attributes Either a typical HTML attribute string or an associative array
78 public function __construct($elementName = null, $elementLabel = null, $options = array(), $attributes = null) {
79 // Get the calendar type used - see MDL-18375.
80 $calendartype = \core_calendar\type_factory
::get_calendar_instance();
81 $this->_options
= array('startyear' => $calendartype->get_min_year(), 'stopyear' => $calendartype->get_max_year(),
82 'defaulttime' => 0, 'timezone' => 99, 'step' => 1, 'optional' => false);
83 // TODO MDL-52313 Replace with the call to parent::__construct().
84 HTML_QuickForm_element
::__construct($elementName, $elementLabel, $attributes);
85 $this->_persistantFreeze
= true;
86 $this->_appendName
= true;
87 $this->_type
= 'date_selector';
88 // set the options, do not bother setting bogus ones
89 if (is_array($options)) {
90 foreach ($options as $name => $value) {
91 if (isset($this->_options
[$name])) {
92 if (is_array($value) && is_array($this->_options
[$name])) {
93 $this->_options
[$name] = @array_merge
($this->_options
[$name], $value);
95 $this->_options
[$name] = $value;
103 * Old syntax of class constructor. Deprecated in PHP7.
105 * @deprecated since Moodle 3.1
107 public function MoodleQuickForm_date_selector($elementName = null, $elementLabel = null, $options = array(), $attributes = null) {
108 debugging('Use of class name as constructor is deprecated', DEBUG_DEVELOPER
);
109 self
::__construct($elementName, $elementLabel, $options, $attributes);
113 * This will create date group element constisting of day, month and year.
117 function _createElements() {
120 // Get the calendar type used - see MDL-18375.
121 $calendartype = \core_calendar\type_factory
::get_calendar_instance();
123 $this->_elements
= array();
125 $dateformat = $calendartype->get_date_order($this->_options
['startyear'], $this->_options
['stopyear']);
126 // Reverse date element (Day, Month, Year), in RTL mode.
127 if (right_to_left()) {
128 $dateformat = array_reverse($dateformat);
130 foreach ($dateformat as $key => $value) {
131 // E_STRICT creating elements without forms is nasty because it internally uses $this
132 $this->_elements
[] = $this->createFormElement('select', $key, get_string($key, 'form'), $value, $this->getAttributes(), true);
134 // The YUI2 calendar only supports the gregorian calendar type so only display the calendar image if this is being used.
135 if ($calendartype->get_name() === 'gregorian') {
136 $image = $OUTPUT->pix_icon('i/calendar', get_string('calendar', 'calendar'), 'moodle');
137 $this->_elements
[] = $this->createFormElement('link', 'calendar',
140 // If optional we add a checkbox which the user can use to turn if on
141 if ($this->_options
['optional']) {
142 $this->_elements
[] = $this->createFormElement('checkbox', 'enabled', null, get_string('enable'), $this->getAttributes(), true);
144 foreach ($this->_elements
as $element){
145 if (method_exists($element, 'setHiddenLabel')){
146 $element->setHiddenLabel(true);
153 * Called by HTML_QuickForm whenever form event is made on this element
155 * @param string $event Name of event
156 * @param mixed $arg event arguments
157 * @param object $caller calling object
160 function onQuickFormEvent($event, $arg, &$caller) {
161 $this->setMoodleForm($caller);
164 // Constant values override both default and submitted ones
165 // default values are overriden by submitted.
166 $value = $this->_findValue($caller->_constantValues
);
167 if (null === $value) {
168 // If no boxes were checked, then there is no value in the array
169 // yet we don't want to display default value in this case.
170 if ($caller->isSubmitted() && !$caller->is_new_repeat($this->getName())) {
171 $value = $this->_findValue($caller->_submitValues
);
173 $value = $this->_findValue($caller->_defaultValues
);
176 $requestvalue=$value;
180 if (!is_array($value)) {
181 $calendartype = \core_calendar\type_factory
::get_calendar_instance();
182 $currentdate = $calendartype->timestamp_to_date_array($value, $this->_options
['timezone']);
184 'day' => $currentdate['mday'],
185 'month' => $currentdate['mon'],
186 'year' => $currentdate['year']);
187 // If optional, default to off, unless a date was provided.
188 if ($this->_options
['optional']) {
189 $value['enabled'] = $requestvalue != 0;
192 $value['enabled'] = isset($value['enabled']);
194 if (null !== $value) {
195 $this->setValue($value);
198 case 'createElement':
199 // Optional is an optional param, if its set we need to add a disabledIf rule.
200 // If its empty or not specified then its not an optional dateselector.
201 if (!empty($arg[2]['optional']) && !empty($arg[0])) {
202 // When using the function addElement, rather than createElement, we still
203 // enter this case, making this check necessary.
204 if ($this->_usedcreateelement
) {
205 $caller->disabledIf($arg[0] . '[day]', $arg[0] . '[enabled]');
206 $caller->disabledIf($arg[0] . '[month]', $arg[0] . '[enabled]');
207 $caller->disabledIf($arg[0] . '[year]', $arg[0] . '[enabled]');
209 $caller->disabledIf($arg[0], $arg[0] . '[enabled]');
212 return parent
::onQuickFormEvent($event, $arg, $caller);
215 $this->_usedcreateelement
= false;
216 return parent
::onQuickFormEvent($event, $arg, $caller);
219 return parent
::onQuickFormEvent($event, $arg, $caller);
224 * Returns HTML for advchecbox form element.
229 include_once('HTML/QuickForm/Renderer/Default.php');
230 $renderer = new HTML_QuickForm_Renderer_Default();
231 $renderer->setElementTemplate('{element}');
232 parent
::accept($renderer);
234 $html = $this->_wrap
[0];
235 if ($this->_usedcreateelement
) {
236 $html .= html_writer
::tag('span', $renderer->toHtml(), array('class' => 'fdate_selector'));
238 $html .= $renderer->toHtml();
240 $html .= $this->_wrap
[1];
248 * @param HTML_QuickForm_Renderer $renderer An HTML_QuickForm_Renderer object
249 * @param bool $required Whether a group is required
250 * @param string $error An error message associated with a group
252 function accept(&$renderer, $required = false, $error = null) {
254 $renderer->renderElement($this, $required, $error);
258 * Export for template
260 * @param renderer_base $output
261 * @return array|stdClass
263 public function export_for_template(renderer_base
$output) {
265 return parent
::export_for_template($output);
269 * Output a timestamp. Give it the name of the group.
271 * @param array $submitValues values submitted.
272 * @param bool $assoc specifies if returned array is associative
275 function exportValue(&$submitValues, $assoc = false) {
276 $valuearray = array();
277 foreach ($this->_elements
as $element){
278 $thisexport = $element->exportValue($submitValues[$this->getName()], true);
279 if ($thisexport!=null){
280 $valuearray +
= $thisexport;
283 if (count($valuearray) && isset($valuearray['year'])) {
284 if($this->_options
['optional']) {
285 // If checkbox is on, the value is zero, so go no further
286 if(empty($valuearray['enabled'])) {
287 return $this->_prepareValue(0, $assoc);
290 // Get the calendar type used - see MDL-18375.
291 $calendartype = \core_calendar\type_factory
::get_calendar_instance();
292 $gregoriandate = $calendartype->convert_to_gregorian($valuearray['year'], $valuearray['month'], $valuearray['day']);
293 $value = make_timestamp($gregoriandate['year'],
294 $gregoriandate['month'],
295 $gregoriandate['day'],
297 $this->_options
['timezone'],
300 return $this->_prepareValue($value, $assoc);