* // Returns the help text in artefact/blog/lang/[lang]/help/forms/editpost.draft.html
* get_help_icon('artefact', 'blog', 'editpost', 'draft');
* // Returns the help text in artefact/internal/lang/[lang]/help/pages/index.html
* get_help_icon('artefact', 'internal', '', '', 'index');
*
*
* @param string $plugintype the type of plugin to find help text for
* @param string $pluginname the name of the plugin to find help text for
* @param string $form the ID of the form this help icon is connected to
* @param string $element the ID of the form element this help icon is connected to
* @param string $page the page this help icon describes
* @param string $section the section this help icon describes
* @param string $title the title/label of the element this help icon is connected to
*
* @return string HTML with help icon element
*/
function get_help_icon($plugintype, $pluginname, $form, $element, $page='', $section='', $title=null) {
global $THEME;
if ($title) {
$content = get_string('helpfor', 'mahara', $title);
}
else {
$content = get_string('Help');
}
return ' '. $content . '';
}
function pieform_get_help(Pieform $form, $element) {
$plugintype = isset($element['helpplugintype']) ? $element['helpplugintype'] : $form->get_property('plugintype');
$pluginname = isset($element['helppluginname']) ? $element['helppluginname'] : $form->get_property('pluginname');
$formname = isset($element['helpformname']) ? $element['helpformname'] : $form->get_name();
return get_help_icon($plugintype, $pluginname, $formname, $element['name'], '', '', (isset($element['title']) ? $element['title'] : null));
}
/**
* Is this a page in the admin area?
*
* @return bool
*/
function in_admin_section() {
return defined('ADMIN') || defined('INSTITUTIONALADMIN') || defined('STAFF') || defined('INSTITUTIONALSTAFF') || defined('INADMINMENU');
}
/**
* Returns the entries in the standard admin menu
*
* See the function find_menu_children() in lib/web.php
* for a description of the expected array structure.
*
* @return $adminnav a data structure containing the admin navigation
*/
function admin_nav() {
$menu = array(
'adminhome' => array(
'path' => 'adminhome',
'url' => 'admin/index.php',
'title' => get_string('adminhome', 'admin'),
'weight' => 10,
'accesskey' => 'a',
'iconclass' => 'home',
),
'adminhome/home' => array(
'path' => 'adminhome/home',
'url' => 'admin/index.php',
'title' => get_string('overview'),
'weight' => 10,
),
'adminhome/registersite' => array(
'path' => 'adminhome/registersite',
'url' => 'admin/registersite.php',
'title' => get_string('register'),
'weight' => 20,
),
'configsite' => array(
'path' => 'configsite',
'url' => 'admin/site/options.php',
'title' => get_string('configsite', 'admin'),
'weight' => 20,
'accesskey' => 's',
'iconclass' => 'cogs',
),
'configsite/siteoptions' => array(
'path' => 'configsite/siteoptions',
'url' => 'admin/site/options.php',
'title' => get_string('siteoptions', 'admin'),
'weight' => 10,
),
'configsite/sitepages' => array(
'path' => 'configsite/sitepages',
'url' => 'admin/site/pages.php',
'title' => get_string('staticpages', 'admin'),
'weight' => 20
),
'configsite/privacy' => array(
'path' => 'configsite/privacy',
'url' => 'admin/site/privacy.php',
'title' => get_string('legal', 'admin'),
'weight' => 25,
),
'configsite/sitemenu' => array(
'path' => 'configsite/sitemenu',
'url' => 'admin/site/menu.php',
'title' => get_string('menus', 'admin'),
'weight' => 30,
),
'configsite/networking' => array(
'path' => 'configsite/networking',
'url' => 'admin/site/networking.php',
'title' => get_string('networking', 'admin'),
'weight' => 40,
),
'configsite/sitelicenses' => array(
'path' => 'configsite/sitelicenses',
'url' => 'admin/site/licenses.php',
'title' => get_string('sitelicenses', 'admin'),
'weight' => 45,
),
'configsite/siteviews' => array(
'path' => 'configsite/siteviews',
'url' => 'admin/site/views.php',
'title' => get_string('Viewscollections', 'view'),
'weight' => 50,
),
'configsite/share' => array(
'path' => 'configsite/share',
'url' => 'admin/site/shareviews.php',
'title' => get_string('share', 'view'),
'weight' => 70,
),
'configsite/sitefiles' => array(
'path' => 'configsite/sitefiles',
'url' => 'artefact/file/sitefiles.php',
'title' => get_string('Files', 'artefact.file'),
'weight' => 80,
),
'configsite/cookieconsent' => array(
'path' => 'configsite/cookieconsent',
'url' => 'admin/site/cookieconsent.php',
'title' => get_string('cookieconsent', 'cookieconsent'),
'weight' => 90,
),
'configusers' => array(
'path' => 'configusers',
'url' => 'admin/users/search.php',
'title' => get_string('users'),
'weight' => 30,
'accesskey' => 'u',
'iconclass' => 'user',
),
'configusers/usersearch' => array(
'path' => 'configusers/usersearch',
'url' => 'admin/users/search.php',
'title' => get_string('usersearch', 'admin'),
'weight' => 10,
),
'configusers/suspendedusers' => array(
'path' => 'configusers/suspendedusers',
'url' => 'admin/users/suspended.php',
'title' => get_string('suspendeduserstitle', 'admin'),
'weight' => 15,
),
'configusers/staffusers' => array(
'path' => 'configusers/staffusers',
'url' => 'admin/users/staff.php',
'title' => get_string('sitestaff', 'admin'),
'weight' => 20,
),
'configusers/adminusers' => array(
'path' => 'configusers/adminusers',
'url' => 'admin/users/admins.php',
'title' => get_string('siteadmins', 'admin'),
'weight' => 30,
),
'configusers/exportqueue' => array(
'path' => 'configusers/exportqueue',
'url' => 'admin/users/exportqueue.php',
'title' => get_string('exportqueue', 'admin'),
'weight' => 35,
),
'configusers/adduser' => array(
'path' => 'configusers/adduser',
'url' => 'admin/users/add.php',
'title' => get_string('adduser', 'admin'),
'weight' => 40,
),
'configusers/uploadcsv' => array(
'path' => 'configusers/uploadcsv',
'url' => 'admin/users/uploadcsv.php',
'title' => get_string('uploadcsv', 'admin'),
'weight' => 50,
),
'managegroups' => array(
'path' => 'managegroups',
'url' => 'admin/groups/groups.php',
'title' => get_string('groups', 'admin'),
'accessibletitle' => get_string('administergroups', 'admin'),
'weight' => 40,
'accesskey' => 'r',
'iconclass' => 'users',
),
'managegroups/groups' => array(
'path' => 'managegroups/groups',
'url' => 'admin/groups/groups.php',
'title' => get_string('administergroups', 'admin'),
'weight' => 10,
),
'managegroups/categories' => array(
'path' => 'managegroups/categories',
'url' => 'admin/groups/groupcategories.php',
'title' => get_string('groupcategories', 'admin'),
'weight' => 20,
),
'managegroups/archives' => array(
'path' => 'managegroups/archives',
'url' => 'admin/groups/archives.php',
'title' => get_string('archivedsubmissions', 'admin'),
'weight' => 25,
),
'managegroups/uploadcsv' => array(
'path' => 'managegroups/uploadcsv',
'url' => 'admin/groups/uploadcsv.php',
'title' => get_string('uploadgroupcsv', 'admin'),
'weight' => 30,
),
'managegroups/uploadmemberscsv' => array(
'path' => 'managegroups/uploadmemberscsv',
'url' => 'admin/groups/uploadmemberscsv.php',
'title' => get_string('uploadgroupmemberscsv', 'admin'),
'weight' => 40,
),
'manageinstitutions' => array(
'path' => 'manageinstitutions',
'url' => 'admin/users/institutions.php',
'title' => get_string('Institutions', 'admin'),
'weight' => 50,
'accesskey' => 'i',
'iconclass' => 'university',
),
'manageinstitutions/institutions' => array(
'path' => 'manageinstitutions/institutions',
'url' => 'admin/users/institutions.php',
'title' => get_string('settings', 'admin'),
'weight' => 10,
),
'manageinstitutions/sitepages' => array(
'path' => 'manageinstitutions/sitepages',
'url' => 'admin/users/institutionpages.php',
'title' => get_string('staticpages', 'admin'),
'weight' => 15
),
'manageinstitutions/privacy' => array(
'path' => 'manageinstitutions/privacy',
'url' => 'admin/users/institutionprivacy.php',
'title' => get_string('legal', 'admin'),
'weight' => 17
),
'manageinstitutions/institutionusers' => array(
'path' => 'manageinstitutions/institutionusers',
'url' => 'admin/users/institutionusers.php',
'title' => get_string('Members', 'admin'),
'weight' => 20,
),
'manageinstitutions/institutionstaff' => array(
'path' => 'manageinstitutions/institutionstaff',
'url' => 'admin/users/institutionstaff.php',
'title' => get_string('Staff', 'admin'),
'weight' => 30,
),
'manageinstitutions/institutionadmins' => array(
'path' => 'manageinstitutions/institutionadmins',
'url' => 'admin/users/institutionadmins.php',
'title' => get_string('Admins', 'admin'),
'weight' => 40,
),
'manageinstitutions/adminnotifications' => array(
'path' => 'manageinstitutions/adminnotifications',
'url' => 'admin/users/notifications.php',
'title' => get_string('adminnotifications', 'admin'),
'weight' => 50,
),
'manageinstitutions/progressbar' => array(
'path' => 'manageinstitutions/progressbar',
'url' => 'admin/users/progressbar.php',
'title' => get_string('progressbar', 'admin'),
'weight' => 55,
),
'manageinstitutions/institutionviews' => array(
'path' => 'manageinstitutions/institutionviews',
'url' => 'view/institutionviews.php',
'title' => get_string('Viewscollections', 'view'),
'weight' => 60,
),
'manageinstitutions/share' => array(
'path' => 'manageinstitutions/share',
'url' => 'view/institutionshare.php',
'title' => get_string('share', 'view'),
'weight' => 80,
),
'manageinstitutions/institutionfiles' => array(
'path' => 'manageinstitutions/institutionfiles',
'url' => 'artefact/file/institutionfiles.php',
'title' => get_string('Files', 'artefact.file'),
'weight' => 90,
),
'manageinstitutions/pendingregistrations' => array(
'path' => 'manageinstitutions/pendingregistrations',
'url' => 'admin/users/pendingregistrations.php',
'title' => get_string('pendingregistrations', 'admin'),
'weight' => 100,
),
'manageinstitutions/pendingdeletions' => array(
'path' => 'manageinstitutions/pendingdeletions`',
'url' => 'admin/users/pendingdeletions.php',
'title' => get_string('pendingdeletions', 'admin'),
'weight' => 110,
),
'reports' => array(
'path' => 'reports',
'url' => 'admin/users/statistics.php',
'title' => get_string('reports', 'statistics'),
'weight' => 60,
'iconclass' => 'pie-chart',
),
'configextensions' => array(
'path' => 'configextensions',
'url' => 'admin/extensions/plugins.php',
'title' => get_string('Extensions', 'admin'),
'weight' => 70,
'accesskey' => 'e',
'iconclass' => 'puzzle-piece',
),
'configextensions/pluginadmin' => array(
'path' => 'configextensions/pluginadmin',
'url' => 'admin/extensions/plugins.php',
'title' => get_string('pluginadmin', 'admin'),
'weight' => 10,
),
'configextensions/filters' => array(
'path' => 'configextensions/filters',
'url' => 'admin/extensions/filter.php',
'title' => get_string('htmlfilters', 'admin'),
'weight' => 20,
),
'configextensions/iframesites' => array(
'path' => 'configextensions/iframesites',
'url' => 'admin/extensions/iframesites.php',
'title' => get_string('allowediframesites', 'admin'),
'weight' => 30,
),
'configextensions/cleanurls' => array(
'path' => 'configextensions/cleanurls',
'url' => 'admin/extensions/cleanurls.php',
'title' => get_string('cleanurls', 'admin'),
'weight' => 40,
),
);
// Add the menu items for skins, if that feature is enabled
if (get_config('skins')) {
$menu['configsite/siteskins'] = array(
'path' => 'configsite/siteskins',
'url' => 'admin/site/skins.php',
'title' => get_string('siteskinmenu', 'skin'),
'weight' => 75,
);
$menu['configsite/sitefonts'] = array(
'path' => 'configsite/sitefonts',
'url' => 'admin/site/fonts.php',
'title' => get_string('sitefontsmenu', 'skin'),
'weight' => 76,
);
}
// Add the menu items for tags, if that feature is enabled in a visible institution.
if (($selector = get_institution_selector(false, false, false, false, false, true)) && !empty($selector['options'])) {
$menu['manageinstitutions/institutiontags'] = array(
'path' => 'manageinstitutions/tags',
'url' => 'admin/users/institutiontags.php',
'title' => get_string('tags'),
'weight' => 95
);
}
// enable plugins to augment the admin menu structure
foreach (array('artefact', 'interaction', 'module', 'auth') as $plugintype) {
if ($plugins = plugins_installed($plugintype)) {
foreach ($plugins as &$plugin) {
if (safe_require_plugin($plugintype, $plugin->name)) {
$plugin_menu = call_static_method(generate_class_name($plugintype,$plugin->name), 'admin_menu_items');
$menu = array_merge($menu, $plugin_menu);
}
}
}
}
return $menu;
}
/**
* Returns the entries in the standard institutional admin menu
*
* See the function find_menu_children() in lib/web.php
* for a description of the expected array structure.
*
* @return $adminnav a data structure containing the admin navigation
*/
function institutional_admin_nav() {
global $USER;
$ret = array(
'configusers' => array(
'path' => 'configusers',
'url' => 'admin/users/search.php',
'title' => get_string('users'),
'weight' => 10,
'accesskey' => 'u',
'iconclass' => 'user',
),
'configusers/usersearch' => array(
'path' => 'configusers/usersearch',
'url' => 'admin/users/search.php',
'title' => get_string('usersearch', 'admin'),
'weight' => 10,
),
'configusers/suspendedusers' => array(
'path' => 'configusers/suspendedusers',
'url' => 'admin/users/suspended.php',
'title' => get_string('suspendeduserstitle', 'admin'),
'weight' => 20,
),
'configusers/exportqueue' => array(
'path' => 'configusers/exportqueue',
'url' => 'admin/users/exportqueue.php',
'title' => get_string('exportqueue', 'admin'),
'weight' => 25,
),
'configusers/adduser' => array(
'path' => 'configusers/adduser',
'url' => 'admin/users/add.php',
'title' => get_string('adduser', 'admin'),
'weight' => 30,
),
'configusers/uploadcsv' => array(
'path' => 'configusers/uploadcsv',
'url' => 'admin/users/uploadcsv.php',
'title' => get_string('uploadcsv', 'admin'),
'weight' => 40,
),
'managegroups' => array(
'path' => 'managegroups',
'url' => 'admin/groups/uploadcsv.php',
'title' => get_string('groups', 'admin'),
'accessibletitle' => get_string('administergroups', 'admin'),
'weight' => 20,
'accesskey' => 'g',
'iconclass' => 'users',
),
'managegroups/archives' => array(
'path' => 'managegroups/archives',
'url' => 'admin/groups/archives.php',
'title' => get_string('archivedsubmissions', 'admin'),
'weight' => 5,
),
'managegroups/uploadcsv' => array(
'path' => 'managegroups/uploadcsv',
'url' => 'admin/groups/uploadcsv.php',
'title' => get_string('uploadgroupcsv', 'admin'),
'weight' => 10,
),
'managegroups/uploadmemberscsv' => array(
'path' => 'managegroups/uploadmemberscsv',
'url' => 'admin/groups/uploadmemberscsv.php',
'title' => get_string('uploadgroupmemberscsv', 'admin'),
'weight' => 20,
),
'manageinstitutions' => array(
'path' => 'manageinstitutions',
'url' => 'admin/users/institutions.php',
'title' => get_string('Institutions', 'admin'),
'weight' => 30,
'accesskey' => 'i',
'iconclass' => 'university',
),
'manageinstitutions/institutions' => array(
'path' => 'manageinstitutions/institutions',
'url' => 'admin/users/institutions.php',
'title' => get_string('settings'),
'weight' => 10,
),
'manageinstitutions/sitepages' => array(
'path' => 'manageinstitutions/sitepages',
'url' => 'admin/users/institutionpages.php',
'title' => get_string('staticpages', 'admin'),
'weight' => 15
),
'manageinstitutions/privacy' => array(
'path' => 'manageinstitutions/privacy',
'url' => 'admin/users/institutionprivacy.php',
'title' => get_string('legal', 'admin'),
'weight' => 17
),
'manageinstitutions/institutionusers' => array(
'path' => 'manageinstitutions/institutionusers',
'url' => 'admin/users/institutionusers.php',
'title' => get_string('Members', 'admin'),
'weight' => 20,
),
'manageinstitutions/institutionstaff' => array(
'path' => 'manageinstitutions/institutionstaff',
'url' => 'admin/users/institutionstaff.php',
'title' => get_string('Staff', 'admin'),
'weight' => 30,
),
'manageinstitutions/institutionadmins' => array(
'path' => 'manageinstitutions/institutionadmins',
'url' => 'admin/users/institutionadmins.php',
'title' => get_string('Admins', 'admin'),
'weight' => 40,
),
'manageinstitutions/adminnotifications' => array(
'path' => 'manageinstitutions/adminnotifications',
'url' => 'admin/users/notifications.php',
'title' => get_string('adminnotifications', 'admin'),
'weight' => 50,
),
'manageinstitutions/institutionviews' => array(
'path' => 'manageinstitutions/institutionviews',
'url' => 'view/institutionviews.php',
'title' => get_string('Viewscollections', 'view'),
'weight' => 60,
),
'manageinstitutions/share' => array(
'path' => 'manageinstitutions/share',
'url' => 'view/institutionshare.php',
'title' => get_string('share', 'view'),
'weight' => 80,
),
'manageinstitutions/institutionfiles' => array(
'path' => 'manageinstitutions/institutionfiles',
'url' => 'artefact/file/institutionfiles.php',
'title' => get_string('Files', 'artefact.file'),
'weight' => 90,
),
'manageinstitutions/pendingregistrations' => array(
'path' => 'manageinstitutions/pendingregistrations',
'url' => 'admin/users/pendingregistrations.php',
'title' => get_string('pendingregistrations', 'admin'),
'weight' => 100,
),
'manageinstitutions/pendingdeletions' => array(
'path' => 'manageinstitutions/pendingdeletions`',
'url' => 'admin/users/pendingdeletions.php',
'title' => get_string('pendingdeletions', 'admin'),
'weight' => 110,
),
'reports' => array(
'path' => 'reports',
'url' => 'admin/users/statistics.php',
'title' => get_string('reports', 'statistics'),
'weight' => 40,
'iconclass' => 'pie-chart',
),
);
// Add the menu items for tags, if that feature is enabled in a visible institution.
if (($selector = get_institution_selector(false, false, false, false, false, true)) && !empty($selector['options'])) {
$ret['manageinstitutions/institutiontags'] = array(
'path' => 'manageinstitutions/tags',
'url' => 'admin/users/institutiontags.php',
'title' => get_string('tags'),
'weight' => 95
);
}
// enable plugins to augment the institution admin menu structure
foreach (array('artefact', 'interaction', 'module', 'auth') as $plugintype) {
if ($plugins = plugins_installed($plugintype)) {
foreach ($plugins as &$plugin) {
if (safe_require_plugin($plugintype, $plugin->name)) {
$plugin_menu = call_static_method(generate_class_name($plugintype,$plugin->name), 'institution_menu_items');
$ret = array_merge($ret, $plugin_menu);
}
}
}
}
return $ret;
}
/**
* Returns the entries in the staff menu
*
* See the function find_menu_children() in lib/web.php
* for a description of the expected array structure.
*
* @return a data structure containing the staff navigation
*/
function staff_nav() {
$menu = array(
'usersearch' => array(
'path' => 'usersearch',
'url' => 'admin/users/search.php',
'title' => get_string('usersearch', 'admin'),
'weight' => 10,
'accesskey' => 'u',
'iconclass' => 'user',
),
'reports' => array(
'path' => 'reports',
'url' => 'admin/users/statistics.php',
'title' => get_string('reports', 'statistics'),
'weight' => 30,
'accesskey' => 'i',
'iconclass' => 'pie-chart',
),
);
// enable plugins to augment the institution staff menu structure
foreach (array('artefact', 'interaction', 'module', 'auth') as $plugintype) {
if ($plugins = plugins_installed($plugintype)) {
foreach ($plugins as &$plugin) {
if (safe_require_plugin($plugintype, $plugin->name)) {
$plugin_menu = call_static_method(generate_class_name($plugintype,$plugin->name), 'institution_staff_menu_items');
$menu = array_merge($menu, $plugin_menu);
}
}
}
}
return $menu;
}
/**
* Returns the entries in the institutional staff menu
*
* See the function find_menu_children() in lib/web.php
* for a description of the expected array structure.
*
* @return a data structure containing the institutional staff navigation
*/
function institutional_staff_nav() {
return array(
'usersearch' => array(
'path' => 'usersearch',
'url' => 'admin/users/search.php',
'title' => get_string('usersearch', 'admin'),
'weight' => 10,
'accesskey' => 'u',
'iconclass' => 'user',
),
'reports' => array(
'path' => 'reports',
'url' => 'admin/users/statistics.php',
'title' => get_string('reports', 'statistics'),
'weight' => 20,
'accesskey' => 'i',
'iconclass' => 'pie-chart',
),
);
}
/**
* Returns the entries in the standard user menu
*
* See the function find_menu_children() in lib/web.php
* for a description of the expected array structure.
*
* @return $standardnav a data structure containing the standard navigation
*/
function mahara_standard_nav() {
global $SESSION;
$exportenabled = (plugins_installed('export') && !$SESSION->get('handheld_device')) ? TRUE : FALSE;
$importenabled = (plugins_installed('import') && !$SESSION->get('handheld_device')) ? TRUE : FALSE;
$menu = array(
'home' => array(
'path' => 'home',
'url' => '',
'title' => get_string('dashboard', 'view'),
'weight' => 10,
'accesskey' => 'd',
'iconclass' => 'home'
),
'create' => array(
'path' => 'create',
'url' => null,
'title' => get_string('Create'),
'weight' => 20,
'iconclass' => 'plus',
),
'share' => array(
'path' => 'share',
'url' => null,
'title' => get_string('share'),
'weight' => 30,
'iconclass' => 'unlock-alt',
),
'engage' => array(
'path' => 'engage',
'url' => null,
'title' => get_string('Engage'),
'weight' => 40,
'iconclass' => 'users',
),
'create/views' => array(
'path' => 'create/views',
'url' => 'view/index.php',
'title' => get_string('Viewscollections', 'view'),
'weight' => 10,
'accesskey' => 'p',
),
'create/tags' => array(
'path' => 'create/tags',
'url' => 'tags.php',
'title' => get_string('tags'),
'weight' => 80,
),
'share/sharedbyme' => array(
'path' => 'share/sharedbyme',
'url' => 'view/share.php',
'title' => get_string('sharedbyme', 'view'),
'weight' => 10,
),
'share/sharedviews' => array(
'path' => 'share/sharedviews',
'url' => 'view/sharedviews.php',
'title' => get_string('sharedwithme', 'view'),
'weight' => 20,
),
'manage/export' => array(
'path' => 'manage/export',
'url' => 'export/index.php',
'title' => get_string('Export', 'export'),
'weight' => 70,
'ignore' => !$exportenabled,
),
'manage/import' => array(
'path' => 'manage/import',
'url' => 'import/index.php',
'title' => get_string('Import', 'import'),
'weight' => 80,
'ignore' => !$importenabled,
),
'manage' => array(
'path' => 'manage',
'url' => null,
'title' => get_string('Manage'),
'weight' => 40,
'iconclass' => 'wrench',
),
'engage/mygroups' => array(
'path' => 'engage/mygroups',
'url' => 'group/mygroups.php',
'title' => get_string('mygroups'),
'weight' => 10,
'accesskey' => 'g',
),
'engage/find' => array(
'path' => 'engage/find',
'url' => 'group/find.php',
'title' => get_string('findgroups'),
'weight' => 20,
),
'engage/myfriends' => array(
'path' => 'engage/myfriends',
'url' => 'user/myfriends.php',
'title' => get_string('myfriends'),
'weight' => 30,
),
'engage/findfriends' => array(
'path' => 'engage/findfriends',
'url' => 'user/find.php',
'title' => get_string('findpeople'),
'weight' => 40,
),
'engage/institutionmembership' => array(
'path' => 'engage/institutions',
'url' => 'account/institutions.php',
'title' => get_string('institutionmembership'),
'weight' => 60,
),
);
if (can_use_skins()) {
$menu['create/skins'] = array(
'path' => 'create/skins',
'url' => 'skin/index.php',
'title' => get_string('myskins', 'skin'),
'weight' => 70,
);
}
return $menu;
}
/**
* Builds a data structure representing the menu for Mahara.
*
* @return array
*/
function main_nav($type = null) {
global $USER;
$language = current_language();
$cachemenu = false;
// Get the first institution
$institution = $USER->get_primary_institution();
$menutype = '';
if ($type == 'adminnav') {
global $USER, $SESSION;
if ($USER->get('admin')) {
$menutype = 'admin_nav';
if (!($cachemenu = get_config_institution($institution, $menutype . '_' . $language))) {
$menu = admin_nav();
}
}
else if ($USER->get('staff')) {
$menutype = 'staff_nav';
if (!($cachemenu = get_config_institution($institution, $menutype . '_' . $language))) {
$menu = staff_nav();
}
}
else if ($USER->is_institutional_admin()) {
$menutype = 'instadmin_nav';
if (!($cachemenu = get_config_institution($institution, $menutype . '_' . $language))) {
$menu = institutional_admin_nav();
}
}
else {
$menutype = 'inststaff_nav';
if (!($cachemenu = get_config_institution($institution, $menutype . '_' . $language))) {
$menu = institutional_staff_nav();
}
}
}
else {
// Build the menu structure for the site
$menutype = 'standard_nav';
if (!($cachemenu = get_config_institution($institution, $menutype . '_' . $language))) {
$menu = mahara_standard_nav();
}
}
if ($cachemenu) {
$menu = json_decode($cachemenu, true);
}
else {
$menu = array_filter($menu, function($a) { return empty($a["ignore"]); });
// enable plugins to augment the menu structure
foreach (array('artefact', 'interaction', 'module', 'auth') as $plugintype) {
if ($plugins = plugins_installed($plugintype)) {
foreach ($plugins as &$plugin) {
if (safe_require_plugin($plugintype, $plugin->name)) {
$plugin_menu = call_static_method(generate_class_name($plugintype,$plugin->name), 'menu_items');
$menu = array_merge($menu, $plugin_menu);
}
}
}
}
set_config_institution($institution, $menutype . '_' . $language, json_encode($menu));
}
// local_main_nav_update allows sites to customise the menu by munging the $menu array.
// as there is no internal way to know if the local_main_nav array has changed we keep it outside the cached menu
if (function_exists('local_main_nav_update')) {
local_main_nav_update($menu);
}
$menu_structure = find_menu_children($menu, '');
return $menu_structure;
}
/**
* Clear the cached menu so that the next visit to the site will recreate the cache.
*
* @param string $institution Optional institution name if we only want to delete cache from a certain institution
*/
function clear_menu_cache($institution = null) {
if ($institution) {
try {
delete_records_sql("DELETE FROM {institution_config} WHERE field LIKE '%/_nav/_%' ESCAPE '/' AND institution = ?", array($institution));
}
catch (SQLException $e) {
// Institution_config table may not exist on install/upgrade at this point
}
}
else {
try {
delete_records_sql("DELETE FROM {institution_config} WHERE field LIKE '%/_nav/_%' ESCAPE '/'", array());
}
catch (SQLException $e) {
// Institution_config table may not exist on install/upgrade at this point
}
}
}
function message_nav() {
global $USER, $THEME;
$menu = array(
'inbox' => array(),
);
if (safe_require_plugin('module', 'multirecipientnotification')) {
$plugin_nav_menu = call_static_method(generate_class_name('module', 'multirecipientnotification'),
'messages_menu_items');
$menu = array_merge($menu, $plugin_nav_menu);
}
return $menu;
}
function right_nav() {
global $USER, $THEME;
safe_require('notification', 'internal');
$unread = $USER->get('unread');
$menu = array(
'userdashboard' => array(
'path' => 'userdashboard',
'url' => profile_url($USER, false),
'title' => display_default_name($USER),
'alt' => '',
'weight' => 10,
'iconclass' => 'user'
),
'settings' => array(
'path' => 'settings',
'url' => null,
'title' => get_string('settings'),
'alt' => '',
'weight' => 20,
'iconclass' => 'cogs'
),
'settings/account' => array(
'path' => 'settings/account',
'url' => 'account/index.php',
'title' => get_string('preferences'),
'weight' => 10,
'iconclass' => 'user'
),
'settings/privacy' => array(
'path' => 'settings/privacy',
'url' => 'account/userprivacy.php',
'title' => get_string('legal', 'admin'),
'weight' => 30
),
'settings/notifications' => array(
'path' => 'settings/notifications',
'url' => 'account/activity/preferences/index.php',
'title' => get_string('notifications'),
'weight' => 40,
'iconclass' => 'flag'
),
);
// enable plugins to augment the menu structure
foreach (array('artefact', 'interaction', 'module') as $plugintype) {
if ($plugins = plugins_installed($plugintype)) {
foreach ($plugins as &$plugin) {
if (safe_require_plugin($plugintype, $plugin->name)) {
$plugin_nav_menu = call_static_method(generate_class_name($plugintype, $plugin->name),
'right_nav_menu_items');
$menu = array_merge($menu, $plugin_nav_menu);
}
}
}
}
// local_right_nav_update allows sites to customise the menu by munging the $menu array.
if (function_exists('local_right_nav_update')) {
local_right_nav_update($menu);
}
$menu_structure = find_menu_children($menu, '');
return $menu_structure;
}
function footer_menu($all=false) {
global $USER;
$wwwroot = get_config('wwwroot');
$menu = array(
'legal' => array(
'url' => ($USER->is_logged_in() ? $wwwroot . 'account/userprivacy.php' : $wwwroot . 'legal.php'),
'title' => get_string('legal'),
),
'about' => array(
'url' => $wwwroot . 'about.php',
'title' => get_string('about'),
),
'contactus' => array(
'url' => $wwwroot . 'contact.php',
'title' => get_string('contactus'),
),
);
$helpkeys = null;
if (defined('MENUITEM')) {
$helpkey = ($USER->is_logged_in() ? '' : 'loggedout') . MENUITEM;
$helpkeys = explode('/', $helpkey);
}
if (defined('SECTION_PAGE')) {
$helpkeys[] = SECTION_PAGE;
}
if (defined('VIEW_TYPE')) {
$helpkeys[] = VIEW_TYPE;
}
// To handle the 'Report' pages where type/subtype are passed in as params
if (defined('MENUITEM') && MENUITEM == 'reports') {
if (param_exists('type')) {
$helpkeys[] = param_alpha('type');
}
if (param_exists('subtype')) {
$helpkeys[] = param_variable('subtype');
}
}
// To handle the configmanager page where plugintye/pluginname are
// passed in as params (not when defined as part of php file)
if (param_exists('plugintype')) {
$helpkeys[] = param_alpha('plugintype');
}
if (param_exists('pluginname')) {
$helpkeys[] = param_variable('pluginname');
}
// If we are in an arrow submenu
if (defined('MENUITEM_SUBPAGE')) {
$helpkeys[] = MENUITEM_SUBPAGE;
}
// If group is set
if (param_exists('group')) {
$helpkeys[] = 'group';
}
// If institution is set
if (param_exists('institution') || param_exists('i')) {
$helpkeys[] = 'institution';
}
// To handle when things have a 'new' state vs edit state
if (param_exists('id')) {
if (param_exists('new')) {
$helpkeys[] = 'new';
}
}
$menu['manualhelp'] = array('fullurl' => get_manual_help_link($helpkeys),
'title' => get_string('externalmanual'),
'url' => _get_manual_link_prefix(),
);
if ($all) {
return $menu;
}
if ($enabled = get_config('footerlinks')) {
$enabled = unserialize($enabled);
foreach ($menu as $k => $v) {
if (!in_array($k, $enabled)) {
unset($menu[$k]);
}
}
}
if ($customlinks = get_config('footercustomlinks')) {
$customlinks = unserialize($customlinks);
foreach ($customlinks as $k => $v) {
if (!empty($menu[$k])) {
$menu[$k]['url'] = $v;
}
}
}
return $menu;
}
/**
* Given a menu structure and a path, returns a data structure representing all
* of the child menu items of the path, and removes those items from the menu
* structure
*
* The menu structure should be an array. Each item in the array should be
* a sub-array representing one of the nodes in the menu.
*
* The keys of each menu node are as follows:
* path: Where the link sits in the menu. E.g. 'myporfolio/myplugin'
* parent: (optional) The parent path - use if tertiary level menu
* url: The URL to the page, relative to wwwroot. E.g. 'artefact/myplugin/'
* title: Translated text to use for the text of the link. E.g. get_string('myplugin', 'artefact.myplugin')
* weight: Where in the menu the item should be inserted. Larger number are to the right.
*
* Used by main_nav()
*/
function find_menu_children(&$menu, $path) {
global $SELECTEDSUBNAV;
$result = array();
if (!$menu) {
return array();
}
foreach ($menu as $key => $item) {
$item['selected'] = defined('MENUITEM')
&& ($item['path'] == MENUITEM
|| ($item['path'] . '/' == substr(MENUITEM, 0, strlen($item['path'])+1))
|| (!empty($item['parent']) && $item['parent'] == MENUITEM));
if (
($path == '' && $item['path'] == '') ||
($item['path'] != '' && substr($item['path'], 0, strlen($path)) == $path && !preg_match('%/%', substr($item['path'], strlen($path) + 1)))) {
$result[] = $item;
unset($menu[$key]);
}
}
if ($menu) {
foreach ($result as &$item) {
$item['submenu'] = find_menu_children($menu, $item['path']);
if ($item['selected']) {
$SELECTEDSUBNAV = $item['submenu'];
}
}
}
uasort($result, 'menu_sort_items');
return $result;
}
/**
* Comparison function for sorting menu items
*/
function menu_sort_items(&$a, &$b) {
!isset($a['weight']) && $a['weight'] = 0;
!isset($b['weight']) && $b['weight'] = 0;
return $a['weight'] > $b['weight'];
}
/**
* Site-level sidebar menu (list of links)
* There is no admin files table yet so just get the urls.
* @return $menu a data structure containing the site menu
*/
function site_menu() {
global $USER;
$menu = array();
if ($menuitems = get_records_array('site_menu','public',(int) !$USER->is_logged_in(),'displayorder')) {
foreach ($menuitems as $i) {
if ($i->url) {
$safeurl = sanitize_url($i->url);
if ($safeurl != '') {
$menu[] = array('name' => $i->title,
'link' => $safeurl);
}
}
else if ($i->file) {
$menu[] = array('name' => $i->title,
'link' => get_config('wwwroot') . 'artefact/file/download.php?file=' . $i->file);
}
}
}
return $menu;
}
/**
* Returns the list of site content pages
* @return array of names
*/
function site_content_pages() {
return array('about', 'home', 'loggedouthome');
}
/**
* Returns the list of site versioned content pages
* @return array of names
*/
function site_content_version_pages() {
return array('privacy', 'termsandconditions');
}
function get_site_page_content($pagename) {
global $USER;
$institution = $USER->sitepages_institutionname_by_theme($pagename);
// try to get the content for this institution and if it fails try to get default site information
// first check to see if the db upgrade has been run so the institution column exists
if (get_config('version') >= '2014010801') {
if ($pagedata = get_record('site_content', 'name', $pagename, 'institution', $institution)) {
return $pagedata->content;
}
else if ($defaultpagedata = get_record('site_content', 'name', $pagename, 'institution', 'mahara')) {
return $defaultpagedata->content;
}
return get_string('sitecontentnotfound', 'mahara', get_string($pagename, $institution));
}
else {
if ($pagedata = get_record('site_content', 'name', $pagename)) {
return $pagedata->content;
}
}
return get_string('sitecontentnotfound', 'mahara', get_string($pagename));
}
/**
* Redirects the browser to a new location. The path to redirect to can take
* two forms:
*
* - http[something]: will redirect the user to that exact URL
* - /[something]: will redirect to WWWROOT/[something]
*
* Any other form is illegal and will cause an error.
*
* @param string $location The location to redirect the user to. Defaults to
* the application home page.
*/
function redirect($location='/') {
$file = $line = null;
if (headers_sent($file, $line)) {
throw new SystemException("Headers already sent when redirect() was called (output started in $file on line $line");
}
if (substr($location, 0, 4) != 'http') {
if (substr($location, 0, 1) != '/') {
throw new SystemException('redirect() should be called with either'
. ' /[something] for local redirects or http[something] for'
. ' absolute redirects');
}
$location = get_config('wwwroot') . substr($location, 1);
}
header('HTTP/1.1 303 See Other');
header('Location:' . $location);
perf_to_log();
exit;
}
/**
* Returns a string, HTML escaped
*
* @param string $text The text to escape
* @return string The text, HTML escaped
*/
function hsc ($text) {
return htmlspecialchars($text, ENT_COMPAT, 'UTF-8');
}
/**
* Builds the pieform for the search field in the page header
*/
function header_search_form() {
$plugin = get_config('searchplugin');
safe_require('search', $plugin);
return call_static_method(
generate_class_name('search', $plugin),
'header_search_form'
);
}
/**
* Returns the name of the current script, WITH the querystring portion.
* this function is necessary because PHP_SELF and REQUEST_URI and SCRIPT_NAME
* return different things depending on a lot of things like your OS, Web
* server, and the way PHP is compiled (ie. as a CGI, module, ISAPI, etc.)
* NOTE: This function returns false if the global variables needed are not set.
*
* @return string
*/
function get_script_path() {
if (!empty($_SERVER['REQUEST_URI'])) {
return $_SERVER['REQUEST_URI'];
} else if (!empty($_SERVER['PHP_SELF'])) {
if (!empty($_SERVER['QUERY_STRING'])) {
return $_SERVER['PHP_SELF'] .'?'. $_SERVER['QUERY_STRING'];
}
return $_SERVER['PHP_SELF'];
} else if (!empty($_SERVER['SCRIPT_NAME'])) {
if (!empty($_SERVER['QUERY_STRING'])) {
return $_SERVER['SCRIPT_NAME'] .'?'. $_SERVER['QUERY_STRING'];
}
return $_SERVER['SCRIPT_NAME'];
} else if (!empty($_SERVER['URL'])) { // May help IIS (not well tested)
if (!empty($_SERVER['QUERY_STRING'])) {
return $_SERVER['URL'] .'?'. $_SERVER['QUERY_STRING'];
}
return $_SERVER['URL'];
}
else {
log_warn('Warning: Could not find any of these web server variables: $REQUEST_URI, $PHP_SELF, $SCRIPT_NAME or $URL');
return false;
}
}
/**
* Get the requested servername in preference to the host in the configured
* wwwroot. Usually the same unless some parts of the site are at subdomains.
*
* @return string
*/
function get_requested_host_name() {
global $CFG;
$hostname = false;
if (false === $hostname && !empty($_SERVER['SERVER_NAME'])) {
$hostname = $_SERVER['SERVER_NAME'];
}
if (false === $hostname && !empty($_ENV['SERVER_NAME'])) {
$hostname = $_ENV['SERVER_NAME'];
}
if (false === $hostname && !empty($_SERVER['HTTP_HOST'])) {
$hostname = $_SERVER['HTTP_HOST'];
}
if (false === $hostname && !empty($_ENV['HTTP_HOST'])) {
$hostname = $_ENV['HTTP_HOST'];
}
if (false === $hostname && !empty($CFG->wwwroot)) {
$url = parse_url($CFG->wwwroot);
if (!empty($url['host'])) {
$hostname = $url['host'];
}
}
if (false === $hostname) {
log_warn('Warning: could not find the name of this server!');
return false;
}
else {
$hostname = strtolower($hostname);
// Because the hostname can be user provided data (from the HTTP request), we
// should whitelist it.
if (!preg_match(
'/^([a-z0-9]|[a-z0-9][a-z0-9-]*[a-z0-9])(\\.([a-z0-9]|[a-z0-9][a-z0-9-]*[a-z0-9]))*$/',
$hostname
)
) {
log_warn('Warning: invalid hostname found in get_requested_host_name.');
return false;
}
return $hostname;
}
}
/**
* Like {@link get_script_path()} but returns a full URL
* @see get_script_path()
* @return string
*/
function get_full_script_path() {
global $CFG;
if (!empty($CFG->wwwroot)) {
$url = parse_url($CFG->wwwroot);
}
if (!$hostname = get_requested_host_name()) {
return false;
}
if (!empty($url['port'])) {
$hostname .= ':'.$url['port'];
} else if (!empty($_SERVER['SERVER_PORT'])) {
// SSL proxy could be on a random port and we don't want it to appear in URL.
if (get_config('sslproxy')) {
$_SERVER['SERVER_PORT'] = '443';
}
if ($_SERVER['SERVER_PORT'] != 80 && $_SERVER['SERVER_PORT'] != 443) {
$hostname .= ':'.$_SERVER['SERVER_PORT'];
}
}
if (isset($_SERVER['HTTPS'])) {
$protocol = ($_SERVER['HTTPS'] == 'on') ? 'https://' : 'http://';
}
else if (isset($_SERVER['SERVER_PORT'])) { # Apache2 does not export $_SERVER['HTTPS']
$protocol = ($_SERVER['SERVER_PORT'] == '443') ? 'https://' : 'http://';
}
else {
$protocol = 'http://';
}
$url_prefix = $protocol.$hostname;
return $url_prefix . get_script_path();
}
/**
* Like {@link get_script_path()} but returns a URI relative to WWWROOT
* @see get_script_path()
* @return string
*/
function get_relative_script_path() {
$maharadir = get_mahara_install_subdirectory();
// $maharadir always has a trailing '/'
return substr(get_script_path(), strlen($maharadir) - 1);
}
/**
* Get query string from url
*
* Takes in a URL and returns the querystring portion
* or returns $_SERVER['QUERY_STRING']) if set
*
* @param string $url the url which may have a query string attached
* @return string
*/
function get_querystring($url = null) {
if (!empty($url) && $commapos = strpos($url, '?')) {
return substr($url, $commapos + 1);
}
else if (!empty($_SERVER['QUERY_STRING'])) {
return $_SERVER['QUERY_STRING'];
}
else {
return '';
}
}
/**
* Remove query string from url
*
* Takes in a URL and returns it without the querystring portion
*
* @param string $url the url which may have a query string attached
* @return string
*/
function strip_querystring($url) {
if ($commapos = strpos($url, '?')) {
return substr($url, 0, $commapos);
}
else {
return $url;
}
}
function has_page_help() {
$pt = defined('SECTION_PLUGINTYPE') ? SECTION_PLUGINTYPE : null;
$pn = defined('SECTION_PLUGINNAME') ? SECTION_PLUGINNAME : null;
$sp = defined('SECTION_PAGE') ? SECTION_PAGE : null;
if (empty($pt) || ($pt != 'core' && empty($pn))) {
// we can't have a plugin type but no plugin name
return false;
}
if (in_array($pt, plugin_types())) {
$pagehelp = get_config('docroot') . $pt . '/' . $pn . '/lang/en.utf8/help/pages/' . $sp . '.html';
}
else {
$pagehelp = get_config('docroot') . 'lang/en.utf8/help/pages/' . $pn . '/' . $sp . '.html';
}
if (is_readable($pagehelp)) {
return array($sp, get_help_icon($pt, $pn, '', '', $sp));
}
return false;
}
//
// Cleaning/formatting functions
//
/**
* Given some plain text, adds the appropriate HTML to it to make it appear in
* an HTML document with the same formatting
*
* This includes escaping entities, replacing newlines etc. It is not
* particularly intelligent about paragraphs, it just adds to every * newline * * @param string $text The text to format * @return string */ function format_whitespace($text) { $text = str_replace("\r\n", "\n", $text); $text = str_replace("\r", "\n", $text); $text = hsc($text); $text = str_replace(' ', ' ', $text); $text = str_replace(' ', ' ', $text); $text = str_replace("\n", "
\n", $text); return $text; } /** * Get the list of custom filters to be used in HTMLPurifier * @return array */ function get_htmlpurifier_custom_filters() { $customfilters = array(); if (get_config('filters')) { foreach (unserialize(get_config('filters')) as $filter) { // These filters are no longer necessary and have been removed $builtinfilters = array('YouTube', 'TeacherTube', 'SlideShare', 'SciVee', 'GoogleVideo'); if (!in_array($filter->file, $builtinfilters)) { include_once(get_config('libroot') . 'htmlpurifiercustom/' . $filter->file . '.php'); $classname = 'HTMLPurifier_Filter_' . $filter->file; if (class_exists($classname)) { $customfilters[] = new $classname(); } } } } return $customfilters; } /** * Given raw html (eg typed in by a user), this function cleans it up * and removes any nasty tags that could mess up pages. * * NOTE: The HTMLPurifier config is cached. You'll need to bump $CFG->cacheversion * to clear the cache. (The easiest way to do that is to bump htdocs/lib/version.php) * * @param string $text The text to be cleaned * @param boolean $xhtml HTML 4.01 will be used for all of mahara, except very special cases (eg leap2a exports) * @return string The cleaned up text */ function clean_html($text, $xhtml=false) { require_once('htmlpurifier/HTMLPurifier.auto.php'); $config = HTMLPurifier_Config::createDefault(); // Uncomment this line to disable the cache during debugging // $config->set('Cache.DefinitionImpl', null); $config->set('HTML.DefinitionID', 'Mahara customisations to default config'); $config->set('HTML.DefinitionRev', get_config('cacheversion', 0)); $config->set('Cache.SerializerPermissions', get_config('directorypermissions')); $config->set('Cache.SerializerPath', get_config('dataroot') . 'htmlpurifier'); if (empty($xhtml)) { $config->set('HTML.Doctype', 'HTML 4.01 Transitional'); } else { $config->set('HTML.Doctype', 'XHTML 1.0 Transitional'); } $config->set('AutoFormat.Linkify', true); if (get_config('disableexternalresources')) { $config->set('URI.DisableExternalResources', true); $config->set('URI.Host', get_config('wwwhost')); } // Permit embedding contents from other sites $config->set('HTML.SafeEmbed', true); $config->set('HTML.SafeObject', true); $config->set('Output.FlashCompat', true); if ($iframeregexp = get_config('iframeregexp')) { $config->set('HTML.SafeIframe', true); $config->set('URI.SafeIframeRegexp', $iframeregexp); } // Allow namespaced IDs // see http://htmlpurifier.org/docs/enduser-id.html $config->set('Attr.EnableID', true); $config->set('Attr.IDPrefix', 'user_'); // Allow base64 images via the 'data' option // need to set all the allowed schemes for this to work $config->set('URI.AllowedSchemes', array('http' => true, 'https' => true, 'mailto' => true, 'ftp' => true, 'nntp' => true, 'news' => true, 'tel' => true, 'data' => true)); $customfilters = get_htmlpurifier_custom_filters(); if (!empty($customfilters)) { $config->set('Filter.Custom', $customfilters); } if ($def = $config->maybeGetRawHTMLDefinition()) { # Allow iframes with custom attributes such as fullscreen # This overrides lib/htmlpurifier/HTMLPurifier/HTMLModule/Iframe.php $def->addElement( 'iframe', 'Inline', 'Flow', 'Common', array( 'src' => 'URI#embedded', 'width' => 'Length', 'height' => 'Length', 'name' => 'ID', 'scrolling' => 'Enum#yes,no,auto', 'frameborder' => 'Enum#0,1', 'allowfullscreen' => 'Enum#,0,1', 'webkitallowfullscreen' => 'Enum#,0,1', 'mozallowfullscreen' => 'Enum#,0,1', 'longdesc' => 'URI', 'marginheight' => 'Pixels', 'marginwidth' => 'Pixels', ) ); // allow the tags used with image map to be rendered // see http://htmlpurifier.org/phorum/read.php?3,5046 $def->addAttribute('img', 'usemap', 'CDATA'); // Add map tag $map = $def->addElement( 'map', 'Block', 'Flow', 'Common', array( 'name' => 'CDATA', ) ); $map->excludes = array('map' => true); // Add area tag $area = $def->addElement( 'area', 'Block', 'Empty', 'Common', array( 'name' => 'CDATA', 'alt' => 'Text', 'coords' => 'CDATA', 'accesskey' => 'Character', 'nohref' => new HTMLPurifier_AttrDef_Enum(array('nohref')), 'href' => 'URI', 'shape' => new HTMLPurifier_AttrDef_Enum(array('rect','circle','poly','default')), 'tabindex' => 'Number', ) ); $area->excludes = array('area' => true); // Allow button tags $def->addElement('button', 'Inline', 'Inline', 'Common'); } $purifier = new HTMLPurifier($config); return $purifier->purify($text); } /** * Like clean_html(), but for CSS stylesheets! (May not be secure for CSS directly * in an HTML document a la '); // The "style" blocks are stored seperately $output_css = $purifier->context->get('StyleBlocks'); // Get the first style block if (is_array($output_css) && count($output_css)) { return $output_css[0]; } return ''; } /** * Given HTML, converts and formats it as text * * @param string $html The html to be formatted * @return string The formatted text */ function html2text($html, $fragment=true) { require_once('htmltotext/htmltotext.php'); if ($fragment) { $html = '' . $html; } $h2t = new HtmltoText($html, get_config('wwwroot')); return $h2t->text(); } /** * Displays purified html on a page with an explanatory message. * * @param string $html The purified html. * @param string $filename The filename to serve the file as * @param array $params Parameters previously passed to serve_file */ function display_cleaned_html($html, $filename, $params) { $smarty = smarty_core(); $smarty->assign('params', $params); if ($params['owner']) { $smarty->assign('htmlremovedmessage', get_string('htmlremovedmessage', 'artefact.file', hsc($filename), profile_url((int) $params['owner']), hsc(display_name($params['owner'])))); } else { $smarty->assign('htmlremovedmessage', get_string('htmlremovedmessagenoowner', 'artefact.file', hsc($filename))); } $smarty->assign('content', $html); $smarty->display('cleanedhtml.tpl'); exit; } /** * Takes a string and a length, and ensures that the string is no longer than * this length, by putting '...' in it somewhere. * * It also strips all tags except
and
.
*
* This version is appropriate for use on HTML. See str_shorten_text() for use
* on text strings.
*
* @param string $str The string to shorten
* @param int $maxlen The maximum length the new string should be (default 100)
* @param bool $truncate If true, cut the string at the end rather than in the middle (default false)
* @param bool $newlines If false, cut off after the first newline (default true)
* @param bool $usenl2br if false, only do HTML-escapes (default true)
* @return string
*/
function str_shorten_html($str, $maxlen=100, $truncate=false, $newlines=true, $usenl2br=true) {
if (empty($str)) {
return $str;
}
if (!$newlines) {
$nextbreak = strpos($str, '';
if ($params['limit'] && ($params['limit'] < $params['count'])) {
$pages = ceil($params['count'] / $params['limit']);
$page = $params['offset'] / $params['limit'];
$last = $pages - 1;
if (!empty($params['lastpage'])) {
$page = $last;
}
$prev = max(0, $page - 1);
$next = min($last, $page + 1);
// Build a list of what pagenumbers will be put between the previous/next links
$pagenumbers = array();
// First page
if ($params['numbersincludefirstlast']) {
$pagenumbers[] = 0;
}
$maxjumplinks = isset($params['jumplinks']) ? (int) $params['jumplinks'] : 0;
// Jump pages between first page and current page
$betweencount = $page;
$jumplinks = $pages ? round($maxjumplinks * ($betweencount / $pages)) : 0;
$jumpcount = $jumplinks ? round($betweencount / ($jumplinks + 1)) : 0;
$gapcount = 1;
if ($jumpcount > 1) {
for ($bc = 1; $bc < $betweencount; $bc++) {
if ($gapcount > $jumpcount) {
$pagenumbers[] = $bc;
$gapcount = 1;
}
$gapcount++;
}
}
// Current page with adjacent prev and next pages
if ($params['numbersincludeprevnext'] > 0) {
for ($i = 1; $i <= $params['numbersincludeprevnext']; $i++) {
$prevlink = $page - $i;
if ($prevlink < 0) {
break;
}
$pagenumbers[] = $prevlink;
}
unset($prevlink);
}
$pagenumbers[] = $page;
if ($params['numbersincludeprevnext'] > 0) {
for ($i = 1; $i <= $params['numbersincludeprevnext']; $i++) {
$nextlink = $page + $i;
if ($nextlink > $last) {
break;
}
$pagenumbers[] = $nextlink;
}
}
// Jump pages between current and last
$betweencount = $pages - $page;
$jumplinks = $pages ? round($maxjumplinks * ($betweencount / $pages)) : 0;
$jumpcount = $jumplinks ? round($betweencount / ($jumplinks + 1)) : 0;
$gapcount = 1;
if ($jumpcount > 1) {
for ($bc = $page; $bc < $last; $bc++) {
if ($gapcount > $jumpcount) {
$pagenumbers[] = $bc;
$gapcount = 1;
}
$gapcount++;
}
}
// Last page
if ($params['numbersincludefirstlast']) {
$pagenumbers[] = $last;
}
$pagenumbers = array_unique($pagenumbers);
sort($pagenumbers);
// Build the first/previous links
$isfirst = $page == 0;
$output .= build_pagination_pagelink(
'',
'«',
get_string('prevpage'),
$isfirst,
$params['url'],
$params['setlimit'],
$params['limit'],
$params['limit'] * $prev,
$params['offsetname']
);
// Build the pagenumbers in the middle
foreach ($pagenumbers as $k => $i) {
// add ellipsis if pages skipped
$text = $i + 1;
if ($k != 0 && $prevpagenum < $i - 1) {
$text = '' . ($i + 1);
}
if ($i == $page) {
$output .= build_pagination_pagelink('active', $text, '', true);
}
else {
$output .= build_pagination_pagelink(
'',
$text,
'',
false,
$params['url'],
$params['setlimit'],
$params['limit'],
$params['limit'] * $i,
$params['offsetname']
);
}
$prevpagenum = $i;
}
// Build the next/last links
$islast = $page == $last;
$output .= build_pagination_pagelink(
'',
' »',
get_string('nextpage'),
$islast,
$params['url'],
$params['setlimit'],
$params['limit'],
$params['limit'] * $next,
$params['offsetname']
);
}
// Build limitoptions dropbox if results are more than 10 (minimum dropbox pagination) and that we are not in the block editor screen
if ($params['setlimit'] && $params['count'] > 10 && (!isset($params['editing']) || $params['editing'] === false)) {
$strlimitoptions = array();
$limit = $params['limit'];
for ($i = 0; $i < count($limitoptions); $i++) {
if ($limit == $limitoptions[$i]) {
$strlimitoptions[] = "";
}
else {
$strlimitoptions[] = "";
}
}
$output .= '
';
$output .= '';
}
// if $params['count'] is less than 10 add the setlimitselect as a hidden field so that elasticsearch js can access it
else if ($params['setlimit']) {
$output .= '';
}
// Work out what javascript we need for the paginator
$js = '';
$id = json_encode($params['id']);
if (isset($params['jsonscript']) && isset($params['datatable'])) {
$paginator_js = hsc(get_config('wwwroot') . 'js/paginator.js');
$datatable = json_encode($params['datatable']);
if (!empty($params['searchresultsheading'])) {
$heading = json_encode($params['searchresultsheading']);
}
else {
$heading = 'null';
}
$jsonscript = json_encode($params['jsonscript']);
$extradata = json_encode($params['extradata']);
$js .= "new Paginator($id, $datatable, $heading, $jsonscript, $extradata);";
}
else {
$extradata = null;
$js .= "new Paginator($id, null, null, null, null);";
}
// Close the container div
$output .= ' tag of the icon we want
*/
function display_icon($type, $id = false, $title = "") {
global $THEME;
switch ($type) {
case 'on':
case 'yes':
case 'success':
case 'true':
case 'enabled':
case 'enabledspecific':
$image = 'icon icon-lg icon-check text-success ';
break;
case 'off':
case 'no':
case 'fail':
case 'false':
case 'disabled':
case 'disabledspecific':
$image = 'icon icon-lg icon-times text-danger ';
break;
}
$title = empty($title) ? get_string($type) : hsc($title);
$html = ' $url,
CURLOPT_HEADER => true,
CURLOPT_NOBODY => true,
CURLOPT_CONNECTTIMEOUT => 2,
),
true
);
if (!$result || $result->error || $result->info['http_code'] == 404) {
return false;
}
return true;
}