webservice/wsdoc.php

   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_once($CFG->dirroot . '/webservice/lib.php');
  28
  29 require_login();
  30
  31 $usercontext = context_user::instance($USER->id);
  32 $tokenid = required_param('id', PARAM_INT);
  33
  34 // PAGE settings
  35 $PAGE->set_context($usercontext);
  36 $PAGE->set_url('/user/wsdoc.php');
  37 $PAGE->set_title(get_string('wsdocumentation', 'webservice'));
  38 $PAGE->set_heading(get_string('wsdocumentation', 'webservice'));
  39 $PAGE->set_pagelayout('standard');
  40
  41 // nav bar
  42 $PAGE->navbar->ignore_active(true);
  43 $PAGE->navbar->add(get_string('preferences'), new moodle_url('/user/preferences.php'));
  44 $PAGE->navbar->add(get_string('useraccount'));
  45 $PAGE->navbar->add(get_string('securitykeys', 'webservice'), new moodle_url('/user/managetoken.php'));
  46 $PAGE->navbar->add(get_string('wsdocumentation', 'webservice'));
  47
  48 // check web service are enabled
  49 if (empty($CFG->enablewsdocumentation)) {
  50     echo get_string('wsdocumentationdisable', 'webservice');
  51     die;
  52 }
  53
  54 // check that the current user is the token user
  55 $webservice = new webservice();
  56 $token = $webservice->get_token_by_id($tokenid);
  57 if (empty($token) or empty($token->userid) or empty($USER->id)
  58         or ($token->userid != $USER->id)) {
  59     throw new moodle_exception('docaccessrefused', 'webservice');
  60 }
  61
  62 // get the list of all functions related to the token
  63 $functions = $webservice->get_external_functions(array($token->externalserviceid));
  64
  65 // get all the function descriptions
  66 $functiondescs = array();
  67 foreach ($functions as $function) {
  68     $functiondescs[$function->name] = external_api::external_function_info($function);
  69 }
  70
  71 // TODO: MDL-76078 - Incorrect inter-communication, core cannot have plugin dependencies like this.
  72
  73 // get activated protocol
  74 $activatedprotocol = array();
  75 $activatedprotocol['rest'] = webservice_protocol_is_enabled('rest');
  76 $activatedprotocol['xmlrpc'] = webservice_protocol_is_enabled('xmlrpc');
  77
  78 // Check if we are in printable mode
  79 $printableformat = optional_param('print', false, PARAM_BOOL);
  80
  81 // OUTPUT
  82 echo $OUTPUT->header();
  83
  84 $renderer = $PAGE->get_renderer('core', 'webservice');
  85 echo $renderer->documentation_html($functiondescs,
  86         $printableformat, $activatedprotocol, array('id' => $tokenid));
  87
  88 // trigger browser print operation
  89 if (!empty($printableformat)) {
  90     $PAGE->requires->js_function_call('window.print', array());
  91 }
  92
  93 echo $OUTPUT->footer();