Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.

Differences Between: [Versions 39 and 311] [Versions 39 and 400] [Versions 39 and 401] [Versions 39 and 402] [Versions 39 and 403]

   1  <?php
   2  // This file is part of Moodle - http://moodle.org/
   3  //
   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.
   8  //
   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.
  13  //
  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/>.
  16  
  17  
  18  /**
  19   * Web services auto-generated documentation
  20   *
  21   * @package    core_webservice
  22   * @copyright  2009 Jerome Mouneyrac <jerome@moodle.com>
  23   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  24   */
  25  
  26  require_once('../config.php');
  27  require($CFG->dirroot . '/webservice/lib.php');
  28  
  29  require_login();
  30  require_sesskey();
  31  
  32  $usercontext = context_user::instance($USER->id);
  33  $tokenid = required_param('id', PARAM_INT);
  34  
  35  // PAGE settings
  36  $PAGE->set_context($usercontext);
  37  $PAGE->set_url('/user/wsdoc.php');
  38  $PAGE->set_title(get_string('wsdocumentation', 'webservice'));
  39  $PAGE->set_heading(get_string('wsdocumentation', 'webservice'));
  40  $PAGE->set_pagelayout('standard');
  41  
  42  // nav bar
  43  $PAGE->navbar->ignore_active(true);
  44  $PAGE->navbar->add(get_string('preferences'), new moodle_url('/user/preferences.php'));
  45  $PAGE->navbar->add(get_string('useraccount'));
  46  $PAGE->navbar->add(get_string('securitykeys', 'webservice'),
  47          new moodle_url('/user/managetoken.php', 
  48                  array('id' => $tokenid, 'sesskey' => sesskey())));
  49  $PAGE->navbar->add(get_string('wsdocumentation', 'webservice'));
  50  
  51  // check web service are enabled
  52  if (empty($CFG->enablewsdocumentation)) {
  53      echo get_string('wsdocumentationdisable', 'webservice');
  54      die;
  55  }
  56  
  57  // check that the current user is the token user
  58  $webservice = new webservice();
  59  $token = $webservice->get_token_by_id($tokenid);
  60  if (empty($token) or empty($token->userid) or empty($USER->id)
  61          or ($token->userid != $USER->id)) {
  62      throw new moodle_exception('docaccessrefused', 'webservice');
  63  }
  64  
  65  // get the list of all functions related to the token
  66  $functions = $webservice->get_external_functions(array($token->externalserviceid));
  67  
  68  // get all the function descriptions
  69  $functiondescs = array();
  70  foreach ($functions as $function) {
  71      $functiondescs[$function->name] = external_api::external_function_info($function);
  72  }
  73  
  74  // get activated protocol
  75  $activatedprotocol = array();
  76  $activatedprotocol['rest'] = webservice_protocol_is_enabled('rest');
  77  $activatedprotocol['xmlrpc'] = webservice_protocol_is_enabled('xmlrpc');
  78  
  79  // Check if we are in printable mode
  80  $printableformat = optional_param('print', false, PARAM_BOOL);
  81  
  82  // OUTPUT
  83  echo $OUTPUT->header();
  84  
  85  $renderer = $PAGE->get_renderer('core', 'webservice');
  86  echo $renderer->documentation_html($functiondescs,
  87          $printableformat, $activatedprotocol, array('id' => $tokenid));
  88  
  89  // trigger browser print operation
  90  if (!empty($printableformat)) {
  91      $PAGE->requires->js_function_call('window.print', array());
  92  }
  93  
  94  echo $OUTPUT->footer();