Extension:ViewFiles

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
Crystal Clear action run.svg
ViewFiles
Release status: stable
ViewFiles.png
Implementation Special page
Description Allows users to view the contents of a limited set of files made available by the system administrator.
Author(s) Nathan Larson (Leucostictetalk)
Latest version 1.1.0 (2014-04-05)
MediaWiki 1.19+
PHP 5.3+
Database changes No
License GNU General Public License 2.0 or later
Download
Example meta.inclumedia.org
Parameters
  • $wgViewFilesIntro
  • $wgViewFilesBegin
  • $wgViewFilesEnd
  • $wgViewFilesFileLangList
  • $wgViewFilesFilePathList
  • $wgViewFilesRobotPolicy
Translate the ViewFiles extension if it is available at translatewiki.net
Check usage and version matrix.

The ViewFiles extension allows users to view the contents of a limited set of files made available by the system administrator. A possible use for this extension would be to enable your users to see the current contents of your configuration files (e.g. LocalSettings.php and InitialiseSettings.php) or customized skin files so that they could better assist with troubleshooting and make recommendations for configuration changes. Don't forget, if you're going to use this to display files such as LocalSettings.php that contain sensitive data, you'll want to get that data out of webroot before exposing those files to the world.

Installation[edit]

In current versions of MediaWiki, the SyntaxHighlight extension already is coming with the tarball of the MediaWiki Core. The files are located in folder extensions/SyntaxHighlight/.

Download ViewFiles[edit]

  • Download the latest version of ViewFiles
  • Create a folder in the extensions folder named ViewFiles
  • Move the files to the extensions/ViewFiles/ folder

Install SyntaxHighlight and ViewFiles[edit]

  • Edit LocalSettings.php in the root of your MediaWiki installation, and add the following line near the bottom:
require_once("$IP/extensions/ViewFiles/ViewFiles.php");
require_once("$IP/extensions/SyntaxHighlight/SyntaxHighlight_GeSHi.php");
require_once("$IP/extensions/SyntaxHighlight/geshi/geshi.php");

See Extension:SyntaxHighlight#Default_Source_Language for information on how to set a default source language (optional; will not affect how files are displayed by ViewFiles).

Configuration[edit]

The only required configuration setting is $wgViewFilesFilePathList.

$wgViewFilesIntro[edit]

What to begin the page with; e.g.

$wgViewFilesIntro = "__FORCETOC__\n";

$wgViewFilesBegin[edit]

What to begin each file listing with; defaults to:

$wgViewFilesBegin = '<source lang="$1">' . "\n";

$wgViewFilesEnd[edit]

What to end each file listing with; defaults to:

$wgViewFilesEnd = '</source>' . "\n";

$wgViewFilesFileLangList[edit]

This list of filenames and associated languages overrides the extension lookup of the SyntaxHighlight extension. Defaults to:

$wgViewFilesFileLangList = array (
	'.htaccess' => 'apache',
	'robots.txt' => 'robots',
);

$wgViewFilesFilePathList[edit]

Create a list of files and their paths, e.g.:

$wgViewFilesPathList = array(
	'LocalSettings.php' => "$IP/LocalSettings.php",
	'robots.txt' => "$IP/../robots.txt"
);