dataroot.'/lang/'] = $file; $locations[$CFG->dirroot.'/lang/'] = $file; } else { $modfile = $module.'/'.$file; $locations[$CFG->dataroot.'/lang/'] = $modfile; $locations[$CFG->dirroot.'/lang/'] = $modfile; $rules = places_to_search_for_lang_strings(); $exceptions = $rules['__exceptions']; unset($rules['__exceptions']); if (!in_array($module, $exceptions)) { $dividerpos = strpos($module, '_'); if ($dividerpos === false) { $type = ''; $plugin = $module; } else { $type = substr($module, 0, $dividerpos + 1); $plugin = substr($module, $dividerpos + 1); } if (!empty($rules[$type])) { foreach ($rules[$type] as $location) { $locations[$CFG->dirroot . "/$location/$plugin/lang/"] = "$plugin/$file"; } } } } // Work through the possible languages, starting with the most specific. while (!$helpfound && (list(,$lang) = each($langs)) && !empty($lang)) { while (!$helpfound && (list($locationprefix,$locationsuffix) = each($locations))) { $filepath = $locationprefix.$lang.'/help/'.$locationsuffix; // Now, try to include the help text from this file, if we can. if (file_exists_and_readable($filepath)) { $helpfound = true; @include($filepath); // The actual helpfile // Now, we process some special cases. $helpdir = $locationprefix.$lang.'/help'; if ($module == 'moodle' and ($file == 'index.html' or $file == 'mods.html')) { include_help_for_each_module($file, $langs, $helpdir); } // The remaining horrible hardcoded special cases should be delegated to modules somehow. if ($module == 'moodle' and ($file == 'resource/types.html')) { // RESOURCES include_help_for_each_resource($file, $langs, $helpdir); } if ($module == 'moodle' and ($file == 'assignment/types.html')) { // ASSIGNMENTS include_help_for_each_assignment_type(); } } } reset($locations); } } else { // The help to display was given as an argument to this function. echo '

'.s($text).'

'; // This param was already cleaned $helpfound = true; } print_simple_box_end(); // Display an error if necessary. if (!$helpfound) { notify('Help file "'. $file .'" could not be found!'); } // End of page. close_window_button(); echo '

'. get_string('helpindex') .''; // Offer a link to the alternative help file language if (($helpfound) and (((current_language() != 'en_utf8') and $lang != 'en_utf8') or ($forcelang === 'en_utf8'))) { $linklang = "{$CFG->wwwroot}/help.php?"; $linklang .= !empty($module) ? "module=$module&" : ''; $linklang .= !empty($file) ? "file=$file&" : ''; $linklang .= !empty($skiplocal) ? "skiplocal=$skiplocal&" : ''; if (empty($forcelang) or $forcelang === current_language()) { $nextlang = 'en_utf8'; $nextlangname = 'English'; } else { $nextlang = current_language(); $nextlangname = get_string('thislanguage'); } $linklang .= "forcelang=$nextlang"; echo "
" . get_string('showthishelpinlanguage', 'moodle', $nextlangname) . ''; } echo '

'; $CFG->docroot = ''; // We don't want a doc link here print_footer('none'); // Utility function ================================================================= function file_exists_and_readable($filepath) { return file_exists($filepath) and is_file($filepath) and is_readable($filepath); } // Some functions for handling special cases ======================================== function include_help_for_each_module($file, $langs, $helpdir) { global $CFG; if (!$modules = get_records('modules', 'visible', 1)) { error('No modules found!!'); // Should never happen } foreach ($modules as $mod) { $strmodulename = get_string('modulename', $mod->name); $modulebyname[$strmodulename] = $mod; } ksort($modulebyname, SORT_LOCALE_STRING); foreach ($modulebyname as $mod) { foreach ($langs as $lang) { if (empty($lang)) { continue; } $filepath = "$helpdir/$mod->name/$file"; // If that does not exist, try a fallback into the module code folder. if (!file_exists($filepath)) { $filepath = "$CFG->dirroot/mod/$mod->name/lang/$lang/help/$mod->name/$file"; } if (file_exists_and_readable($filepath)) { echo '
'; @include($filepath); // The actual helpfile break; // Out of loop over languages. } } } } function include_help_for_each_resource($file, $langs, $helpdir) { global $CFG; require_once($CFG->dirroot .'/mod/resource/lib.php'); $typelist = resource_get_types(); //add label type $labelType = new object(); $labelType->modclass = MOD_CLASS_RESOURCE; $resourcetype = 'label'; $labelType->name = $resourcetype; $labelType->type = "resource&type=$resourcetype"; $labelType->typestr = get_string("resourcetype$resourcetype", 'resource'); $typelist[] = $labelType; foreach ($typelist as $type) { foreach ($langs as $lang) { if (empty($lang)) { continue; } $filepath = "$helpdir/resource/type/".$type->name.".html"; if (file_exists_and_readable($filepath)) { echo '
'; @include($filepath); // The actual helpfile break; // Out of loop over languages. } } } } function include_help_for_each_assignment_type() { global $CFG; require_once($CFG->dirroot .'/mod/assignment/lib.php'); $typelist = assignment_types(); foreach ($typelist as $type => $name) { echo '

'.$name.'

'; echo get_string('help'.$type, 'assignment'); echo '
'; } } ?>