Moodle PHP Documentation 4.2
Moodle 4.2.8 (Build: 20240610) (2d41ac46f45)
availability_date\frontend Class Reference

Front-end class. More...

Inheritance diagram for availability_date\frontend:
core_availability\frontend

Static Public Member Functions

static get_fields_from_time ($time)
 Given a timestamp, obtains corresponding field values.
 
static get_time_from_fields ($year, $month, $day, $hour, $minute)
 Given field values, obtains the corresponding timestamp.
 
static include_all_javascript ($course, cm_info $cm=null, section_info $section=null)
 Includes JavaScript for the main system and all plugins.
 
static report_validation_errors (array $data, array &$errors)
 For use within forms, reports any validation errors from the availability field.
 

Public Attributes

bool const DATE_SELECTOR_SUPPORTED = false
 The date selector popup is not currently supported because the date selector is in a messy state (about to be replaced with a new YUI3 implementation) and MDL-44814 was rejected.
 

Protected Member Functions

 allow_add ($course, cm_info $cm=null, section_info $section=null)
 Decides whether this plugin should be available in a given course.
 
 get_component ()
 Gets the Frankenstyle component name for this plugin.
 
 get_javascript_init_params ($course, cm_info $cm=null, section_info $section=null)
 Gets additional parameters for the plugin's initInner function.
 
 get_javascript_strings ()
 Gets a list of string identifiers (in the plugin's language file) that are required in JavaScript for this plugin.
 

Static Protected Member Functions

static convert_associative_array_for_js (array $inarray, $keyname, $valuename)
 Converts an associative array into an array of objects with two fields.
 

Detailed Description

Front-end class.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ allow_add()

core_availability\frontend::allow_add ( $course,
cm_info $cm = null,
section_info $section = null )
protectedinherited

Decides whether this plugin should be available in a given course.

The plugin can do this depending on course or system settings.

Default returns true.

Parameters
stdClass$courseCourse object
cm_info$cmCourse-module currently being edited (null if none)
section_info$sectionSection currently being edited (null if none)

Reimplemented in availability_completion\frontend, availability_group\frontend, and availability_grouping\frontend.

◆ convert_associative_array_for_js()

static core_availability\frontend::convert_associative_array_for_js ( array $inarray,
$keyname,
$valuename )
staticprotectedinherited

Converts an associative array into an array of objects with two fields.

This is necessary because JavaScript associative arrays/objects are not ordered (at least officially according to the language specification).

Parameters
array$inarrayAssociative array key => value
string$keynameName to use for key in resulting array objects
string$valuenameName to use for value in resulting array objects
Return values
arrayNon-associative (numeric) array

◆ get_component()

core_availability\frontend::get_component ( )
protectedinherited

Gets the Frankenstyle component name for this plugin.

Return values
stringThe component name for this plugin

◆ get_fields_from_time()

static availability_date\frontend::get_fields_from_time ( $time)
static

Given a timestamp, obtains corresponding field values.

Parameters
int$timeTimestamp
Return values
stdClassObject with fields for year, month, day, hour, minute

◆ get_javascript_init_params()

availability_date\frontend::get_javascript_init_params ( $course,
cm_info $cm = null,
section_info $section = null )
protected

Gets additional parameters for the plugin's initInner function.

Default returns no parameters.

Parameters
stdClass$courseCourse object
cm_info$cmCourse-module currently being edited (null if none)
section_info$sectionSection currently being edited (null if none)
Return values
arrayArray of parameters for the JavaScript function

Reimplemented from core_availability\frontend.

◆ get_javascript_strings()

availability_date\frontend::get_javascript_strings ( )
protected

Gets a list of string identifiers (in the plugin's language file) that are required in JavaScript for this plugin.

The default returns nothing.

You do not need to include the 'title' string (which is used by core) as this is automatically added.

Return values
arrayArray of required string identifiers

Reimplemented from core_availability\frontend.

◆ get_time_from_fields()

static availability_date\frontend::get_time_from_fields ( $year,
$month,
$day,
$hour,
$minute )
static

Given field values, obtains the corresponding timestamp.

Parameters
int$yearYear
int$monthMonth
int$dayDay
int$hourHour
int$minuteMinute
Return values
intTimestamp

◆ include_all_javascript()

static core_availability\frontend::include_all_javascript ( $course,
cm_info $cm = null,
section_info $section = null )
staticinherited

Includes JavaScript for the main system and all plugins.

Parameters
stdClass$courseCourse object
cm_info$cmCourse-module currently being edited (null if none)
section_info$sectionSection currently being edited (null if none)

◆ report_validation_errors()

static core_availability\frontend::report_validation_errors ( array $data,
array & $errors )
staticinherited

For use within forms, reports any validation errors from the availability field.

Parameters
array$dataForm data fields
array$errorsError array

Member Data Documentation

◆ DATE_SELECTOR_SUPPORTED

bool const availability_date\frontend::DATE_SELECTOR_SUPPORTED = false

The date selector popup is not currently supported because the date selector is in a messy state (about to be replaced with a new YUI3 implementation) and MDL-44814 was rejected.

I have left the code in place, but disabled. When the date selector situation is finalised, then this constant should be removed (either applying MDL-44814 if old selector is still in use, or modifying the JavaScript code to support the new date selector if it has landed).


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