core_courseformat\stateactions Class Reference

Public Member Functions
	cm_move (stateupdates $updates, stdClass $course, array $ids, ?int $targetsectionid=null, ?int $targetcmid=null)
	Move course modules to another location in the same course.
	cm_moveleft (stateupdates $updates, stdClass $course, array $ids=[], ?int $targetsectionid=null, ?int $targetcmid=null)
	Move course cms to the left.
	cm_moveright (stateupdates $updates, stdClass $course, array $ids=[], ?int $targetsectionid=null, ?int $targetcmid=null)
	Move course cms to the right.
	cm_state (stateupdates $updates, stdClass $course, array $ids, ?int $targetsectionid=null, ?int $targetcmid=null)
	Add the update messages of the updated version of any cm and section related to the cm ids.
	course_state (stateupdates $updates, stdClass $course, array $ids=[], ?int $targetsectionid=null, ?int $targetcmid=null)
	Add all the update messages from the complete course state.
	section_add (stateupdates $updates, stdClass $course, array $ids=[], ?int $targetsectionid=null, ?int $targetcmid=null)
	Create a course section.
	section_content_collapsed (stateupdates $updates, stdClass $course, array $ids=[], ?int $targetsectionid=null, ?int $targetcmid=null)
	Update the course content section collapsed value.
	section_delete (stateupdates $updates, stdClass $course, array $ids=[], ?int $targetsectionid=null, ?int $targetcmid=null)
	Delete course sections.
	section_index_collapsed (stateupdates $updates, stdClass $course, array $ids=[], ?int $targetsectionid=null, ?int $targetcmid=null)
	Update the course index section collapsed value.
	section_move (stateupdates $updates, stdClass $course, array $ids, ?int $targetsectionid=null, ?int $targetcmid=null)
	Move course sections to another location in the same course.
	section_state (stateupdates $updates, stdClass $course, array $ids, ?int $targetsectionid=null, ?int $targetcmid=null)
	Add the update messages of the updated version of any cm and section related to the section ids.

Protected Member Functions
	get_cm_info (course_modinfo $modinfo, array $ids)
	Extract several cm_info from the course_modinfo.
	get_section_info (course_modinfo $modinfo, array $ids)
	Extract several section_info from the course_modinfo.
	set_cm_indentation (stateupdates $updates, stdClass $course, array $ids, int $indent)
	Internal method to define the cm indentation level.
	validate_cms (stdClass $course, array $cmids, ?string $info=null)
	Checks related to course modules: all given cm exist.
	validate_sections (stdClass $course, array $sectionids, ?string $info=null)
	Checks related to sections: course format support them, all given sections exist and topic 0 is not included.

Member Function Documentation

cm_move()

core_courseformat\stateactions::cm_move	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids,
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Move course modules to another location in the same course.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	the list of affected course module ids
int	$targetsectionid	optional target section id
int	$targetcmid	optional target cm id

cm_moveleft()

core_courseformat\stateactions::cm_moveleft	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids = [],
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Move course cms to the left.

Indent = 0.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	cm ids
int	$targetsectionid	not used
int	$targetcmid	not used

cm_moveright()

core_courseformat\stateactions::cm_moveright	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids = [],
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Move course cms to the right.

Indent = 1.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	cm ids
int	$targetsectionid	not used
int	$targetcmid	not used

cm_state()

core_courseformat\stateactions::cm_state	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids,
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Add the update messages of the updated version of any cm and section related to the cm ids.

This action is mainly used by legacy actions to partially update the course state when the result of core_course_edit_module is not enough to generate the correct state data.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	the list of affected course module ids
int	$targetsectionid	optional target section id
int	$targetcmid	optional target cm id

course_state()

core_courseformat\stateactions::course_state	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids = [],
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Add all the update messages from the complete course state.

This action is mainly used by legacy actions to partially update the course state when the result of core_course_edit_module is not enough to generate the correct state data.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	the list of affected course module ids (not used)
int	$targetsectionid	optional target section id (not used)
int	$targetcmid	optional target cm id (not used)

get_cm_info()

core_courseformat\stateactions::get_cm_info ( course_modinfo  $modinfo, array  $ids  )

protected

Extract several cm_info from the course_modinfo.

Parameters

course_modinfo	$modinfo	the course modinfo.
int[]	$ids	the course modules $ids

Return values

cm_info[]

the extracted cm_info objects

get_section_info()

core_courseformat\stateactions::get_section_info ( course_modinfo  $modinfo, array  $ids  )

protected

Extract several section_info from the course_modinfo.

Parameters

course_modinfo	$modinfo	the course modinfo.
int[]	$ids	the course modules $ids

Return values

section_info[]

the extracted section_info objects

section_add()

core_courseformat\stateactions::section_add	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids = [],
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Create a course section.

This method follows the same logic as changenumsections.php.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	not used
int	$targetsectionid	optional target section id (if not passed section will be appended)
int	$targetcmid	not used

section_content_collapsed()

core_courseformat\stateactions::section_content_collapsed	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids = [],
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Update the course content section collapsed value.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	the collapsed section ids
int	$targetsectionid	not used
int	$targetcmid	not used

section_delete()

core_courseformat\stateactions::section_delete	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids = [],
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Delete course sections.

This method follows the same logic as editsection.php.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	section ids
int	$targetsectionid	not used
int	$targetcmid	not used

section_index_collapsed()

core_courseformat\stateactions::section_index_collapsed	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids = [],
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Update the course index section collapsed value.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	the collapsed section ids
int	$targetsectionid	not used
int	$targetcmid	not used

section_move()

core_courseformat\stateactions::section_move	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids,
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Move course sections to another location in the same course.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	the list of affected course module ids
int	$targetsectionid	optional target section id
int	$targetcmid	optional target cm id

section_state()

core_courseformat\stateactions::section_state	(	stateupdates	$updates,
		stdClass	$course,
		array	$ids,
		?int	$targetsectionid = null,
		?int	$targetcmid = null
	)

Add the update messages of the updated version of any cm and section related to the section ids.

This action is mainly used by legacy actions to partially update the course state when the result of core_course_edit_module is not enough to generate the correct state data.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	the list of affected course section ids
int	$targetsectionid	optional target section id
int	$targetcmid	optional target cm id

set_cm_indentation()

core_courseformat\stateactions::set_cm_indentation ( stateupdates  $updates, stdClass  $course, array  $ids, int  $indent  )

protected

Internal method to define the cm indentation level.

Parameters

stateupdates	$updates	the affected course elements track
stdClass	$course	the course object
int[]	$ids	cm ids
int	$indent	new value for indentation

validate_cms()

core_courseformat\stateactions::validate_cms ( stdClass  $course, array  $cmids, ?string  $info = null  )

protected

Checks related to course modules: all given cm exist.

Parameters

stdClass	$course	The course where given $cmids belong.
array	$cmids	List of course module ids to validate.
string	$info	additional information in case of error.

Exceptions

moodle_exception

if any id is not valid

validate_sections()

core_courseformat\stateactions::validate_sections ( stdClass  $course, array  $sectionids, ?string  $info = null  )

protected

Checks related to sections: course format support them, all given sections exist and topic 0 is not included.

Parameters

stdClass	$course	The course where given $sectionids belong.
array	$sectionids	List of sections to validate.
string | null	$info	additional information in case of error (default null).

Exceptions

moodle_exception

if any id is not valid

---

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

• course/format/classes/stateactions.php