Your comment couldn't be posted because you're not logged in. You can login here. Here's the comment you tried to post:

Your comment couldn't be posted because it was too short. $settings->sitename needs at $settings->comment_min_length characters in a comment in order to post it.

Your comment couldn't be posted because it was too long. $settings->sitenamae can only post comments that are up to $settings->comment_max_length characters in length, and yours was $message_length characters. Try splitting it up into multiple comments! Here's the comment you tried to post:

$settings->sitename ran into a problem whilst creating a file to save your comment to! Please contact $settings->admindetails_name, $settings->sitename's administrator and tell them about this problem.

$settings->sitename couldn't post your comment because it couldn't find the parent comment you replied to. It's possible that $settings->admindetails_name, $settings->sitename's administrator, deleted the comment. Here's the comment you tried to post:

$settings->sitename ran into a problem whilst saving your comment to disk! Please contact $settings->admindetails_name, $settings->sitename's administrator and tell them about this problem.

Your comment on $env->page was posted successfully. If your browser doesn't redirect you automagically, please click here to go to the comment you posted on the page you were viewing.

No comments here! Start the conversation above.

You don't have permission to change $settings->sitename's master settings.

You could try logging in.

You could try logging out and then logging in again with a different account that has the appropriate privileges..

Master Control Panel

This page lets you configure $settings->sitename's master settings. Please be careful - you can break things easily on this page if you're not careful!

Mouse over the name of each setting to see a description of what it does.

Master settings updated sucessfully

$settings->sitename's master settings file has been updated successfully. A backup of the original settings has been created under the name peppermint.json.bak, just in case. You can go back and continue editing the master settings file, or you can go to the " . htmlentities($settings->defaultpage) . ".

For reference, the newly generated master settings file is as follows:

Although you can use the edit page to view a page's source, you can also ask $settings->sitename to send you the raw page source and nothing else. This feature is intented for those who want to automate their interaction with $settings->sitename.

To use this feature, navigate to the page for which you want to see the source, and then alter the action parameter in the url's query string to be raw. If the action parameter doesn't exist, add it. Note that when used on an file's page this action will return the source of the description and not the file itself.

History for $env->page

