2 // This file is part of Moodle - http://moodle.org/
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 // GNU General Public License for more details.
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
21 * @package core_course
23 * @copyright 2009 Petr Skodak
24 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
27 defined('MOODLE_INTERNAL') ||
die;
29 require_once("$CFG->libdir/externallib.php");
32 * Course external functions
34 * @package core_course
36 * @copyright 2011 Jerome Mouneyrac
37 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
40 class core_course_external
extends external_api
{
43 * Returns description of method parameters
45 * @return external_function_parameters
48 public static function get_course_contents_parameters() {
49 return new external_function_parameters(
50 array('courseid' => new external_value(PARAM_INT
, 'course id'),
51 'options' => new external_multiple_structure (
52 new external_single_structure(
53 array('name' => new external_value(PARAM_ALPHANUM
, 'option name'),
54 'value' => new external_value(PARAM_RAW
, 'the value of the option, this param is personaly validated in the external function.')
56 ), 'Options, not used yet, might be used in later version', VALUE_DEFAULT
, array())
64 * @param int $courseid course id
65 * @param array $options These options are not used yet, might be used in later version
69 public static function get_course_contents($courseid, $options) {
71 require_once($CFG->dirroot
. "/course/lib.php");
74 $params = self
::validate_parameters(self
::get_course_contents_parameters(),
75 array('courseid' => $courseid, 'options' => $options));
78 $course = $DB->get_record('course', array('id' => $params['courseid']), '*', MUST_EXIST
);
80 //check course format exist
81 if (!file_exists($CFG->dirroot
. '/course/format/' . $course->format
. '/lib.php')) {
82 throw new moodle_exception('cannotgetcoursecontents', 'webservice', '', null, get_string('courseformatnotfound', 'error', '', $course->format
));
84 require_once($CFG->dirroot
. '/course/format/' . $course->format
. '/lib.php');
87 // now security checks
88 $context = get_context_instance(CONTEXT_COURSE
, $course->id
);
90 self
::validate_context($context);
91 } catch (Exception
$e) {
92 $exceptionparam = new stdClass();
93 $exceptionparam->message
= $e->getMessage();
94 $exceptionparam->courseid
= $course->id
;
95 throw new moodle_exception('errorcoursecontextnotvalid', 'webservice', '', $exceptionparam);
98 $canupdatecourse = has_capability('moodle/course:update', $context);
100 //create return value
101 $coursecontents = array();
103 if ($canupdatecourse or $course->visible
104 or has_capability('moodle/course:viewhiddencourses', $context)) {
107 $modinfo = get_fast_modinfo($course);
108 $sections = get_all_sections($course->id
);
110 //for each sections (first displayed to last displayed)
111 foreach ($sections as $key => $section) {
113 $showsection = (has_capability('moodle/course:viewhiddensections', $context) or $section->visible
or !$course->hiddensections
);
118 // reset $sectioncontents
119 $sectionvalues = array();
120 $sectionvalues['id'] = $section->id
;
121 $sectionvalues['name'] = get_section_name($course, $section);
122 $summary = file_rewrite_pluginfile_urls($section->summary
, 'webservice/pluginfile.php', $context->id
, 'course', 'section', $section->id
);
123 $sectionvalues['visible'] = $section->visible
;
124 $sectionvalues['summary'] = format_text($summary, $section->summaryformat
);
125 $sectioncontents = array();
127 //for each module of the section
128 foreach ($modinfo->sections
[$section->section
] as $cmid) { //matching /course/lib.php:print_section() logic
129 $cm = $modinfo->cms
[$cmid];
131 // stop here if the module is not visible to the user
132 if (!$cm->uservisible
) {
138 //common info (for people being able to see the module or availability dates)
139 $module['id'] = $cm->id
;
140 $module['name'] = format_string($cm->name
, true);
141 $module['modname'] = $cm->modname
;
142 $module['modplural'] = $cm->modplural
;
143 $module['modicon'] = $cm->get_icon_url()->out(false);
144 $module['indent'] = $cm->indent
;
146 $modcontext = get_context_instance(CONTEXT_MODULE
, $cm->id
);
148 if (!empty($cm->showdescription
)) {
149 $module['description'] = $cm->get_content();
153 $url = $cm->get_url();
154 if ($url) { //labels don't have url
155 $module['url'] = $cm->get_url()->out();
158 $canviewhidden = has_capability('moodle/course:viewhiddenactivities',
159 get_context_instance(CONTEXT_MODULE
, $cm->id
));
160 //user that can view hidden module should know about the visibility
161 $module['visible'] = $cm->visible
;
163 //availability date (also send to user who can see hidden module when the showavailabilyt is ON)
164 if ($canupdatecourse or ($CFG->enableavailability
&& $canviewhidden && $cm->showavailability
)) {
165 $module['availablefrom'] = $cm->availablefrom
;
166 $module['availableuntil'] = $cm->availableuntil
;
169 $baseurl = 'webservice/pluginfile.php';
171 //call $modulename_export_contents
172 //(each module callback take care about checking the capabilities)
173 require_once($CFG->dirroot
. '/mod/' . $cm->modname
. '/lib.php');
174 $getcontentfunction = $cm->modname
.'_export_contents';
175 if (function_exists($getcontentfunction)) {
176 if ($contents = $getcontentfunction($cm, $baseurl)) {
177 $module['contents'] = $contents;
181 //assign result to $sectioncontents
182 $sectioncontents[] = $module;
185 $sectionvalues['modules'] = $sectioncontents;
187 // assign result to $coursecontents
188 $coursecontents[] = $sectionvalues;
191 return $coursecontents;
195 * Returns description of method result value
197 * @return external_description
200 public static function get_course_contents_returns() {
201 return new external_multiple_structure(
202 new external_single_structure(
204 'id' => new external_value(PARAM_INT
, 'Section ID'),
205 'name' => new external_value(PARAM_TEXT
, 'Section name'),
206 'visible' => new external_value(PARAM_INT
, 'is the section visible', VALUE_OPTIONAL
),
207 'summary' => new external_value(PARAM_RAW
, 'Section description'),
208 'modules' => new external_multiple_structure(
209 new external_single_structure(
211 'id' => new external_value(PARAM_INT
, 'activity id'),
212 'url' => new external_value(PARAM_URL
, 'activity url', VALUE_OPTIONAL
),
213 'name' => new external_value(PARAM_TEXT
, 'activity module name'),
214 'description' => new external_value(PARAM_RAW
, 'activity description', VALUE_OPTIONAL
),
215 'visible' => new external_value(PARAM_INT
, 'is the module visible', VALUE_OPTIONAL
),
216 'modicon' => new external_value(PARAM_URL
, 'activity icon url'),
217 'modname' => new external_value(PARAM_PLUGIN
, 'activity module type'),
218 'modplural' => new external_value(PARAM_TEXT
, 'activity module plural name'),
219 'availablefrom' => new external_value(PARAM_INT
, 'module availability start date', VALUE_OPTIONAL
),
220 'availableuntil' => new external_value(PARAM_INT
, 'module availability en date', VALUE_OPTIONAL
),
221 'indent' => new external_value(PARAM_INT
, 'number of identation in the site'),
222 'contents' => new external_multiple_structure(
223 new external_single_structure(
226 'type'=> new external_value(PARAM_TEXT
, 'a file or a folder or external link'),
227 'filename'=> new external_value(PARAM_FILE
, 'filename'),
228 'filepath'=> new external_value(PARAM_PATH
, 'filepath'),
229 'filesize'=> new external_value(PARAM_INT
, 'filesize'),
230 'fileurl' => new external_value(PARAM_URL
, 'downloadable file url', VALUE_OPTIONAL
),
231 'content' => new external_value(PARAM_RAW
, 'Raw content, will be used when type is content', VALUE_OPTIONAL
),
232 'timecreated' => new external_value(PARAM_INT
, 'Time created'),
233 'timemodified' => new external_value(PARAM_INT
, 'Time modified'),
234 'sortorder' => new external_value(PARAM_INT
, 'Content sort order'),
236 // copyright related info
237 'userid' => new external_value(PARAM_INT
, 'User who added this content to moodle'),
238 'author' => new external_value(PARAM_TEXT
, 'Content owner'),
239 'license' => new external_value(PARAM_TEXT
, 'Content license'),
241 ), VALUE_DEFAULT
, array()
252 * Returns description of method parameters
254 * @return external_function_parameters
257 public static function get_courses_parameters() {
258 return new external_function_parameters(
259 array('options' => new external_single_structure(
260 array('ids' => new external_multiple_structure(
261 new external_value(PARAM_INT
, 'Course id')
262 , 'List of course id. If empty return all courses
263 except front page course.',
265 ), 'options - operator OR is used', VALUE_DEFAULT
, array())
273 * @param array $options It contains an array (list of ids)
277 public static function get_courses($options) {
279 require_once($CFG->dirroot
. "/course/lib.php");
282 $params = self
::validate_parameters(self
::get_courses_parameters(),
283 array('options' => $options));
286 if (!key_exists('ids', $params['options'])
287 or empty($params['options']['ids'])) {
288 $courses = $DB->get_records('course');
290 $courses = $DB->get_records_list('course', 'id', $params['options']['ids']);
293 //create return value
294 $coursesinfo = array();
295 foreach ($courses as $course) {
297 // now security checks
298 $context = get_context_instance(CONTEXT_COURSE
, $course->id
);
300 self
::validate_context($context);
301 } catch (Exception
$e) {
302 $exceptionparam = new stdClass();
303 $exceptionparam->message
= $e->getMessage();
304 $exceptionparam->courseid
= $course->id
;
305 throw new moodle_exception(
306 get_string('errorcoursecontextnotvalid', 'webservice', $exceptionparam));
308 require_capability('moodle/course:view', $context);
310 $courseinfo = array();
311 $courseinfo['id'] = $course->id
;
312 $courseinfo['fullname'] = $course->fullname
;
313 $courseinfo['shortname'] = $course->shortname
;
314 $courseinfo['categoryid'] = $course->category
;
315 $courseinfo['summary'] = $course->summary
;
316 $courseinfo['summaryformat'] = $course->summaryformat
;
317 $courseinfo['format'] = $course->format
;
318 $courseinfo['startdate'] = $course->startdate
;
319 $courseinfo['numsections'] = $course->numsections
;
321 //some field should be returned only if the user has update permission
322 $courseadmin = has_capability('moodle/course:update', $context);
324 $courseinfo['categorysortorder'] = $course->sortorder
;
325 $courseinfo['idnumber'] = $course->idnumber
;
326 $courseinfo['showgrades'] = $course->showgrades
;
327 $courseinfo['showreports'] = $course->showreports
;
328 $courseinfo['newsitems'] = $course->newsitems
;
329 $courseinfo['visible'] = $course->visible
;
330 $courseinfo['maxbytes'] = $course->maxbytes
;
331 $courseinfo['hiddensections'] = $course->hiddensections
;
332 $courseinfo['groupmode'] = $course->groupmode
;
333 $courseinfo['groupmodeforce'] = $course->groupmodeforce
;
334 $courseinfo['defaultgroupingid'] = $course->defaultgroupingid
;
335 $courseinfo['lang'] = $course->lang
;
336 $courseinfo['timecreated'] = $course->timecreated
;
337 $courseinfo['timemodified'] = $course->timemodified
;
338 $courseinfo['forcetheme'] = $course->theme
;
339 $courseinfo['enablecompletion'] = $course->enablecompletion
;
340 $courseinfo['completionstartonenrol'] = $course->completionstartonenrol
;
341 $courseinfo['completionnotify'] = $course->completionnotify
;
344 if ($courseadmin or $course->visible
345 or has_capability('moodle/course:viewhiddencourses', $context)) {
346 $coursesinfo[] = $courseinfo;
354 * Returns description of method result value
356 * @return external_description
359 public static function get_courses_returns() {
360 return new external_multiple_structure(
361 new external_single_structure(
363 'id' => new external_value(PARAM_INT
, 'course id'),
364 'shortname' => new external_value(PARAM_TEXT
, 'course short name'),
365 'categoryid' => new external_value(PARAM_INT
, 'category id'),
366 'categorysortorder' => new external_value(PARAM_INT
,
367 'sort order into the category', VALUE_OPTIONAL
),
368 'fullname' => new external_value(PARAM_TEXT
, 'full name'),
369 'idnumber' => new external_value(PARAM_RAW
, 'id number', VALUE_OPTIONAL
),
370 'summary' => new external_value(PARAM_RAW
, 'summary'),
371 'summaryformat' => new external_value(PARAM_INT
,
372 'the summary text Moodle format'),
373 'format' => new external_value(PARAM_PLUGIN
,
374 'course format: weeks, topics, social, site,..'),
375 'showgrades' => new external_value(PARAM_INT
,
376 '1 if grades are shown, otherwise 0', VALUE_OPTIONAL
),
377 'newsitems' => new external_value(PARAM_INT
,
378 'number of recent items appearing on the course page', VALUE_OPTIONAL
),
379 'startdate' => new external_value(PARAM_INT
,
380 'timestamp when the course start'),
381 'numsections' => new external_value(PARAM_INT
, 'number of weeks/topics'),
382 'maxbytes' => new external_value(PARAM_INT
,
383 'largest size of file that can be uploaded into the course',
385 'showreports' => new external_value(PARAM_INT
,
386 'are activity report shown (yes = 1, no =0)', VALUE_OPTIONAL
),
387 'visible' => new external_value(PARAM_INT
,
388 '1: available to student, 0:not available', VALUE_OPTIONAL
),
389 'hiddensections' => new external_value(PARAM_INT
,
390 'How the hidden sections in the course are displayed to students',
392 'groupmode' => new external_value(PARAM_INT
, 'no group, separate, visible',
394 'groupmodeforce' => new external_value(PARAM_INT
, '1: yes, 0: no',
396 'defaultgroupingid' => new external_value(PARAM_INT
, 'default grouping id',
398 'timecreated' => new external_value(PARAM_INT
,
399 'timestamp when the course have been created', VALUE_OPTIONAL
),
400 'timemodified' => new external_value(PARAM_INT
,
401 'timestamp when the course have been modified', VALUE_OPTIONAL
),
402 'enablecompletion' => new external_value(PARAM_INT
,
403 'Enabled, control via completion and activity settings. Disbaled,
404 not shown in activity settings.',
406 'completionstartonenrol' => new external_value(PARAM_INT
,
407 '1: begin tracking a student\'s progress in course completion
408 after course enrolment. 0: does not',
410 'completionnotify' => new external_value(PARAM_INT
,
411 '1: yes 0: no', VALUE_OPTIONAL
),
412 'lang' => new external_value(PARAM_SAFEDIR
,
413 'forced course language', VALUE_OPTIONAL
),
414 'forcetheme' => new external_value(PARAM_PLUGIN
,
415 'name of the force theme', VALUE_OPTIONAL
),
422 * Returns description of method parameters
424 * @return external_function_parameters
427 public static function create_courses_parameters() {
428 $courseconfig = get_config('moodlecourse'); //needed for many default values
429 return new external_function_parameters(
431 'courses' => new external_multiple_structure(
432 new external_single_structure(
434 'fullname' => new external_value(PARAM_TEXT
, 'full name'),
435 'shortname' => new external_value(PARAM_TEXT
, 'course short name'),
436 'categoryid' => new external_value(PARAM_INT
, 'category id'),
437 'idnumber' => new external_value(PARAM_RAW
, 'id number', VALUE_OPTIONAL
),
438 'summary' => new external_value(PARAM_RAW
, 'summary', VALUE_OPTIONAL
),
439 'summaryformat' => new external_value(PARAM_INT
,
440 'the summary text Moodle format', VALUE_DEFAULT
, FORMAT_MOODLE
),
441 'format' => new external_value(PARAM_PLUGIN
,
442 'course format: weeks, topics, social, site,..',
443 VALUE_DEFAULT
, $courseconfig->format
),
444 'showgrades' => new external_value(PARAM_INT
,
445 '1 if grades are shown, otherwise 0', VALUE_DEFAULT
,
446 $courseconfig->showgrades
),
447 'newsitems' => new external_value(PARAM_INT
,
448 'number of recent items appearing on the course page',
449 VALUE_DEFAULT
, $courseconfig->newsitems
),
450 'startdate' => new external_value(PARAM_INT
,
451 'timestamp when the course start', VALUE_OPTIONAL
),
452 'numsections' => new external_value(PARAM_INT
, 'number of weeks/topics',
453 VALUE_DEFAULT
, $courseconfig->numsections
),
454 'maxbytes' => new external_value(PARAM_INT
,
455 'largest size of file that can be uploaded into the course',
456 VALUE_DEFAULT
, $courseconfig->maxbytes
),
457 'showreports' => new external_value(PARAM_INT
,
458 'are activity report shown (yes = 1, no =0)', VALUE_DEFAULT
,
459 $courseconfig->showreports
),
460 'visible' => new external_value(PARAM_INT
,
461 '1: available to student, 0:not available', VALUE_OPTIONAL
),
462 'hiddensections' => new external_value(PARAM_INT
,
463 'How the hidden sections in the course are displayed to students',
464 VALUE_DEFAULT
, $courseconfig->hiddensections
),
465 'groupmode' => new external_value(PARAM_INT
, 'no group, separate, visible',
466 VALUE_DEFAULT
, $courseconfig->groupmode
),
467 'groupmodeforce' => new external_value(PARAM_INT
, '1: yes, 0: no',
468 VALUE_DEFAULT
, $courseconfig->groupmodeforce
),
469 'defaultgroupingid' => new external_value(PARAM_INT
, 'default grouping id',
471 'enablecompletion' => new external_value(PARAM_INT
,
472 'Enabled, control via completion and activity settings. Disabled,
473 not shown in activity settings.',
475 'completionstartonenrol' => new external_value(PARAM_INT
,
476 '1: begin tracking a student\'s progress in course completion after
477 course enrolment. 0: does not',
479 'completionnotify' => new external_value(PARAM_INT
,
480 '1: yes 0: no', VALUE_OPTIONAL
),
481 'lang' => new external_value(PARAM_SAFEDIR
,
482 'forced course language', VALUE_OPTIONAL
),
483 'forcetheme' => new external_value(PARAM_PLUGIN
,
484 'name of the force theme', VALUE_OPTIONAL
),
486 ), 'courses to create'
495 * @param array $courses
496 * @return array courses (id and shortname only)
499 public static function create_courses($courses) {
501 require_once($CFG->dirroot
. "/course/lib.php");
502 require_once($CFG->libdir
. '/completionlib.php');
505 $params = self
::validate_parameters(self
::create_courses_parameters(),
506 array('courses' => $courses));
508 $availablethemes = get_plugin_list('theme');
509 $availablelangs = get_string_manager()->get_list_of_translations();
511 $transaction = $DB->start_delegated_transaction();
513 foreach ($params['courses'] as $course) {
515 // Ensure the current user is allowed to run this function
516 $context = get_context_instance(CONTEXT_COURSECAT
, $course['categoryid']);
518 self
::validate_context($context);
519 } catch (Exception
$e) {
520 $exceptionparam = new stdClass();
521 $exceptionparam->message
= $e->getMessage();
522 $exceptionparam->catid
= $course['categoryid'];
523 throw new moodle_exception(
524 get_string('errorcatcontextnotvalid', 'webservice', $exceptionparam));
526 require_capability('moodle/course:create', $context);
528 // Make sure lang is valid
529 if (key_exists('lang', $course) and empty($availablelangs[$course['lang']])) {
530 throw new moodle_exception(
531 get_string('errorinvalidparam', 'webservice', 'lang'));
534 // Make sure theme is valid
535 if (key_exists('forcetheme', $course)) {
536 if (!empty($CFG->allowcoursethemes
)) {
537 if (empty($availablethemes[$course['forcetheme']])) {
538 throw new moodle_exception(
539 get_string('errorinvalidparam', 'webservice', 'forcetheme'));
541 $course['theme'] = $course['forcetheme'];
546 //force visibility if ws user doesn't have the permission to set it
547 $category = $DB->get_record('course_categories', array('id' => $course['categoryid']));
548 if (!has_capability('moodle/course:visibility', $context)) {
549 $course['visible'] = $category->visible
;
552 //set default value for completion
553 $courseconfig = get_config('moodlecourse');
554 if (completion_info
::is_enabled_for_site()) {
555 if (!key_exists('enablecompletion', $course)) {
556 $course['enablecompletion'] = $courseconfig->enablecompletion
;
558 if (!key_exists('completionstartonenrol', $course)) {
559 $course['completionstartonenrol'] = $courseconfig->completionstartonenrol
;
562 $course['enablecompletion'] = 0;
563 $course['completionstartonenrol'] = 0;
566 $course['category'] = $course['categoryid'];
568 //Note: create_course() core function check shortname, idnumber, category
569 $course['id'] = create_course((object) $course)->id
;
571 $resultcourses[] = array('id' => $course['id'], 'shortname' => $course['shortname']);
574 $transaction->allow_commit();
576 return $resultcourses;
580 * Returns description of method result value
582 * @return external_description
585 public static function create_courses_returns() {
586 return new external_multiple_structure(
587 new external_single_structure(
589 'id' => new external_value(PARAM_INT
, 'course id'),
590 'shortname' => new external_value(PARAM_TEXT
, 'short name'),
597 * Returns description of method parameters
598 * @return external_function_parameters
600 public static function delete_courses_parameters() {
601 return new external_function_parameters(
603 'courseids' => new external_multiple_structure(new external_value(PARAM_INT
, 'course ID')),
610 * @param array $courseids A list of course ids
612 public static function delete_courses($courseids) {
614 require_once($CFG->dirroot
."/course/lib.php");
616 // Parameter validation.
617 $params = self
::validate_parameters(self
::delete_courses_parameters(), array('courseids'=>$courseids));
619 $transaction = $DB->start_delegated_transaction();
621 foreach ($params['courseids'] as $courseid) {
622 $course = $DB->get_record('course', array('id'=>$courseid), '*', MUST_EXIST
);
624 // Check if the context is valid.
625 $coursecontext = context_course
::instance($course->id
);
626 self
::validate_context($coursecontext);
628 // Check if the current user has enought permissions.
629 if (!can_delete_course($courseid)) {
630 throw new moodle_exception('cannotdeletecategorycourse', 'error', '', format_string($course->fullname
)." (id: $courseid)");
633 delete_course($course, false);
636 $transaction->allow_commit();
642 * Returns description of method result value
643 * @return external_description
645 public static function delete_courses_returns() {
652 * Deprecated course external functions
654 * @package core_course
655 * @copyright 2009 Petr Skodak
656 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
658 * @deprecated Moodle 2.2 MDL-29106 - Please do not use this class any more.
659 * @todo MDL-31194 This will be deleted in Moodle 2.5.
660 * @see core_course_external
662 class moodle_course_external
extends external_api
{
665 * Returns description of method parameters
667 * @return external_function_parameters
669 * @deprecated Moodle 2.2 MDL-29106 - Please do not call this function any more.
670 * @todo MDL-31194 This will be deleted in Moodle 2.5.
671 * @see core_course_external::get_courses_parameters()
673 public static function get_courses_parameters() {
674 return core_course_external
::get_courses_parameters();
680 * @param array $options
683 * @deprecated Moodle 2.2 MDL-29106 - Please do not call this function any more.
684 * @todo MDL-31194 This will be deleted in Moodle 2.5.
685 * @see core_course_external::get_courses()
687 public static function get_courses($options) {
688 return core_course_external
::get_courses($options);
692 * Returns description of method result value
694 * @return external_description
696 * @deprecated Moodle 2.2 MDL-29106 - Please do not call this function any more.
697 * @todo MDL-31194 This will be deleted in Moodle 2.5.
698 * @see core_course_external::get_courses_returns()
700 public static function get_courses_returns() {
701 return core_course_external
::get_courses_returns();
705 * Returns description of method parameters
707 * @return external_function_parameters
709 * @deprecated Moodle 2.2 MDL-29106 - Please do not call this function any more.
710 * @todo MDL-31194 This will be deleted in Moodle 2.5.
711 * @see core_course_external::create_courses_parameters()
713 public static function create_courses_parameters() {
714 return core_course_external
::create_courses_parameters();
720 * @param array $courses
721 * @return array courses (id and shortname only)
723 * @deprecated Moodle 2.2 MDL-29106 - Please do not call this function any more.
724 * @todo MDL-31194 This will be deleted in Moodle 2.5.
725 * @see core_course_external::create_courses()
727 public static function create_courses($courses) {
728 return core_course_external
::create_courses($courses);
732 * Returns description of method result value
734 * @return external_description
736 * @deprecated Moodle 2.2 MDL-29106 - Please do not call this function any more.
737 * @todo MDL-31194 This will be deleted in Moodle 2.5.
738 * @see core_course_external::create_courses_returns()
740 public static function create_courses_returns() {
741 return core_course_external
::create_courses_returns();