Course and category management interface helper class. More...

Static Public Member Functions
static	action_category_change_sortorder_down_one (\core_course_category $category)
	Resort a categories subcategories shifting the given category down one. More...

static	action_category_change_sortorder_down_one_by_id ($categoryid)
	Resort a categories subcategories shifting the given category down one. More...

static	action_category_change_sortorder_up_one (\core_course_category $category)
	Resort a categories subcategories shifting the given category up one. More...

static	action_category_change_sortorder_up_one_by_id ($categoryid)
	Resort a categories subcategories shifting the given category up one. More...

static	action_category_hide (\core_course_category $category)
	Makes a category hidden given a core_course_category object. More...

static	action_category_hide_by_id ($categoryid)
	Makes a category hidden given a course category id or database record. More...

static	action_category_move_courses_into (\core_course_category $oldcategory, core_course_category $newcategory, array $courseids)
	Moves courses out of one category and into a new category. More...

static	action_category_resort_courses (\core_course_category $category, $sort, $cleanup=true)
	Resorts the courses within the given category. More...

static	action_category_resort_subcategories (\core_course_category $category, $sort, $cleanup=true)
	Resorts the sub categories of the given category. More...

static	action_category_show (\core_course_category $category)
	Makes a category visible given a core_course_category object. More...

static	action_category_show_by_id ($categoryid)
	Makes a category visible given a course category id or database record. More...

static	action_course_change_sortorder_after_course ($courserecordorid, $moveaftercourseid)
	Changes the sort order so that the first course appears after the second course. More...

static	action_course_change_sortorder_down_one (\core_course_list_element $course, core_course_category $category)
	Resorts the courses within a category moving the given course down by one. More...

static moodle_database	action_course_change_sortorder_down_one_by_record ($courserecordorid)
	Resorts the courses within a category moving the given course down by one. More...

static	action_course_change_sortorder_up_one (\core_course_list_element $course, core_course_category $category)
	Resorts the courses within a category moving the given course up by one. More...

static moodle_database	action_course_change_sortorder_up_one_by_record ($courserecordorid)
	Resorts the courses within a category moving the given course up by one. More...

static	action_course_hide (\core_course_list_element $course)
	Makes a course hidden given a core_course_list_element object. More...

static moodle_database	action_course_hide_by_record ($courserecordorid)
	Makes a course hidden given a course id or a database record. More...

static	action_course_show (\core_course_list_element $course)
	Makes a course visible given a core_course_list_element object. More...

static moodle_database	action_course_show_by_record ($courserecordorid)
	Makes a course visible given a course id or a database record. More...

static	can_copy_course (int $courseid)
	Returns true if the current user can copy this course. More...

static	get_category_children_visibility ($categoryid)
	Returns an array of all categoryids that have the given category as a parent and their visible value. More...

static	get_category_courses_visibility ($categoryid)
	Returns an array of courseids and visiblity for all courses within the given category. More...

static	get_category_listitem_actions (\core_course_category $category)
	Returns an array of actions that can be performed upon a category being shown in a list. More...

static	get_course_copy_capabilities ()
	Get an array of the capabilities required to copy a course. More...

static	get_course_detail_actions (\core_course_list_element $course)
	Returns an array of actions that can be performed on the course being displayed. More...

static moodle_database	get_course_detail_array (\core_course_list_element $course)
	Returns course details in an array ready to be printed. More...

static	get_course_listitem_actions (\core_course_category $category, core_course_list_element $course)
	Returns an array of actions for a course listitem. More...

static	get_expanded_categories ($withpath=null)
	Returns the categories that should be expanded when displaying the interface. More...

static	get_management_viewmodes ()
	Returns the view modes for the management interface. More...

static	move_courses_into_category ($categoryorid, $courseids=array())
	Moves one or more courses out of the category they are currently in and into a new category. More...

static	record_expanded_category (\core_course_category $coursecat, $expanded=true)
	Records when a category is expanded or collapsed so that when the user. More...

