core MDL-19799 Updated print_header and build_navigation to OUTPUT and PAGE equivalents
[moodle.git] / help.php
1 <?php
2 /**
3  * help.php - Displays help page.
4  *
5  * Prints a very simple page and includes
6  * page content or a string from elsewhere.
7  * Usually this will appear in a popup
8  * See {@link helpbutton()} in {@link lib/moodlelib.php}
9  *
10  * @author Martin Dougiamas
11  * @version $Id$
12  * @package moodlecore
13  */
14 require_once('config.php');
16 // Get URL parameters.
17 $file = optional_param('file', '', PARAM_PATH);
18 $text = optional_param('text', 'No text to display', PARAM_CLEAN);
19 $module = optional_param('module', 'moodle', PARAM_ALPHAEXT);
20 $forcelang = optional_param('forcelang', '', PARAM_SAFEDIR);
21 $skiplocal = optional_param('skiplocal', 0, PARAM_INT);     // shall _local help files be skipped?
22 $fortooltip = optional_param('fortooltip', 0, PARAM_INT);
24 $PAGE->set_course($COURSE);
26 // We look for the help to display in lots of different places, and
27 // only display an error at the end if we can't find the help file
28 // anywhere. This variable tracks that.
29 $helpfound = false;
31 // Buffer output so that we can examine it later to extract metadata (page title)
32 ob_start();
34 if (!empty($file)) {
35     // The help to display is from a help file.
36     list($filepath, $foundlang) = string_manager::instance()->find_help_file($file, $module, $forcelang, $skiplocal);
38     if ($filepath) {
39         $helpfound = true;
40         @include($filepath);   // The actual helpfile
42         // Now, we process some special cases.
43         if ($module == 'moodle' and ($file == 'index.html' or $file == 'mods.html')) {
44             include_help_for_each_module($file, $forcelang, $skiplocal);
45         }
46         if ($module == 'question' && $file == 'types.html') {
47             include_help_for_each_qtype();
48         }
50         // The remaining horrible hardcoded special cases should be delegated to modules somehow.
51         if ($module == 'moodle' && $file == 'assignment/types.html') {  // ASSIGNMENTS
52             include_help_for_each_assignment_type($forcelang, $skiplocal);
53         }
54     }
55 } else {
56     // The help to display was given as an argument to this function.
57     echo '<p>'.s($text).'</p>';   // This param was already cleaned
58     $helpfound = true;
59 }
61 // Finish buffer
62 $output = ob_get_contents();
64 ob_end_clean();
66 if ($fortooltip) {
67     echo shorten_text($output, 400, false, '<span class="readmore">' . get_string('clickhelpiconformoreinfo') . '</span>');
68     die();
69 }
71 // Determine title
72 $title = get_string('help'); // Default is just 'Help'
73 $matches = array();
74 // You can include a <title> tag to override the standard behaviour:
75 // 'Help - title contents'. Otherwise it looks for the text of the first
76 // heading: 'Help - heading text'. If there aren't even any headings
77 // you just get 'Help'
78 if (preg_match('~^(.*?)<title>(.*?)</title>(.*)$~s', $output, $matches)) {
79     // Extract title
80     $title = $title.' - '.$matches[2];
81     // Strip title from output
82     $output = $matches[1].$matches[3];
83 } else if(preg_match('~<h[0-9]+(\s[^>]*)?>(.*?)</h[0-9]+>~s',$output,$matches)) {
84     // Use first heading as title (obviously leave it in output too). Strip
85     // any tags from inside
86     $matches[2] = preg_replace('~<[^>]*>~s','',$matches[2]);
87     $title = $title.' - '.$matches[2];
88 }
90 // use ##emoticons_html## to replace the emoticons documentation
91 if(preg_match('~(##emoticons_html##)~', $output, $matches)) {
92     $output = preg_replace('~(##emoticons_html##)~', get_emoticons_list_for_help_file(), $output);
93 }
95 // Do the main output.
96 $PAGE->set_title($title);
97 echo $OUTPUT->header();
98 echo $OUTPUT->box_start();
99 print $output;
100 echo $OUTPUT->box_end();
102 // Display an error if necessary.
103 if (!$helpfound) {
104     echo $OUTPUT->notification('Help file "'. $file .'" could not be found!');
107 // End of page.
108 echo $OUTPUT->close_window_button();
109 echo '<p class="helpindex"><a href="help.php?file=index.html">'. get_string('helpindex') .'</a></p>';
111 // Offer a link to the alternative help file language
112 $currentlang = current_language();
113 if ($file && $helpfound && ($foundlang != 'en_utf8' || ($forcelang == 'en_utf8' && current_language() != 'en_utf8'))) {
114     $url = new moodle_url();
115     if ($foundlang != 'en_utf8') {
116         $url->param('forcelang', 'en_utf8');
117         $nextlangname = get_string('english');
118     } else {
119         $url->param('forcelang', $currentlang);
120         $nextlangname = get_string('thislanguage');
121     }
122     echo '<p><a href="' . $url->out() . '">' . get_string('showthishelpinlanguage', 'moodle', $nextlangname) . '</a></p>';
125 $CFG->docroot = '';   // We don't want a doc link here
126 echo $OUTPUT->footer();
128 function file_exists_and_readable($filepath) {
129     return file_exists($filepath) and is_file($filepath) and is_readable($filepath);
132 // Some functions for handling special cases ========================================
134 function include_help_for_each_module($file, $forcelang, $skiplocal) {
135     global $CFG, $DB;
137     if (!$modules = $DB->get_records('modules', array('visible'=> 1))) {
138         print_error('nomodules', 'debug'); // Should never happen
139     }
141     // Horrible hack to show the help about grades here too.
142     $grade = new stdClass();
143     $grade->name = 'grade';
144     $modules[] = $grade;
146     foreach ($modules as $mod) {
147         $strmodulename = get_string('modulename', $mod->name);
148         $modulebyname[$strmodulename] = $mod;
149     }
150     ksort($modulebyname, SORT_LOCALE_STRING);
152     foreach ($modulebyname as $mod) {
153         list($filepath, $foundlang) = string_manager::instance()->find_help_file($file, $mod->name, $forcelang, $skiplocal);
154         if ($filepath) {
155             echo '<hr />';
156             include($filepath);
157         }
158     }
161 function include_help_for_each_qtype() {
162     global $CFG;
163     require_once($CFG->libdir . '/questionlib.php');
164     global $QTYPES;
165     $types = question_type_menu();
166     $fakeqtypes = array();
167     foreach ($types as $qtype => $localizedname) {
168         if ($QTYPES[$qtype]->is_real_question_type()) {
169             include_help_for_qtype($qtype, $localizedname);
170         } else {
171             $fakeqtypes[$qtype] = $localizedname;
172         }
173     }
174     foreach ($fakeqtypes as $qtype => $localizedname) {
175         include_help_for_qtype($qtype, $localizedname);
176     }
178 function include_help_for_qtype($qtype, $localizedname) {
179     echo '<h2>' . $localizedname . "</h2>\n\n";
180     echo '<p>' . get_string($qtype . 'summary', 'qtype_' . $qtype) . "</p>\n\n";
183 function include_help_for_each_assignment_type() {
184     global $CFG;
186     require_once($CFG->dirroot .'/mod/assignment/lib.php');
187     $typelist = assignment_types();
189     foreach ($typelist as $type => $name) {
190         echo '<h2>'.$name.'</h2>';
191         echo get_string('help'.$type, 'assignment');
192         echo '<hr />';
193     }
195 ?>