.
/**
* Course and category management interfaces.
*
* @package core_course
* @copyright 2013 Sam Hemelryk
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
require_once('../config.php');
require_once($CFG->dirroot.'/lib/coursecatlib.php');
require_once($CFG->dirroot.'/course/lib.php');
$categoryid = optional_param('categoryid', null, PARAM_INT);
$selectedcategoryid = optional_param('selectedcategoryid', null, PARAM_INT);
$courseid = optional_param('courseid', null, PARAM_INT);
$action = optional_param('action', false, PARAM_ALPHA);
$page = optional_param('page', 0, PARAM_INT);
$perpage = optional_param('perpage', null, PARAM_INT);
$viewmode = optional_param('view', 'default', PARAM_ALPHA); // Can be one of default, combined, courses, or categories.
// Search related params.
$search = optional_param('search', '', PARAM_RAW); // Search words. Shortname, fullname, idnumber and summary get searched.
$blocklist = optional_param('blocklist', 0, PARAM_INT); // Find courses containing this block.
$modulelist = optional_param('modulelist', '', PARAM_PLUGIN); // Find courses containing the given modules.
if (!in_array($viewmode, array('default', 'combined', 'courses', 'categories'))) {
$viewmode = 'default';
}
$issearching = ($search !== '' || $blocklist !== 0 || $modulelist !== '');
if ($issearching) {
$viewmode = 'courses';
}
$url = new moodle_url('/course/management.php');
$systemcontext = $context = context_system::instance();
if ($courseid) {
$record = get_course($courseid);
$course = new course_in_list($record);
$category = coursecat::get($course->category);
$categoryid = $category->id;
$context = context_coursecat::instance($category->id);
$url->param('categoryid', $categoryid);
$url->param('courseid', $course->id);
} else if ($categoryid) {
$courseid = null;
$course = null;
$category = coursecat::get($categoryid);
$context = context_coursecat::instance($category->id);
$url->param('categoryid', $category->id);
} else {
$course = null;
$courseid = null;
$category = coursecat::get_default();
$categoryid = $category->id;
$context = context_coursecat::instance($category->id);
$url->param('categoryid', $category->id);
}
// Check if there is a selected category param, and if there is apply it.
if ($course === null && $selectedcategoryid !== null && $selectedcategoryid !== $categoryid) {
$url->param('categoryid', $selectedcategoryid);
}
if ($page !== 0) {
$url->param('page', $page);
}
if ($viewmode !== 'default') {
$url->param('view', $viewmode);
}
if ($search !== '') {
$url->param('search', $search);
}
if ($blocklist !== 0) {
$url->param('blocklist', $search);
}
if ($modulelist !== '') {
$url->param('modulelist', $search);
}
$strmanagement = new lang_string('coursecatmanagement');
$pageheading = format_string($SITE->fullname, true, array('context' => $systemcontext));
$PAGE->set_context($context);
$PAGE->set_url($url);
$PAGE->set_pagelayout('admin');
$PAGE->set_title($strmanagement);
$PAGE->set_heading($pageheading);
// This is a system level page that operates on other contexts.
require_login();
if (!coursecat::has_capability_on_any(array('moodle/category:manage', 'moodle/course:create'))) {
// The user isn't able to manage any categories. Lets redirect them to the relevant course/index.php page.
$url = new moodle_url('/course/index.php');
if ($categoryid) {
$url->param('categoryid', $categoryid);
}
redirect($url);
}
// If the user poses any of these capabilities then they will be able to see the admin
// tree and the management link within it.
// This is the most accurate form of navigation.
$capabilities = array(
'moodle/site:config',
'moodle/backup:backupcourse',
'moodle/category:manage',
'moodle/course:create',
'moodle/site:approvecourse'
);
if ($category && !has_any_capability($capabilities, $systemcontext)) {
// If the user doesn't poses any of these system capabilities then we're going to mark the manage link in the settings block
// as active, tell the page to ignore the active path and just build what the user would expect.
// This will at least give the page some relevant navigation.
navigation_node::override_active_url(new moodle_url('/course/management.php', array('categoryid' => $category->id)));
$PAGE->set_category_by_id($category->id);
$PAGE->navbar->ignore_active(true);
$PAGE->navbar->add(get_string('coursemgmt', 'admin'), $PAGE->url->out_omit_querystring());
} else {
// If user has system capabilities, make sure the "Manage courses and categories" item in Administration block is active.
navigation_node::require_admin_tree();
navigation_node::override_active_url(new moodle_url('/course/management.php'));
}
if (!$issearching && $category !== null) {
$parents = coursecat::get_many($category->get_parents());
$parents[] = $category;
foreach ($parents as $parent) {
$PAGE->navbar->add(
$parent->get_formatted_name(),
new moodle_url('/course/management.php', array('categoryid' => $parent->id))
);
}
if ($course instanceof course_in_list) {
// Use the list name so that it matches whats being displayed below.
$PAGE->navbar->add($course->get_formatted_name());
}
}
$notificationspass = array();
$notificationsfail = array();
if ($action !== false && confirm_sesskey()) {
// Actions:
// - resortcategories : Resort the courses in the given category.
// - resortcourses : Resort courses
// - showcourse : make a course visible.
// - hidecourse : make a course hidden.
// - movecourseup : move the selected course up one.
// - movecoursedown : move the selected course down.
// - showcategory : make a category visible.
// - hidecategory : make a category hidden.
// - movecategoryup : move category up.
// - movecategorydown : move category down.
// - deletecategory : delete the category either in full, or moving contents.
// - bulkaction : performs bulk actions:
// - bulkmovecourses.
// - bulkmovecategories.
// - bulkresortcategories.
$redirectback = false;
$redirectmessage = false;
switch ($action) {
case 'resortcategories' :
$sort = required_param('resort', PARAM_ALPHA);
$cattosort = coursecat::get((int)optional_param('categoryid', 0, PARAM_INT));
$redirectback = \core_course\management\helper::action_category_resort_subcategories($cattosort, $sort);
break;
case 'resortcourses' :
// They must have specified a category.
required_param('categoryid', PARAM_INT);
$sort = required_param('resort', PARAM_ALPHA);
\core_course\management\helper::action_category_resort_courses($category, $sort);
break;
case 'showcourse' :
$redirectback = \core_course\management\helper::action_course_show($course);
break;
case 'hidecourse' :
$redirectback = \core_course\management\helper::action_course_hide($course);
break;
case 'movecourseup' :
// They must have specified a category and a course.
required_param('categoryid', PARAM_INT);
required_param('courseid', PARAM_INT);
$redirectback = \core_course\management\helper::action_course_change_sortorder_up_one($course, $category);
break;
case 'movecoursedown' :
// They must have specified a category and a course.
required_param('categoryid', PARAM_INT);
required_param('courseid', PARAM_INT);
$redirectback = \core_course\management\helper::action_course_change_sortorder_down_one($course, $category);
break;
case 'showcategory' :
// They must have specified a category.
required_param('categoryid', PARAM_INT);
$redirectback = \core_course\management\helper::action_category_show($category);
break;
case 'hidecategory' :
// They must have specified a category.
required_param('categoryid', PARAM_INT);
$redirectback = \core_course\management\helper::action_category_hide($category);
break;
case 'movecategoryup' :
// They must have specified a category.
required_param('categoryid', PARAM_INT);
$redirectback = \core_course\management\helper::action_category_change_sortorder_up_one($category);
break;
case 'movecategorydown' :
// They must have specified a category.
required_param('categoryid', PARAM_INT);
$redirectback = \core_course\management\helper::action_category_change_sortorder_down_one($category);
break;
case 'deletecategory':
// They must have specified a category.
required_param('categoryid', PARAM_INT);
if (!$category->can_delete()) {
throw new moodle_exception('permissiondenied', 'error', '', null, 'coursecat::can_resort');
}
$mform = new core_course_deletecategory_form(null, $category);
if ($mform->is_cancelled()) {
redirect($PAGE->url);
}
// Start output.
/* @var core_course_management_renderer|core_renderer $renderer */
$renderer = $PAGE->get_renderer('core_course', 'management');
echo $renderer->header();
echo $renderer->heading(get_string('deletecategory', 'moodle', $category->get_formatted_name()));
if ($data = $mform->get_data()) {
// The form has been submit handle it.
if ($data->fulldelete == 1 && $category->can_delete_full()) {
$continueurl = new moodle_url('/course/management.php');
if ($category->parent != '0') {
$continueurl->param('categoryid', $category->parent);
}
$notification = get_string('coursecategorydeleted', '', $category->get_formatted_name());
$deletedcourses = $category->delete_full(true);
foreach ($deletedcourses as $course) {
echo $renderer->notification(get_string('coursedeleted', '', $course->shortname), 'notifysuccess');
}
echo $renderer->notification($notification, 'notifysuccess');
echo $renderer->continue_button($continueurl);
} else if ($data->fulldelete == 0 && $category->can_move_content_to($data->newparent)) {
$continueurl = new moodle_url('/course/management.php', array('categoryid' => $data->newparent));
$category->delete_move($data->newparent, true);
echo $renderer->continue_button($continueurl);
} else {
// Some error in parameters (user is cheating?)
$mform->display();
}
} else {
// Display the form.
$mform->display();
}
// Finish output and exit.
echo $renderer->footer();
exit();
break;
case 'bulkaction':
$bulkmovecourses = optional_param('bulkmovecourses', false, PARAM_BOOL);
$bulkmovecategories = optional_param('bulkmovecategories', false, PARAM_BOOL);
$bulkresortcategories = optional_param('bulksort', false, PARAM_BOOL);
if ($bulkmovecourses) {
// Move courses out of the current category and into a new category.
// They must have specified a category.
required_param('categoryid', PARAM_INT);
$movetoid = required_param('movecoursesto', PARAM_INT);
$courseids = optional_param_array('bc', false, PARAM_INT);
if ($courseids === false) {
break;
}
$moveto = coursecat::get($movetoid);
try {
// If this fails we want to catch the exception and report it.
$redirectback = \core_course\management\helper::move_courses_into_category($moveto,
$courseids);
if ($redirectback) {
$a = new stdClass;
$a->category = $moveto->get_formatted_name();
$a->courses = count($courseids);
$redirectmessage = get_string('bulkmovecoursessuccess', 'moodle', $a);
}
} catch (moodle_exception $ex) {
$redirectback = false;
$notificationsfail[] = $ex->getMessage();
}
} else if ($bulkmovecategories) {
$categoryids = optional_param_array('bcat', array(), PARAM_INT);
$movetocatid = required_param('movecategoriesto', PARAM_INT);
$movetocat = coursecat::get($movetocatid);
$movecount = 0;
foreach ($categoryids as $id) {
$cattomove = coursecat::get($id);
if ($id == $movetocatid) {
$notificationsfail[] = get_string('movecategoryownparent', 'error', $cattomove->get_formatted_name());
continue;
}
if (strpos($movetocat->path, $cattomove->path) === 0) {
$notificationsfail[] = get_string('movecategoryparentconflict', 'error', $cattomove->get_formatted_name());
continue;
}
if ($cattomove->parent != $movetocatid) {
if ($cattomove->can_change_parent($movetocatid)) {
$cattomove->change_parent($movetocatid);
$movecount++;
} else {
$notificationsfail[] = get_string('movecategorynotpossible', 'error', $cattomove->get_formatted_name());
}
}
}
if ($movecount > 1) {
$a = new stdClass;
$a->count = $movecount;
$a->to = $movetocat->get_formatted_name();
$movesuccessstrkey = 'movecategoriessuccess';
if ($movetocatid == 0) {
$movesuccessstrkey = 'movecategoriestotopsuccess';
}
$notificationspass[] = get_string($movesuccessstrkey, 'moodle', $a);
} else if ($movecount === 1) {
$a = new stdClass;
$a->moved = $cattomove->get_formatted_name();
$a->to = $movetocat->get_formatted_name();
$movesuccessstrkey = 'movecategorysuccess';
if ($movetocatid == 0) {
$movesuccessstrkey = 'movecategorytotopsuccess';
}
$notificationspass[] = get_string($movesuccessstrkey, 'moodle', $a);
}
} else if ($bulkresortcategories) {
$for = required_param('selectsortby', PARAM_ALPHA);
$sortcategoriesby = required_param('resortcategoriesby', PARAM_ALPHA);
$sortcoursesby = required_param('resortcoursesby', PARAM_ALPHA);
if ($sortcategoriesby === 'none' && $sortcoursesby === 'none') {
// They're not sorting anything.
break;
}
if (!in_array($sortcategoriesby, array('idnumber', 'idnumberdesc',
'name', 'namedesc'))) {
$sortcategoriesby = false;
}
if (!in_array($sortcoursesby, array('timecreated', 'timecreateddesc',
'idnumber', 'idnumberdesc',
'fullname', 'fullnamedesc',
'shortname', 'shortnamedesc'))) {
$sortcoursesby = false;
}
if ($for === 'thiscategory') {
$categoryids = array(
required_param('currentcategoryid', PARAM_INT)
);
$categories = coursecat::get_many($categoryids);
} else if ($for === 'selectedcategories') {
// Bulk resort selected categories.
$categoryids = optional_param_array('bcat', false, PARAM_INT);
$sort = required_param('resortcategoriesby', PARAM_ALPHA);
if ($categoryids === false) {
break;
}
$categories = coursecat::get_many($categoryids);
} else if ($for === 'allcategories') {
if ($sortcategoriesby && coursecat::get(0)->can_resort_subcategories()) {
\core_course\management\helper::action_category_resort_subcategories(coursecat::get(0), $sortcategoriesby);
}
$categorieslist = coursecat::make_categories_list('moodle/category:manage');
$categoryids = array_keys($categorieslist);
$categories = coursecat::get_many($categoryids);
unset($categorieslist);
} else {
break;
}
foreach ($categories as $cat) {
if ($sortcategoriesby && $cat->can_resort_subcategories()) {
// Don't clean up here, we'll do it once we're all done.
\core_course\management\helper::action_category_resort_subcategories($cat, $sortcategoriesby, false);
}
if ($sortcoursesby && $cat->can_resort_courses()) {
\core_course\management\helper::action_category_resort_courses($cat, $sortcoursesby, false);
}
}
coursecat::resort_categories_cleanup($sortcoursesby !== false);
if ($category === null && count($categoryids) === 1) {
// They're bulk sorting just a single category and they've not selected a category.
// Lets for convenience sake auto-select the category that has been resorted for them.
redirect(new moodle_url($PAGE->url, array('categoryid' => reset($categoryids))));
}
}
}
if ($redirectback) {
if ($redirectmessage) {
redirect($PAGE->url, $redirectmessage, 5);
} else {
redirect($PAGE->url);
}
}
}
if (!is_null($perpage)) {
set_user_preference('coursecat_management_perpage', $perpage);
} else {
$perpage = get_user_preferences('coursecat_management_perpage', $CFG->coursesperpage);
}
if ((int)$perpage != $perpage || $perpage < 2) {
$perpage = $CFG->coursesperpage;
}
$categorysize = 4;
$coursesize = 4;
$detailssize = 4;
if ($viewmode === 'default' || $viewmode === 'combined') {
if (isset($courseid)) {
$class = 'columns-3';
} else {
$categorysize = 5;
$coursesize = 7;
$class = 'columns-2';
}
} else if ($viewmode === 'categories') {
$categorysize = 12;
$class = 'columns-1';
} else if ($viewmode === 'courses') {
if (isset($courseid)) {
$coursesize = 6;
$detailssize = 6;
$class = 'columns-2';
} else {
$coursesize = 12;
$class = 'columns-1';
}
}
if ($viewmode === 'default' || $viewmode === 'combined') {
$class .= ' viewmode-cobmined';
} else {
$class .= ' viewmode-'.$viewmode;
}
if (($viewmode === 'default' || $viewmode === 'combined' || $viewmode === 'courses') && !empty($courseid)) {
$class .= ' course-selected';
}
/* @var core_course_management_renderer|core_renderer $renderer */
$renderer = $PAGE->get_renderer('core_course', 'management');
$renderer->enhance_management_interface();
$displaycategorylisting = ($viewmode === 'default' || $viewmode === 'combined' || $viewmode === 'categories');
$displaycourselisting = ($viewmode === 'default' || $viewmode === 'combined' || $viewmode === 'courses');
$displaycoursedetail = (isset($courseid));
echo $renderer->header();
if (!$issearching) {
echo $renderer->management_heading($strmanagement, $viewmode, $categoryid);
} else {
echo $renderer->management_heading(new lang_string('searchresults'));
}
if (count($notificationspass) > 0) {
echo $renderer->notification(join('
', $notificationspass), 'notifysuccess');
}
if (count($notificationsfail) > 0) {
echo $renderer->notification(join('
', $notificationsfail));
}
// Start the management form.
echo $renderer->management_form_start();
echo $renderer->accessible_skipto_links($displaycategorylisting, $displaycourselisting, $displaycoursedetail);
echo $renderer->grid_start('course-category-listings', $class);
if ($displaycategorylisting) {
echo $renderer->grid_column_start($categorysize, 'category-listing');
echo $renderer->category_listing($category);
echo $renderer->grid_column_end();
}
if ($displaycourselisting) {
echo $renderer->grid_column_start($coursesize, 'course-listing');
if (!$issearching) {
echo $renderer->course_listing($category, $course, $page, $perpage);
} else {
list($courses, $coursescount, $coursestotal) =
\core_course\management\helper::search_courses($search, $blocklist, $modulelist, $page, $perpage);
echo $renderer->search_listing($courses, $coursestotal, $course, $page, $perpage, $search);
}
echo $renderer->grid_column_end();
if ($displaycoursedetail) {
echo $renderer->grid_column_start($detailssize, 'course-detail');
echo $renderer->course_detail($course);
echo $renderer->grid_column_end();
}
}
echo $renderer->grid_end();
// End of the management form.
echo $renderer->management_form_end();
echo $renderer->course_search_form($search);
echo $renderer->footer();