MoodleQuickForm_date_selector Class Reference

Inheritance diagram for MoodleQuickForm_date_selector:

Public Member Functions
	__construct ($elementName=null, $elementLabel=null, $options=array(), $attributes=null)
	constructor More...
	accept (&$renderer, $required=false, $error=null)
	Accepts a renderer. More...
	createFormElement ()
	Creates an element to add to the group Expects the same arguments as MoodleQuickForm::createElement()
	export_for_template (renderer_base $output)
	Export for template. More...
	exportValue (&$submitValues, $assoc=false)
	Output a timestamp. More...
	getElementTemplateType ()
	Returns element template, nodisplay/static/fieldset. More...
string	getHelpButton ()
	template type, would cause problems with client side validation so will leave for now More...
	MoodleQuickForm_date_selector ($elementName=null, $elementLabel=null, $options=array(), $attributes=null)
	Old syntax of class constructor. More...
	MoodleQuickForm_group ($elementName=null, $elementLabel=null, $elements=null, $separator=null, $appendName=true)
	Old syntax of class constructor. More...
	onQuickFormEvent ($event, $arg, &$caller)
	Called by HTML_QuickForm whenever form event is made on this element. More...
	setElements ($elements)
	Sets the grouped elements and hides label. More...
	setMoodleForm ($mform)
	Stores the form this element was added to This object is later used by MoodleQuickForm_group::createElement(). More...
	toHtml ()
	Returns HTML for advchecbox form element. More...
	validateSubmitValue ($values)
	Calls the validateSubmitValue function for the containing elements and returns an error string as soon as it finds one. More...

Public Attributes
string	$_helpbutton =''
	html for help button, if empty then no help

Protected Attributes
MoodleQuickForm	$_mform = null
array	$_options = array()
	Control the fieldnames for form elements. More...
	$_renderedfromtemplate = false
null bool	$_usedcreateelement = true
	Keeps track of whether the date selector was initialised using createElement or addElement. More...
array	$_wrap = array('', '')
	These complement separators, they are appended to the resultant HTML.

Constructor & Destructor Documentation

__construct()

MoodleQuickForm_date_selector::__construct	(		$elementName = null,
			$elementLabel = null,
			$options = array(),
			$attributes = null
	)

constructor

Parameters

string	$elementName	Element's name
mixed	$elementLabel	Label(s) for an element
array	$options	Options to control the element's display
mixed	$attributes	Either a typical HTML attribute string or an associative array

Member Function Documentation

accept()

MoodleQuickForm_date_selector::accept	(	&	$renderer,
			$required = false,
			$error = null
	)

Accepts a renderer.

Parameters

HTML_QuickForm_Renderer	$renderer	An HTML_QuickForm_Renderer object
bool	$required	Whether a group is required
string	$error	An error message associated with a group

Reimplemented from MoodleQuickForm_group.

export_for_template()

MoodleQuickForm_date_selector::export_for_template

(

renderer_base

$output

)

Export for template.

Parameters

renderer_base

$output

Return values

array|stdClass

Reimplemented from MoodleQuickForm_group.

exportValue()

MoodleQuickForm_date_selector::exportValue	(	&	$submitValues,
			$assoc = false
	)

Output a timestamp.

Give it the name of the group.

Parameters

array	$submitValues	values submitted.
bool	$assoc	specifies if returned array is associative

Return values

array

getElementTemplateType()

MoodleQuickForm_group::getElementTemplateType ( )

inherited

Returns element template, nodisplay/static/fieldset.

Return values

string

getHelpButton()

string MoodleQuickForm_group::getHelpButton ( )

inherited

template type, would cause problems with client side validation so will leave for now

set html for help button

MoodleQuickForm_date_selector()

MoodleQuickForm_date_selector::MoodleQuickForm_date_selector	(		$elementName = null,
			$elementLabel = null,
			$options = array(),
			$attributes = null
	)

Old syntax of class constructor.

Deprecated in PHP7.

Deprecated:

since Moodle 3.1

MoodleQuickForm_group()

MoodleQuickForm_group::MoodleQuickForm_group (   $elementName = null,   $elementLabel = null,   $elements = null,   $separator = null,   $appendName = true  )

inherited

Old syntax of class constructor.

Deprecated in PHP7.

Deprecated:

since Moodle 3.1

onQuickFormEvent()

MoodleQuickForm_date_selector::onQuickFormEvent	(		$event,
			$arg,
		&	$caller
	)

Called by HTML_QuickForm whenever form event is made on this element.

Parameters

string	$event	Name of event
mixed	$arg	event arguments
object	$caller	calling object

Return values

bool

Reimplemented from MoodleQuickForm_group.

setElements()

MoodleQuickForm_group::setElements (   $elements )

inherited

Sets the grouped elements and hides label.

Parameters

array

$elements

setMoodleForm()

MoodleQuickForm_group::setMoodleForm (   $mform )

inherited

Stores the form this element was added to This object is later used by MoodleQuickForm_group::createElement().

Parameters

null | MoodleQuickForm

$mform

toHtml()

MoodleQuickForm_date_selector::toHtml

(

)

Returns HTML for advchecbox form element.

Return values

string

validateSubmitValue()

MoodleQuickForm_group::validateSubmitValue (   $values )

inherited

Calls the validateSubmitValue function for the containing elements and returns an error string as soon as it finds one.

Parameters

array

$values

Values of the containing elements.

Return values

string|null

Validation error message or null.

Reimplemented in MoodleQuickForm_filetypes.

Member Data Documentation

$_options

array MoodleQuickForm_date_selector::$_options = array()

protected

Control the fieldnames for form elements.

startyear => int start of range of years that can be selected stopyear => int last year that can be selected timezone => int|float|string (optional) timezone modifier used for edge case only. If not specified, then date is caclulated based on current user timezone. Note: dst will be calculated for string timezones only optional => if true, show a checkbox beside the date to turn it on (or off)

$_usedcreateelement

null bool MoodleQuickForm_date_selector::$_usedcreateelement = true

protected

Keeps track of whether the date selector was initialised using createElement or addElement.

If true, createElement was used signifying the element has been added to a group - see MDL-39187.

---

The documentation for this class was generated from the following file:

• lib/form/dateselector.php