original_string: private static function definition() {
          global $CFG;
          $definition = array();
          $definition['id']                = new external_value(PARAM_INT, 'definition id', VALUE_OPTIONAL);
          $definition['method']            = new external_value(PARAM_TEXT, 'method');
          $definition['name']              = new external_value(PARAM_TEXT, 'name');
          $definition['description']       = new external_value(PARAM_RAW, 'description', VALUE_OPTIONAL);
          $definition['descriptionformat'] = new external_format_value('description', VALUE_OPTIONAL);
          $definition['status']            = new external_value(PARAM_INT, 'status');
          $definition['copiedfromid']      = new external_value(PARAM_INT, 'copied from id', VALUE_OPTIONAL);
          $definition['timecreated']       = new external_value(PARAM_INT, 'creation time');
          $definition['usercreated']       = new external_value(PARAM_INT, 'user who created definition');
          $definition['timemodified']      = new external_value(PARAM_INT, 'last modified time');
          $definition['usermodified']      = new external_value(PARAM_INT, 'user who modified definition');
          $definition['timecopied']        = new external_value(PARAM_INT, 'time copied', VALUE_OPTIONAL);
          foreach (self::get_grading_methods() as $method) {
              require_once($CFG->dirroot.'/grade/grading/form/'.$method.'/lib.php');
              $details  = call_user_func('gradingform_'.$method.'_controller::get_external_definition_details');
              if ($details != null) {
                  $items = array();
                  foreach ($details as $key => $value) {
                      $details[$key]->required = VALUE_OPTIONAL;
                      $items[$key] = $value;
                  }
                  $definition[$method] = new external_single_structure($items, 'items', VALUE_OPTIONAL);
              }
          }
          return new external_single_structure($definition);
      }
code: private static function definition() {
          global $CFG;
          $definition = array();
          $definition['id']                = new external_value(PARAM_INT, 'definition id', VALUE_OPTIONAL);
          $definition['method']            = new external_value(PARAM_TEXT, 'method');
          $definition['name']              = new external_value(PARAM_TEXT, 'name');
          $definition['description']       = new external_value(PARAM_RAW, 'description', VALUE_OPTIONAL);
          $definition['descriptionformat'] = new external_format_value('description', VALUE_OPTIONAL);
          $definition['status']            = new external_value(PARAM_INT, 'status');
          $definition['copiedfromid']      = new external_value(PARAM_INT, 'copied from id', VALUE_OPTIONAL);
          $definition['timecreated']       = new external_value(PARAM_INT, 'creation time');
          $definition['usercreated']       = new external_value(PARAM_INT, 'user who created definition');
          $definition['timemodified']      = new external_value(PARAM_INT, 'last modified time');
          $definition['usermodified']      = new external_value(PARAM_INT, 'user who modified definition');
          $definition['timecopied']        = new external_value(PARAM_INT, 'time copied', VALUE_OPTIONAL);
          foreach (self::get_grading_methods() as $method) {
              require_once($CFG->dirroot.'/grade/grading/form/'.$method.'/lib.php');
              $details  = call_user_func('gradingform_'.$method.'_controller::get_external_definition_details');
              if ($details != null) {
                  $items = array();
                  foreach ($details as $key => $value) {
                      $details[$key]->required = VALUE_OPTIONAL;
                      $items[$key] = $value;
                  }
                  $definition[$method] = new external_single_structure($items, 'items', VALUE_OPTIONAL);
              }
          }
          return new external_single_structure($definition);
      }
code_tokens: private static function definition ( ) { global $ CFG ; $ definition = array ( ) ; $ definition [ 'id' ] = new external_value ( PARAM_INT , 'definition id' , VALUE_OPTIONAL ) ; $ definition [ 'method' ] = new external_value ( PARAM_TEXT , 'method' ) ; $ definition [ 'name' ] = new external_value ( PARAM_TEXT , 'name' ) ; $ definition [ 'description' ] = new external_value ( PARAM_RAW , 'description' , VALUE_OPTIONAL ) ; $ definition [ 'descriptionformat' ] = new external_format_value ( 'description' , VALUE_OPTIONAL ) ; $ definition [ 'status' ] = new external_value ( PARAM_INT , 'status' ) ; $ definition [ 'copiedfromid' ] = new external_value ( PARAM_INT , 'copied from id' , VALUE_OPTIONAL ) ; $ definition [ 'timecreated' ] = new external_value ( PARAM_INT , 'creation time' ) ; $ definition [ 'usercreated' ] = new external_value ( PARAM_INT , 'user who created definition' ) ; $ definition [ 'timemodified' ] = new external_value ( PARAM_INT , 'last modified time' ) ; $ definition [ 'usermodified' ] = new external_value ( PARAM_INT , 'user who modified definition' ) ; $ definition [ 'timecopied' ] = new external_value ( PARAM_INT , 'time copied' , VALUE_OPTIONAL ) ; foreach ( self :: get_grading_methods ( ) as $ method ) { require_once ( $ CFG -> dirroot . '/grade/grading/form/' . $ method . '/lib.php' ) ; $ details = call_user_func ( 'gradingform_' . $ method . '_controller::get_external_definition_details' ) ; if ( $ details != null ) { $ items = array ( ) ; foreach ( $ details as $ key => $ value ) { $ details [ $ key ] -> required = VALUE_OPTIONAL ; $ items [ $ key ] = $ value ; } $ definition [ $ method ] = new external_single_structure ( $ items , 'items' , VALUE_OPTIONAL ) ; } } return new external_single_structure ( $ definition ) ; }
docstring: creates a grading form definition
  @return external_single_structure
  @since  Moodle 2.5
docstring_tokens: creates a grading form definition