\n"; foreach(array_reverse($pageindex->{$env->page}->history) as $revisionData) { // Only display edits for now if($revisionData->type != "edit") continue; // The number (and the sign) of the size difference to display $size_display = ($revisionData->sizediff > 0 ? "+" : "") . $revisionData->sizediff; $size_display_class = $revisionData->sizediff > 0 ? "larger" : ($revisionData->sizediff < 0 ? "smaller" : "nochange"); if($revisionData->sizediff > 500 or $revisionData->sizediff < -500) $size_display_class .= " significant"; $size_title_display = human_filesize($revisionData->newsize - $revisionData->sizediff) . " -> " . human_filesize($revisionData->newsize); $content .= "
• #$revisionData->rid " . render_editor($revisionData->editor) . " " . render_timestamp($revisionData->timestamp) . " ($size_display)"; } } else { $content .= "

  (None yet! Try editing this page and then coming back here.)

  \n"; } exit(page_renderer::render_main("$env->page - History - $settings->sitename", $content)); }); register_save_preprocessor("history_add_revision"); } ]); function history_add_revision(&$pageinfo, &$newsource, &$oldsource, $save_pageindex = true) { global $pageindex, $paths, $env; if(!isset($pageinfo->history)) $pageinfo->history = []; // Save the *new source* as a revision // This results in 2 copies of the current source, but this is ok // since any time someone changes something, it create a new // revision // Note that we can't save the old source here because we'd have no // clue who edited it since $pageinfo has already been updated by // this point // TODO Store tag changes here $nextRid = count($pageinfo->history); // The next revision id $ridFilename = "$pageinfo->filename.r$nextRid"; // Insert a new entry into the history $pageinfo->history[] = [ "type" => "edit", // We might want to store other types later (e.g. page moves) "rid" => $nextRid, "timestamp" => time(), "filename" => $ridFilename, "newsize" => strlen($newsource), "sizediff" => strlen($newsource) - strlen($oldsource), "editor" => $pageinfo->lasteditor ]; // Save the new source as a revision file_put_contents("$env->storage_prefix$ridFilename", $newsource); // Save the edited pageindex if($save_pageindex) file_put_contents($paths->pageindex, json_encode($pageindex, JSON_PRETTY_PRINT)); } register_module([ "name" => "Recent Changes", "version" => "0.3.3", "author" => "Starbeamrainbowlabs", "description" => "Adds recent changes. Access through the 'recent-changes' action.", "id" => "feature-recent-changes", "code" => function() { global $settings, $env, $paths; /** * @api {get} ?action=recentchanges Get a list of recent changes * @apiName RecentChanges * @apiGroup Stats * @apiPermission Anonymous */ // Add the recent changes json file to $paths for convenience. $paths->recentchanges = $env->storage_prefix . "recent-changes.json"; // Create the recent changes json file if it doesn't exist if(!file_exists($paths->recentchanges)) file_put_contents($paths->recentchanges, "[]"); /* * ██████ ███████ ██████ ███████ ███ ██ ████████ * ██ ██ ██ ██ ██ ████ ██ ██ * ██████ █████ ██ █████ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ███████ ██████ ███████ ██ ████ ██ * * ██████ ██ ██ █████ ███ ██ ██████ ███████ ███████ * ██ ██ ██ ██ ██ ████ ██ ██ ██ ██ * ██ ███████ ███████ ██ ██ ██ ██ ███ █████ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██ ██ ██ ██ ██ ████ ██████ ███████ ███████ */ add_action("recent-changes", function() { global $settings, $paths, $pageindex; $content = "\t\t

  Recent Changes

  \n"; $recent_changes = json_decode(file_get_contents($paths->recentchanges)); if(count($recent_changes) > 0) { $content .= render_recent_changes($recent_changes); } else { // No changes yet :( $content .= "

  None yet! Try making a few changes and then check back here.

  \n"; } exit(page_renderer::render("Recent Changes - $settings->sitename", $content)); }); register_save_preprocessor(function(&$pageinfo, &$newsource, &$oldsource) { global $env, $settings, $paths; // Work out the old and new page lengths $oldsize = strlen($oldsource); $newsize = strlen($newsource); // Calculate the page length difference $size_diff = $newsize - $oldsize; $newchange = [ "type" => "edit", "timestamp" => time(), "page" => $env->page, "user" => $env->user, "newsize" => $newsize, "sizediff" => $size_diff ]; if($oldsize == 0) $newchange["newpage"] = true; add_recent_change($newchange); }); add_help_section("800-raw-page-content", "Recent Changes", "

  The recent changes page displays a list of all the most recent changes that have happened around $settings->sitename, arranged in chronological order. It can be found in the \"More...\" menu in the top right by default.

  Each entry displays the name of the page in question, who edited it, how long ago they did so, and the number of characters added or removed. Pages that currently redirect to another page are shown in italics, and hovering over the time since the edit wil show the exact time that the edit was made.

  "); } ]); /** * Adds a new recent change to the recent changes file. * @param array $rchange The new change to add. */ function add_recent_change($rchange) { global $settings, $paths; $recentchanges = json_decode(file_get_contents($paths->recentchanges), true); array_unshift($recentchanges, $rchange); // Limit the number of entries in the recent changes file if we've // been asked to. if(isset($settings->max_recent_changes)) $recentchanges = array_slice($recentchanges, 0, $settings->max_recent_changes); // Save the recent changes file back to disk file_put_contents($paths->recentchanges, json_encode($recentchanges, JSON_PRETTY_PRINT)); } function render_recent_changes($recent_changes) { global $pageindex; // Cache the number of recent changes we are dealing with $rchange_count = count($recent_changes); // Group changes made on the same page and the same day together for($i = 0; $i < $rchange_count; $i++) { for($s = $i + 1; $s < $rchange_count; $s++) { // Break out if we have reached the end of the day we are scanning if(date("dmY", $recent_changes[$i]->timestamp) !== date("dmY", $recent_changes[$s]->timestamp)) break; // If we have found a change that has been made on the same page and // on the same day as the one that we are scanning for, move it up // next to the change we are scanning for. if($recent_changes[$i]->page == $recent_changes[$s]->page && date("j", $recent_changes[$i]->timestamp) === date("j", $recent_changes[$s]->timestamp)) { // FUTURE: We may need to remove and insert instead of swapping changes around if this causes some changes to appear out of order. $temp = $recent_changes[$i + 1]; $recent_changes[$i + 1] = $recent_changes[$s]; $recent_changes[$s] = $temp; $i++; } } } $content = "
  \n"; $last_time = 0; for($i = 0; $i < $rchange_count; $i++) { $rchange = $recent_changes[$i]; if($last_time !== date("dmY", $rchange->timestamp)) $content .= "

  • " . date("jS F", $rchange->timestamp) . "

  \n"; $rchange_results = []; for($s = $i; $s < $rchange_count; $s++) { if($recent_changes[$s]->page !== $rchange->page) break; $rchange_results[$s] = render_recent_change($recent_changes[$s]); $i++; } // Take one from i to account for when we tick over to the next // iteration of the main loop $i -= 1; $next_entry = implode("\n", $rchange_results); // If the change count is greater than 1, then we should enclose it // in a
  tag. if(count($rchange_results) > 1) { reset($rchange_results); $rchange_first = $recent_changes[key($rchange_results)]; end($rchange_results); $rchange_last = $recent_changes[key($rchange_results)]; $pageDisplayHtml = render_pagename($rchange_first); $timeDisplayHtml = render_timestamp($rchange_first->timestamp); $users = []; foreach($rchange_results as $key => $rchange_result) { if(!in_array($recent_changes[$key]->user, $users)) $users[] = $recent_changes[$key]->user; } foreach($users as &$user) $user = page_renderer::render_username($user); $userDisplayHtml = render_editor(implode(", ", $users)); $next_entry = "
  $pageDisplayHtml $userDisplayHtml $timeDisplayHtml
  $next_entry
  "; $content .= "$next_entry\n"; } else { $content .= implode("\n", $rchange_results); } $last_time = date("dmY", $rchange->timestamp); } $content .= "\t\t
  "; return $content; } function render_recent_change($rchange) { global $pageindex; $pageDisplayHtml = render_pagename($rchange); $editorDisplayHtml = render_editor(page_renderer::render_username($rchange->user)); $timeDisplayHtml = render_timestamp($rchange->timestamp); $revisionId = false; if(isset($pageindex->{$rchange->page}) && isset($pageindex->{$rchange->page}->history)) { foreach($pageindex->{$rchange->page}->history as $historyEntry) { if($historyEntry->timestamp == $rchange->timestamp) { $revisionId = $historyEntry->rid; break; } } } $result = ""; $resultClasses = []; switch(isset($rchange->type) ? $rchange->type : "edit") { case "edit": // The number (and the sign) of the size difference to display $size_display = ($rchange->sizediff > 0 ? "+" : "") . $rchange->sizediff; $size_display_class = $rchange->sizediff > 0 ? "larger" : ($rchange->sizediff < 0 ? "smaller" : "nochange"); if($rchange->sizediff > 500 or $rchange->sizediff < -500) $size_display_class .= " significant"; $size_title_display = human_filesize($rchange->newsize - $rchange->sizediff) . " -> " . human_filesize($rchange->newsize); if(!empty($rchange->newpage)) $resultClasses[] = "newpage"; $result .= "$pageDisplayHtml $editorDisplayHtml $timeDisplayHtml ($size_display)"; break; case "deletion": $resultClasses[] = "deletion"; $result .= "$pageDisplayHtml $editorDisplayHtml $timeDisplayHtml"; break; case "upload": $resultClasses[] = "upload"; $result .= "$pageDisplayHtml $editorDisplayHtml $timeDisplayHtml (" . human_filesize($rchange->filesize) . ")"; break; case "comment": $resultClasses[] = "new-comment"; $result .= "$pageDisplayHtml $editorDisplayHtml"; } $resultAttributes = " " . (count($resultClasses) > 0 ? "class='" . implode(" ", $resultClasses) . "'" : ""); $result = "\t\t\t$result
\n"; return $result; } register_module([ "name" => "Redirect pages", "version" => "0.3", "author" => "Starbeamrainbowlabs", "description" => "Adds support for redirect pages. Uses the same syntax that Mediawiki does.", "id" => "feature-redirect", "code" => function() { global $settings; register_save_preprocessor(function(&$index_entry, &$pagedata) { $matches = []; if(preg_match("/^# ?REDIRECT ?\[\[([^\]]+)\]\]/i", $pagedata, $matches) === 1) { //error_log("matches: " . var_export($matches, true)); // We have found a redirect page! // Update the metadata to reflect this. $index_entry->redirect = true; $index_entry->redirect_target = $matches[1]; } else { // This page isn't a redirect. Unset the metadata just in case. if(isset($index_entry->redirect)) unset($index_entry->redirect); if(isset($index_entry->redirect_target)) unset($index_entry->redirect_target); } }); // Register a help section add_help_section("25-redirect", "Redirect Pages", "

$settings->sitename supports redirect pages. To create a redirect page, enter something like # REDIRECT [[pagename]] on the first line of the redirect page's content. This must appear as the first line of the page, with no whitespace before it. You can include content beneath the redirect if you want, too (such as a reason for redirecting the page).

"); } ]); register_module([ "name" => "Search", "version" => "0.5", "author" => "Starbeamrainbowlabs", "description" => "Adds proper search functionality to Pepperminty Wiki using an inverted index to provide a full text search engine. If pages don't show up, then you might have hit a stop word. If not, try requesting the `invindex-rebuild` action to rebuild the inverted index from scratch.", "id" => "feature-search", "code" => function() { global $settings; /** * @api {get} ?action=index&page={pageName} Get an index of words for a given page * @apiName SearchIndex * @apiGroup Search * @apiPermission Anonymous * * @apiParam {string} page The page to generate a word index page. */ /* * ██ ███ ██ ██████ ███████ ██ ██ * ██ ████ ██ ██ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ █████ ███ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ████ ██████ ███████ ██ ██ */ add_action("index", function() { global $settings, $env; $breakable_chars = "\r\n\t .,\\/!\"£$%^&*[]()+`_~#"; header("content-type: text/plain"); $source = file_get_contents("$env->storage_prefix$env->page.md"); $index = search::index($source); var_dump($env->page); var_dump($source); var_dump($index); }); /** * @api {get} ?action=invindex-rebuild Rebuild the inverted search index from scratch * @apiDescription Causes the inverted search index to be completely rebuilt from scratch. Can take a while for large wikis! * @apiName SearchInvindexRebuild * @apiGroup Search * @apiPermission Anonymous */ /* * ██ ███ ██ ██ ██ ██ ███ ██ ██████ ███████ ██ ██ * ██ ████ ██ ██ ██ ██ ████ ██ ██ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ █████ ███ █████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ████ ████ ██ ██ ████ ██████ ███████ ██ ██ * * ██████ ███████ ██████ ██ ██ ██ ██ ██████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ █████ ██████ ██ ██ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ███████ ██████ ██████ ██ ███████ ██████ */ add_action("invindex-rebuild", function() { search::rebuild_invindex(); }); /** * @api {get} ?action=idindex-show Show the id index * @apiDescription Outputs the id index. Useful if you need to verify that it's working as expected. * @apiName SearchShowIdIndex * @apiGroup Search * @apiPermission Anonymous */ add_action("idindex-show", function() { global $idindex; header("content-type: application/json; charset=UTF-8"); exit(json_encode($idindex, JSON_PRETTY_PRINT)); }); /** * @api {get} ?action=search&query={text} Search the wiki for a given query string * @apiName Search * @apiGroup Search * @apiPermission Anonymous * * @apiParam {string} query The query string to search for. */ /* * ███████ ███████ █████ ██████ ██████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ █████ ███████ ██████ ██ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ███████ ██ ██ ██ ██ ██████ ██ ██ */ add_action("search", function() { global $settings, $env, $pageindex, $paths; // Create the inverted index if it doesn't exist. // todo In the future perhaps a CLI for this would be good? if(!file_exists($paths->searchindex)) search::rebuild_invindex(); if(!isset($_GET["query"])) exit(page_renderer::render("No Search Terms - Error - $settings->sitename", "

You didn't specify any search terms. Try typing some into the box above.

")); $search_start = microtime(true); $invindex = search::load_invindex($paths->searchindex); $results = search::query_invindex($_GET["query"], $invindex); $resultCount = count($results); $env->perfdata->search_time = round((microtime(true) - $search_start)*1000, 3); $title = $_GET["query"] . " - Search results - $settings->sitename"; $content = "
\n"; $content .= "
Search Results
"; /// Search Box /// $content .= "
\n"; $content .= " \n"; $content .= " \n"; $content .= "
"; $content .= "
Found $resultCount " . ($resultCount === 1 ? "result" : "results") . " in " . $env->perfdata->search_time . "ms. "; $query = $_GET["query"]; if(isset($pageindex->$query)) { $content .= "There's a page on $settings->sitename called $query."; } else { $content .= "There isn't a page called $query on $settings->sitename, but you "; if((!$settings->anonedits && !$env->is_logged_in) || !$settings->editing) { $content .= "do not have permission to create it."; if(!$env->is_logged_in) { $content .= " You could try logging in."; } } else { $content .= "can create it."; } } $content .= "
"; $i = 0; // todo use $_GET["offset"] and $_GET["result-count"] or something foreach($results as $result) { $link = "?page=" . rawurlencode($result["pagename"]); $pagesource = file_get_contents($env->storage_prefix . $result["pagename"] . ".md"); //echo("Extracting context for result " . $result["pagename"] . ".\n"); $context = search::extract_context($_GET["query"], $pagesource); if(strlen($context) === 0) $context = substr($pagesource, 0, $settings->search_characters_context * 2); //echo("'Generated search context for " . $result["pagename"] . ": $context'\n"); $context = search::highlight_context($_GET["query"], $context); /*if(strlen($context) == 0) { $context = search::strip_markup(file_get_contents("$env->page.md", null, null, null, $settings->search_characters_context * 2)); if($pageindex->{$env->page}->size > $settings->search_characters_context * 2) $context .= "..."; }*/ // Make redirect pages italics if(!empty($pageindex->{$result["pagename"]}->redirect)) $result["pagename"] = "{$result["pagename"]}"; // We add 1 to $i here to convert it from an index to a result // number as people expect it to start from 1 $content .= "
\n"; $content .= "
" . $result["pagename"] . "
\n"; $content .= "
$context
\n"; $content .= "
\n"; $i++; } $content .= "
\n"; header("content-type: text/html; charset=UTF-8"); exit(page_renderer::render($title, $content)); //header("content-type: text/plain"); //var_dump($results); }); /* * ██████ ██ ██ ███████ ██████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██ ██ █████ ██████ ████ █████ * ██ ▄▄ ██ ██ ██ ██ ██ ██ ██ * ██████ ██████ ███████ ██ ██ ██ * ▀▀ * ███████ ███████ █████ ██████ ██████ ██ ██ ██ ███ ██ ██████ ███████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ████ ██ ██ ██ ██ ██ ██ * ███████ █████ ███████ ██████ ██ ███████ ██ ██ ██ ██ ██ ██ █████ ███ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ███████ ██ ██ ██ ██ ██████ ██ ██ ██ ██ ████ ██████ ███████ ██ ██ */ /** * @api {get} ?action=query-searchindex&query={text} Inspect the internals of the search results for a query * @apiName Search * @apiGroup Search * @apiPermission Anonymous * * @apiParam {string} query The query string to search for. */ add_action("query-searchindex", function() { global $env, $paths; if(empty($_GET["query"])) { http_response_code(400); header("content-type: text/plain"); exit("Error: No query specified. Specify it with the 'query' GET parameter."); } $env->perfdata->searchindex_decode_start = microtime(true); $searchIndex = search::load_invindex($paths->searchindex); $env->perfdata->searchindex_decode_time = (microtime(true) - $env->perfdata->searchindex_decode_start) * 1000; $env->perfdata->searchindex_query_start = microtime(true); $searchResults = search::query_invindex($_GET["query"], $searchIndex); $env->perfdata->searchindex_query_time = (microtime(true) - $env->perfdata->searchindex_query_start) * 1000; header("content-type: application/json"); $result = new stdClass(); $result->time_format = "ms"; $result->decode_time = $env->perfdata->searchindex_decode_time; $result->query_time = $env->perfdata->searchindex_query_time; $result->total_time = $result->decode_time + $result->query_time; $result->search_results = $searchResults; exit(json_encode($result, JSON_PRETTY_PRINT)); }); /* * ██████ ██████ ███████ ███ ██ ███████ ███████ █████ ██████ ██████ ██ ██ * ██ ██ ██ ██ ██ ████ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██████ █████ ██ ██ ██ ███████ █████ ███████ ██████ ██ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██ ███████ ██ ████ ███████ ███████ ██ ██ ██ ██ ██████ ██ ██ */ add_action("opensearch-description", function () { global $settings; $siteRoot = full_url() . "/index.php"; if(!isset($_GET["debug"])) header("content-type: application/opensearchdescription+xml"); else header("content-type: text/plain"); exit(utf8_encode(" Search $settings->sitename Search $settings->sitename, which is powered by Pepperminty Wiki. $settings->sitename Wiki $settings->favicon Search content available under the license linked to at the bottom of the search results page. Starbeamrainbowlabs (https://github.com/sbrl/Pepperminty-Wiki/graphs/contributors) UTF-8 UTF-8 ")); }); add_action("suggest-pages", function() { global $settings, $pageindex; if($settings->dynamic_page_suggestion_count === 0) { header("content-type: application/json"); header("content-length: 2"); exit("[]"); } if(empty($_GET["query"])) { http_response_code(400); header("content-type: text/plain"); exit("Error: You didn't specify the 'query' GET parameter."); } // Rank each page name $results = []; foreach($pageindex as $pageName => $entry) { $results[] = [ "pagename" => $pageName, // Costs: Insert: 1, Replace: 8, Delete: 6 "distance" => levenshtein($_GET["query"], $pageName, 1, 8, 6) ]; } // Sort the page names by distance form the original query usort($results, function($a, $b) { if($a["distance"] == $b["distance"]) return strcmp($a["pagename"], $b["pagename"]); return $a["distance"] < $b["distance"] ? -1 : 1; }); // Send the results to the user header("content-type: application/json"); exit(json_encode(array_slice($results, 0, $settings->dynamic_page_suggestion_count))); }); if($settings->dynamic_page_suggestion_count > 0) { page_renderer::AddJSSnippet('/// Dynamic page suggestion system // Micro snippet 8 - Promisified GET (fetched 20th Nov 2016) function get(u){return new Promise(function(r,t,a){a=new XMLHttpRequest();a.onload=function(b,c){b=a.status;c=a.response;if(b>199&&b<300){r(c)}else{t(c)}};a.open("GET",u,true);a.send(null)})} window.addEventListener("load", function(event) { var searchBox = document.querySelector("input[type=search]"); searchBox.dataset.lastValue = ""; searchBox.addEventListener("keyup", function(event) { // Make sure that we don\'t keep sending requests to the server if nothing has changed if(searchBox.dataset.lastValue == event.target.value) return; searchBox.dataset.lastValue = event.target.value; // Fetch the suggestions from the server get("?action=suggest-pages&query=" + encodeURIComponent(event.target.value)).then(function(response) { var suggestions = JSON.parse(response), dataList = document.getElementById("allpages"); // If the server sent no suggestions, then we shouldn\'t replace the contents of the datalist if(suggestions.length == 0) return; console.info(`Fetched suggestions for ${event.target.value}:`, suggestions.map(s => s.pagename)); // Remove all the existing suggestions while(dataList.firstChild) { dataList.removeChild(dataList.firstChild); } // Add the new suggestions to the datalist var optionsFrag = document.createDocumentFragment(); suggestions.forEach(function(suggestion) { var suggestionElement = document.createElement("option"); suggestionElement.value = suggestion.pagename; suggestionElement.dataset.distance = suggestion.distance; optionsFrag.appendChild(suggestionElement); }); dataList.appendChild(optionsFrag); }); }); }); '); } } ]); class search { // Words that we should exclude from the inverted index public static $stop_words = [ "a", "about", "above", "above", "across", "after", "afterwards", "again", "against", "all", "almost", "alone", "along", "already", "also", "although", "always", "am", "among", "amongst", "amoungst", "amount", "an", "and", "another", "any", "anyhow", "anyone", "anything", "anyway", "anywhere", "are", "around", "as", "at", "back", "be", "became", "because", "become", "becomes", "becoming", "been", "before", "beforehand", "behind", "being", "below", "beside", "besides", "between", "beyond", "bill", "both", "bottom", "but", "by", "call", "can", "cannot", "cant", "co", "con", "could", "couldnt", "cry", "de", "describe", "detail", "do", "done", "down", "due", "during", "each", "eg", "eight", "either", "eleven", "else", "elsewhere", "empty", "enough", "etc", "even", "ever", "every", "everyone", "everything", "everywhere", "except", "few", "fill", "find", "fire", "first", "five", "for", "former", "formerly", "found", "four", "from", "front", "full", "further", "get", "give", "go", "had", "has", "hasnt", "have", "he", "hence", "her", "here", "hereafter", "hereby", "herein", "hereupon", "hers", "herself", "him", "himself", "his", "how", "however", "ie", "if", "in", "inc", "indeed", "interest", "into", "is", "it", "its", "itself", "keep", "last", "latter", "latterly", "least", "less", "ltd", "made", "many", "may", "me", "meanwhile", "might", "mine", "more", "moreover", "most", "mostly", "move", "much", "must", "my", "myself", "name", "namely", "neither", "never", "nevertheless", "next", "nine", "no", "none", "nor", "not", "nothing", "now", "nowhere", "of", "off", "often", "on", "once", "one", "only", "onto", "or", "other", "others", "otherwise", "our", "ours", "ourselves", "out", "over", "own", "part", "per", "perhaps", "please", "put", "rather", "re", "same", "see", "seem", "seemed", "seeming", "seems", "serious", "several", "she", "should", "show", "side", "since", "sincere", "six", "sixty", "so", "some", "somehow", "someone", "something", "sometime", "sometimes", "somewhere", "still", "such", "system", "take", "ten", "than", "that", "the", "their", "them", "themselves", "then", "thence", "there", "thereafter", "thereby", "therefore", "therein", "thereupon", "these", "they", "thickv", "thin", "third", "this", "those", "though", "three", "through", "throughout", "thru", "thus", "to", "together", "too", "top", "toward", "towards", "twelve", "twenty", "two", "un", "under", "until", "up", "upon", "us", "very", "via", "was", "we", "well", "were", "what", "whatever", "when", "whence", "whenever", "where", "whereafter", "whereas", "whereby", "wherein", "whereupon", "wherever", "whether", "which", "while", "whither", "who", "whoever", "whole", "whom", "whose", "why", "will", "with", "within", "without", "would", "yet", "you", "your", "yours", "yourself", "yourselves" ]; public static function index($source) { $source = html_entity_decode($source, ENT_QUOTES); $source_length = strlen($source); $index = []; $terms = self::tokenize($source); $i = 0; foreach($terms as $term) { $nterm = $term; // Skip over stop words (see https://en.wikipedia.org/wiki/Stop_words) if(in_array($nterm, self::$stop_words)) continue; if(!isset($index[$nterm])) { $index[$nterm] = [ "freq" => 0, "offsets" => [] ]; } $index[$nterm]["freq"]++; $index[$nterm]["offsets"][] = $i; $i++; } return $index; } public static function tokenize($source) { $source = strtolower($source); $source = str_replace([ '[', ']', '|', '{', '}' ], " ", $source); return preg_split("/((^\p{P}+)|(\p{P}*\s+\p{P}*)|(\p{P}+$))|\|/u", $source, -1, PREG_SPLIT_NO_EMPTY); } public static function strip_markup($source) { return str_replace([ "[", "]", "\"", "*", "_", " - ", "`" ], "", $source); } public static function rebuild_invindex() { global $pageindex, $env, $paths; header("content-type: text/event-stream"); // Clear the id index out ids::clear(); // Reindex each page in turn $invindex = []; foreach($pageindex as $pagename => $pagedetails) { $pagesource = utf8_encode(file_get_contents("$env->storage_prefix$pagename.md")); $index = self::index($pagesource); $pageid = ids::getid($pagename); self::merge_into_invindex($invindex, $pageid, $index); echo("Added $pagename (id #$pageid) to the new search index.\n\n"); flush(); } echo("Search index rebuilding complete.\n\n"); echo("Saving new search index to '$paths->searchindex'.\n\n"); self::save_invindex($paths->searchindex, $invindex); } /* * @summary Sorts an index alphabetically. Will also sort an inverted index. * This allows us to do a binary search instead of a regular * sequential search. */ public static function sort_index(&$index) { ksort($index, SORT_NATURAL); } /* * @summary Compares two *regular* indexes to find the differences between them. * * @param {array} $indexa - The old index. * @param {array} $indexb - The new index. * @param {array} $changed - An array to be filled with the nterms of all * the changed entries. * @param {array} $removed - An array to be filled with the nterms of all * the removed entries. */ public static function compare_indexes($oldindex, $newindex, &$changed, &$removed) { foreach($oldindex as $nterm => $entry) { if(!isset($newindex[$nterm])) $removed[] = $nterm; } foreach($newindex as $nterm => $entry) { if(!isset($oldindex[$nterm]) or // If this world is new $newindex[$nterm] !== $oldindex[$nterm]) // If this word has changed $changed[$nterm] = $newindex[$nterm]; } } /* * @summary Reads in and parses an inverted index. */ // Todo remove this function and make everything streamable public static function load_invindex($invindex_filename) { $invindex = json_decode(file_get_contents($invindex_filename), true); return $invindex; } public static function measure_invindex_load_time($invindex_filename) { global $env; $searchindex_decode_start = microtime(true); search::load_invindex($invindex_filename); $env->perfdata->searchindex_decode_time = round((microtime(true) - $searchindex_decode_start)*1000, 3); } /* * @summary Merge an index into an inverted index. */ public static function merge_into_invindex(&$invindex, $pageid, &$index, &$removals = []) { // Remove all the subentries that were removed since last time foreach($removals as $nterm) { unset($invindex[$nterm][$pageid]); } // Merge all the new / changed index entries into the inverted index foreach($index as $nterm => $newentry) { // If the nterm isn't in the inverted index, then create a space for it if(!isset($invindex[$nterm])) $invindex[$nterm] = []; $invindex[$nterm][$pageid] = $newentry; // Sort the page entries for this word by frequency uasort($invindex[$nterm], function($a, $b) { if($a["freq"] == $b["freq"]) return 0; return ($a["freq"] < $b["freq"]) ? +1 : -1; }); } // Sort the inverted index by rank uasort($invindex, function($a, $b) { $ac = count($a); $bc = count($b); if($ac == $bc) return 0; return ($ac < $bc) ? +1 : -1; }); } /** * Deletes the given pageid from the given pageindex. * @param inverted_index &$invindex The inverted index. * @param number $pageid The pageid to remove. */ public static function delete_entry(&$invindex, $pageid) { $str_pageid = (string)$pageid; foreach($invindex as $nterm => &$entry) { if(isset($entry[$pageid])) unset($entry[$pageid]); if(isset($entry[$str_pageid])) unset($entry[$str_pageid]); if(count($entry) === 0) unset($invindex[$nterm]); } } public static function save_invindex($filename, &$invindex) { file_put_contents($filename, json_encode($invindex)); } public static function query_invindex($query, &$invindex) { global $settings, $pageindex; $query_terms = self::tokenize($query); $matching_pages = []; // Loop over each term in the query and find the matching page entries $count = count($query_terms); for($i = 0; $i < $count; $i++) { $qterm = $query_terms[$i]; // Stop words aren't worth the bother - make sure we don't search // the title or the tags for them if(in_array($qterm, self::$stop_words)) continue; // Only search the inverted index if it actually exists there if(isset($invindex[$qterm])) { // Loop over each page in the inverted index entry foreach($invindex[$qterm] as $pageid => $page_entry) { // Create an entry in the matching pages array if it doesn't exist if(!isset($matching_pages[$pageid])) $matching_pages[$pageid] = [ "nterms" => [] ]; $matching_pages[$pageid]["nterms"][$qterm] = $page_entry; } } // Loop over the pageindex and search the titles / tags foreach ($pageindex as $pagename => $pagedata) { // Get the current page's id $pageid = ids::getid($pagename); // Consider matches in the page title if(stripos($pagename, $qterm) !== false) { // We found the qterm in the title if(!isset($matching_pages[$pageid])) $matching_pages[$pageid] = [ "nterms" => [] ]; // Set up a counter for page title matches if it doesn't exist already if(!isset($matching_pages[$pageid]["title-matches"])) $matching_pages[$pageid]["title-matches"] = 0; $matching_pages[$pageid]["title-matches"] += count(mb_stripos_all($pagename, $qterm)); } // Consider matches in the page's tags if(isset($pagedata->tags) and // If this page has tags stripos(implode(" ", $pagedata->tags), $qterm) !== false) // And we found the qterm in the tags { if(!isset($matching_pages[$pageid])) $matching_pages[$pageid] = [ "nterms" => [] ]; // Set up a counter for tag match if there isn't one already if(!isset($matching_pages[$pageid]["tag-matches"])) $matching_pages[$pageid]["tag-matches"] = 0; $matching_pages[$pageid]["tag-matches"] += count(mb_stripos_all(implode(" ", $pagedata->tags), $qterm)); } } } foreach($matching_pages as $pageid => &$pagedata) { $pagedata["pagename"] = ids::getpagename($pageid); $pagedata["rank"] = 0; $pageOffsets = []; // Loop over each search term found on this page foreach($pagedata["nterms"] as $pterm => $entry) { // Add the number of occurrences of this search term to the ranking $pagedata["rank"] += $entry["freq"]; // Add the offsets to a listof all offsets on this page foreach($entry["offsets"] as $offset) $pageOffsets[] = $offset; } /* // Sort the list of offsets $pageOffsets = array_unique($pageOffsets); sort($pageOffsets); var_dump($pageOffsets); // Calcualate the clump distances via a variable moving window size $pageOffsetsCount = count($pageOffsets); $clumpDistanceWindow = min($count, $pageOffsetsCount); // a.k.a. count($query_terms) - see above $clumpDistances = []; for($i = 0; $i < $pageOffsetsCount - $clumpDistanceWindow; $i++) $clumpDistances[] = $pageOffsets[$i] - $pageOffsets[$i + $clumpDistanceWindow]; // Sort the new list of clump distances sort($clumpDistances); // Calcualate a measureof how clumped the offsets are $tightClumpLimit = floor((count($clumpDistances) - 1) / 0.25); $tightClumpsMeasure = $clumpDistances[$tightClumpLimit] - $clumpDistances[0]; $clumpsRange = $clumpDistances[count($clumpDistances) - 1] - $clumpDistances[0]; $clumpiness = $tightClumpsMeasure / $clumpsRange; echo("{$pagedata["pagename"]} - $clumpiness"); */ // Consider matches in the title / tags if(isset($pagedata["title-matches"])) $pagedata["rank"] += $pagedata["title-matches"] * $settings->search_title_matches_weighting; if(isset($pagedata["tag-matches"])) $pagedata["rank"] += $pagedata["tag-matches"] * $settings->search_tags_matches_weighting; // todo remove items if the rank is below a threshold } // todo sort by rank here uasort($matching_pages, function($a, $b) { if($a["rank"] == $b["rank"]) return 0; return ($a["rank"] < $b["rank"]) ? +1 : -1; }); return $matching_pages; } public static function extract_context($query, $source) { global $settings; $nterms = self::tokenize($query); $matches = []; // Loop over each nterm and find it in the source foreach($nterms as $nterm) { if(in_array($nterm, static::$stop_words)) continue; $all_offsets = mb_stripos_all($source, $nterm); // Skip over adding matches if there aren't any if($all_offsets === false) continue; foreach($all_offsets as $offset) { $matches[] = [ $nterm, $offset ]; } } // Sort the matches by offset usort($matches, function($a, $b) { if($a[1] == $b[1]) return 0; return ($a[1] > $b[1]) ? +1 : -1; }); $sourceLength = strlen($source); $contexts = []; $basepos = 0; $matches_count = count($matches); while($basepos < $matches_count) { // Store the next match along - all others will be relative to that one $group = [$matches[$basepos]]; // Start scanning at the next one along - we always store the first match $scanpos = $basepos + 1; $distance = 0; while(true) { // Break out if we reach the end if($scanpos >= $matches_count) break; // Find the distance between the current one and the last one $distance = $matches[$scanpos][1] - $matches[$scanpos - 1][1]; // Store it if the distance is below the threshold if($distance < $settings->search_characters_context) $group[] = $matches[$scanpos]; else break; $scanpos++; } $context_start = $group[0][1] - $settings->search_characters_context; $context_end = $group[count($group) - 1][1] + $settings->search_characters_context; if($context_start < 0) $context_start = 0; if($context_end > $sourceLength) $context_end = $sourceLength; //echo("Got context. Start: $context_start, End: $context_end\n"); //echo("Group:"); var_dump($group); $context = substr($source, $context_start, $context_end - $context_start); // Strip the markdown from the context - it's most likely going to // be broken anyway. //$context = self::strip_markup($context); // Escape special characters to protect against attacks $context = htmlentities($context); $contexts[] = $context; $basepos = $scanpos + 1; } return implode(" ... ", $contexts); } public static function highlight_context($query, $context) { $qterms = self::tokenize($query); foreach($qterms as $qterm) { if(in_array($qterm, static::$stop_words)) continue; // From http://stackoverflow.com/a/2483859/1460422 $context = preg_replace("/" . str_replace("/", "\/", preg_quote($qterm)) . "/i", "$0", $context); } return $context; } } register_module([ "name" => "Uploader", "version" => "0.5.8", "author" => "Starbeamrainbowlabs", "description" => "Adds the ability to upload files to Pepperminty Wiki. Uploaded files act as pages and have the special 'File/' prefix.", "id" => "feature-upload", "code" => function() { global $settings; /** * @api {get} ?action=upload Get a page to let you upload a file. * @apiName UploadFilePage * @apiGroup Upload * @apiPermission User */ /** * @api {post} ?action=upload Upload a file * @apiName UploadFile * @apiGroup Upload * @apiPermission User * * @apiParam {string} name The name of the file to upload. * @apiParam {string} description A description of the file. * @apiParam {file} file The file to upload. * * @apiUse UserNotLoggedInError * @apiError UploadsDisabledError Uploads are currently disabled in the wiki's settings. * @apiError UnknownFileTypeError The type of the file you uploaded is not currently allowed in the wiki's settings. * @apiError ImageDimensionsFiledError PeppermintyWiki couldn't obtain the dimensions of the image you uploaded. * @apiError DangerousFileError The file uploaded appears to be dangerous. * @apiError DuplicateFileError The filename specified is a duplicate of a file that already exists. * @apiError FileTamperedError Pepperminty Wiki couldn't verify that the file wasn't tampered with during theupload process. */ /* * ██ ██ ██████ ██ ██████ █████ ██████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██████ ██ ██ ██ ███████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██ ███████ ██████ ██ ██ ██████ */ add_action("upload", function() { global $settings, $env, $pageindex, $paths; switch($_SERVER["REQUEST_METHOD"]) { case "GET": // Send upload page if(!$settings->upload_enabled) exit(page_renderer::render("Upload Disabled - $setting->sitename", "

You can't upload anything at the moment because $settings->sitename has uploads disabled. Try contacting $settings->admindetails_name, your site Administrator. Go back.

")); if(!$env->is_logged_in) exit(page_renderer::render("Upload Error - $settings->sitename", "

You are not currently logged in, so you can't upload anything.

Try logging in first.

")); exit(page_renderer::render("Upload - $settings->sitename", "

Upload file

Select an image below, and then type a name for it in the box. This server currently supports uploads up to " . human_filesize(get_max_upload_size()) . " in size.

$settings->sitename currently supports uploading of the following file types: " . implode(", ", $settings->upload_allowed_file_types) . ".

Select a file to upload.
Name:
Description:

$settings->editing_message

")); break; case "POST": // Recieve file // Make sure uploads are enabled if(!$settings->upload_enabled) { unlink($_FILES["file"]["tmp_name"]); http_response_code(412); exit(page_renderer::render("Upload failed - $settings->sitename", "

Your upload couldn't be processed because uploads are currently disabled on $settings->sitename. Go back to the main page.

")); } // Make sure that the user is logged in if(!$env->is_logged_in) { unlink($_FILES["file"]["tmp_name"]); http_response_code(401); exit(page_renderer::render("Upload failed - $settings->sitename", "

Your upload couldn't be processed because you are not logged in.

Try logging in first.")); } // Calculate the target name, removing any characters we // are unsure about. $target_name = makepathsafe($_POST["name"]); $temp_filename = $_FILES["file"]["tmp_name"]; $mimechecker = finfo_open(FILEINFO_MIME_TYPE); $mime_type = finfo_file($mimechecker, $temp_filename); finfo_close($mimechecker); if(!in_array($mime_type, $settings->upload_allowed_file_types)) { http_response_code(415); exit(page_renderer::render("Unknown file type - Upload error - $settings->sitename", "

$settings->sitename recieved the file you tried to upload successfully, but detected that the type of file you uploaded is not in the allowed file types list. The file has been discarded.

The file you tried to upload appeared to be of type $mime_type, but $settings->sitename currently only allows the uploading of the following file types: " . implode(", ", $settings->upload_allowed_file_types) . ".

Go back to the Main Page.

")); } // Perform appropriate checks based on the *real* filetype switch(substr($mime_type, 0, strpos($mime_type, "/"))) { case "image": $extra_data = []; // Check SVG uploads with a special function $imagesize = $mime_type !== "image/svg+xml" ? getimagesize($temp_filename, $extra_data) : upload_check_svg($temp_filename); // Make sure that the image size is defined if(!is_int($imagesize[0]) or !is_int($imagesize[1])) { http_response_code(415); exit(page_renderer::render("Upload Error - $settings->sitename", "

Although the file that you uploaded appears to be an image, $settings->sitename has been unable to determine it's dimensions. The uploaded file has been discarded. Go back to try again.

You may wish to consider opening an issue against Pepperminty Wiki (the software that powers $settings->sitename) if this isn't the first time that you have seen this message.

")); } break; } $file_extension = system_mime_type_extension($mime_type); // Override the detected file extension if a file extension // is explicitly specified in the settings if(isset($settings->mime_mappings_overrides->$mime_type)) $file_extension = $settings->mime_mappings_overrides->$mime_type; if(in_array($file_extension, [ "php", ".htaccess", "asp" ])) { http_response_code(415); exit(page_renderer::render("Upload Error - $settings->sitename", "

The file you uploaded appears to be dangerous and has been discarded. Please contact $settings->sitename's administrator for assistance.

Additional information: The file uploaded appeared to be of type $mime_type, which mapped onto the extension $file_extension. This file extension has the potential to be executed accidentally by the web server.

")); } $new_filename = "$paths->upload_file_prefix$target_name.$file_extension"; $new_description_filename = "$new_filename.md"; if(isset($pageindex->$new_filename)) exit(page_renderer::render("Upload Error - $settings->sitename", "

A page or file has already been uploaded with the name '$new_filename'. Try deleting it first. If you do not have permission to delete things, try contacting one of the moderators.

")); if(!file_exists($env->storage_prefix . "Files")) mkdir($env->storage_prefix . "Files", 0775); if(!move_uploaded_file($temp_filename, $env->storage_prefix . $new_filename)) { http_response_code(409); exit(page_renderer::render("Upload Error - $settings->sitename", "

The file you uploaded was valid, but $settings->sitename couldn't verify that it was tampered with during the upload process. This probably means that either is a configuration error, or $settings->sitename has been attacked. Please contact " . $settings->admindetails_name . ", your $settings->sitename Administrator.

")); } $description = $_POST["description"]; // Escape the raw html in the provided description if the setting is enabled if($settings->clean_raw_html) $description = htmlentities($description, ENT_QUOTES); file_put_contents($env->storage_prefix . $new_description_filename, $description); // Construct a new entry for the pageindex $entry = new stdClass(); // Point to the description's filepath since this property // should point to a markdown file $entry->filename = $new_description_filename; $entry->size = strlen($description); $entry->lastmodified = time(); $entry->lasteditor = $env->user; $entry->uploadedfile = true; $entry->uploadedfilepath = $new_filename; $entry->uploadedfilemime = $mime_type; // Add the new entry to the pageindex // Assign the new entry to the image's filepath as that // should be the page name. $pageindex->$new_filename = $entry; // Generate a revision to keep the page history up to date if(module_exists("feature-history")) { $oldsource = ""; // Only variables can be passed by reference, not literals history_add_revision($entry, $description, $oldsource, false); } // Save the pageindex file_put_contents($paths->pageindex, json_encode($pageindex, JSON_PRETTY_PRINT)); if(module_exists("feature-recent-changes")) { add_recent_change([ "type" => "upload", "timestamp" => time(), "page" => $new_filename, "user" => $env->user, "filesize" => filesize($env->storage_prefix . $entry->uploadedfilepath) ]); } header("location: ?action=view&page=$new_filename&upload=success"); break; } }); /** * @api {get} ?action=preview&page={pageName}[&size={someSize}] Get a preview of a file * @apiName PreviewFile * @apiGroup Upload * @apiPermission Anonymous * * @apiParam {string} page The name of the file to preview. * @apiParam {number} size Optional. The size fo the resulting preview. Will be clamped to fit within the bounds specified in the wiki's settings. May also be set to the keyword 'original', which will cause the original file to be returned with it's appropriate mime type instead. * * @apiError PreviewNoFileError No file was found associated with the specified page. * @apiError PreviewUnknownFileTypeError Pepperminty Wiki was unable to generate a preview for the requested file's type. */ /* * ██████ ██████ ███████ ██ ██ ██ ███████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██████ █████ ██ ██ ██ █████ ██ █ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ███ ██ * ██ ██ ██ ███████ ████ ██ ███████ ███ ███ */ add_action("preview", function() { global $settings, $env, $pageindex, $start_time; if(empty($pageindex->{$env->page}->uploadedfilepath)) { $im = errorimage("The page '$env->page' doesn't have an associated file."); header("content-type: image/png"); imagepng($im); exit(); } $filepath = $env->storage_prefix . $pageindex->{$env->page}->uploadedfilepath; $mime_type = $pageindex->{$env->page}->uploadedfilemime; $shortFilename = substr($filepath, 1 + (strrpos($filepath, '/') !== false ? strrpos($filepath, '/') : -1)); header("content-disposition: inline; filename=\"$shortFilename\""); // If the size is set or original, then send (or redirect to) the original image // Also do the same for SVGs if svg rendering is disabled. if(isset($_GET["size"]) and $_GET["size"] == "original" or (empty($settings->render_svg_previews) && $mime_type == "image/svg+xml")) { // Get the file size $filesize = filesize($filepath); // Send some headers header("content-length: $filesize"); header("content-type: $mime_type"); // Open the file and send it to the user $handle = fopen($filepath, "rb"); fpassthru($handle); fclose($handle); exit(); } // Determine the target size of the image $target_size = 512; if(isset($_GET["size"])) $target_size = intval($_GET["size"]); if($target_size < $settings->min_preview_size) $target_size = $settings->min_preview_size; if($target_size > $settings->max_preview_size) $target_size = $settings->max_preview_size; // Determine the output file type $output_mime = $settings->preview_file_type; if(isset($_GET["type"]) and in_array($_GET["type"], [ "image/png", "image/jpeg", "image/webp" ])) $output_mime = $_GET["type"]; /// ETag handling /// // Generate the etag and send it to the client $preview_etag = sha1("$output_mime|$target_size|$filepath|$mime_type"); $allheaders = getallheaders(); $allheaders = array_change_key_case($allheaders, CASE_LOWER); if(!isset($allheaders["if-none-match"])) { header("etag: $preview_etag"); } else { if($allheaders["if-none-match"] === $preview_etag) { http_response_code(304); header("x-generation-time: " . (microtime(true) - $start_time)); exit(); } } /// ETag handling end /// /* Disabled until we work out what to do about caching previews * $previewFilename = "$filepath.preview.$outputFormat"; if($target_size === $settings->default_preview_size) { // The request is for the default preview size // Check to see if we have a preview pre-rendered } */ $preview = new Imagick(); switch(substr($mime_type, 0, strpos($mime_type, "/"))) { case "image": $preview->readImage($filepath); break; case "application": if($mime_type == "application/pdf") { $preview = new imagick(); $preview->readImage("{$filepath}[0]"); $preview->setResolution(300,300); $preview->setImageColorspace(255); break; } case "video": case "audio": if($settings->data_storage_dir == ".") { // The data storage directory is the current directory // Redirect to the file isntead http_response_code(307); header("location: " . $pageindex->{$env->page}->uploadedfilepath); exit(); } // TODO: Add support for ranges here. // Get the file size $filesize = filesize($filepath); // Send some headers header("content-length: $filesize"); header("content-type: $mime_type"); // Open the file and send it to the user $handle = fopen($filepath, "rb"); fpassthru($handle); fclose($handle); exit(); break; default: http_response_code(501); $preview = errorimage("Unrecognised file type '$mime_type'.", $target_size); header("content-type: image/png"); imagepng($preview); exit(); } // Scale the image down to the target size $preview->resizeImage($target_size, $target_size, imagick::FILTER_LANCZOS, 1, true); // Send the completed preview image to the user header("content-type: $output_mime"); header("x-generation-time: " . (microtime(true) - $start_time) . "s"); $outputFormat = substr($output_mime, strpos($output_mime, "/") + 1); $preview->setImageFormat($outputFormat); echo($preview->getImageBlob()); /* Disabled while we work out what to do about caching previews * // Save a preview file if there isn't one alreaddy if(!file_exists($previewFilename)) file_put_contents($previewFilename, $preview->getImageBlob()); */ }); /* * ██████ ██████ ███████ ██ ██ ██ ███████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██████ █████ ██ ██ ██ █████ ██ █ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ███ ██ * ██ ██ ██ ███████ ████ ██ ███████ ███ ███ * * ██████ ██ ███████ ██████ ██ █████ ██ ██ ███████ ██████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██ ███████ ██████ ██ ███████ ████ █████ ██████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██ ███████ ██ ███████ ██ ██ ██ ███████ ██ ██ */ page_renderer::register_part_preprocessor(function(&$parts) { global $pageindex, $env, $settings; // Don't do anything if the action isn't view if($env->action !== "view") return; if(isset($pageindex->{$env->page}->uploadedfile) and $pageindex->{$env->page}->uploadedfile == true) { // We are looking at a page that is paired with an uploaded file $filepath = $pageindex->{$env->page}->uploadedfilepath; $mime_type = $pageindex->{$env->page}->uploadedfilemime; $dimensions = $mime_type !== "image/svg+xml" ? getimagesize($env->storage_prefix . $filepath) : getsvgsize($env->storage_prefix . $filepath); $fileTypeDisplay = substr($mime_type, 0, strpos($mime_type, "/")); $previewUrl = "?action=preview&size=$settings->default_preview_size&page=" . rawurlencode($env->page); $preview_html = ""; switch($fileTypeDisplay) { case "application": case "image": if($mime_type == "application/pdf") $fileTypeDisplay = "file"; $preview_sizes = [ 256, 512, 768, 1024, 1440 ]; $preview_html .= "\t\t\t

\n\t\t\t

"; break; case "video": $preview_html .= "\t\t\t
"; break; case "audio": $preview_html .= "\t\t\t
"; } $fileInfo = []; $fileInfo["Name"] = str_replace("File/", "", $filepath); $fileInfo["Type"] = $mime_type; $fileInfo["Size"] = human_filesize(filesize($env->storage_prefix . $filepath)); switch($fileTypeDisplay) { case "image": $dimensionsKey = $mime_type !== "image/svg+xml" ? "Original dimensions" : "Native size"; $fileInfo[$dimensionsKey] = "$dimensions[0] x $dimensions[1]"; break; } $fileInfo["Uploaded by"] = $pageindex->{$env->page}->lasteditor; $preview_html .= "\t\t\t

File Information

"; foreach ($fileInfo as $displayName => $displayValue) { $preview_html .= "\n"; } $preview_html .= "

$displayName	$displayValue

"; $parts["{content}"] = str_replace("", "\n$preview_html", $parts["{content}"]); } }); // Register a section on the help page on uploading files add_help_section("28-uploading-files", "Uploading Files", "

$settings->sitename supports the uploading of files, though it is up to " . $settings->admindetails_name . ", $settings->sitename's administrator as to whether it is enabled or not (uploads are currently " . (($settings->upload_enabled) ? "enabled" : "disabled") . ").

Currently Pepperminty Wiki (the software that $settings->sitename uses) only supports the uploading of images, although more file types should be supported in the future (open an issue on GitHub if you are interested in support for more file types).

Uploading a file is actually quite simple. Click the "Upload" option in the "More..." menu to go to the upload page. The upload page will tell you what types of file $settings->sitename allows, and the maximum supported filesize for files that you upload (this is usually set by the web server that the wiki is running on).

Use the file chooser to select the file that you want to upload, and then decide on a name for it. Note that the name that you choose should not include the file extension, as this will be determined automatically. Enter a description that will appear on the file's page, and then click upload.

"); } ]); //// Pair of functions to calculate the actual maximum upload size supported by the server //// Lifted from Drupal by @meustrus from Stackoverflow. Link to answer: //// http://stackoverflow.com/a/25370978/1460422 // Returns a file size limit in bytes based on the PHP upload_max_filesize // and post_max_size function get_max_upload_size() { static $max_size = -1; if ($max_size < 0) { // Start with post_max_size. $max_size = parse_size(ini_get('post_max_size')); // If upload_max_size is less, then reduce. Except if upload_max_size is // zero, which indicates no limit. $upload_max = parse_size(ini_get('upload_max_filesize')); if ($upload_max > 0 && $upload_max < $max_size) { $max_size = $upload_max; } } return $max_size; } function parse_size($size) { $unit = preg_replace('/[^bkmgtpezy]/i', '', $size); // Remove the non-unit characters from the size. $size = preg_replace('/[^0-9\.]/', '', $size); // Remove the non-numeric characters from the size. if ($unit) { // Find the position of the unit in the ordered string which is the power of magnitude to multiply a kilobyte by. return round($size * pow(1024, stripos('bkmgtpezy', $unit[0]))); } else { return round($size); } } function upload_check_svg($temp_filename) { global $settings; // Check for script tags if(strpos(file_get_contents($temp_filename), "sitename", "

$settings->sitename detected that you uploaded an SVG image and performed some extra security checks on your file. Whilst performing these checks it was discovered that the file you uploaded contains some Javascript, which could be dangerous. The uploaded file has been discarded. Go back to try again.

You may wish to consider opening an issue against Pepperminty Wiki (the software that powers $settings->sitename) if this isn't the first time that you have seen this message.

")); } // Find and return the size of the SVG image return getsvgsize($temp_filename); } function getsvgsize($svgFilename) { $svg = simplexml_load_file($svgFilename); // Load it as XML if($svg === false) { http_response_code(415); exit(page_renderer::render("Upload Error - $settings->sitename", "

When $settings->sitename tried to open your SVG file for checking, it found some invalid syntax. The uploaded file has been discarded. Go back to try again.

")); } $rootAttrs = $svg->attributes(); $imageSize = false; if(isset($rootAttrs->width) and isset($rootAttrs->height)) $imageSize = [ intval($rootAttrs->width), intval($rootAttrs->height) ]; else if(isset($rootAttrs->viewBox)) $imageSize = array_map("intval", array_slice(explode(" ", $rootAttrs->viewBox), -2, 2)); return $imageSize; } function errorimage($text, $target_size = null) { $width = 640; $height = 480; if(!empty($target_size)) { $width = $target_size; $height = $target_size * (2 / 3); } $image = imagecreatetruecolor($width, $height); imagefill($image, 0, 0, imagecolorallocate($image, 238, 232, 242)); // Set the background to #eee8f2 $fontwidth = imagefontwidth(3); imagestring($image, 3, ($width / 2) - (($fontwidth * strlen($text)) / 2), ($height / 2) - (imagefontheight(3) / 2), $text, imagecolorallocate($image, 17, 17, 17) // #111111 ); return $image; } register_module([ "name" => "User Preferences", "version" => "0.2.1", "author" => "Starbeamrainbowlabs", "description" => "Adds a user preferences page, letting pople do things like change their email address and password.", "id" => "feature-user-preferences", "code" => function() { global $env, $settings; /** * @api {get} ?action=user-preferences Get a user preferences configuration page. * @apiName UserPreferences * @apiGroup Settings * @apiPermission User */ /* * ██ ██ ███████ ███████ ██████ * ██ ██ ██ ██ ██ ██ * ██ ██ ███████ █████ ██████ █████ * ██ ██ ██ ██ ██ ██ * ██████ ███████ ███████ ██ ██ * * ██████ ██████ ███████ ███████ ███████ * ██ ██ ██ ██ ██ ██ ██ * ██████ ██████ █████ █████ ███████ * ██ ██ ██ ██ ██ ██ * ██ ██ ██ ███████ ██ ███████ */ add_action("user-preferences", function() { global $env, $settings; if(!$env->is_logged_in) { exit(page_renderer::render_main("Error - $settings->sitename", "

Since you aren't logged in, you can't change your preferences. This is because stored preferences are tied to each registered user account. You can login here.

")); } $statusMessages = [ "change-password" => "Password changed successfully!" ]; if(!isset($env->user_data->emailAddress)) { $env->user_data->emailAddress = ""; save_userdata(); } $content = "

User Preferences

\n"; if(isset($_GET["success"]) && $_GET["success"] === "yes") { $content .= "

" . $statusMessages[$_GET["operation"]] . "

\n"; } $content .= "Username:\n"; $content .= "\n"; $content .= "
\n"; $content .= " Email Address:\n"; $content .= " \n"; $content .= "
Used to send you notifications etc. Never shared with anyone except $settings->admindetails_name, $settings->sitename's administrator.
\n"; $content .= " \n"; $content .= "
\n"; $content .= "

Change Password"; $content .= "

\n"; $content .= " Current Password:\n"; $content .= " \n"; $content .= "
\n"; $content .= " New Password:\n"; $content .= " \n"; $content .= "
\n"; $content .= " Confirm New Password:\n"; $content .= " \n"; $content .= "
\n"; $content .= " \n"; $content .= "

\n"; if($env->is_admin) $content .= "

As an admin, you can also edit $settings->sitename's master settings.

\n"; exit(page_renderer::render_main("User Preferences - $settings->sitename", $content)); }); add_action("save-preferences", function() { global $env, $settings; if(!$env->is_logged_in) { http_response_code(400); exit(page_renderer::render_main("Error Saving Preferences - $settings->sitename", "

You aren't logged in, so you can't save your preferences. Try logging in first.

")); } if(isset($_POST["email-address"])) { if(mb_strlen($_POST["email-address"]) > 320) { http_response_code(413); exit(page_renderer::render_main("Error Saving Email Address - $settings->sitename", "

The email address you supplied ({$_POST['email-address']}) is too long. Email addresses can only be 320 characters long. Go back.")); } if(mb_strpos($_POST["email-address"], "@") === false) { http_response_code(422); exit(page_renderer::render_main("Error Saving Email Address - $settings->sitename", "

The email address you supplied ({$_POST['email-address']}) doesn't appear to be valid. Go back.")); } $env->user_data->emailAddress = $_POST["email-address"]; } // Save the user's preferences if(!save_userdata()) { http_response_code(503); exit(page_renderer::render_main("Error Saving Preferences - $settings->sitename", "

$settings->sitename had some trouble saving your preferences! Please contact $settings->admindetails_name, $settings->sitename's administrator and tell them about this error if it still occurs in 5 minutes. They can be contacted by email at this address: " . hide_email($settings->admindetails_email) . ".

")); } exit(page_renderer::render_main("Preferences Saved Successfully - $settings->sitename", "

Your preferences have been saved successfully! You could go back your preferences page, or on to the $settings->defaultpage.

")); }); /** * @api {post} ?action=change-password Change your password * @apiName ChangePassword * @apiGroup Settings * @apiPermission User * * @apiParam {string} current-pass Your current password. * @apiParam {string} new-pass Your new password. * @apiParam {string} new-pass-confirm Your new password again, to make sure you've typed it correctly. * * @apiError PasswordMismatchError The new password fields don't match. */ add_action("change-password", function() { global $env, $settings; // Make sure the new password was typed correctly // This comes before the current password check since that's more intensive if($_POST["new-pass"] !== $_POST["new-pass-confirm"]) { exit(page_renderer::render_main("Password mismatch - $settings->sitename", "

The new password you typed twice didn't match! Go back.

")); } // Check the current password if(hash_password($_POST["current-pass"]) !== $env->user_data->password) { exit(page_renderer::render_main("Password mismatch - $settings->sitename", "

Error: You typed your current password incorrectly! Go back.

")); } // All's good! Go ahead and change the password. $env->user_data->password = hash_password($_POST["new-pass"]); // Save the userdata back to disk save_userdata(); http_response_code(307); header("location: ?action=user-preferences&success=yes&operation=change-password"); exit(page_renderer::render_main("Password Changed Successfully", "

You password was changed successfully. Go back to the user preferences page.

")); }); // Display a help section on the user preferences, but only if the user // is logged in and so able to access them if($env->is_logged_in) { add_help_section("910-user-preferences", "User Preferences", "

As you are logged in, $settings->sitename lets you configure a selection of personal preferences. These can be viewed and tweaked to you liking over on the preferences page, which can be accessed at any time by clicking the cog icon (it looks something like this: $settings->user_preferences_button_text), though the administrator of $settings->sitename ($settings->admindetails_name) may have changed its appearance.

"); } } ]); register_module([ "name" => "Credits", "version" => "0.7.6", "author" => "Starbeamrainbowlabs", "description" => "Adds the credits page. You *must* have this module :D", "id" => "page-credits", "code" => function() { /** * @api {get} ?action=credits Get the credits page * @apiName Credits * @apiGroup Utility * @apiPermission Anonymous */ /* * ██████ ██████ ███████ ██████ ██ ████████ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██████ █████ ██ ██ ██ ██ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██ ██ ███████ ██████ ██ ██ ███████ */ add_action("credits", function() { global $settings, $version, $pageindex, $modules; $credits = [ "Code" => [ "author" => "Starbeamrainbowlabs", "author_url" => "https://starbeamrmainbowlabs.com/", "thing_url" => "https://github.com/sbrl/Pepprminty-Wiki", "icon" => "https://avatars0.githubusercontent.com/u/9929737?v=3&s=24" ], "Mime type to file extension mapper" => [ "author" => "Chaos", "author_url" => "https://stackoverflow.com/users/47529/chaos", "thing_url" => "https://stackoverflow.com/a/1147952/1460422", "icon" => "https://www.gravatar.com/avatar/aaee40db39ad6b164cfb89cb6ad4d176?s=328&d=identicon&s=24" ], "Parsedown" => [ "author" => "Emanuil Rusev and others", "author_url" => "https://github.com/erusev/", "thing_url" => "https://github.com/erusev/parsedown/", "icon" => "https://avatars1.githubusercontent.com/u/184170?v=3&s=24" ], "CSS Minification Code" => [ "author" => "Jean", "author_url" => "http://www.catswhocode.com/", "thing_url" => "http://www.catswhocode.com/blog/3-ways-to-compress-css-files-using-php" ], "Slightly modified version of Slimdown" => [ "author" => "Johnny Broadway", "author_url" => "https://github.com/jbroadway", "thing_url" => "https://gist.github.com/jbroadway/2836900", "icon" => "https://avatars2.githubusercontent.com/u/87886?v=3&s=24" ], "Insert tab characters into textareas" => [ "author" => "Unknown", "author_url" => "http://stackoverflow.com/q/6140632/1460422", "thing_url" => "https://jsfiddle.net/2wAzx/13/", ], "Default Favicon" => [ "author" => "bluefrog23", "author_url" => "https://openclipart.org/user-detail/bluefrog23/", "thing_url" => "https://openclipart.org/detail/19571/peppermint-candy-by-bluefrog23" ], "Bug Reports" => [ "author" => "nibreh", "author_url" => "https://github.com/nibreh/", "thing_url" => "", "icon" => "https://avatars2.githubusercontent.com/u/7314006?v=3&s=24" ] ]; //// Credits html renderer //// $credits_html = "

\n"; foreach($credits as $thing => $author_details) { $credits_html .= "
• "; $credits_html .= "$thing by "; if(isset($author_details["icon"])) $credits_html .= " "; $credits_html .= "" . $author_details["author"] . ""; $credits_html .= "
\n"; } $credits_html .= "

"; /////////////////////////////// //// Module html renderer //// $modules_html = ""; foreach($modules as $module) { $modules_html .= " \n"; } $modules_html .= "

Name	Version	Author	Description
" . $module["name"] . "	" . $module["version"] . "	" . $module["author"] . "	" . $module["description"] . "

"; ////////////////////////////// $title = "Credits - $settings->sitename"; $content = "

$settings->sitename credits

$settings->sitename is powered by Pepperminty Wiki - an entire wiki packed inside a single file, which was built by Starbeamrainbowlabs, and can be found on GitHub (contributors will also be listed here in the future). Pepperminty Wiki is licensed under the Mozilla Public License 2.0 (simple version).

Main Credits

$credits_html

Site status

Site name:	$settings->sitename ({$settings->admindisplaychar}Update, {$settings->admindisplaychar}Edit master settings, Export as zip - Check for permission first)
Pepperminty Wiki version:	$version
Number of pages:	" . count(get_object_vars($pageindex)) . "
Number of modules:	" . count($modules) . "

Installed Modules

$modules_html"; exit(page_renderer::render_main($title, $content)); }); } ]); register_module([ "name" => "Debug Information", "version" => "0.1.1", "author" => "Starbeamrainbowlabs", "description" => "Adds a debug action for administrator use only that collects a load of useful information to make reporting bugs easier.", "id" => "page-debug-info", "code" => function() { global $settings, $env; /** * @api {get} ?action=debug Get a debug dump * @apiName Debug * @apiGroup Utility * @apiPermission Moderator * * @apiUse UserNotModeratorError */ /* * ██████ ███████ ██████ ██ ██ ██████ * ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ █████ ██████ ██ ██ ██ ███ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ███████ ██████ ██████ ██████ */ add_action("debug", function() { global $settings, $env, $paths, $version; header("content-type: text/plain"); if(!$env->is_admin) { exit("You must be logged in as an moderator in order to generate debugging information."); } $title = "$settings->sitename debug report"; echo("$title\n"); echo(str_repeat("=", strlen($title)) . "\n"); echo("Powered by Pepperminty Wiki version $version.\n"); echo("This report may contain personal information.\n\n"); echo("Environment: "); echo(var_export($env, true)); echo("\nPaths: "); var_dump(var_export($paths, true)); echo("\nServer information:\n"); echo("uname -a: " . php_uname() . "\n"); echo("Path: " . getenv("PATH") . "\n"); echo("Temporary directory: " . sys_get_temp_dir() . "\n"); echo("Server: " . $_SERVER["SERVER_SOFTWARE"] . "\n"); echo("Web root: " . $_SERVER["DOCUMENT_ROOT"] . "\n"); echo("Web server user: " . exec("whoami") . "\n"); echo("PHP version: " . phpversion() . "\n"); echo("index.php location: " . __FILE__ . "\n"); echo("index.php file permissions: " . substr(sprintf('%o', fileperms("./index.php")), -4) . "\n"); echo("Current folder permissions: " . substr(sprintf('%o', fileperms(".")), -4) . "\n"); echo("Storage directory permissions: " . substr(sprintf('%o', fileperms($env->storage_prefix)), -4) . "\n"); echo("Loaded extensions: " . implode(", ", get_loaded_extensions()) . "\n"); echo("Settings:\n-----\n"); $settings_export = explode("\n", var_export($settings, true)); foreach ($settings_export as &$row) { if(preg_match("/(sitesecret|email)/i", $row)) $row = "********* secret *********"; } echo(implode("\n", $settings_export)); echo("\n-----\n"); exit(); }); if($env->is_admin) { add_help_section("950-debug-information", "Gathering debug information", "

As a moderator, $settings->sitename gives you the ability to generate a report on $settings->sitename's installation of Pepperminty Wiki for debugging purposes.

To generate such a report, visit the debug action or click here.

"); } } ]); register_module([ "name" => "Page deleter", "version" => "0.10", "author" => "Starbeamrainbowlabs", "description" => "Adds an action to allow administrators to delete pages.", "id" => "page-delete", "code" => function() { global $settings; /** * @api {post} ?action=delete Delete a page * @apiDescription Delete a page and all its associated data. * @apiName DeletePage * @apiGroup Page * @apiPermission Moderator * * @apiParam {string} page The name of the page to delete. * @apiParam {string} delete Set to 'yes' to actually delete the page. * * @apiUse UserNotModeratorError * @apiError PageNonExistentError The specified page doesn't exist */ /* * ██████ ███████ ██ ███████ ████████ ███████ * ██ ██ ██ ██ ██ ██ ██ * ██ ██ █████ ██ █████ ██ █████ * ██ ██ ██ ██ ██ ██ ██ * ██████ ███████ ███████ ███████ ██ ███████ */ add_action("delete", function() { global $pageindex, $settings, $env, $paths, $modules; if(!$settings->editing) { exit(page_renderer::render_main("Error: Editing disabled - Deleting $env->page", "

You tried to delete $env->page, but editing is disabled on this wiki.

If you wish to delete this page, please re-enable editing on this wiki first.

Go back to $env->page.

Nothing has been changed.

")); } if(!$env->is_admin) { exit(page_renderer::render_main("Error: Insufficient permissions - Deleting $env->page", "

You tried to delete $env->page, but you are not an admin so you don't have permission to do that.

You should try logging in as an admin.

")); } if(!isset($pageindex->{$env->page})) { exit(page_renderer::render_main("Error: Non-existent page - Deleting $env->page", "

You tried to delete $env->page, but that page doesn't appear to exist in the first page. Go back to the $settings->defaultpage.

")); } if(!isset($_GET["delete"]) or $_GET["delete"] !== "yes") { exit(page_renderer::render_main("Deleting $env->page", "

You are about to delete $env->page" . (module_exists("feature-history")?" and all its revisions":"") . ". You can't undo this!

Click here to delete $env->page.

Click here to go back.")); } $page = $env->page; // Delete the associated file if it exists if(!empty($pageindex->$page->uploadedfile)) { unlink($env->storage_prefix . $pageindex->$page->uploadedfilepath); } // While we're at it, we should delete all the revisions too foreach($pageindex->{$env->page}->history as $revisionData) { unlink($env->storage_prefix . $revisionData->filename); } // Delete the page from the page index unset($pageindex->$page); // Save the new page index file_put_contents($paths->pageindex, json_encode($pageindex, JSON_PRETTY_PRINT)); // Remove the page's name from the id index ids::deletepagename($env->page); // Delete the page from the search index, if that module is installed if(module_exists("feature-search")) { $pageid = ids::getid($env->page); $invindex = search::load_invindex($paths->searchindex); search::delete_entry($invindex, $pageid); search::save_invindex($paths->searchindex, $invindex); } // Delete the page from the disk unlink("$env->storage_prefix$env->page.md"); // Add a recent change announcing the deletion if the recent changes // module is installed if(module_exists("feature-recent-changes")) { add_recent_change([ "type" => "deletion", "timestamp" => time(), "page" => $env->page, "user" => $env->user, ]); } exit(page_renderer::render_main("Deleting $env->page - $settings->sitename", "

$env->page has been deleted. Go back to the main page.

")); }); // Register a help section add_help_section("60-delete", "Deleting Pages", "

If you are logged in as an adminitrator, then you have the power to delete pages. To do this, click "Delete" in the "More..." menu when browsing the pge you wish to delete. When you are sure that you want to delete the page, click the given link.

Warning: Once a page has been deleted, you can't bring it back! You will need to recover it from your backup, if you have one (which you really should).

"); } ]); register_module([ "name" => "Page editor", "version" => "0.15.1", "author" => "Starbeamrainbowlabs", "description" => "Allows you to edit pages by adding the edit and save actions. You should probably include this one.", "id" => "page-edit", "code" => function() { global $settings, $env; /** * @api {get} ?action=edit&page={pageName}[&newpage=yes] Get an editing page * @apiDescription Gets an editing page for a given page. If you don't have permission to edit the page in question, a view source pagee is returned instead. * @apiName EditPage * @apiGroup Page * @apiPermission Anonymous * * @apiUse PageParameter * @apiParam {string} newpage Set to 'yes' if a new page is being created. Only affects a few bits of text here and there, and the HTTP response code recieved on success from the `save` action. */ /* * _ _ _ * ___ __| (_) |_ * / _ \/ _` | | __| * | __/ (_| | | |_ * \___|\__,_|_|\__| * %edit% */ add_action("edit", function() { global $pageindex, $settings, $env; $filename = "$env->storage_prefix$env->page.md"; $page = $env->page; $creatingpage = !isset($pageindex->$page); if((isset($_GET["newpage"]) and $_GET["newpage"] == "true") or $creatingpage) { $title = "Creating $env->page"; } else { $title = "Editing $env->page"; } $pagetext = ""; if(isset($pageindex->$page)) { $pagetext = file_get_contents($filename); } $isOtherUsersPage = false; if( $settings->user_page_prefix == mb_substr($env->page, 0, mb_strlen($settings->user_page_prefix)) and // The current page is a user page of some sort ( !$env->is_logged_in or // the user isn't logged in..... extract_user_from_userpage($env->page) !== $env->user // ...or it's not under this user's own name ) ) { $isOtherUsersPage = true; } if((!$env->is_logged_in and !$settings->anonedits) or // if we aren't logged in and anonymous edits are disabled !$settings->editing or // or editing is disabled ( isset($pageindex->$page) and // or if the page exists isset($pageindex->$page->protect) and // the protect property exists $pageindex->$page->protect and // the protect property is true !$env->is_admin // the user isn't an admin ) or $isOtherUsersPage // this page actually belongs to another user ) { if(!$creatingpage) { // The page already exists - let the user view the page source $sourceViewContent = "

$settings->sitename does not allow anonymous users to make edits. You can view the source of $env->page below, but you can't edit it. You could, however, try logging in.

\n"; if($env->is_logged_in) $sourceViewContent = "

$env->page is protected, and you aren't an administrator or moderator. You can view the source of $env->page below, but you can't edit it.

\n"; if($isOtherUsersPage) $sourceViewContent = "

$env->page is a special user page which acutally belongs to " . extract_user_from_userpage($env->page) . ", another user on $settings->sitename. Because of this, you are not allowed to edit it (though you can always edit your own page and any pages under it if you're logged in). You can, however, vieww it's source below.

"; // Append a view of the page's source $sourceViewContent .= "$pagetext"; exit(page_renderer::render_main("Viewing source for $env->page", $sourceViewContent)); } else { $errorMessage = "

The page $env->page does not exist, but you do not have permission to create it.

If you haven't already, perhaps you should try logging in.

\n"; if($isOtherUsersPage) { $errorMessage = "

The page " . htmlentities($env->page) . " doesn't exist, but you can't create it because it's a page belonging to another user.

\n"; if(!$env->is_logged_in) $errorMessage .= "

You could try logging in.

\n"; } http_response_code(404); exit(page_renderer::render_main("404 - $env->page", $errorMessage)); } } $content = "

$title

"; $page_tags = implode(", ", (!empty($pageindex->{$env->page}->tags)) ? $pageindex->{$env->page}->tags : []); if(!$env->is_logged_in and $settings->anonedits) { $content .= "

Warning: You are not logged in! Your IP address may be recorded.

"; } $content .= "
$pagetext

$settings->editing_message

"; // Allow tab characters in the page editor page_renderer::AddJSSnippet("window.addEventListener('load', function(event) { // Adapted from https://jsfiddle.net/2wAzx/13/ document.querySelector(\"[name=content]\").addEventListener(\"keydown\", (event) => { if(event.keyCode !== 9) return true; var currentValue = event.target.value, startPos = event.target.selectionStart, endPos = event.target.selectionEnd; event.target.value = currentValue.substring(0, startPos) + \"\\t\" + currentValue.substring(endPos); event.target.selectionStart = event.target.selectionEnd = startPos + 1; event.stopPropagation(); event.preventDefault(); return false; }); });"); // Utilise the mirror to automatically resize the textarea to fit it's content page_renderer::AddJSSnippet('function updateTextSize(textarea, mirror, event) { let textareaFontSize = parseFloat(getComputedStyle(textarea).fontSize); let textareaWidth = textarea.getBoundingClientRect().width;// - parseInt(textarea.style.padding); mirror.style.width = `${textareaWidth}px`; mirror.innerText = textarea.value; textarea.style.height = `${mirror.offsetHeight + (textareaFontSize * 5)}px`; } function trackTextSize(textarea) { let mirror = textarea.nextElementSibling; textarea.addEventListener("input", updateTextSize.bind(null, textarea, mirror)); updateTextSize(textarea, mirror, null); } window.addEventListener("load", function(event) { trackTextSize(document.querySelector("textarea[name=content]")); }); '); // ~ /// ~~~ Smart saving ~~~ /// // TODO: Add a button to press that restores the content that you were working on before. page_renderer::AddJSSnippet('document.addEventListener("load", function(event) { // Smart saving function getSmartSaveKey() { return document.querySelector("main h1").innerHTML.replace("Creating ", "").replace("Editing ", "").trim(); } // Saving document.querySelector("textarea[name=content]").addEventListener("keyup", function(event) { window.localStorage.setItem(getSmartSaveKey(), event.target.value) }); // Loading window.addEventListener("load", function(event) { var editor = document.querySelector("textarea[name=content]"); if(editor.value.length > 0) return; // Don\'t restore if there\'s data in the editor already editor.value = localStorage.getItem(getSmartSaveKey()); }); });'); exit(page_renderer::render_main("$title - $settings->sitename", $content)); }); /** * @api {post} ?action=save&page={pageName} Save an edit to a page. * @apiDescription Saves an edit to a page. If an edit conflict is encountered, then a conflict resolution page is returned instead. * @apiName EditPage * @apiGroup Page * @apiPermission Anonymous * * @apiUse PageParameter * @apiParam {string} newpage GET only. Set to 'yes' to indicate that this is a new page that is being saved. Only affects the HTTP response code you recieve upon success. * @apiParam {string} content POST only. The new content to save to the given filename. * @apiParam {string} tags POST only. A comma-separated list of tags to assign to the current page. Will replace the existing list of tags, if any are present. * @apiParam {string} prev-content-hash POST only. The hash of the original content before editing. If this hash is found to be different to a hash computed of the currentl saved content, a conflict resolution page will be returned instead of saving the provided content. * * @apiError UnsufficientPermissionError You don't currently have sufficient permissions to save an edit. */ /* * * ___ __ ___ _____ * / __|/ _` \ \ / / _ \ * \__ \ (_| |\ V / __/ * |___/\__,_| \_/ \___| * %save% */ add_action("save", function() { global $pageindex, $settings, $env, $save_preprocessors, $paths; if(!$settings->editing) { header("location: index.php?page=$env->page"); exit(page_renderer::render_main("Error saving edit", "

Editing is currently disabled on this wiki.

")); } if(!$env->is_logged_in and !$settings->anonedits) { http_response_code(403); header("refresh: 5; url=index.php?page=$env->page"); exit("You are not logged in, so you are not allowed to save pages on $settings->sitename. Redirecting in 5 seconds...."); } $page = $env->page; if(( isset($pageindex->$page) and isset($pageindex->page->protect) and $pageindex->$page->protect ) and !$env->is_admin) { http_response_code(403); header("refresh: 5; url=index.php?page=$env->page"); exit("$env->page is protected, and you aren't logged in as an administrator or moderator. Your edit was not saved. Redirecting in 5 seconds..."); } if(!isset($_POST["content"])) { http_response_code(400); header("refresh: 5; url=index.php?page=$env->page"); exit("Bad request: No content specified."); } // Make sure that the directory in which the page needs to be saved exists if(!is_dir(dirname("$env->storage_prefix$env->page.md"))) { // Recursively create the directory if needed mkdir(dirname("$env->storage_prefix$env->page.md"), 0775, true); } // Read in the new page content $pagedata = $_POST["content"]; // We don't need to santise the input here as Parsedown has an // option that does this for us, and is _way_ more intelligent about // it. // Read in the new page tags, so long as there are actually some // tags to read in $page_tags = []; if(strlen(trim($_POST["tags"])) > 0) { $page_tags = explode(",", $_POST["tags"]); // Trim off all the whitespace foreach($page_tags as &$tag) $tag = trim($tag); } // Check for edit conflicts if(!empty($pageindex->{$env->page}) && file_exists($env->storage_prefix . $pageindex->{$env->page}->filename)) { $existing_content_hash = sha1_file($env->storage_prefix . $pageindex->{$env->page}->filename); if(isset($_POST["prev-content-hash"]) and $existing_content_hash != $_POST["prev-content-hash"]) { $existingPageData = htmlentities(file_get_contents($env->storage_prefix . $env->storage_prefix . $pageindex->{$env->page}->filename)); // An edit conflict has occurred! We should get the user to fix it. $content = "

Resolving edit conflict - $env->page

"; if(!$env->is_logged_in and $settings->anonedits) { $content .= "

Warning: You are not logged in! Your IP address may be recorded.

"; } $content .= "

An edit conflict has arisen because someone else has saved an edit to $env->page since you started editing it. Both texts are shown below, along the differences between the 2 conflicting revisions. To continue, please merge your changes with the existing content. Note that only the text in the existing content box will be kept when you press the \"Resolve Conflict\" button at the bottom of the page.

Existing content

$existingPageData

Differences

Your content

$pagedata

$settings->editing_message

"; // Insert a reference to jsdiff to generate the diffs $diffScript = <<<'DIFFSCRIPT' window.addEventListener("load", function(event) { var destination = document.getElementById("highlighted-diff"), diff = JsDiff.diffWords(document.getElementById("original-content").value, document.getElementById("new-content").value), output = ""; diff.forEach(function(change) { var classes = "token"; if(change.added) classes += " diff-added"; if(change.removed) classes += " diff-removed"; output += `${change.value}`; }); destination.innerHTML = output; }); DIFFSCRIPT; $content .= "\n \n"; exit(page_renderer::render_main("Edit Conflict - $env->page - $settings->sitename", $content)); } } // -----~~~==~~~----- // Update the inverted search index // Construct an index for the old and new page content $oldindex = []; $oldpagedata = ""; // We need the old page data in order to pass it to the preprocessor if(file_exists("$env->storage_prefix$env->page.md")) { $oldpagedata = file_get_contents("$env->storage_prefix$env->page.md"); $oldindex = search::index($oldpagedata); } $newindex = search::index($pagedata); // Compare the indexes of the old and new content $additions = []; $removals = []; search::compare_indexes($oldindex, $newindex, $additions, $removals); // Load in the inverted index $invindex = search::load_invindex($env->storage_prefix . "invindex.json"); // Merge the changes into the inverted index search::merge_into_invindex($invindex, ids::getid($env->page), $additions, $removals); // Save the inverted index back to disk search::save_invindex($env->storage_prefix . "invindex.json", $invindex); // -----~~~==~~~----- if(file_put_contents("$env->storage_prefix$env->page.md", $pagedata) !== false) { $page = $env->page; // Make sure that this page's parents exist check_subpage_parents($page); // Update the page index if(!isset($pageindex->$page)) { $pageindex->$page = new stdClass(); $pageindex->$page->filename = "$env->page.md"; } $pageindex->$page->size = strlen($_POST["content"]); $pageindex->$page->lastmodified = time(); if($env->is_logged_in) $pageindex->$page->lasteditor = utf8_encode($env->user); else // TODO: Add an option to record the user's IP here instead $pageindex->$page->lasteditor = utf8_encode("anonymous"); $pageindex->$page->tags = $page_tags; // A hack to resave the pagedata if the preprocessors have // changed it. We need this because the preprocessors *must* // run _after_ the pageindex has been updated. $pagedata_orig = $pagedata; // Execute all the preprocessors foreach($save_preprocessors as $func) { $func($pageindex->$page, $pagedata, $oldpagedata); } if($pagedata !== $pagedata_orig) file_put_contents("$env->storage_prefix$env->page.md", $pagedata); file_put_contents($paths->pageindex, json_encode($pageindex, JSON_PRETTY_PRINT)); if(isset($_GET["newpage"])) http_response_code(201); else http_response_code(200); // header("content-type: text/plain"); header("location: index.php?page=$env->page&edit_status=success&redirect=no"); exit(); } else { http_response_code(507); exit(page_renderer::render_main("Error saving page - $settings->sitename", "

$settings->sitename failed to write your changes to the server's disk. Your changes have not been saved, but you might be able to recover your edit by pressing the back button in your browser.

Please tell the administrator of this wiki (" . $settings->admindetails_name . ") about this problem.

")); } }); add_help_section("15-editing", "Editing", "

To edit a page on $settings->sitename, click the edit button on the top bar. Note that you will probably need to be logged in. If you do not already have an account you will need to ask $settings->sitename's administrator for an account since there is no registration form. Note that the $settings->sitename's administrator may have changed these settings to allow anonymous edits.

Editing is simple. The edit page has a sizeable box that contains a page's current contents. Once you are done altering it, add or change the comma separated list of tags in the field below the editor and then click save page.

A reference to the syntax that $settings->sitename supports can be found below.

"); add_help_section("17-user-pages", "User Pages", "

If you are logged in, $settings->sitename allocates you your own user page that only you can edit. On $settings->sitename, user pages are sub-pages of the " . htmlentities($settings->user_page_prefix) . " page, and each user page can have a nested structure of pages underneath it, just like a normal page. Your user page is located at " . htmlentities(get_user_pagename($env->user)) . ".

"); } ]); register_module([ "name" => "Export", "version" => "0.4", "author" => "Starbeamrainbowlabs", "description" => "Adds a page that you can use to export your wiki as a .zip file. Uses \$settings->export_only_allow_admins, which controls whether only admins are allowed to export the wiki.", "id" => "page-export", "code" => function() { global $settings; /** * @api {get} ?action=export Export the all the wiki's content * @apiDescription Export all the wiki's content. Please ask for permission before making a request to this URI. Note that some wikis may only allow moderators to export content. * @apiName Export * @apiGroup Utility * @apiPermission Anonymous * * @apiError InsufficientExportPermissionsError The wiki has the export_allow_only_admins option turned on, and you aren't logged into a moderator account. * @apiError CouldntOpenTempFileError Pepperminty Wiki couldn't open a temporary file to send the compressed archive to. * @apiError CouldntCloseTempFileError Pepperminty Wiki couldn't close the temporary file to finish creating the zip archive ready for downloading. */ /* * ███████ ██ ██ ██████ ██████ ██████ ████████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * █████ ███ ██████ ██ ██ ██████ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██ ██ ██ ██████ ██ ██ ██ */ add_action("export", function() { global $settings, $pageindex, $env; if($settings->export_allow_only_admins && !$env->is_admin) { http_response_code(401); exit(page_renderer::render("Export error - $settings->sitename", "Only administrators of $settings->sitename are allowed to export the wiki as a zip. Return to the $settings->defaultpage.")); } $tmpfilename = tempnam(sys_get_temp_dir(), "pepperminty-wiki-"); $zip = new ZipArchive(); if($zip->open($tmpfilename, ZipArchive::CREATE) !== true) { http_response_code(507); exit(page_renderer::render("Export error - $settings->sitename", "Pepperminty Wiki was unable to open a temporary file to store the exported data in. Please contact $settings->sitename's administrator (" . $settings->admindetails_name . " at " . hide_email($settings->admindetails_email) . ") for assistance.")); } foreach($pageindex as $entry) { $zip->addFile("$env->storage_prefix$entry->filename", $entry->filename); } if($zip->close() !== true) { http_response_code(500); exit(page_renderer::render("Export error - $settings->sitename", "Pepperminty wiki was unable to close the temporary zip file after creating it. Please contact $settings->sitename's administrator (" . $settings->admindetails_name . " at " . hide_email($settings->admindetails_email) . ") for assistance.")); } header("content-type: application/zip"); header("content-disposition: attachment; filename=$settings->sitename-export.zip"); header("content-length: " . filesize($tmpfilename)); $zip_handle = fopen($tmpfilename, "rb"); fpassthru($zip_handle); fclose($zip_handle); unlink($tmpfilename); }); // Add a section to the help page add_help_section("50-export", "Exporting", "

$settings->sitename supports exporting the entire wiki's content as a zip. Note that you may need to be a moderator in order to do this. Also note that you should check for permission before doing so, even if you are able to export without asking.

To perform an export, go to the credits page and click "Export as zip - Check for permission first".

"); } ]); register_module([ "name" => "Help page", "version" => "0.9.3", "author" => "Starbeamrainbowlabs", "description" => "Adds a rather useful help page. Access through the 'help' action. This module also exposes help content added to Pepperminty Wiki's inbuilt invisible help section system.", "id" => "page-help", "code" => function() { global $settings; /** * @api {get} ?action=help[&dev=yes] Get a help page * @apiDescription Get a customised help page. This page will be slightly different for every wiki, depending on their name, settings, and installed modules. * @apiName Help * @apiGroup Utility * @apiPermission Anonymous * * @apiParam {string} dev Set to 'yes' to get a developer help page instead. The developer help page gives some general information about which modules and help page sections are registered, and other various (non-sensitive) settings. */ /* * ██ ██ ███████ ██ ██████ * ██ ██ ██ ██ ██ ██ * ███████ █████ ██ ██████ * ██ ██ ██ ██ ██ * ██ ██ ███████ ███████ ██ */ add_action("help", function() { global $env, $paths, $settings, $version, $help_sections, $actions; // Sort the help sections by key ksort($help_sections, SORT_NATURAL); if(isset($_GET["dev"]) and $_GET["dev"] == "yes") { $title = "Developers Help - $settings->sitename"; $content = "

$settings->sitename runs on Pepperminty Wiki, an entire wiki packed into a single file. This page contains some information that developers may find useful.

A full guide to developing a Pepperminty Wiki module can be found on GitHub.

Registered Help Sections

The following help sections are currently registered:

\n"; $totalSize = 0; foreach($help_sections as $index => $section) { $sectionLength = strlen($section["content"]); $totalSize += $sectionLength; $content .= "\t\t\t\n"; } $content .= "\t\t\t\n"; $content .= "\t\t

Index	Title	Length
$index	" . $section["title"] . "	" . human_filesize($sectionLength) . "
Total:		" . human_filesize($totalSize) . "

\n"; $content .= "

Registered Actions

"; $registeredActions = array_keys(get_object_vars($actions)); sort($registeredActions); $content .= "

The following actions are currently registered:

\n"; $content .= "

" . implode(", ", $registeredActions) . "

"; $content .= "

Environment

\n"; $content .= "
\n"; $content .= "
• $settings->sitename's root directory is " . (!is_writeable(__DIR__) ? "not " : "") . "writeable.
\n"; $content .= "
• The page index is currently " . human_filesize(filesize($paths->pageindex)) . " in size, and took " . $env->perfdata->pageindex_decode_time . "ms to decode.
"; if(module_exists("feature-search")) { search::measure_invindex_load_time($paths->searchindex); $content .= "
• The search index is currently " . human_filesize(filesize($paths->searchindex)) . " in size, and took " . $env->perfdata->searchindex_decode_time . "ms to decode.
"; } $content .= "
• The id index is currently " . human_filesize(filesize($paths->idindex)) . " in size, and took " . $env->perfdata->idindex_decode_time . "ms to decode.
"; $content .= "
\n"; $content .= "

Data

\n"; $wikiSize = new stdClass(); $wikiSize->all = 0; $wikiSize->images = 0; $wikiSize->audio = 0; $wikiSize->videos = 0; $wikiSize->pages = 0; $wikiSize->history = 0; $wikiSize->indexes = 0; $wikiSize->other = 0; $wikiFiles = glob_recursive($env->storage_prefix . "*"); foreach($wikiFiles as $filename) { $extension = strtolower(substr($filename, strrpos($filename, ".") + 1)); if($extension === "php") continue; // Skip php files $nextFilesize = filesize($filename); $wikiSize->all += $nextFilesize; if($extension[0] === "r") // It's a revision of a page $wikiSize->history += $nextFilesize; else if($extension == "md") // It's a page $wikiSize->pages += $nextFilesize; else if($extension == "json") // It's an index $wikiSize->indexes += $nextFilesize; else if(in_array($extension, [ // It's an uploaded image "jpg", "jpeg", "png", "gif", "webp", "svg" ])) $wikiSize->images += $nextFilesize; else if(in_array($extension, [ "mp3", "ogg", "wav", "aac", "m4a" ])) // It's an audio file $wikiSize->audio += $nextFilesize; else if(in_array($extension, [ "avi", "mp4", "m4v", "webm" ])) // It's a video file $wikiSize->videos += $nextFilesize; else $wikiSize->other += $nextFilesize; } $content .= "

$settings->sitename is currently " . human_filesize($wikiSize->all) . " in size.

\n"; $content .= "
Indexes: " . human_filesize($wikiSize->indexes) . "
Pages: " . human_filesize($wikiSize->pages) . "
Page History: " . human_filesize($wikiSize->history) . "
Images: " . human_filesize($wikiSize->images) . "
\n"; if($wikiSize->audio > 0) $content .= "
Audio: " . human_filesize($wikiSize->audio) . "
\n"; if($wikiSize->videos > 0) $content .= "
Videos: " . human_filesize($wikiSize->videos) . "
\n"; if($wikiSize->other > 0) $content .= "
Other: " . human_filesize($wikiSize->other) . "
\n"; $content .= "
"; } else { $title = "Help - $settings->sitename"; $content = "

$settings->sitename Help

Welcome to $settings->sitename!

$settings->sitename is powered by Pepperminty Wiki, a complete wiki in a box you can drop into your server and expect it to just work.

"; // Todo Insert a table of contents here? foreach($help_sections as $index => $section) { // Todo add a button that you can click to get a permanent link // to this section. $content .= "

" . $section["title"] . "

\n"; $content .= $section["content"] . "\n"; } } exit(page_renderer::render_main($title, $content)); }); // Register a help section on general navigation add_help_section("5-navigation", "Navigating", "

All the navigation links can be found on the top bar, along with a search box (if your site administrator has enabled it). There is also a "More..." menu in the top right that contains some additional links that you may fine useful.

This page, along with the credits page, can be found on the bar at the bottom of every page.

"); add_help_section("1-extra", "Extra Information", "

You can find out whch version of Pepperminty Wiki $settings->sitename is using by visiting the credits page.

Information for developers can be found on this page.

"); } ]); register_module([ "name" => "Page list", "version" => "0.10.2", "author" => "Starbeamrainbowlabs", "description" => "Adds a page that lists all the pages in the index along with their metadata.", "id" => "page-list", "code" => function() { global $settings; /** * @api {get} ?action=list List all pages * @apiDescription Gets a list of all the pages currently stored on the wiki. * @apiName ListPages * @apiGroup Page * @apiPermission Anonymous */ /* * ██ ██ ███████ ████████ * ██ ██ ██ ██ * ██ ██ ███████ ██ * ██ ██ ██ ██ * ███████ ██ ███████ ██ */ add_action("list", function() { global $pageindex, $settings; $title = "All Pages"; $content = "

$title on $settings->sitename

"; $sorted_pageindex = get_object_vars($pageindex); ksort($sorted_pageindex, SORT_NATURAL); $content .= generate_page_list(array_keys($sorted_pageindex)); exit(page_renderer::render_main("$title - $settings->sitename", $content)); }); /** * @api {get} ?action=list-tags[&tag=] Get a list of tags or pages with a certain tag * @apiDescription Gets a list of all tags on the wiki. Adding the `tag` parameter causes a list of pages with the given tag to be returned instead. * @apiName ListTags * @apiGroup Utility * @apiPermission Anonymous * * @apiParam {string} tag Optional. If provided a list of all the pages with that tag is returned instead. */ /* * ██ ██ ███████ ████████ ████████ █████ ██████ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ███████ ██ █████ ██ ███████ ██ ███ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██ ███████ ██ ██ ██ ██ ██████ ███████ */ add_action("list-tags", function() { global $pageindex, $settings; if(!isset($_GET["tag"])) { // Render a list of all tags $all_tags = []; foreach($pageindex as $entry) { if(!isset($entry->tags)) continue; foreach($entry->tags as $tag) { if(!in_array($tag, $all_tags)) $all_tags[] = $tag; } } sort($all_tags, SORT_NATURAL); $content = "

All tags

\n"; foreach($all_tags as $tag) { $content .= "
• $tag
\n"; } $content .= "
\n"; exit(page_renderer::render("All tags - $settings->sitename", $content)); } $tag = $_GET["tag"]; $sorted_pageindex = get_object_vars($pageindex); ksort($sorted_pageindex, SORT_NATURAL); $pagelist = []; foreach($pageindex as $pagename => $pagedetails) { if(empty($pagedetails->tags)) continue; if(in_array($tag, $pagedetails->tags)) $pagelist[] = $pagename; } $content = "

Tag List: $tag

\n"; $content .= generate_page_list($pagelist); $content .= "

(All tags)

\n"; exit(page_renderer::render("$tag - Tag List - $settings->sitename", $content)); }); add_help_section("30-all-pages-tags", "Listing pages and tags", "

All the pages and tags on $settings->sitename are listed on a pair of pages to aid navigation. The list of all pages on $settings->sitename can be found by clicking "All Pages" on the top bar. The list of all the tags currently in use can be found by clicking "All Tags" in the "More..." menu in the top right.

Each tag on either page can be clicked, and leads to a list of all pages that possess that particular tag.

Redirect pages are shown in italics. A page's last known editor is also shown next to each entry on a list of pages, along with the last known size (which should correct, unless it was changed outside of $settings->sitename) and the time since the last modification (hovering over this will show the exact time that the last modification was made in a tooltip).

"); } ]); function generate_page_list($pagelist) { global $pageindex; // ✎ ✎ 🕒 🕒 $result = "
\n"; foreach($pagelist as $pagename) { // Construct a list of tags that are attached to this page ready for display $tags = ""; // Make sure that this page does actually have some tags first if(isset($pageindex->$pagename->tags)) { foreach($pageindex->$pagename->tags as $tag) { $tags .= "$tag, "; } $tags = substr($tags, 0, -2); // Remove the last ", " from the tag list } $pageDisplayName = $pagename; if(isset($pageindex->$pagename) and !empty($pageindex->$pagename->redirect)) $pageDisplayName = "$pageDisplayName"; $result .= "
• $pageDisplayName (" . human_filesize($pageindex->$pagename->size) . ") ✎ " . $pageindex->$pagename->lasteditor . " " . human_time_since($pageindex->$pagename->lastmodified) . " $tags
"; } $result .= "
\n"; return $result; } register_module([ "name" => "Login", "version" => "0.8.4", "author" => "Starbeamrainbowlabs", "description" => "Adds a pair of actions (login and checklogin) that allow users to login. You need this one if you want your users to be able to login.", "id" => "page-login", "code" => function() { global $settings; /** * @api {get} ?action=login[&failed=yes][&returnto={someUrl}] Get the login page * @apiName Login * @apiGroup Authorisation * @apiPermission Anonymous * * @apiParam {string} failed Setting to yes causes a login failure message to be displayed above the login form. * @apiParam {string} returnto Set to the url to redirect to upon a successful login. */ /* * ██ ██████ ██████ ██ ███ ██ * ██ ██ ██ ██ ██ ████ ██ * ██ ██ ██ ██ ███ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██████ ██████ ██ ██ ████ */ add_action("login", function() { global $settings, $env; // Build the action url that will actually perform the login $login_form_action_url = "index.php?action=checklogin"; if(isset($_GET["returnto"])) $login_form_action_url .= "&returnto=" . rawurlencode($_GET["returnto"]); if($env->is_logged_in && !empty($_GET["returnto"])) { http_response_code(307); header("location: " . $_GET["returnto"]); } $title = "Login to $settings->sitename"; $content = "

Login to $settings->sitename

\n"; if(isset($_GET["failed"])) $content .= "\t\t

Login failed.

\n"; if(isset($_GET["required"])) $content .= "\t\t

$settings->sitename requires that you login before continuing.

\n"; $content .= "\t\t
Username:
Password:

\n"; exit(page_renderer::render_main($title, $content)); }); /** * @api {post} ?action=checklogin Perform a login * @apiName CheckLogin * @apiGroup Authorisation * @apiPermission Anonymous * * @apiParam {string} user The user name to login with. * @apiParam {string} password The password to login with. * @apiParam {string} returnto The URL to redirect to upon a successful login. * * @apiError InvalidCredentialsError The supplied credentials were invalid. Note that this error is actually a redirect to ?action=login&failed=yes (with the returnto parameter appended if you supplied one) */ /* * ██████ ██ ██ ███████ ██████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ * ██ ███████ █████ ██ █████ * ██ ██ ██ ██ ██ ██ ██ * ██████ ██ ██ ███████ ██████ ██ ██ * * ██ ██████ ██████ ██ ███ ██ * ██ ██ ██ ██ ██ ████ ██ * ██ ██ ██ ██ ███ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██████ ██████ ██ ██ ████ */ add_action("checklogin", function() { global $settings, $env; //actually do the login if(isset($_POST["user"]) and isset($_POST["pass"])) { //the user wants to log in $user = $_POST["user"]; $pass = $_POST["pass"]; if($settings->users->$user->password == hash_password($pass)) { $env->is_logged_in = true; $expiretime = time() + 60*60*24*30; //30 days from now $_SESSION["$settings->sessionprefix-user"] = $user; $_SESSION["$settings->sessionprefix-pass"] = hash_password($pass); $_SESSION["$settings->sessionprefix-expiretime"] = $expiretime; //redirect to wherever the user was going http_response_code(302); if(isset($_GET["returnto"])) header("location: " . $_GET["returnto"]); else header("location: index.php"); exit(); } else { http_response_code(302); $nextUrl = "index.php?action=login&failed=yes"; if(!empty($_GET["returnto"])) $nextUrl .= "&returnto=" . rawurlencode($_GET["returnto"]); header("location: $nextUrl"); exit(); } } else { http_response_code(302); $nextUrl = "index.php?action=login&failed=yes&badrequest=yes"; if(!empty($_GET["returnto"])) $nextUrl .= "&returnto=" . rawurlencode($_GET["returnto"]); header("location: $nextUrl"); exit(); } }); // Register a section on logging in on the help page. add_help_section("30-login", "Logging in", "

In order to edit $settings->sitename and have your edit attributed to you, you need to be logged in. Depending on the settings, logging in may be a required step if you want to edit at all. Thankfully, loggging in is not hard. Simply click the "Login" link in the top left, type your username and password, and then click login.

If you do not have an account yet and would like one, try contacting $settings->admindetails_name, $settings->sitename's administrator and ask them nicely to see if they can create you an account.

"); } ]); /* * @summary Hashes the given password according to the current settings defined * in $settings. * * @param $pass {string} The password to hash. * * @returns {string} The hashed password. Uses sha3 if $settings->use_sha3 is * enabled, or sha256 otherwise. */ function hash_password($pass) { global $settings; if($settings->use_sha3) { return sha3($pass, 256); } else { return hash("sha256", $pass); } } register_module([ "name" => "Logout", "version" => "0.6", "author" => "Starbeamrainbowlabs", "description" => "Adds an action to let users user out. For security reasons it is wise to add this module since logging in automatically opens a session that is valid for 30 days.", "id" => "page-logout", "code" => function() { /** * @api {post} ?action=logout Logout * @apiDescription Logout. Make sure that your bot requests this URL when it is finished - this call not only clears your cookies but also clears the server's session file as well. Note that you can request this when you are already logged out and it will completely wipe your session on the server. * @apiName Logout * @apiGroup Authorisation * @apiPermission Anonymous */ /* * ██ ██████ ██████ ██████ ██ ██ ████████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██ ██ ███ ██ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██████ ██████ ██████ ██████ ██ */ add_action("logout", function() { global $env; $env->is_logged_in = false; unset($env->user); unset($env->pass); //clear the session variables $_SESSION = []; session_destroy(); exit(page_renderer::render_main("Logout Successful", "

Logout Successful

Logout Successful. You can login again here.

")); }); } ]); register_module([ "name" => "Page mover", "version" => "0.9.2", "author" => "Starbeamrainbowlabs", "description" => "Adds an action to allow administrators to move pages.", "id" => "page-move", "code" => function() { global $settings; /** * @api {get} ?action=move[&new_name={newPageName}] Move a page * @apiName Move * @apiGroup Page * @apiPermission Moderator * * @apiParam {string} new_name The new name to move the page to. If not set a page will be returned containing a move page form. * * @apiUse UserNotModeratorError * @apiError EditingDisabledError Editing is disabled on this wiki, so pages can't be moved. * @apiError PageExistsAtDestinationError A page already exists with the specified new name. * @apiError NonExistentPageError The page you're trying to move doesn't exist in the first place. * @apiError PreExistingFileError A pre-existing file on the server's file system was detected. */ /* * ███ ███ ██████ ██ ██ ███████ * ████ ████ ██ ██ ██ ██ ██ * ██ ████ ██ ██ ██ ██ ██ █████ * ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██████ ████ ███████ */ add_action("move", function() { global $pageindex, $settings, $env, $paths; if(!$settings->editing) { exit(page_renderer::render_main("Moving $env->page - error", "

You tried to move $env->page, but editing is disabled on this wiki.

If you wish to move this page, please re-enable editing on this wiki first.

Go back to $env->page.

Nothing has been changed.

")); } if(!$env->is_admin) { exit(page_renderer::render_main("Moving $env->page - Error", "

You tried to move $env->page, but you do not have permission to do that.

You should try logging in as an admin.

")); } if(!isset($_GET["new_name"]) or strlen($_GET["new_name"]) == 0) exit(page_renderer::render_main("Moving $env->page", "

Moving $env->page

Old Name:
New Name:

")); $new_name = makepathsafe($_GET["new_name"]); $page = $env->page; if(!isset($pageindex->$page)) exit(page_renderer::render_main("Moving $env->page - Error", "

You tried to move $env->page to $new_name, but the page with the name $env->page does not exist in the first place.

Nothing has been changed.

")); if($env->page == $new_name) exit(page_renderer::render_main("Moving $env->page - Error", "

You tried to move $page, but the new name you gave is the same as it's current name.

It is possible that you tried to use some characters in the new name that are not allowed and were removed.

Page names may not contain any of these characters: ?%*:|\"><()[]

")); if(isset($pageindex->$page->uploadedfile) and file_exists($new_name)) exit(page_renderer::render_main("Moving $env->page - Error - $settings->sitename", "

Whilst moving the file associated with $env->page, $settings->sitename detected a pre-existing file on the server's file system. Because $settings->sitename can't determine whether the existing file is important to another component of $settings->sitename or it's host web server, the move have been aborted - just in case.

If you know that this move is actually safe, please get your site administrator (" . $settings->admindetails_name . ") to perform the move manually. Their contact address can be found at the bottom of every page (including this one).

")); // Move the page in the page index $pageindex->$new_name = new stdClass(); foreach($pageindex->$page as $key => $value) { $pageindex->$new_name->$key = $value; } unset($pageindex->$page); $pageindex->$new_name->filename = "$new_name.md"; // If this page has an associated file, then we should move that too if(!empty($pageindex->$new_name->uploadedfile)) { // Update the filepath to point to the description and not the image $pageindex->$new_name->filename = $pageindex->$new_name->filename . ".md"; // Move the file in the pageindex $pageindex->$new_name->uploadedfilepath = $new_name; // Move the file on disk rename($env->storage_prefix . $env->page, $env->storage_prefix . $new_name); } // Come to think about it, we should probably move the history while we're at it foreach($pageindex->$new_name->history as &$revisionData) { // We're only interested in edits if($revisionData->type !== "edit") continue; $newRevisionName = $pageindex->$new_name->filename . ".r$revisionData->rid"; // Move the revision to it's new name rename( $env->storage_prefix . $revisionData->filename, $env->storage_prefix . $newRevisionName ); // Update the pageindex entry $revisionData->filename = $newRevisionName; } // Save the updated pageindex file_put_contents($paths->pageindex, json_encode($pageindex, JSON_PRETTY_PRINT)); // Move the page on the disk rename("$env->storage_prefix$env->page.md", "$env->storage_prefix$new_name.md"); // Move the page in the id index ids::movepagename($page, $new_name); // Exit with a nice message exit(page_renderer::render_main("Moving $env->page", "

$env->page has been moved to $new_name successfully.

")); }); // Register a help section add_help_section("60-move", "Moving Pages", "

If you are logged in as an administrator, then you have the power to move pages. To do this, click "Delete" in the "More..." menu when browsing the pge you wish to move. Type in the new name of the page, and then click "Move Page".

"); } ]); register_module([ "name" => "Update", "version" => "0.6.2", "author" => "Starbeamrainbowlabs", "description" => "Adds an update page that downloads the latest stable version of Pepperminty Wiki. This module is currently outdated as it doesn't save your module preferences.", "id" => "page-update", "code" => function() { /** * @api {get} ?action=update[do=yes] Update the wiki * @apiDescription Update the wiki by downloading a new version of Pepperminty Wiki from the URL specified in the settings. Note that unless you change the url from it's default, all custom modules installed will be removed. **Note also that this plugin is currently out of date. Use with extreme caution!** * @apiName Update * @apiGroup Utility * @apiPermission Moderator * * @apiParam {string} do Set to 'yes' to actually do the upgrade. Omission causes a page asking whether an update is desired instead. * @apiParam {string} secret The wiki's secret string that's stored in the settings. * * @apiUse UserNotModeratorError * @apiParam InvalidSecretError The supplied secret doesn't match up with the secret stored in the wiki's settings. */ /* * ██ ██ ██████ ██████ █████ ████████ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██████ ██ ██ ███████ ██ █████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ██ ██████ ██ ██ ██ ███████ */ add_action("update", function() { global $settings, $env; if(!$env->is_admin) { http_response_code(401); exit(page_renderer::render_main("Update - Error", "

You must be an administrator to do that.

")); } if(!isset($_GET["do"]) or $_GET["do"] !== "true" or $_GET["do"] !== "yes") { exit(page_renderer::render_main("Update $settings->sitename", "

This page allows you to update $settings->sitename.

Currently, $settings->sitename is using $settings->version of Pepperminty Wiki.

This script will automatically download and install the latest version of Pepperminty Wiki from the url of your choice (see settings), regardless of whether an update is actually needed (version checking isn't implemented yet).

To update $settings->sitename, fill out the form below and click click the update button.

Note that a backup system has not been implemented yet! If this script fails you will loose your wiki's code and have to re-build it.

$settings->sitename's secret code
")); } if(!isset($_GET["secret"]) or $_GET["secret"] !== $settings->sitesecret) { exit(page_renderer::render_main("Update $settings->sitename - Error", "

You forgot to enter $settings->sitename's secret code or entered it incorrectly. $settings->sitename's secret can be found in the settings portion of index.php.

")); } $settings_separator = "/////////////// Do not edit below this line unless you know what you are doing! ///////////////"; $log = "Beginning update...\n"; $log .= "I am " . __FILE__ . ".\n"; $oldcode = file_get_contents(__FILE__); $log .= "Fetching new code..."; $newcode = file_get_contents($settings->updateurl); $log .= "done.\n"; $log .= "Rewriting " . __FILE__ . "..."; $settings = substr($oldcode, 0, strpos($oldcode, $settings_separator)); $code = substr($newcode, strpos($newcode, $settings_separator)); $result = $settings . $code; $log .= "done.\n"; $log .= "Saving..."; file_put_contents(__FILE__, $result); $log .= "done.\n"; $log .= "Update complete. I am now running on the latest version of Pepperminty Wiki."; $log .= "The version number that I have updated to can be found on the credits or help ages."; exit(page_renderer::render_main("Update - Success", "
• " . implode("
• ", explode("\n", $log)) . "
")); }); } ]); register_module([ "name" => "User list", "version" => "0.1", "author" => "Starbeamrainbowlabs", "description" => "Adds a 'user-list' action that generates a list of users. Supports json output with 'format=json' in the queyr string.", "id" => "page-user-list", "code" => function() { global $settings; /** * @api {get} ?action=user-list[format=json] List all users * @apiName UserList * @apiGroup Utility * @apiPermission Anonymous */ /* * ██ ██ ███████ ███████ ██████ ██ ██ ███████ ████████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ███████ █████ ██████ █████ ██ ██ ███████ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██████ ███████ ███████ ██ ██ ███████ ██ ███████ ██ */ add_action("user-list", function() { global $env, $settings; $userList = array_keys(get_object_vars($settings->users)); if(!empty($_GET["format"]) && $_GET["format"] === "json") { header("content-type: application/json"); exit(json_encode($userList)); } $content = "

User List

\n"; $content .= "
\n"; foreach($userList as $username) $content .= "\t
• " . page_renderer::render_username($username) . "
\n"; $content .= "
\n"; exit(page_renderer::render_main("User List - $settings->sitename", $content)); }); add_help_section("800-raw-page-content", "Viewing Raw Page Content", "

Although you can use the edit page to view a page's source, you can also ask $settings->sitename to send you the raw page source and nothing else. This feature is intented for those who want to automate their interaction with $settings->sitename.

To use this feature, navigate to the page for which you want to see the source, and then alter the action parameter in the url's query string to be raw. If the action parameter doesn't exist, add it. Note that when used on an file's page this action will return the source of the description and not the file itself.

"); } ]); register_module([ "name" => "Page viewer", "version" => "0.16.4", "author" => "Starbeamrainbowlabs", "description" => "Allows you to view pages. You really should include this one.", "id" => "page-view", "code" => function() { /** * @api {get} ?action=view[&page={pageName}][&revision=rid][&printable=yes] View a page * @apiName View * @apiGroup Page * @apiPermission Anonymous * * @apiUse PageParameter * @apiParam {number} revision The revision number to display. * @apiParam {string} mode Optional. The display mode to use. Can hld the following values: 'normal' - The default. Sends a normal page. 'printable' - Sends a printable version of the page. 'contentonly' - Sends only the content of the page, not the extra stuff around it. 'parsedsourceonly' - Sends only the raw rendered source of the page, as it appears just after it has come out of the page parser. Useful for writing external tools (see also the `raw` action). * * @apiError NonExistentPageError The page doesn't exist and editing is disabled in the wiki's settings. If editing isn't disabled, you will be redirected to the edit page instead. * @apiError NonExistentRevisionError The specified revision was not found. */ /* * ██ ██ ██ ███████ ██ ██ * ██ ██ ██ ██ ██ ██ * ██ ██ ██ █████ ██ █ ██ * ██ ██ ██ ██ ██ ███ ██ * ████ ██ ███████ ███ ███ */ add_action("view", function() { global $pageindex, $settings, $env; // Check to make sure that the page exists $page = $env->page; if(!isset($pageindex->$page)) { // todo make this intelligent so we only redirect if the user is actually able to create the page if($settings->editing) { // Editing is enabled, redirect to the editing page http_response_code(307); // Temporary redirect header("location: index.php?action=edit&newpage=yes&page=" . rawurlencode($env->page)); exit(); } else { // Editing is disabled, show an error message http_response_code(404); exit(page_renderer::render_main("404: Page not found - $env->page - $settings->sitename", "

$env->page does not exist.

Since editing is currently disabled on this wiki, you may not create this page. If you feel that this page should exist, try contacting this wiki's Administrator.

")); } } // Perform a redirect if the requested page is a redirect page if(isset($pageindex->$page->redirect) && $pageindex->$page->redirect === true) { $send_redirect = true; if(isset($_GET["redirect"]) && $_GET["redirect"] == "no") $send_redirect = false; if($send_redirect) { // Todo send an explanatory page along with the redirect http_response_code(307); $redirectUrl = "?action=$env->action&redirected_from=$env->page"; $hashCode = ""; $newPage = $pageindex->$page->redirect_target; if(strpos($newPage, "#") !== false) { // Extract the part after the hash symbol $hashCode = substr($newPage, strpos($newPage, "#") + 1); // Remove the hash from the new page name $newPage = substr($newPage, 0, strpos($newPage, "#")); } $redirectUrl .= "&page=$newPage"; if(!empty($pageindex->$newPage->redirect)) $redirectUrl .= "&redirect=no"; if(strlen($hashCode) > 0) $redirectUrl .= "#$hashCode"; header("location: $redirectUrl"); exit(); } } $title = "$env->page - $settings->sitename"; if(isset($pageindex->$page->protect) && $pageindex->$page->protect === true) $title = $settings->protectedpagechar . $title; $content = ""; if(!$env->is_history_revision) $content .= "

$env->page

\n"; else { $content .= "

Revision #{$env->history->revision_number} of $env->page

\n"; $content .= "

(Revision saved by {$env->history->revision_data->editor} " . render_timestamp($env->history->revision_data->timestamp) . ". Jump to the current revision or see a list of all revisions for this page.)

\n"; } // Add an extra message if the requester was redirected from another page if(isset($_GET["redirected_from"])) $content .= "

Redirected from " . $_GET["redirected_from"] . ".

"; $parsing_start = microtime(true); $rawRenderedSource = parse_page_source(file_get_contents($env->page_filename)); $content .= $rawRenderedSource; if(!empty($pageindex->$page->tags)) { $content .= "
\n"; foreach($pageindex->$page->tags as $tag) { $content .= "
• $tag
\n"; } $content .= "\n
\n"; } /*else { $content .= "\n"; }*/ if($settings->show_subpages) { $subpages = get_object_vars(get_subpages($pageindex, $env->page)); if(count($subpages) > 0) { $content .= "

---

"; $content .= "Subpages: "; foreach($subpages as $subpage => $times_removed) { if($times_removed <= $settings->subpages_display_depth) { $content .= "$subpage, "; } } // Remove the last comma from the content $content = substr($content, 0, -2); } } $content .= "\n\t\t\n"; // Prevent indexing of this page if it's still within the noindex // time period if(isset($settings->delayed_indexing_time) and time() - $pageindex->{$env->page}->lastmodified < $settings->delayed_indexing_time) header("x-robots-tag: noindex"); $settings->footer_message = "$env->page was last edited by {$pageindex->{$env->page}->lasteditor} at " . date('h:ia T \o\n j F Y', $pageindex->{$env->page}->lastmodified) . ".
\n

" . $settings->footer_message; // Add the last edited time to the footer $mode = isset($_GET["mode"]) ? strtolower(trim($_GET["mode"])) : "normal"; switch($mode) { case "contentonly": // Content only mode: Send only the content of the page exit($content); case "parsedsourceonly": // Parsed source only mode: Send only the raw rendered source exit($rawRenderedSource); case "printable": // Printable mode: Sends a printable version of the page exit(page_renderer::render_minimal($title, $content)); case "normal": default: // Normal mode: Send a normal page exit(page_renderer::render_main($title, $content)); } }); } ]); register_module([ "name" => "Parsedown", "version" => "0.9.9", "author" => "Emanuil Rusev & Starbeamrainbowlabs", "description" => "An upgraded (now default!) parser based on Emanuil Rusev's Parsedown Extra PHP library (https://github.com/erusev/parsedown-extra), which is licensed MIT. Please be careful, as this module adds some weight to your installation, and also *requires* write access to the disk on first load.", "id" => "parser-parsedown", "code" => function() { global $settings; $parser = new PeppermintParsedown(); $parser->setInternalLinkBase("?page=%s"); add_parser("parsedown", function($source) use ($parser) { global $settings; if($settings->clean_raw_html) $parser->setMarkupEscaped(true); else $parser->setMarkupEscaped(false); $result = $parser->text($source); return $result; }); add_help_section("20-parser-default", "Editor Syntax", "

$settings->sitename's editor uses an extended version of Parsedown to render pages, which is a fantastic open source Github flavoured markdown parser. You can find a quick reference guide on Github flavoured markdown here by adam-p, or if you prefer a book Mastering Markdown by KB is a good read, and free too!

Tips

• Put 2 spaces at the end of a line to add a soft line break. Leave a blank line to add a head line break (i.e. a new paragraph).
• You can add an id to a header that you can link to. Put it in curly braces after the heading name like this: # Heading Name {#HeadingId}. Then you can link to like like this: [[Page name#HeadingId}]]. You can also link to a heading id on the current page by omitting the page name: [[#HeadingId]].

Extra Syntax

$settings->sitename's editor also supports some extra custom syntax, some of which is inspired by Mediawiki.

Type this	To get this	Comments
[[Internal link]]	Internal Link	An internal link.
[[Display Text|Internal link]]	Display Text	An internal link with some display text.
		An image floating to the right of the page that fits inside a 256px x 256px box, preserving aspect ratio.
		An image with a caption that fits inside a 256px x 256px box, preserving aspect ratio. The caption is taken from the alt text.
		An example of the short url syntax for images. Simply enter the page name of an image (or video / audio file), and Pepperminty Wiki will sort out the url for you.

Note that the all image image syntax above can be mixed and matched to your liking. The caption option in particular must come last or next to last.

Templating

$settings->sitename also supports including one page in another page as a template. The syntax is very similar to that of Mediawiki. For example, {{Announcement banner}} will include the contents of the \"Announcement banner\" page, assuming it exists.

You can also use variables. Again, the syntax here is very similar to that of Mediawiki - they can be referenced in the included page by surrrounding the variable name in triple curly braces (e.g. {{{Announcement text}}}), and set when including a page with the bar syntax (e.g. {{Announcement banner | importance = high | text = Maintenance has been planned for tonight.}}). Currently the only restriction in templates and variables is that you may not include a closing curly brace (}) in the page name, variable name, or value.

Special Variables

$settings->sitename also supports a number of special built-in variables. Their syntax and function are described below:

Type this	To get this
{{{@}}}	Lists all variables and their values in a table.
{{{#}}}	Shows a 'stack trace', outlining all the parent includes of the current page being parsed.
{{{~}}}	Outputs the requested page's name.
{{{*}}}	Outputs a comma separated list of all the subpages of the current page.
{{{+}}}	Shows a gallery containing all the files that are sub pages of the current page.

"); } ]); /*** Parsedown versions *** * Parsedown Core: 1.6.0 * * Parsedown Extra: 0.7.0 * **************************/ $env->parsedown_paths = new stdClass(); $env->parsedown_paths->parsedown = "https://cdn.rawgit.com/erusev/parsedown/3ebbd730b5c2cf5ce78bc1bf64071407fc6674b7/Parsedown.php"; $env->parsedown_paths->parsedown_extra = "https://cdn.rawgit.com/erusev/parsedown-extra/11a44e076d02ffcc4021713398a60cd73f78b6f5/ParsedownExtra.php"; // Download parsedown and parsedown extra if they don't already exist if(!file_exists("./Parsedown.php") || filesize("./Parsedown.php") === 0) file_put_contents("./Parsedown.php", fopen($env->parsedown_paths->parsedown, "r")); if(!file_exists("./ParsedownExtra.php") || filesize("./ParsedownExtra.php") === 0) file_put_contents("./ParsedownExtra.php", fopen($env->parsedown_paths->parsedown_extra, "r")); require_once("./Parsedown.php"); require_once("./ParsedownExtra.php"); /* * ██████ █████ ██████ ███████ ███████ ██████ ██████ ██ ██ ███ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ████ ██ * ██████ ███████ ██████ ███████ █████ ██ ██ ██ ██ ██ █ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ███ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ███████ ███████ ██████ ██████ ███ ███ ██ ████ * * ███████ ██ ██ ████████ ███████ ███ ██ ███████ ██ ██████ ███ ██ ███████ * ██ ██ ██ ██ ██ ████ ██ ██ ██ ██ ██ ████ ██ ██ * █████ ███ ██ █████ ██ ██ ██ ███████ ██ ██ ██ ██ ██ ██ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██ ██ ██ ███████ ██ ████ ███████ ██ ██████ ██ ████ ███████ */ class PeppermintParsedown extends ParsedownExtra { private $internalLinkBase = "./%s"; protected $maxParamDepth = 0; protected $paramStack = []; function __construct() { // Prioritise our internal link parsing over the regular link parsing array_unshift($this->InlineTypes["["], "InternalLink"); // Prioritise our image parser over the regular image parser array_unshift($this->InlineTypes["!"], "ExtendedImage"); $this->inlineMarkerList .= "{"; if(!isset($this->InlineTypes["{"]) or !is_array($this->InlineTypes["{"])) $this->InlineTypes["{"] = []; $this->InlineTypes["{"][] = "Template"; } /* * ████████ ███████ ███ ███ ██████ ██ █████ ████████ ██ ███ ██ ██████ * ██ ██ ████ ████ ██ ██ ██ ██ ██ ██ ██ ████ ██ ██ * ██ █████ ██ ████ ██ ██████ ██ ███████ ██ ██ ██ ██ ██ ██ ███ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ███████ ██ ██ ██ ███████ ██ ██ ██ ██ ██ ████ ██████ */ protected function inlineTemplate($fragment) { global $env, $pageindex; // Variable parsing if(preg_match("/\{\{\{([^}]+)\}\}\}/", $fragment["text"], $matches)) { $params = []; if(!empty($this->paramStack)) { $stackEntry = array_slice($this->paramStack, -1)[0]; $params = !empty($stackEntry) ? $stackEntry["params"] : false; } $variableKey = trim($matches[1]); $variableValue = false; switch ($variableKey) { case "@": // Lists all variables and their values if(!empty($params)) { $variableValue = "\n"; foreach($params as $key => $value) { $variableValue .= "\t\n"; } $variableValue .= "

Key	Value
" . $this->escapeText($key) . "	" . $this->escapeText($value) . "

"; } break; case "#": // Shows a stack trace $variableValue = "
\n"; $variableValue .= "\t
1. $env->page
\n"; foreach($this->paramStack as $curStackEntry) { $variableValue .= "\t
2. " . $curStackEntry["pagename"] . "
\n"; } $variableValue .= "
\n"; break; case "~": // Show requested page's name if(!empty($this->paramStack)) $variableValue = $this->escapeText($env->page); break; case "*": // Lists subpages $subpages = get_subpages($pageindex, $env->page); $variableValue = []; foreach($subpages as $pagename => $depth) { $variableValue[] = $pagename; } $variableValue = implode(", ", $variableValue); if(strlen($variableValue) === 0) $variableValue = "(none yet!)"; break; case "+": // Shows a file gallery for subpages with files // If the upload module isn't present, then there's no point // in checking for uploaded files if(!module_exists("feature-upload")) break; $variableValue = []; $subpages = get_subpages($pageindex, $env->page); foreach($subpages as $pagename => $depth) { // Make sure that this is an uploaded file if(!$pageindex->$pagename->uploadedfile) continue; $mime_type = $pageindex->$pagename->uploadedfilemime; $previewSize = 300; $previewUrl = "?action=preview&size=$previewSize&page=" . rawurlencode($pagename); $previewHtml = ""; switch(substr($mime_type, 0, strpos($mime_type, "/"))) { case "video": $previewHtml .= "\n"; break; case "audio": $previewHtml .= "\n"; break; case "application": case "image": default: $previewHtml .= "\n"; break; } $previewHtml = "$previewHtml$pagename"; $variableValue[$pagename] = "
• $previewHtml
"; } if(count($variableValue) === 0) $variableValue["default"] = "
• (No files found)
\n"; $variableValue = implode("\n", $variableValue); $variableValue = "
$variableValue
"; break; } if(isset($params[$variableKey])) { $variableValue = $params[$variableKey]; $variableValue = $this->escapeText($variableValue); } if($variableValue !== false) { return [ "extent" => strlen($matches[0]), "markup" => $variableValue ]; } } else if(preg_match("/\{\{([^}]+)\}\}/", $fragment["text"], $matches)) { $templateElement = $this->templateHandler($matches[1]); if(!empty($templateElement)) { return [ "extent" => strlen($matches[0]), "element" => $templateElement ]; } } } protected function templateHandler($source) { global $pageindex, $env; $parts = preg_split("/\\||¦/", trim($source, "{}")); $parts = array_map("trim", $parts); // Extract the name of the template page $templatePagename = array_shift($parts); // If the page that we are supposed to use as the tempalte doesn't // exist, then there's no point in continuing. if(empty($pageindex->$templatePagename)) return false; // Parse the parameters $this->maxParamDepth++; $params = []; $i = 0; foreach($parts as $part) { if(strpos($part, "=") !== false) { // This param contains an equals sign, so it's a named parameter $keyValuePair = explode("=", $part, 2); $keyValuePair = array_map("trim", $keyValuePair); $params[$keyValuePair[0]] = $keyValuePair[1]; } else { // This isn't a named parameter $params["$i"] = trim($part); $i++; } } // Add the parsed parameters to the parameter stack $this->paramStack[] = [ "pagename" => $templatePagename, "params" => $params ]; $templateFilePath = $env->storage_prefix . $pageindex->$templatePagename->filename; $parsedTemplateSource = $this->text(file_get_contents($templateFilePath)); // Remove the parsed parameters from the stack array_pop($this->paramStack); return [ "name" => "div", "text" => $parsedTemplateSource, "attributes" => [ "class" => "template" ] ]; } /* * ██ ███ ██ ████████ ███████ ██████ ███ ██ █████ ██ * ██ ████ ██ ██ ██ ██ ██ ████ ██ ██ ██ ██ * ██ ██ ██ ██ ██ █████ ██████ ██ ██ ██ ███████ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ████ ██ ███████ ██ ██ ██ ████ ██ ██ ███████ * * ██ ██ ███ ██ ██ ██ ███████ * ██ ██ ████ ██ ██ ██ ██ * ██ ██ ██ ██ ██ █████ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██ ██ ████ ██ ██ ███████ */ protected function inlineInternalLink($fragment) { global $pageindex, $env; if(preg_match('/^\[\[([^\]]*)\]\]([^\s!?",.()\[\]{}*=+\/]*)/u', $fragment["text"], $matches)) { $linkPage = trim($matches[1]); $display = $linkPage . trim($matches[2]); if(strpos($matches[1], "|") !== false || strpos($matches[1], "¦") !== false) { // We have a bar character $parts = preg_split("/\\||¦/", $matches[1], 2); $linkPage = trim($parts[0]); // The page to link to $display = trim($parts[1]); // The text to display } $hashCode = ""; if(strpos($linkPage, "#") !== false) { // We want to link to a subsection of a page $hashCode = substr($linkPage, strpos($linkPage, "#") + 1); $linkPage = substr($linkPage, 0, strpos($linkPage, "#")); // If $linkPage is empty then we want to link to the current page if(strlen($linkPage) === 0) $linkPage = $env->page; } // If the page doesn't exist, check varying different // capitalisations to see if it exists under some variant. if(empty($pageindex->$linkPage)) { if(!empty($pageindex->{ucfirst($linkPage)})) $linkPage = ucfirst($linkPage); else if(!empty($pageindex->{ucwords($linkPage)})) $linkPage = ucwords($linkPage); } // Construct the full url $linkUrl = str_replace( "%s", rawurlencode($linkPage), $this->internalLinkBase ); if(strlen($hashCode) > 0) $linkUrl .= "#$hashCode"; $result = [ "extent" => strlen($matches[0]), "element" => [ "name" => "a", "text" => $display, "attributes" => [ "href" => $linkUrl ] ] ]; if(empty($pageindex->{makepathsafe($linkPage)})) $result["element"]["attributes"]["class"] = "redlink"; return $result; } return; } /* * ███████ ██ ██ ████████ ███████ ███ ██ ██████ ███████ ██████ * ██ ██ ██ ██ ██ ████ ██ ██ ██ ██ ██ ██ * █████ ███ ██ █████ ██ ██ ██ ██ ██ █████ ██ ██ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ███████ ██ ██ ██ ███████ ██ ████ ██████ ███████ ██████ * * ██ ███ ███ █████ ██████ ███████ ███████ * ██ ████ ████ ██ ██ ██ ██ ██ * ██ ██ ████ ██ ███████ ██ ███ █████ ███████ * ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ * ██ ██ ██ ██ ██ ██████ ███████ ███████ */ protected function inlineExtendedImage($fragment) { global $pageindex; if(preg_match('/^!\[(.*)\]\(([^|¦)]+)\s*(?:(?:\||¦)([^|¦)]*))?(?:(?:\||¦)([^|¦)]*))?(?:(?:\||¦)([^)]*))?\)/', $fragment["text"], $matches)) { /* * 0 - Everything * 1 - Alt text * 2 - Url * 3 - First param (optional) * 4 - Second param (optional) * 5 - Third param (optional) */ $altText = $matches[1]; $imageUrl = trim(str_replace("&", "&", $matches[2])); // Decode & to allow it in preview urls $param1 = empty($matches[3]) ? false : strtolower(trim($matches[3])); $param2 = empty($matches[4]) ? false : strtolower(trim($matches[4])); $param3 = empty($matches[5]) ? false : strtolower(trim($matches[5])); $floatDirection = false; $imageSize = false; $imageCaption = false; $shortImageUrl = false; if($this->isFloatValue($param1)) { // Param 1 is a valid css float: ... value $floatDirection = $param1; $imageSize = $this->parseSizeSpec($param2); } else if($this->isFloatValue($param2)) { // Param 2 is a valid css float: ... value $floatDirection = $param2; $imageSize = $this->parseSizeSpec($param1); } else if($this->isFloatValue($param3)) { $floatDirection = $param3; $imageSize = $this->parseSizeSpec($param1); } else if($param1 === false and $param2 === false) { // Neither params were specified $floatDirection = false; $imageSize = false; } else { // Neither of them are floats, but at least one is specified // This must mean that the first param is a size spec like // 250x128. $imageSize = $this->parseSizeSpec($param1); } if($param1 !== false && strtolower(trim($param1)) == "caption") $imageCaption = true; if($param2 !== false && strtolower(trim($param2)) == "caption") $imageCaption = true; if($param3 !== false && strtolower(trim($param3)) == "caption") $imageCaption = true; //echo("Image url: $imageUrl, Pageindex entry: " . var_export(isset($pageindex->$imageUrl), true) . "\n"); if(isset($pageindex->$imageUrl) and $pageindex->$imageUrl->uploadedfile) { // We have a short url! Expand it. $shortImageUrl = $imageUrl; $imageUrl = "index.php?action=preview&size=" . max($imageSize["x"], $imageSize["y"]) ."&page=" . rawurlencode($imageUrl); } $style = ""; if($imageSize !== false) $style .= " max-width: " . $imageSize["x"] . "px; max-height: " . $imageSize["y"] . "px;"; if($floatDirection) $style .= " float: $floatDirection;"; $urlExtension = pathinfo($imageUrl, PATHINFO_EXTENSION); $urlType = system_extension_mime_type($urlExtension); $result = []; switch(substr($urlType, 0, strpos($urlType, "/"))) { case "audio": $result = [ "extent" => strlen($matches[0]), "element" => [ "name" => "audio", "text" => $altText, "attributes" => [ "src" => $imageUrl, "controls" => "controls", "preload" => "metadata", "style" => trim($style) ] ] ]; break; case "video": $result = [ "extent" => strlen($matches[0]), "element" => [ "name" => "video", "text" => $altText, "attributes" => [ "src" => $imageUrl, "controls" => "controls", "preload" => "metadata", "style" => trim($style) ] ] ]; break; case "image": default: // If we can't work out what it is, then assume it's an image $result = [ "extent" => strlen($matches[0]), "element" => [ "name" => "img", "attributes" => [ "src" => $imageUrl, "alt" => $altText, "title" => $altText, "style" => trim($style) ] ] ]; break; } // ~ Image linker ~ $imageHref = $shortImageUrl !== false ? "?page=" . rawurlencode($shortImageUrl) : $imageUrl; $result["element"] = [ "name" => "a", "attributes" => [ "href" => $imageHref ], "text" => [$result["element"]], "handler" => "elements" ]; // ~ if($imageCaption) { $rawStyle = $result["element"]["attributes"]["style"]; $containerStyle = preg_replace('/^.*float/', "float", $rawStyle); $mediaStyle = preg_replace('/\s*float.*;/', "", $rawStyle); $result["element"] = [ "name" => "figure", "attributes" => [ "style" => $containerStyle ], "text" => [ $result["element"], [ "name" => "figcaption", "text" => $altText ], ], "handler" => "elements" ]; $result["element"]["text"][0]["attributes"]["style"] = $mediaStyle; } return $result; } } # ~ # Utility Methods # ~ private function isFloatValue($value) { return in_array(strtolower($value), [ "left", "right" ]); } private function parseSizeSpec($text) { if(strpos($text, "x") === false) return false; $parts = explode("x", $text, 2); if(count($parts) != 2) return false; array_map("trim", $parts); array_map("intval", $parts); if(in_array(0, $parts)) return false; return [ "x" => $parts[0], "y" => $parts[1] ]; } protected function escapeText($text) { return htmlentities($text, ENT_COMPAT | ENT_HTML5); } /** * Sets the base url to be used for internal links. '%s' will be replaced * with a URL encoded version of the page name. * @param string $url The url to use when parsing internal links. */ public function setInternalLinkBase($url) { $this->internalLinkBase = $url; } } // %next_module% // ////////////////////////////////////////////////////////////////// // Execute each module's code foreach($modules as $moduledata) { $moduledata["code"](); } // Make sure that the credits page exists if(!isset($actions->credits)) { exit(page_renderer::render_main("Error - $settings->$sitename", "

No credits page detected. The credits page is a required module!

")); } // Perform the appropriate action $action_name = $env->action; if(isset($actions->$action_name)) { $req_action_data = $actions->$action_name; $req_action_data(); } else { exit(page_renderer::render_main("Error - $settings->sitename", "

No action called " . strtolower($_GET["action"]) ." has been registered. Perhaps you are missing a module?

")); } ?>