mirror of
https://github.com/moodle/moodle.git
synced 2025-01-19 14:27:22 +01:00
105 lines
3.5 KiB
PHP
105 lines
3.5 KiB
PHP
<?php
|
|
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// Moodle is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
/**
|
|
* Displays help via AJAX call or in a new page
|
|
*
|
|
* Use {@link core_renderer::help_icon()} or {@link addHelpButton()} to display
|
|
* the help icon.
|
|
*
|
|
* @copyright 2002 onwards Martin Dougiamas
|
|
* @package core
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
define('NO_MOODLE_COOKIES', true);
|
|
|
|
require_once(dirname(__FILE__) . '/config.php');
|
|
|
|
$identifier = required_param('identifier', PARAM_STRINGID);
|
|
$component = required_param('component', PARAM_COMPONENT);
|
|
$lang = required_param('lang', PARAM_LANG); // TODO: maybe split into separate scripts
|
|
$ajax = optional_param('ajax', 0, PARAM_BOOL);
|
|
|
|
if (!$lang) {
|
|
$lang = 'en';
|
|
}
|
|
$SESSION->lang = $lang; // does not actually modify session because we do not use cookies here
|
|
|
|
$sm = get_string_manager();
|
|
|
|
$PAGE->set_url('/help.php');
|
|
$PAGE->set_pagelayout('popup');
|
|
$PAGE->set_context(context_system::instance());
|
|
|
|
if ($ajax) {
|
|
@header('Content-Type: text/plain; charset=utf-8');
|
|
}
|
|
|
|
if (!$sm->string_exists($identifier.'_help', $component)) {
|
|
// strings on disk-cache may be dirty - try to rebuild it and check again
|
|
$sm->load_component_strings($component, current_language(), true);
|
|
}
|
|
|
|
$data = new stdClass();
|
|
|
|
if ($sm->string_exists($identifier.'_help', $component)) {
|
|
$options = new stdClass();
|
|
$options->trusted = false;
|
|
$options->noclean = false;
|
|
$options->smiley = false;
|
|
$options->filter = false;
|
|
$options->para = true;
|
|
$options->newlines = false;
|
|
$options->overflowdiv = !$ajax;
|
|
|
|
$data->heading = format_string(get_string($identifier, $component));
|
|
// Should be simple wiki only MDL-21695
|
|
$data->text = format_text(get_string($identifier.'_help', $component), FORMAT_MARKDOWN, $options);
|
|
|
|
$helplink = $identifier . '_link';
|
|
if ($sm->string_exists($helplink, $component)) { // Link to further info in Moodle docs
|
|
$link = get_string($helplink, $component);
|
|
$linktext = get_string('morehelp');
|
|
|
|
$data->doclink = new stdClass();
|
|
$url = new moodle_url(get_docs_url($link));
|
|
$data->doclink->link = $url->out();
|
|
$data->doclink->linktext = $linktext;
|
|
$data->doclink->class = ($CFG->doctonewwindow) ? 'helplinkpopup' : '';
|
|
|
|
$completedoclink = html_writer::tag('div', $OUTPUT->doc_link($link, $linktext), array('class' => 'helpdoclink'));
|
|
}
|
|
} else {
|
|
$data->text = html_writer::tag('p',
|
|
html_writer::tag('strong', 'TODO') . ": missing help string [{$identifier}_help, {$component}]");
|
|
}
|
|
|
|
if ($ajax) {
|
|
echo json_encode($data);
|
|
} else {
|
|
echo $OUTPUT->header();
|
|
if (isset($data->heading)) {
|
|
echo $OUTPUT->heading($data->heading, 1, 'helpheading');
|
|
}
|
|
echo $data->text;
|
|
if (isset($completedoclink)) {
|
|
echo $completedoclink;
|
|
}
|
|
echo $OUTPUT->footer();
|
|
}
|