static	search_courses ($search, $blocklist, $modulelist, $page=0, $perpage=null)
	Search for courses with matching params. More...

Static Protected Attributes
static null array	$expandedcategories = null
	The expanded category structure if its already being loaded from the cache.

Detailed Description

Course and category management interface helper class.

This class provides methods useful to the course and category management interfaces. Many of the methods on this class are static and serve one of two purposes.

encapsulate functionality in an effort to ensure minimal changes between the different methods of interaction. Specifically browser, AJAX and webservice.
abstract logic for acquiring actions away from output so that renderers may use them without having to include any logic or capability checks.

Copyright: 2013 Sam Hemelryk

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

Member Function Documentation

◆ action_category_change_sortorder_down_one()

static core_course\management\helper::action_category_change_sortorder_down_one ( \core_course_category $category )

static

Resort a categories subcategories shifting the given category down one.

Parameters

core_course_category $category

Return values

bool

Exceptions

moodle_exception

◆ action_category_change_sortorder_down_one_by_id()

static core_course\management\helper::action_category_change_sortorder_down_one_by_id ( $categoryid )

static

Resort a categories subcategories shifting the given category down one.

Parameters

int $categoryid

Return values

bool

◆ action_category_change_sortorder_up_one()

static core_course\management\helper::action_category_change_sortorder_up_one ( \core_course_category $category )

static

Resort a categories subcategories shifting the given category up one.

Parameters

core_course_category $category

Return values

bool

Exceptions

moodle_exception

◆ action_category_change_sortorder_up_one_by_id()

static core_course\management\helper::action_category_change_sortorder_up_one_by_id ( $categoryid )

static

Resort a categories subcategories shifting the given category up one.

Parameters

int $categoryid

Return values

bool

◆ action_category_hide()

static core_course\management\helper::action_category_hide ( \core_course_category $category )

static

Makes a category hidden given a core_course_category object.

Parameters

core_course_category $category

Return values

bool

Exceptions

moodle_exception

◆ action_category_hide_by_id()

static core_course\management\helper::action_category_hide_by_id ( $categoryid )

static

Makes a category hidden given a course category id or database record.

Parameters

int | stdClass $categoryid

Return values

bool

◆ action_category_move_courses_into()

static core_course\management\helper::action_category_move_courses_into	(	\core_course_category	$oldcategory,
		core_course_category	$newcategory,
		array	$courseids
	)

static

Moves courses out of one category and into a new category.

Parameters

core_course_category	$oldcategory	The category we are moving courses out of.
core_course_category	$newcategory	The category we are moving courses into.
array	$courseids	The ID's of the courses we want to move.

Return values

bool	True on success.

Exceptions

moodle_exception

◆ action_category_resort_courses()

static core_course\management\helper::action_category_resort_courses	(	\core_course_category	$category,
			$sort,
			$cleanup = `true`
	)

static

Resorts the courses within the given category.

Parameters

core_course_category	$category
string	$sort	One of fullname, shortname or idnumber
bool	$cleanup	If true cleanup will be done, if false you will need to do it manually later.

Return values

bool

Exceptions

moodle_exception

◆ action_category_resort_subcategories()

static core_course\management\helper::action_category_resort_subcategories	(	\core_course_category	$category,
			$sort,
			$cleanup = `true`
	)

static

Resorts the sub categories of the given category.

Parameters

core_course_category	$category
string	$sort	One of idnumber or name.
bool	$cleanup	If true cleanup will be done, if false you will need to do it manually later.

Return values

bool

Exceptions

moodle_exception

◆ action_category_show()

static core_course\management\helper::action_category_show ( \core_course_category $category )

static

Makes a category visible given a core_course_category object.

Parameters

core_course_category $category

Return values

bool

Exceptions

moodle_exception

◆ action_category_show_by_id()

static core_course\management\helper::action_category_show_by_id ( $categoryid )

static

