. /** * This contains functions and classes that will be used by scripts in wiki module * * @package mod_wiki * @copyright 2009 Marc Alier, Jordi Piguillem marc.alier@upc.edu * @copyright 2009 Universitat Politecnica de Catalunya http://www.upc.edu * * @author Jordi Piguillem * @author Marc Alier * @author David Jimenez * @author Josep Arus * @author Daniel Serrano * @author Kenneth Riba * * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ require_once($CFG->dirroot . '/mod/wiki/lib.php'); require_once($CFG->dirroot . '/mod/wiki/parser/parser.php'); require_once($CFG->libdir . '/filelib.php'); define('WIKI_REFRESH_CACHE_TIME', 30); // @TODO: To be deleted. define('FORMAT_CREOLE', '37'); define('FORMAT_NWIKI', '38'); define('NO_VALID_RATE', '-999'); define('IMPROVEMENT', '+'); define('EQUAL', '='); define('WORST', '-'); define('LOCK_TIMEOUT', 30); /** * Get a wiki instance * @param int $wikiid the instance id of wiki */ function wiki_get_wiki($wikiid) { global $DB; return $DB->get_record('wiki', array('id' => $wikiid)); } /** * Get sub wiki instances with same wiki id * @param int $wikiid */ function wiki_get_subwikis($wikiid) { global $DB; return $DB->get_records('wiki_subwikis', array('wikiid' => $wikiid)); } /** * Get a sub wiki instance by wiki id and group id * @param int $wikiid * @param int $groupid * @return object */ function wiki_get_subwiki_by_group($wikiid, $groupid, $userid = 0) { global $DB; return $DB->get_record('wiki_subwikis', array('wikiid' => $wikiid, 'groupid' => $groupid, 'userid' => $userid)); } /** * Get a sub wiki instace by instance id * @param int $subwikiid * @return object */ function wiki_get_subwiki($subwikiid) { global $DB; return $DB->get_record('wiki_subwikis', array('id' => $subwikiid)); } /** * Add a new sub wiki instance * @param int $wikiid * @param int $groupid * @return int $insertid */ function wiki_add_subwiki($wikiid, $groupid, $userid = 0) { global $DB; $record = new StdClass(); $record->wikiid = $wikiid; $record->groupid = $groupid; $record->userid = $userid; $insertid = $DB->insert_record('wiki_subwikis', $record); return $insertid; } /** * Get a wiki instance by pageid * @param int $pageid * @return object */ function wiki_get_wiki_from_pageid($pageid) { global $DB; $sql = "SELECT w.* FROM {wiki} w, {wiki_subwikis} s, {wiki_pages} p WHERE p.id = ? AND p.subwikiid = s.id AND s.wikiid = w.id"; return $DB->get_record_sql($sql, array($pageid)); } /** * Get a wiki page by pageid * @param int $pageid * @return object */ function wiki_get_page($pageid) { global $DB; return $DB->get_record('wiki_pages', array('id' => $pageid)); } /** * Get latest version of wiki page * @param int $pageid * @return object */ function wiki_get_current_version($pageid) { global $DB; // @TODO: Fix this query $sql = "SELECT * FROM {wiki_versions} WHERE pageid = ? ORDER BY version DESC"; $records = $DB->get_records_sql($sql, array($pageid), 0, 1); return array_pop($records); } /** * Alias of wiki_get_current_version * @TODO, does the exactly same thing as wiki_get_current_version, should be removed * @param int $pageid * @return object */ function wiki_get_last_version($pageid) { return wiki_get_current_version($pageid); } /** * Get page section * @param int $pageid * @param string $section */ function wiki_get_section_page($page, $section) { $version = wiki_get_current_version($page->id); return wiki_parser_proxy::get_section($version->content, $version->contentformat, $section); } /** * Get a wiki page by page title * @param int $swid, sub wiki id * @param string $title * @return object */ function wiki_get_page_by_title($swid, $title) { global $DB; return $DB->get_record('wiki_pages', array('subwikiid' => $swid, 'title' => $title)); } /** * Get a version record by record id * @param int $versionid, the version id * @return object */ function wiki_get_version($versionid) { global $DB; return $DB->get_record('wiki_versions', array('id' => $versionid)); } /** * Get first page of wiki instace * @param int $subwikiid * @param int $module, wiki instance object */ function wiki_get_first_page($subwikid, $module = null) { global $DB, $USER; $sql = "SELECT p.* FROM {wiki} w, {wiki_subwikis} s, {wiki_pages} p WHERE s.id = ? AND s.wikiid = w.id AND w.firstpagetitle = p.title AND p.subwikiid = s.id"; return $DB->get_record_sql($sql, array($subwikid)); } function wiki_save_section($wikipage, $sectiontitle, $sectioncontent, $userid) { $wiki = wiki_get_wiki_from_pageid($wikipage->id); $cm = get_coursemodule_from_instance('wiki', $wiki->id); $context = context_module::instance($cm->id); if (has_capability('mod/wiki:editpage', $context)) { $version = wiki_get_current_version($wikipage->id); $content = wiki_parser_proxy::get_section($version->content, $version->contentformat, $sectiontitle, true); $newcontent = $content[0] . $sectioncontent . $content[2]; return wiki_save_page($wikipage, $newcontent, $userid); } else { return false; } } /** * Save page content * @param object $wikipage * @param string $newcontent * @param int $userid */ function wiki_save_page($wikipage, $newcontent, $userid) { global $DB; $wiki = wiki_get_wiki_from_pageid($wikipage->id); $cm = get_coursemodule_from_instance('wiki', $wiki->id); $context = context_module::instance($cm->id); if (has_capability('mod/wiki:editpage', $context)) { $version = wiki_get_current_version($wikipage->id); $version->content = $newcontent; $version->userid = $userid; $version->version++; $version->timecreated = time(); $version->id = $DB->insert_record('wiki_versions', $version); $wikipage->timemodified = $version->timecreated; $wikipage->userid = $userid; $return = wiki_refresh_cachedcontent($wikipage, $newcontent); $event = \mod_wiki\event\page_updated::create( array( 'context' => $context, 'objectid' => $wikipage->id, 'relateduserid' => $userid, 'other' => array( 'newcontent' => $newcontent ) )); $event->add_record_snapshot('wiki', $wiki); $event->add_record_snapshot('wiki_pages', $wikipage); $event->add_record_snapshot('wiki_versions', $version); $event->trigger(); return $return; } else { return false; } } function wiki_refresh_cachedcontent($page, $newcontent = null) { global $DB; $version = wiki_get_current_version($page->id); if (empty($version)) { return null; } if (!isset($newcontent)) { $newcontent = $version->content; } $options = array('swid' => $page->subwikiid, 'pageid' => $page->id); $parseroutput = wiki_parse_content($version->contentformat, $newcontent, $options); $page->cachedcontent = $parseroutput['toc'] . $parseroutput['parsed_text']; $page->timerendered = time(); $DB->update_record('wiki_pages', $page); wiki_refresh_page_links($page, $parseroutput['link_count']); return array('page' => $page, 'sections' => $parseroutput['repeated_sections'], 'version' => $version->version); } /** * Restore a page with specified version. * * @param stdClass $wikipage wiki page record * @param stdClass $version wiki page version to restore * @param context_module $context context of wiki module * @return stdClass restored page */ function wiki_restore_page($wikipage, $version, $context) { $return = wiki_save_page($wikipage, $version->content, $version->userid); $event = \mod_wiki\event\page_version_restored::create( array( 'context' => $context, 'objectid' => $version->id, 'other' => array( 'pageid' => $wikipage->id ) )); $event->add_record_snapshot('wiki_versions', $version); $event->trigger(); return $return['page']; } function wiki_refresh_page_links($page, $links) { global $DB; $DB->delete_records('wiki_links', array('frompageid' => $page->id)); foreach ($links as $linkname => $linkinfo) { $newlink = new stdClass(); $newlink->subwikiid = $page->subwikiid; $newlink->frompageid = $page->id; if ($linkinfo['new']) { $newlink->tomissingpage = $linkname; } else { $newlink->topageid = $linkinfo['pageid']; } try { $DB->insert_record('wiki_links', $newlink); } catch (dml_exception $e) { debugging($e->getMessage()); } } } /** * Create a new wiki page, if the page exists, return existing pageid * @param int $swid * @param string $title * @param string $format * @param int $userid */ function wiki_create_page($swid, $title, $format, $userid) { global $DB; $subwiki = wiki_get_subwiki($swid); $cm = get_coursemodule_from_instance('wiki', $subwiki->wikiid); $context = context_module::instance($cm->id); require_capability('mod/wiki:editpage', $context); // if page exists if ($page = wiki_get_page_by_title($swid, $title)) { return $page->id; } // Creating a new empty version $version = new stdClass(); $version->content = ''; $version->contentformat = $format; $version->version = 0; $version->timecreated = time(); $version->userid = $userid; $versionid = null; $versionid = $DB->insert_record('wiki_versions', $version); // Createing a new empty page $page = new stdClass(); $page->subwikiid = $swid; $page->title = $title; $page->cachedcontent = ''; $page->timecreated = $version->timecreated; $page->timemodified = $version->timecreated; $page->timerendered = $version->timecreated; $page->userid = $userid; $page->pageviews = 0; $page->readonly = 0; $pageid = $DB->insert_record('wiki_pages', $page); // Setting the pageid $version->id = $versionid; $version->pageid = $pageid; $DB->update_record('wiki_versions', $version); $event = \mod_wiki\event\page_created::create( array( 'context' => $context, 'objectid' => $pageid ) ); $event->trigger(); wiki_make_cache_expire($page->title); return $pageid; } function wiki_make_cache_expire($pagename) { global $DB; $sql = "UPDATE {wiki_pages} SET timerendered = 0 WHERE id IN ( SELECT l.frompageid FROM {wiki_links} l WHERE l.tomissingpage = ? )"; $DB->execute ($sql, array($pagename)); } /** * Get a specific version of page * @param int $pageid * @param int $version */ function wiki_get_wiki_page_version($pageid, $version) { global $DB; return $DB->get_record('wiki_versions', array('pageid' => $pageid, 'version' => $version)); } /** * Get version list * @param int $pageid * @param int $limitfrom * @param int $limitnum */ function wiki_get_wiki_page_versions($pageid, $limitfrom, $limitnum) { global $DB; return $DB->get_records('wiki_versions', array('pageid' => $pageid), 'version DESC', '*', $limitfrom, $limitnum); } /** * Count the number of page version * @param int $pageid */ function wiki_count_wiki_page_versions($pageid) { global $DB; return $DB->count_records('wiki_versions', array('pageid' => $pageid)); } /** * Get linked from page * @param int $pageid */ function wiki_get_linked_to_pages($pageid) { global $DB; return $DB->get_records('wiki_links', array('frompageid' => $pageid)); } /** * Get linked from page * @param int $pageid */ function wiki_get_linked_from_pages($pageid) { global $DB; return $DB->get_records('wiki_links', array('topageid' => $pageid)); } /** * Get pages which user have been edited * @param int $swid * @param int $userid */ function wiki_get_contributions($swid, $userid) { global $DB; $sql = "SELECT v.* FROM {wiki_versions} v, {wiki_pages} p WHERE p.subwikiid = ? AND v.pageid = p.id AND v.userid = ?"; return $DB->get_records_sql($sql, array($swid, $userid)); } /** * Get missing or empty pages in wiki * @param int $swid sub wiki id */ function wiki_get_missing_or_empty_pages($swid) { global $DB; $sql = "SELECT DISTINCT p.title, p.id, p.subwikiid FROM {wiki} w, {wiki_subwikis} s, {wiki_pages} p WHERE s.wikiid = w.id and s.id = ? and w.firstpagetitle != p.title and p.subwikiid = ? and 1 = (SELECT count(*) FROM {wiki_versions} v WHERE v.pageid = p.id) UNION SELECT DISTINCT l.tomissingpage as title, 0 as id, l.subwikiid FROM {wiki_links} l WHERE l.subwikiid = ? and l.topageid = 0"; return $DB->get_records_sql($sql, array($swid, $swid, $swid)); } /** * Get pages list in wiki * @param int $swid sub wiki id */ function wiki_get_page_list($swid) { global $DB; $records = $DB->get_records('wiki_pages', array('subwikiid' => $swid), 'title ASC'); return $records; } /** * Return a list of orphaned wikis for one specific subwiki * @global object * @param int $swid sub wiki id */ function wiki_get_orphaned_pages($swid) { global $DB; $sql = "SELECT p.id, p.title FROM {wiki_pages} p, {wiki} w , {wiki_subwikis} s WHERE p.subwikiid = ? AND s.id = ? AND w.id = s.wikiid AND p.title != w.firstpagetitle AND p.id NOT IN (SELECT topageid FROM {wiki_links} WHERE subwikiid = ?)"; return $DB->get_records_sql($sql, array($swid, $swid, $swid)); } /** * Search wiki title * @param int $swid sub wiki id * @param string $search */ function wiki_search_title($swid, $search) { global $DB; return $DB->get_records_select('wiki_pages', "subwikiid = ? AND title LIKE ?", array($swid, '%'.$search.'%')); } /** * Search wiki content * @param int $swid sub wiki id * @param string $search */ function wiki_search_content($swid, $search) { global $DB; return $DB->get_records_select('wiki_pages', "subwikiid = ? AND cachedcontent LIKE ?", array($swid, '%'.$search.'%')); } /** * Search wiki title and content * @param int $swid sub wiki id * @param string $search */ function wiki_search_all($swid, $search) { global $DB; return $DB->get_records_select('wiki_pages', "subwikiid = ? AND (cachedcontent LIKE ? OR title LIKE ?)", array($swid, '%'.$search.'%', '%'.$search.'%')); } /** * Get user data */ function wiki_get_user_info($userid) { global $DB; return $DB->get_record('user', array('id' => $userid)); } /** * Increase page view nubmer * @param int $page, database record */ function wiki_increment_pageviews($page) { global $DB; $page->pageviews++; $DB->update_record('wiki_pages', $page); } //---------------------------------------------------------- //---------------------------------------------------------- /** * Text format supported by wiki module */ function wiki_get_formats() { return array('html', 'creole', 'nwiki'); } /** * Parses a string with the wiki markup language in $markup. * * @return Array or false when something wrong has happened. * * Returned array contains the following fields: * 'parsed_text' => String. Contains the parsed wiki content. * 'unparsed_text' => String. Constains the original wiki content. * 'link_count' => Array of array('destination' => ..., 'new' => "is new?"). Contains the internal wiki links found in the wiki content. * 'deleted_sections' => the list of deleted sections. * '' => * * @author Josep Arús Pous **/ function wiki_parse_content($markup, $pagecontent, $options = array()) { global $PAGE; $subwiki = wiki_get_subwiki($options['swid']); $cm = get_coursemodule_from_instance("wiki", $subwiki->wikiid); $context = context_module::instance($cm->id); $parser_options = array( 'link_callback' => '/mod/wiki/locallib.php:wiki_parser_link', 'link_callback_args' => array('swid' => $options['swid']), 'table_callback' => '/mod/wiki/locallib.php:wiki_parser_table', 'real_path_callback' => '/mod/wiki/locallib.php:wiki_parser_real_path', 'real_path_callback_args' => array( 'context' => $context, 'component' => 'mod_wiki', 'filearea' => 'attachments', 'subwikiid'=> $subwiki->id, 'pageid' => $options['pageid'] ), 'pageid' => $options['pageid'], 'pretty_print' => (isset($options['pretty_print']) && $options['pretty_print']), 'printable' => (isset($options['printable']) && $options['printable']) ); return wiki_parser_proxy::parse($pagecontent, $markup, $parser_options); } /** * This function is the parser callback to parse wiki links. * * It returns the necesary information to print a link. * * NOTE: Empty pages and non-existent pages must be print in red color. * * !!!!!! IMPORTANT !!!!!! * It is critical that you call format_string on the content before it is used. * * @param string|page_wiki $link name of a page * @param array $options * @return array Array('content' => string, 'url' => string, 'new' => bool, 'link_info' => array) * * @TODO Doc return and options */ function wiki_parser_link($link, $options = null) { global $CFG; if (is_object($link)) { $parsedlink = array('content' => $link->title, 'url' => $CFG->wwwroot . '/mod/wiki/view.php?pageid=' . $link->id, 'new' => false, 'link_info' => array('link' => $link->title, 'pageid' => $link->id, 'new' => false)); $version = wiki_get_current_version($link->id); if ($version->version == 0) { $parsedlink['new'] = true; } return $parsedlink; } else { $swid = $options['swid']; if ($page = wiki_get_page_by_title($swid, $link)) { $parsedlink = array('content' => $link, 'url' => $CFG->wwwroot . '/mod/wiki/view.php?pageid=' . $page->id, 'new' => false, 'link_info' => array('link' => $link, 'pageid' => $page->id, 'new' => false)); $version = wiki_get_current_version($page->id); if ($version->version == 0) { $parsedlink['new'] = true; } return $parsedlink; } else { return array('content' => $link, 'url' => $CFG->wwwroot . '/mod/wiki/create.php?swid=' . $swid . '&title=' . urlencode($link) . '&action=new', 'new' => true, 'link_info' => array('link' => $link, 'new' => true, 'pageid' => 0)); } } } /** * Returns the table fully parsed (HTML) * * @return HTML for the table $table * @author Josep Arús Pous * **/ function wiki_parser_table($table) { global $OUTPUT; $htmltable = new html_table(); $headers = $table[0]; $htmltable->head = array(); foreach ($headers as $h) { $htmltable->head[] = $h[1]; } array_shift($table); $htmltable->data = array(); foreach ($table as $row) { $row_data = array(); foreach ($row as $r) { $row_data[] = $r[1]; } $htmltable->data[] = $row_data; } return html_writer::table($htmltable); } /** * Returns an absolute path link, unless there is no such link. * * @param string $url Link's URL or filename * @param stdClass $context filearea params * @param string $component The component the file is associated with * @param string $filearea The filearea the file is stored in * @param int $swid Sub wiki id * * @return string URL for files full path */ function wiki_parser_real_path($url, $context, $component, $filearea, $swid) { global $CFG; if (preg_match("/^(?:http|ftp)s?\:\/\//", $url)) { return $url; } else { $file = 'pluginfile.php'; if (!$CFG->slasharguments) { $file = $file . '?file='; } $baseurl = "$CFG->wwwroot/$file/{$context->id}/$component/$filearea/$swid/"; // it is a file in current file area return $baseurl . $url; } } /** * Returns the token used by a wiki language to represent a given tag or "object" (bold -> **) * * @return A string when it has only one token at the beginning (f. ex. lists). An array composed by 2 strings when it has 2 tokens, one at the beginning and one at the end (f. ex. italics). Returns false otherwise. * @author Josep Arús Pous **/ function wiki_parser_get_token($markup, $name) { return wiki_parser_proxy::get_token($name, $markup); } /** * Checks if current user can view a subwiki * * @param stdClass $subwiki usually record from {wiki_subwikis}. Must contain fields 'wikiid', 'groupid', 'userid'. * If it also contains fields 'course' and 'groupmode' from table {wiki} it will save extra DB query. * @param stdClass $wiki optional wiki object if known * @return bool */ function wiki_user_can_view($subwiki, $wiki = null) { global $USER; if (empty($wiki) || $wiki->id != $subwiki->wikiid) { $wiki = wiki_get_wiki($subwiki->wikiid); } $modinfo = get_fast_modinfo($wiki->course); if (!isset($modinfo->instances['wiki'][$subwiki->wikiid])) { // Module does not exist. return false; } $cm = $modinfo->instances['wiki'][$subwiki->wikiid]; if (!$cm->uservisible) { // The whole module is not visible to the current user. return false; } $context = context_module::instance($cm->id); // Working depending on activity groupmode switch (groups_get_activity_groupmode($cm)) { case NOGROUPS: if ($wiki->wikimode == 'collaborative') { // Collaborative Mode: // There is one wiki for all the class. // // Only view capbility needed return has_capability('mod/wiki:viewpage', $context); } else if ($wiki->wikimode == 'individual') { // Individual Mode: // Each person owns a wiki. if ($subwiki->userid == $USER->id) { // Only the owner of the wiki can view it return has_capability('mod/wiki:viewpage', $context); } else { // User has special capabilities // User must have: // mod/wiki:viewpage capability // and // mod/wiki:managewiki capability $view = has_capability('mod/wiki:viewpage', $context); $manage = has_capability('mod/wiki:managewiki', $context); return $view && $manage; } } else { //Error return false; } case SEPARATEGROUPS: // Collaborative and Individual Mode // // Collaborative Mode: // There is one wiki per group. // Individual Mode: // Each person owns a wiki. if ($wiki->wikimode == 'collaborative' || $wiki->wikimode == 'individual') { // Only members of subwiki group could view that wiki if (in_array($subwiki->groupid, $modinfo->get_groups($cm->groupingid))) { // Only view capability needed return has_capability('mod/wiki:viewpage', $context); } else { // User is not part of that group // User must have: // mod/wiki:managewiki capability // or // moodle/site:accessallgroups capability // and // mod/wiki:viewpage capability $view = has_capability('mod/wiki:viewpage', $context); $manage = has_capability('mod/wiki:managewiki', $context); $access = has_capability('moodle/site:accessallgroups', $context); return ($manage || $access) && $view; } } else { //Error return false; } case VISIBLEGROUPS: // Collaborative and Individual Mode // // Collaborative Mode: // There is one wiki per group. // Individual Mode: // Each person owns a wiki. if ($wiki->wikimode == 'collaborative' || $wiki->wikimode == 'individual') { // Everybody can read all wikis // // Only view capability needed return has_capability('mod/wiki:viewpage', $context); } else { //Error return false; } default: // Error return false; } } /** * Checks if current user can edit a subwiki * * @param $subwiki */ function wiki_user_can_edit($subwiki) { global $USER; $wiki = wiki_get_wiki($subwiki->wikiid); $cm = get_coursemodule_from_instance('wiki', $wiki->id); $context = context_module::instance($cm->id); // Working depending on activity groupmode switch (groups_get_activity_groupmode($cm)) { case NOGROUPS: if ($wiki->wikimode == 'collaborative') { // Collaborative Mode: // There is a wiki for all the class. // // Only edit capbility needed return has_capability('mod/wiki:editpage', $context); } else if ($wiki->wikimode == 'individual') { // Individual Mode // There is a wiki per user // Only the owner of that wiki can edit it if ($subwiki->userid == $USER->id) { return has_capability('mod/wiki:editpage', $context); } else { // Current user is not the owner of that wiki. // User must have: // mod/wiki:editpage capability // and // mod/wiki:managewiki capability $edit = has_capability('mod/wiki:editpage', $context); $manage = has_capability('mod/wiki:managewiki', $context); return $edit && $manage; } } else { //Error return false; } case SEPARATEGROUPS: if ($wiki->wikimode == 'collaborative') { // Collaborative Mode: // There is one wiki per group. // // Only members of subwiki group could edit that wiki if (groups_is_member($subwiki->groupid)) { // Only edit capability needed return has_capability('mod/wiki:editpage', $context); } else { // User is not part of that group // User must have: // mod/wiki:managewiki capability // and // moodle/site:accessallgroups capability // and // mod/wiki:editpage capability $manage = has_capability('mod/wiki:managewiki', $context); $access = has_capability('moodle/site:accessallgroups', $context); $edit = has_capability('mod/wiki:editpage', $context); return $manage && $access && $edit; } } else if ($wiki->wikimode == 'individual') { // Individual Mode: // Each person owns a wiki. // // Only the owner of that wiki can edit it if ($subwiki->userid == $USER->id) { return has_capability('mod/wiki:editpage', $context); } else { // Current user is not the owner of that wiki. // User must have: // mod/wiki:managewiki capability // and // moodle/site:accessallgroups capability // and // mod/wiki:editpage capability $manage = has_capability('mod/wiki:managewiki', $context); $access = has_capability('moodle/site:accessallgroups', $context); $edit = has_capability('mod/wiki:editpage', $context); return $manage && $access && $edit; } } else { //Error return false; } case VISIBLEGROUPS: if ($wiki->wikimode == 'collaborative') { // Collaborative Mode: // There is one wiki per group. // // Only members of subwiki group could edit that wiki if (groups_is_member($subwiki->groupid)) { // Only edit capability needed return has_capability('mod/wiki:editpage', $context); } else { // User is not part of that group // User must have: // mod/wiki:managewiki capability // and // mod/wiki:editpage capability $manage = has_capability('mod/wiki:managewiki', $context); $edit = has_capability('mod/wiki:editpage', $context); return $manage && $edit; } } else if ($wiki->wikimode == 'individual') { // Individual Mode: // Each person owns a wiki. // // Only the owner of that wiki can edit it if ($subwiki->userid == $USER->id) { return has_capability('mod/wiki:editpage', $context); } else { // Current user is not the owner of that wiki. // User must have: // mod/wiki:managewiki capability // and // mod/wiki:editpage capability $manage = has_capability('mod/wiki:managewiki', $context); $edit = has_capability('mod/wiki:editpage', $context); return $manage && $edit; } } else { //Error return false; } default: // Error return false; } } //---------------- // Locks //---------------- /** * Checks if a page-section is locked. * * @return true if the combination of section and page is locked, FALSE otherwise. */ function wiki_is_page_section_locked($pageid, $userid, $section = null) { global $DB; $sql = "pageid = ? AND lockedat > ? AND userid != ?"; $params = array($pageid, time(), $userid); if (!empty($section)) { $sql .= " AND (sectionname = ? OR sectionname IS null)"; $params[] = $section; } return $DB->record_exists_select('wiki_locks', $sql, $params); } /** * Inserts or updates a wiki_locks record. */ function wiki_set_lock($pageid, $userid, $section = null, $insert = false) { global $DB; if (wiki_is_page_section_locked($pageid, $userid, $section)) { return false; } $params = array('pageid' => $pageid, 'userid' => $userid, 'sectionname' => $section); $lock = $DB->get_record('wiki_locks', $params); if (!empty($lock)) { $DB->update_record('wiki_locks', array('id' => $lock->id, 'lockedat' => time() + LOCK_TIMEOUT)); } else if ($insert) { $DB->insert_record('wiki_locks', array('pageid' => $pageid, 'sectionname' => $section, 'userid' => $userid, 'lockedat' => time() + 30)); } return true; } /** * Deletes wiki_locks that are not in use. (F.Ex. after submitting the changes). If no userid is present, it deletes ALL the wiki_locks of a specific page. * * @param int $pageid page id. * @param int $userid id of user for which lock is deleted. * @param string $section section to be deleted. * @param bool $delete_from_db deleted from db. * @param bool $delete_section_and_page delete section and page version. */ function wiki_delete_locks($pageid, $userid = null, $section = null, $delete_from_db = true, $delete_section_and_page = false) { global $DB; $wiki = wiki_get_wiki_from_pageid($pageid); $cm = get_coursemodule_from_instance('wiki', $wiki->id); $context = context_module::instance($cm->id); $params = array('pageid' => $pageid); if (!empty($userid)) { $params['userid'] = $userid; } if (!empty($section)) { $params['sectionname'] = $section; } if ($delete_from_db) { $DB->delete_records('wiki_locks', $params); if ($delete_section_and_page && !empty($section)) { $params['sectionname'] = null; $DB->delete_records('wiki_locks', $params); } $event = \mod_wiki\event\page_locks_deleted::create( array( 'context' => $context, 'objectid' => $pageid, 'relateduserid' => $userid, 'other' => array( 'section' => $section ) )); // No need to add snapshot, as important data is section, userid and pageid, which is part of event. $event->trigger(); } else { $DB->set_field('wiki_locks', 'lockedat', time(), $params); } } /** * Deletes wiki_locks that expired 1 hour ago. */ function wiki_delete_old_locks() { global $DB; $DB->delete_records_select('wiki_locks', "lockedat < ?", array(time() - 3600)); } /** * Deletes wiki_links. It can be sepecific link or links attached in subwiki * * @global mixed $DB database object * @param int $linkid id of the link to be deleted * @param int $topageid links to the specific page * @param int $frompageid links from specific page * @param int $subwikiid links to subwiki */ function wiki_delete_links($linkid = null, $topageid = null, $frompageid = null, $subwikiid = null) { global $DB; $params = array(); // if link id is givien then don't check for anything else if (!empty($linkid)) { $params['id'] = $linkid; } else { if (!empty($topageid)) { $params['topageid'] = $topageid; } if (!empty($frompageid)) { $params['frompageid'] = $frompageid; } if (!empty($subwikiid)) { $params['subwikiid'] = $subwikiid; } } //Delete links if any params are passed, else nothing to delete. if (!empty($params)) { $DB->delete_records('wiki_links', $params); } } /** * Delete wiki synonyms related to subwikiid or page * * @param int $subwikiid id of sunbwiki * @param int $pageid id of page */ function wiki_delete_synonym($subwikiid, $pageid = null) { global $DB; $params = array('subwikiid' => $subwikiid); if (!is_null($pageid)) { $params['pageid'] = $pageid; } $DB->delete_records('wiki_synonyms', $params, IGNORE_MISSING); } /** * Delete pages and all related data * * @param mixed $context context in which page needs to be deleted. * @param mixed $pageids id's of pages to be deleted * @param int $subwikiid id of the subwiki for which all pages should be deleted */ function wiki_delete_pages($context, $pageids = null, $subwikiid = null) { global $DB, $CFG; if (!empty($pageids) && is_int($pageids)) { $pageids = array($pageids); } else if (!empty($subwikiid)) { $pageids = wiki_get_page_list($subwikiid); } //If there is no pageid then return as we can't delete anything. if (empty($pageids)) { return; } require_once($CFG->dirroot . '/tag/lib.php'); /// Delete page and all it's relevent data foreach ($pageids as $pageid) { if (is_object($pageid)) { $pageid = $pageid->id; } //Delete page comments $comments = wiki_get_comments($context->id, $pageid); foreach ($comments as $commentid => $commentvalue) { wiki_delete_comment($commentid, $context, $pageid); } //Delete page tags $tags = tag_get_tags_array('wiki_pages', $pageid); foreach ($tags as $tagid => $tagvalue) { tag_delete_instance('wiki_pages', $pageid, $tagid); } //Delete Synonym wiki_delete_synonym($subwikiid, $pageid); //Delete all page versions wiki_delete_page_versions(array($pageid=>array(0)), $context); //Delete all page locks wiki_delete_locks($pageid); //Delete all page links wiki_delete_links(null, $pageid); $params = array('id' => $pageid); // Get page before deleting. $page = $DB->get_record('wiki_pages', $params); //Delete page $DB->delete_records('wiki_pages', $params); // Trigger page_deleted event. $event = \mod_wiki\event\page_deleted::create( array( 'context' => $context, 'objectid' => $pageid, 'other' => array('subwikiid' => $subwikiid) )); $event->add_record_snapshot('wiki_pages', $page); $event->trigger(); } } /** * Delete specificed versions of a page or versions created by users * if version is 0 then it will remove all versions of the page * * @param array $deleteversions delete versions for a page * @param context_module $context module context */ function wiki_delete_page_versions($deleteversions, $context = null) { global $DB; /// delete page-versions foreach ($deleteversions as $id => $versions) { $params = array('pageid' => $id); if (is_null($context)) { $wiki = wiki_get_wiki_from_pageid($id); $cm = get_coursemodule_from_instance('wiki', $wiki->id); $context = context_module::instance($cm->id); } // Delete all versions, if version specified is 0. if (in_array(0, $versions)) { $oldversions = $DB->get_records('wiki_versions', $params); $DB->delete_records('wiki_versions', $params, IGNORE_MISSING); } else { list($insql, $param) = $DB->get_in_or_equal($versions); $insql .= ' AND pageid = ?'; array_push($param, $params['pageid']); $oldversions = $DB->get_recordset_select('wiki_versions', 'version ' . $insql, $param); $DB->delete_records_select('wiki_versions', 'version ' . $insql, $param); } foreach ($oldversions as $version) { // Trigger page version deleted event. $event = \mod_wiki\event\page_version_deleted::create( array( 'context' => $context, 'objectid' => $version->id, 'other' => array( 'pageid' => $id ) )); $event->add_record_snapshot('wiki_versions', $version); $event->trigger(); } } } function wiki_get_comment($commentid){ global $DB; return $DB->get_record('comments', array('id' => $commentid)); } /** * Returns all comments by context and pageid * * @param int $contextid Current context id * @param int $pageid Current pageid **/ function wiki_get_comments($contextid, $pageid) { global $DB; return $DB->get_records('comments', array('contextid' => $contextid, 'itemid' => $pageid, 'commentarea' => 'wiki_page'), 'timecreated ASC'); } /** * Add comments ro database * * @param object $context. Current context * @param int $pageid. Current pageid * @param string $content. Content of the comment * @param string editor. Version of editor we are using. **/ function wiki_add_comment($context, $pageid, $content, $editor) { global $CFG; require_once($CFG->dirroot . '/comment/lib.php'); list($context, $course, $cm) = get_context_info_array($context->id); $cmt = new stdclass(); $cmt->context = $context; $cmt->itemid = $pageid; $cmt->area = 'wiki_page'; $cmt->course = $course; $cmt->component = 'mod_wiki'; $manager = new comment($cmt); if ($editor == 'creole') { $manager->add($content, FORMAT_CREOLE); } else if ($editor == 'html') { $manager->add($content, FORMAT_HTML); } else if ($editor == 'nwiki') { $manager->add($content, FORMAT_NWIKI); } } /** * Delete comments from database * * @param $idcomment. Id of comment which will be deleted * @param $context. Current context * @param $pageid. Current pageid **/ function wiki_delete_comment($idcomment, $context, $pageid) { global $CFG; require_once($CFG->dirroot . '/comment/lib.php'); list($context, $course, $cm) = get_context_info_array($context->id); $cmt = new stdClass(); $cmt->context = $context; $cmt->itemid = $pageid; $cmt->area = 'wiki_page'; $cmt->course = $course; $cmt->component = 'mod_wiki'; $manager = new comment($cmt); $manager->delete($idcomment); } /** * Delete al comments from wiki * **/ function wiki_delete_comments_wiki() { global $PAGE, $DB; $cm = $PAGE->cm; $context = context_module::instance($cm->id); $table = 'comments'; $select = 'contextid = ?'; $DB->delete_records_select($table, $select, array($context->id)); } function wiki_add_progress($pageid, $oldversionid, $versionid, $progress) { global $DB; for ($v = $oldversionid + 1; $v <= $versionid; $v++) { $user = wiki_get_wiki_page_id($pageid, $v); $DB->insert_record('wiki_progress', array('userid' => $user->userid, 'pageid' => $pageid, 'versionid' => $v, 'progress' => $progress)); } } function wiki_get_wiki_page_id($pageid, $id) { global $DB; return $DB->get_record('wiki_versions', array('pageid' => $pageid, 'id' => $id)); } function wiki_print_page_content($page, $context, $subwikiid) { global $OUTPUT, $CFG; if ($page->timerendered + WIKI_REFRESH_CACHE_TIME < time()) { $content = wiki_refresh_cachedcontent($page); $page = $content['page']; } if (isset($content)) { $box = ''; foreach ($content['sections'] as $s) { $box .= '
' . get_string('repeatedsection', 'wiki', $s) . '
'; } if (!empty($box)) { echo $OUTPUT->box($box); } } $html = file_rewrite_pluginfile_urls($page->cachedcontent, 'pluginfile.php', $context->id, 'mod_wiki', 'attachments', $subwikiid); $html = format_text($html, FORMAT_MOODLE, array('overflowdiv'=>true, 'allowid'=>true)); echo $OUTPUT->box($html); if (!empty($CFG->usetags)) { $tags = tag_get_tags_array('wiki_pages', $page->id); echo $OUTPUT->container_start('wiki-tags'); echo ' '; $links = array(); foreach ($tags as $tagid=>$tag) { $url = new moodle_url('/tag/index.php', array('tag'=>$tag)); $links[] = html_writer::link($url, $tag, array('title'=>get_string('tagtitle', 'wiki', $tag))); } echo join($links, ", "); echo $OUTPUT->container_end(); } wiki_increment_pageviews($page); } /** * This function trims any given text and returns it with some dots at the end * * @param string $text * @param string $limit * * @return string */ function wiki_trim_string($text, $limit = 25) { if (core_text::strlen($text) > $limit) { $text = core_text::substr($text, 0, $limit) . '...'; } return $text; } /** * Prints default edit form fields and buttons * * @param string $format Edit form format (html, creole...) * @param integer $version Version number. A negative number means no versioning. */ function wiki_print_edit_form_default_fields($format, $pageid, $version = -1, $upload = false, $deleteuploads = array()) { global $CFG, $PAGE, $OUTPUT; echo ''; if ($version >= 0) { echo ''; } echo ''; //attachments require_once($CFG->dirroot . '/lib/form/filemanager.php'); $filemanager = new MoodleQuickForm_filemanager('attachments', get_string('wikiattachments', 'wiki'), array('id' => 'attachments'), array('subdirs' => false, 'maxfiles' => 99, 'maxbytes' => $CFG->maxbytes)); $value = file_get_submitted_draft_itemid('attachments'); if (!empty($value) && !$upload) { $filemanager->setValue($value); } echo ""; echo ''; echo ''; echo ''; echo ''; } /** * Prints a table with the files attached to a wiki page * @param object $context * @param string $filearea * @param int $fileitemid * @param array deleteuploads */ function wiki_print_upload_table($context, $filearea, $fileitemid, $deleteuploads = array()) { global $CFG, $OUTPUT; $htmltable = new html_table(); $htmltable->head = array(get_string('deleteupload', 'wiki'), get_string('uploadname', 'wiki'), get_string('uploadactions', 'wiki')); $fs = get_file_storage(); $files = $fs->get_area_files($context->id, 'mod_wiki', $filearea, $fileitemid); //TODO: this is weird (skodak) foreach ($files as $file) { if (!$file->is_directory()) { $checkbox = 'get_pathnamehash(), $deleteuploads)) { $checkbox .= ' checked="checked"'; } $checkbox .= " />"; $htmltable->data[] = array($checkbox, '' . $file->get_filename() . '', ""); } } print '