MDL-31936 workshop: version bump and @since phpdocs

mod/workshop/lib.php

@@ -1718,6 +1718,8 @@ function workshop_calendar_update(stdClass $workshop, $cmid) {
 /**
  * Extends the course reset form with workshop specific settings.
  *
+ * @since Moodle 2.6.6, 2.7.3
+ *
  * @param MoodleQuickForm $mform
  */
 function workshop_reset_course_form_definition($mform) {
@@ -1738,6 +1740,8 @@ function workshop_reset_course_form_definition($mform) {
 /**
  * Provides default values for the workshop settings in the course reset form.
  *
+ * @since Moodle 2.6.6, 2.7.3
+ *
  * @param stdClass $course The course to be reset.
  */
 function workshop_reset_course_form_defaults(stdClass $course) {
@@ -1754,6 +1758,8 @@ function workshop_reset_course_form_defaults(stdClass $course) {
 /**
  * Performs the reset of all workshop instances in the course.
  *
+ * @since Moodle 2.6.6, 2.7.3
+ *
  * @param stdClass $data The actual course reset settings.
  * @return array List of results, each being array[(string)component, (string)item, (string)error]
  */

mod/workshop/locallib.php

@@ -2381,6 +2381,8 @@ class workshop {
     /**
      * Performs the reset of this workshop instance.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param stdClass $data The actual course reset settings.
      * @return array List of results, each being array[(string)component, (string)item, (string)error]
      */
@@ -2705,6 +2707,8 @@ class workshop {
      * This includes assessments of example submissions as long as they are not
      * referential assessments.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param stdClass $data The actual course reset settings.
      * @return bool|string True on success, error message otherwise.
      */
@@ -2728,6 +2732,8 @@ class workshop {
     /**
      * Removes all user data related to participants' submissions.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param stdClass $data The actual course reset settings.
      * @return bool|string True on success, error message otherwise.
      */
@@ -2744,6 +2750,8 @@ class workshop {
 
     /**
      * Hard set the workshop phase to the setup one.
+     *
+     * @since Moodle 2.6.6, 2.7.3
      */
     protected function reset_phase() {
         global $DB;

mod/workshop/tests/generator/lib.php

@@ -101,6 +101,8 @@ class mod_workshop_generator extends testing_module_generator {
     /**
      * Generates a submission authored by the given user.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param int $workshopid Workshop instance id.
      * @param int $authorid Author user id.
      * @param stdClass|array $options Optional explicit properties.
@@ -132,6 +134,8 @@ class mod_workshop_generator extends testing_module_generator {
     /**
      * Generates an allocation of the given submission for peer-assessment by the given user
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param int $submissionid Submission id.
      * @param int $reviewerid Reviewer's user id.
      * @param stdClass|array $options Optional explicit properties.

mod/workshop/version.php

@@ -24,7 +24,7 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$plugin->version   = 2014051200;        // the current module version (YYYYMMDDXX)
+$plugin->version   = 2014051201;        // the current module version (YYYYMMDDXX)
 $plugin->requires  = 2014050800;        // requires this Moodle version
 $plugin->component = 'mod_workshop';    // full name of the plugin (used for diagnostics)
 $plugin->cron      = 60;                // give as a chance every minute