Makes a category visible given a course category id or database record.

Parameters

int | stdClass $categoryid

Return values

bool

◆ action_course_change_sortorder_after_course()

static core_course\management\helper::action_course_change_sortorder_after_course	(	$courserecordorid,
		$moveaftercourseid
	)

static

Changes the sort order so that the first course appears after the second course.

Parameters

int \| stdClass	$courserecordorid
int	$moveaftercourseid

Return values

bool

Exceptions

moodle_exception

◆ action_course_change_sortorder_down_one()

static core_course\management\helper::action_course_change_sortorder_down_one	(	\core_course_list_element	$course,
		core_course_category	$category
	)

static

Resorts the courses within a category moving the given course down by one.

Parameters

core_course_list_element	$course
core_course_category	$category

Return values

bool

Exceptions

moodle_exception

◆ action_course_change_sortorder_down_one_by_record()

static moodle_database core_course\management\helper::action_course_change_sortorder_down_one_by_record ( $courserecordorid )

static

Resorts the courses within a category moving the given course down by one.

$DB

Parameters

int | stdClass $courserecordorid

Return values

bool

◆ action_course_change_sortorder_up_one()

static core_course\management\helper::action_course_change_sortorder_up_one	(	\core_course_list_element	$course,
		core_course_category	$category
	)

static

Resorts the courses within a category moving the given course up by one.

Parameters

core_course_list_element	$course
core_course_category	$category

Return values

bool

Exceptions

moodle_exception

◆ action_course_change_sortorder_up_one_by_record()

static moodle_database core_course\management\helper::action_course_change_sortorder_up_one_by_record ( $courserecordorid )

static

Resorts the courses within a category moving the given course up by one.

$DB

Parameters

int | stdClass $courserecordorid

Return values

bool

◆ action_course_hide()

static core_course\management\helper::action_course_hide ( \core_course_list_element $course )

static

Makes a course hidden given a core_course_list_element object.

Parameters

core_course_list_element $course

Return values

bool

Exceptions

moodle_exception

◆ action_course_hide_by_record()

static moodle_database core_course\management\helper::action_course_hide_by_record ( $courserecordorid )

static

Makes a course hidden given a course id or a database record.

$DB

Parameters

int | stdClass $courserecordorid

Return values

bool

◆ action_course_show()

static core_course\management\helper::action_course_show ( \core_course_list_element $course )

static

Makes a course visible given a core_course_list_element object.

Parameters

core_course_list_element $course

Return values

bool

Exceptions

moodle_exception

◆ action_course_show_by_record()

static moodle_database core_course\management\helper::action_course_show_by_record ( $courserecordorid )

static

Makes a course visible given a course id or a database record.

$DB

Parameters

int | stdClass $courserecordorid

Return values

bool

◆ can_copy_course()

static core_course\management\helper::can_copy_course ( int $courseid )

static

Returns true if the current user can copy this course.

Parameters

int $courseid

Return values

bool

◆ get_category_children_visibility()

static core_course\management\helper::get_category_children_visibility ( $categoryid )

static

Returns an array of all categoryids that have the given category as a parent and their visible value.

Parameters

int $categoryid

Return values

array

◆ get_category_courses_visibility()

static core_course\management\helper::get_category_courses_visibility ( $categoryid )

static

Returns an array of courseids and visiblity for all courses within the given category.

Parameters

int $categoryid

Return values

array

◆ get_category_listitem_actions()

static core_course\management\helper::get_category_listitem_actions ( \core_course_category $category )

static

Returns an array of actions that can be performed upon a category being shown in a list.

Parameters

core_course_category $category

Return values

array

◆ get_course_copy_capabilities()

static core_course\management\helper::get_course_copy_capabilities ( )

static

Get an array of the capabilities required to copy a course.

Return values

array

◆ get_course_detail_actions()

static core_course\management\helper::get_course_detail_actions ( \core_course_list_element $course )

static

Returns an array of actions that can be performed on the course being displayed.

