Open main menu

Extension:ViewFiles

MediaWiki extensions manual
OOjs UI icon advanced.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.

Contents

InstallationEdit

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 ViewFilesEdit

  • 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 ViewFilesEdit

  • 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).

ConfigurationEdit

The only required configuration setting is $wgViewFilesFilePathList.

$wgViewFilesIntroEdit

What to begin the page with; e.g.

$wgViewFilesIntro = "__FORCETOC__\n";

$wgViewFilesBeginEdit

What to begin each file listing with; defaults to:

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

$wgViewFilesEndEdit

What to end each file listing with; defaults to:

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

$wgViewFilesFileLangListEdit

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

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

$wgViewFilesFilePathListEdit

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

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