Release status: stable
|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)|
|License||GNU General Public License 2.0 or later|
|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.
In current versions of MediaWiki, the SyntaxHighlight extension already is coming with the tarball of the MediaWiki Core. The files are located in folder
- Download the latest version of ViewFiles
- Create a folder in the extensions folder named ViewFiles
- Move the files to the
Install SyntaxHighlight and ViewFiles
LocalSettings.phpin 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).
The only required configuration setting is $wgViewFilesFilePathList.
What to begin the page with; e.g.
$wgViewFilesIntro = "__FORCETOC__\n";
What to begin each file listing with; defaults to:
$wgViewFilesBegin = '<source lang="$1">' . "\n";
What to end each file listing with; defaults to:
$wgViewFilesEnd = '</source>' . "\n";
This list of filenames and associated languages overrides the extension lookup of the SyntaxHighlight extension. Defaults to:
$wgViewFilesFileLangList = array ( '.htaccess' => 'apache', 'robots.txt' => 'robots', );
Create a list of files and their paths, e.g.:
$wgViewFilesPathList = array( 'LocalSettings.php' => "$IP/LocalSettings.php", 'robots.txt' => "$IP/../robots.txt" );