Parameters

core_course_list_element $course

Return values

array

◆ get_course_detail_array()

static moodle_database core_course\management\helper::get_course_detail_array ( \core_course_list_element $course )

static

Returns course details in an array ready to be printed.

$DB

Parameters

core_course_list_element $course

Return values

array

◆ get_course_listitem_actions()

static core_course\management\helper::get_course_listitem_actions	(	\core_course_category	$category,
		core_course_list_element	$course
	)

static

Returns an array of actions for a course listitem.

Parameters

core_course_category	$category
core_course_list_element	$course

Return values

array

◆ get_expanded_categories()

static core_course\management\helper::get_expanded_categories ( $withpath = null )

static

Returns the categories that should be expanded when displaying the interface.

Parameters

int | null $withpath If specified a path to require as the parent.

Return values

core_course_category[] An array of Category ID's to expand.

◆ get_management_viewmodes()

static core_course\management\helper::get_management_viewmodes ( )

static

Returns the view modes for the management interface.

Return values

array

◆ move_courses_into_category()

static core_course\management\helper::move_courses_into_category	(	$categoryorid,
		$courseids = `array()`
	)

static

Moves one or more courses out of the category they are currently in and into a new category.

This function works much the same way as action_category_move_courses_into however it allows courses from multiple categories to be moved into a single category.

Parameters

int \| core_course_category	$categoryorid	The category to move them into.
array \| int	$courseids	An array of course id's or optionally just a single course id.

Return values

bool	True on success or false on failure.

Exceptions

moodle_exception

◆ record_expanded_category()

static core_course\management\helper::record_expanded_category	(	\core_course_category	$coursecat,
			$expanded = `true`
	)

static

Records when a category is expanded or collapsed so that when the user.

Parameters

core_course_category	$coursecat	The category we're working with.
bool	$expanded	True if the category is expanded now.

◆ search_courses()

static core_course\management\helper::search_courses	(	$search,
		$blocklist,
		$modulelist,
		$page = `0`,
		$perpage = `null`
	)

static

Search for courses with matching params.

Please note that only one of search, blocklist, or modulelist can be specified at a time. Specifying more than one will result in only the first being used.

Parameters

string	$search	Words to search for. We search fullname, shortname, idnumber and summary.
int	$blocklist	The ID of a block, courses will only be returned if they use this block.
string	$modulelist	The name of a module (relates to database table name). Only courses containing this module will be returned.
int	$page	The page number to display, starting at 0.
int	$perpage	The number of courses to display per page.

Return values

array

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

course/classes/management/helper.php

Static Public Member Functions

Static Protected Attributes

Detailed Description

Member Function Documentation

◆ action_category_change_sortorder_down_one()

◆ action_category_change_sortorder_down_one_by_id()

◆ action_category_change_sortorder_up_one()

◆ action_category_change_sortorder_up_one_by_id()

◆ action_category_hide()

◆ action_category_hide_by_id()

◆ action_category_move_courses_into()

◆ action_category_resort_courses()

◆ action_category_resort_subcategories()

◆ action_category_show()

◆ action_category_show_by_id()

◆ action_course_change_sortorder_after_course()

◆ action_course_change_sortorder_down_one()

◆ action_course_change_sortorder_down_one_by_record()

◆ action_course_change_sortorder_up_one()

◆ action_course_change_sortorder_up_one_by_record()

◆ action_course_hide()

◆ action_course_hide_by_record()

◆ action_course_show()

◆ action_course_show_by_record()

◆ can_copy_course()

◆ get_category_children_visibility()

◆ get_category_courses_visibility()

◆ get_category_listitem_actions()

◆ get_course_copy_capabilities()

◆ get_course_detail_actions()

◆ get_course_detail_array()

◆ get_course_listitem_actions()

◆ get_expanded_categories()

◆ get_management_viewmodes()

◆ move_courses_into_category()

◆ record_expanded_category()

◆ search_courses()