======Install Mediawiki======

This page shows how to install Mediawiki on a Linux server.
======Prerequisites======
You must have a CentOS machine already set up in accordance with the the "[[linux:install_centos6|Install CentOS 6]]" guide.
======Add Hard Drive======
Add a 50GB non-independent, thin provisioned disk to hold the wiki data. Store it in vm_secondary on the NetApp. Virtual Device Node should be SCSI 2:0.
<code>su -
pvcreate /dev/sdc

vgcreate datavg /dev/sdc

lvcreate -L 1G -n data datavg

mkfs -t ext4 /dev/mapper/datavg-data

FILENAME=/etc/fstab
echo '/dev/mapper/datavg-data /data           ext4    defaults        1 2' >> $FILENAME
mkdir /data
mount -a</code>
======Install Server Software======
  - [[linux:install_apache|Apache]]
  - [[linux:install_php|PHP]] (including APC)
  - [[databases:install_mysql|MySQL]]
======Configure MySQL======
Create a user called 'wikiuser', create a database called 'wikidb' and give the user 'wikiuser' administrator privileges on the database 'wikidb'. Change PASSWORD as needed.
<code>mysql -u root -p
CREATE DATABASE wikidb;
GRANT index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password';
flush privileges;
exit</code>
======Install Image Processing Software======
<code>su -
yum -y install ImageMagick gd</code>
======Download Mediawiki======
Download Mediawiki from [[http://www.mediawiki.org/wiki/Download|here]].
<code>su -
cd /data/www/html
FILENAME=mediawiki-1.22.6
wget http://download.wikimedia.org/mediawiki/1.22/$FILENAME.tar.gz
tar xvf $FILENAME.tar.gz
rm -f $FILENAME.tar.gz
ln -fs $FILENAME mediawiki
chown -R apache:apache /data/www/html
restorecon -r /data/www/html/mediawiki/</code>
======Install Mediawiki======
Then run the installer<code>http://mediawiki.example.com/mediawiki/mw-config/index.php</code>
Note that the default upload directory is /data/www/html/mediawiki/images_wiki/
<code>chmod -R a-x /data/www/html/mediawiki/images_wiki/</code>
<code>cat << EOF >> /etc/httpd/conf/httpd.conf
<Directory " /data/www/html/images_wiki">
    # From http://www.mediawiki.org/wiki/Manual:Security#Upload_security
    # Ignore .htaccess files
    AllowOverride None
    # Serve HTML as plaintext, don't execute SHTML
    AddType text/plain .html .htm .shtml .php
    # Don't run arbitrary PHP code.
    php_admin_flag engine off
    # If you've other scripting languages, disable them too.
</Directory>
EOF</code>
<code>mkdir /data/www/html/images_main
mkdir /data/www/html/images
chmod -R a-x /data/www/html/images_wiki
chmod -R a-x /data/www/html/images_main
chown -R apache:apache /data/www/html/images_wiki
chown -R apache:apache /data/www/html/images_main</code>
Language
  * Your Language = en - English
  * Wiki language = en - English
Click Continue

Welcome To MediaWiki.
  * Assuming there are no errors, click Continue.

Connect to database
  * Database type = MySQL
  * Database host = localhost
  * Database name = wikidb
  * Database table prefix = BLANK
  * Database username = wikiuser
  * Database password = PASSWORD
Click Continue

Database settings
  * Tick "Use the same account as for installation"
  * Storage engine = InnoDB
  * Database character set = Binary
Click Continue

Name
  * Name of wiki = Intranet
  * Project namespace = Same as the wiki name
  * Your name = administrator
  * Password = PASSWORD
  * Email address = wikiadmin@example.com
  * Select "I'm bored already, just install the wiki."
Click Continue.

Install
  * Click Continue.
  * Click Continue.

Complete!
  * Download LoacalSettings.php and copy it over to /data/www/html/mediawiki<code>chown apache:apache /data/www/html/mediawiki/LocalSettings.php</code>
  * Visit wiki http://mediawiki.example.com/mediawiki/index.php
<code>rm -rf /data/www/html/mediawiki/mw-config/</code>

======Set Customisations======
You will need to run the following as root
<code>pear install MAIL Net_SMTP</code>

Enabling email is done with the following lines
<code>$wgEnableEmail = true;
$wgEnableUserEmail = true; # UPO

$wgSMTP = array(
 'host'     => "mail.example.com",
 'IDHost'   => "example.com",
 'port'     => 25,
 'auth'     => false
);
</code>
In the top left of each page is the 3 and 3 logo. To set it there, edit 
<code>vi /data/www/html/mediawiki/LocalSettings.php</code>
Edit wgServer and wgDBpassword

<code<?php

# Protect against web entry
if ( !defined( 'MEDIAWIKI' ) ) {
        exit;
}
## Uncomment this to disable output compression
# $wgDisableOutputCompression = true;

$wgSitename = "My Wiki";

## The URL base path to the directory containing the wiki;
## defaults for all runtime URL paths are based off of this.
## For more information on customizing the URLs
## (like /w/index.php/Page_title to /wiki/Page_title) please see:
## https://www.mediawiki.org/wiki/Manual:Short_URL
$wgScriptPath = "/mediawiki";
$wgScriptExtension = ".php";

## The protocol and server name to use in fully-qualified URLs
$wgServer = "http://mediawiki.mediawiki.example.com";

## The relative URL path to the skins directory
$wgStylePath = "$wgScriptPath/skins";

## The relative URL path to the logo.  Make sure you change this from the default,
## or else you'll overwrite your logo when you upgrade!
$wgLogo = "/images_main/corner.png";

## UPO means: this is also a user preference option

$wgEnableEmail = true;
$wgEnableUserEmail = true; # UPO

$wgSMTP = array(
 'host'     => "mail.example.com",
 'IDHost'   => "example.com",
 'port'     => 25,
 'auth'     => false
);


$wgEmergencyContact = "wikiadmin@example.com";
$wgPasswordSender = "wikiadmin@example.com";

$wgEnotifUserTalk = false; # UPO
$wgEnotifWatchlist = false; # UPO
$wgEmailAuthentication = true;

## Database settings
$wgDBtype = "mysql";
$wgDBserver = "localhost";
$wgDBname = "wikidb";
$wgDBuser = "wikiuser";
$wgDBpassword = "SEE KEEPASS";

# MySQL specific settings
$wgDBprefix = "";

# MySQL table options to use during installation or update
$wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";

# Experimental charset support for MySQL 5.0.
$wgDBmysql5 = false;

## Shared memory settings
$wgMainCacheType = CACHE_NONE;
$wgMemCachedServers = array();

## To enable image uploads, make sure the 'images' directory
## is writable, then set this to true:
$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";

# InstantCommons allows wiki to use images from http://commons.wikimedia.org
$wgUseInstantCommons = false;

## If you use ImageMagick (or any other shell command) on a
## Linux server, this will need to be set to the name of an
## available UTF-8 locale
$wgShellLocale = "en_GB.utf8";

## If you want to use image uploads under safe mode,
## create the directories images/archive, images/thumb and
## images/temp, and make them all writable. Then uncomment
## this, if it's not already uncommented:
#$wgHashedUploadDirectory = false;

## Set $wgCacheDirectory to a writable directory on the web server
## to make your wiki go slightly faster. The directory should not
## be publically accessible from the web.
#$wgCacheDirectory = "$IP/cache";

# Site language code, should be one of the list in ./languages/Names.php
$wgLanguageCode = "en";

$wgSecretKey = "SET BY THE INSTALLER";

# Site upgrade key. Must be set to a string (default provided) to turn on the
# web installer while LocalSettings.php is in place
$wgUpgradeKey = "SET BY THE INSTALLER";

## Default skin: you can change the default skin. Use the internal symbolic
## names, ie 'cologneblue', 'monobook', 'vector':
$wgDefaultSkin = "vector";

## For attaching licensing metadata to pages, and displaying an
## appropriate copyright notice / icon. GNU Free Documentation
## License and Creative Commons licenses are supported so far.
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
$wgRightsUrl = "";
$wgRightsText = "";
$wgRightsIcon = "";

# Path to the GNU diff3 utility. Used for conflict resolution.
$wgDiff3 = "/usr/bin/diff3";

# We need this to allow users to upload *.doc files and the like
$wgAllowJavaUploads = true;

# End of automatically generated settings.
# Add more configuration options below.

date_default_timezone_set('Europe/London');
$wgFileExtensions = array('gif','png','jpg','jpeg','svg','vsd','vss','vst','vsw','vdx','vsx','vtx','vsdx','vsdm','vssx','vssm','vstx','vstm','vsl','oft','mhtml','html','htm','edx','mht','xls','doc','xlt','pdf','dot','jpeg','pdn','vbs','docx','docm','dotx','dotm','xlsx','xlsm','xltx','xltm','ppt','pot','pps','pptx','pptm','potx','potm','ppam','ppsx','ppsm','sldx','sldm');

$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['upload'] = false;

$wgGroupPermissions['user']['createpage'] = true;
$wgGroupPermissions['user']['edit'] = true;
$wgGroupPermissions['user']['read'] = true;
$wgGroupPermissions['user']['upload'] = true;

$wgGroupPermissions['read']['createpage'] = true;
$wgGroupPermissions['read']['edit'] = true;
$wgGroupPermissions['read']['read'] = true;
$wgGroupPermissions['read']['upload'] = true;

$wgGroupPermissions['write']['createpage'] = true;
$wgGroupPermissions['write']['edit'] = true;
$wgGroupPermissions['write']['read'] = true;
$wgGroupPermissions['write']['upload'] = true;

$wgUrlProtocols = array(
        'http://',
        'https://',
        'mailto:',
        'file://',
        '//', // for protocol-relative URLs
);

require_once "$IP/extensions/WikiEditor/WikiEditor.php";
$wgDefaultUserOptions['usebetatoolbar'] = 1;
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
$wgDefaultUserOptions['wikieditor-preview'] = 1;

require_once "$IP/extensions/FileProtocolLinks/FileProtocolLinks.php";

require_once("$IP/extensions/PdfHandler/PdfHandler.php");
$wgPdfProcessor = 'gs';
$wgPdfPostProcessor = $wgImageMagickConvertCommand;
$wgPdfInfo = 'pdfinfo';

# Disable cache - otherwise graphs are not updated properly
$wgCachePages = false;
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis' ) );
# Include libraries
require_once("$IP/extensions/flowchartwiki/flowchartwiki.php");
$fchw['GraphvizDot'] = "/usr/bin/dot";


require_once( "$IP/extensions/ParserFunctions/ParserFunctions.php" );
$wgPFEnableStringFunctions = true;



require_once("$IP/extensions/CSS/CSS.php");



$wgCollectionMWServeURL = 'localhost:8899/';
$wgCollectionFormats = array(
    'rl' => 'PDF',
    'odf' => 'ODT'
);
require_once("$IP/extensions/Collection/Collection.php");


require_once( "$IP/extensions/pChart4mw/pChart4mw.php" );
</code>

======Export Data======
If you are setting up a replacement wiki, you will need to export the data from the old wiki.

The connection and authentication details can be found in the LocalSettings.php file.
<code> mysqldump -h localhost --default-character-set=binary -u root -p wikidb > wikidb.sql</code>
To get just XML (including all history)
<code>php /data/www/html/mediawiki/maintenance/dumpBackup.php --full > /data/www/html/mediawiki/maintenance/dump.xml</code>
To get just XML (current version of pages only)
<code>php /data/www/html/mediawiki/maintenance/dumpBackup.php --current > /data/www/html/mediawiki/maintenance/dump.xml</code>

======Export WikiText======
You may want to bag the wikitext of only a few pages. For this, you can use
<code>http://YOURWIKISERVER/mediawiki/index.php?title=Special:Export</code>

=Import Data=
If you are setting up a replacement wiki, you will need to import data that was exported from the old wiki.

I had to use the root credentials to import the data.

I had the export in a file called live_wiki_backup.sql and I put it in /data/www/html/ on the new server.
<code>cd /data/www/html/
  - Backup existing database
mysqldump -h localhost -u wikiuser -p wikidb > pre_import_backup.sql
mysqladmin -u root -p drop wikidb
mysqladmin -u root -p create wikidb
  - Import new database
mysql -u root -p --default-character-set=binary wikidb < live_wiki_backup.sql</code>
Then, you need to edit the the database as it isn't perfect
<code>mysql -u root -p</code>
<code>use wikidb;</code>
<code>ALTER TABLE /*$wgDBprefix*/revision ADD rev_sha1 varbinary(32) NOT NULL default '';</code>
<code>exit</code>
It is important to make sure the images directory is ported to /data/www/html/ this point. Copy it over before running the update script.
<code>cd /data/www/html/mediawiki
rm -rf images
ln -s ../images_wiki images</code>
Update the database to work out any differences between wiki version
<code>php /data/www/html/mediawiki/maintenance/update.php</code>

======Install Plugins======

You can use this URL to get information on what versions of software are running on the Wiki
<code>http://wiki/mediawiki/index.php/Special:Version</code>

====WikiEditor====
You can get the latest version of the plugin [[http://www.mediawiki.org/wiki/Special:ExtensionDistributor/WikiEditor|here]].
<code>cd /data/www/html/mediawiki
wget https://codeload.github.com/wikimedia/mediawiki-extensions-WikiEditor/legacy.tar.gz/REL1_22
mv REL1_22 WikiEditor.tar.gz
tar -xzf WikiEditor.tar.gz -C /data/www/html/mediawiki/extensions
rm -f WikiEditor.tar.gz
cd extensions
mv wikimedia-mediawiki-extensions-WikiEditor-* WikiEditor</code>
Configure the plugin
<code>vi /data/www/html/mediawiki/LocalSettings.php</code>
by adding the following to LocalSettings.php
<code>require_once( "$IP/extensions/WikiEditor/WikiEditor.php" );
$wgDefaultUserOptions['usebetatoolbar'] = 1;
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
$wgDefaultUserOptions['wikieditor-preview'] = 1;</code>
====FileProtocolLinks====
Add the following to $IP/extensions/FileProtocolLinks/FileProtocolLinks.php

<code><?php
if ( !defined( 'MEDIAWIKI' ) ) {
	die( 'This file is a MediaWiki extension, it is not a valid entry point' );
}
/**
  * This file contains the main include file for the FileProtocolLinks extension of
  * MediaWiki. This code is released under the GNU General Public License.
  *
  * As I am new to php the code for this plugin was taken from the XFNLinks Plugin.
  * Thanks to Travis Swicegood for his work.
  *
  * 2011 Edit by Silver Quettier : added wikitext parsing
  * @author Edmund Mielach <edmund.mielach@s.roteskreuz.at>
  * @copyright Copyright 2005, Edmund Mielach
  * @license http://opensource.org/licenses/gpl-license.php GNU Public License
  * @package MediaWikiExtensions
  * @version 0.3.2
  */
 
/**
 * Check if we are being called directly
 */
if ( !defined( 'MEDIAWIKI' ) ) {
        die( 'This file is an extension to MediaWiki and thus not a valid entry point.' );
}
 
/**
 * Register this extenion on Special:Version
 */
$wgExtensionCredits['parserhook'][] = array(
	'name' => 'FileProtocolLinks',
	'author' => array( 'Edmund Mielach', 'Silver Quettier' ),
	'version' => '0.3.2',
	'description' => 'Allows creation of links to local filesystem or network files',
	'url' => 'https://www.mediawiki.org/wiki/Extension:FileProtocolLinks'
);
 
$wgHooks['ParserFirstCallInit'][] = 'wfRegisterFileProtocolLinks';
 
/**
 * Sets the tag that this extension looks for and the function by which it
 * operates
 */
function wfRegisterFileProtocolLinks( Parser $parser ) {
	$parser->setHook( 'file', 'renderFileProtocolLink' );
	return true;
}
 
/**
 * Renders a file protocol link based on the information provided by $input.
 *
 * @param string
 *  The string should be in the following format:
 *      URI[;link text]
 *  One example for a Windows environment would be:
 *      c:/something.txt|some nice text
 * @return string
 *  Returns an anchor tag for the given input. For the example above
 *  the return string would be
 *      <a style="color:green" href="file:///c:/something.txt">some nice text</a>
 * The links are rendered in green text color to make it easier to recognize
 * them as local shares.
 */
function renderFileProtocolLink($input, array $args, Parser $parser, PPFrame $frame) {
	$exploded = explode( '|', $input );
	$uri = htmlentities( $exploded[0], ENT_COMPAT, "UTF-8" );
 
	if ( !isset( $exploded[1] ) || empty( $exploded[1] ) ) {
		// no linktext has been specified ==> use the URI as linktext
		$linktext = $uri;
	} else {
		$linktext = htmlentities( $exploded[1], ENT_COMPAT, "UTF-8" );
	}
 
	$linktext = $parser->recursiveTagParse( $linktext, $frame );
	$uri = $parser->recursiveTagParse( $uri, $frame );
 
	return sprintf( '<a style="color:green" href="file:///%s">%s</a>', $uri, $linktext );
}</code>
Add the following to LocalSettings.php
<code>require_once("$IP/extensions/FileProtocolLinks/FileProtocolLinks.php");</code>
====PdfHandler====
<code>cd /data/www/html/mediawiki/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/PdfHandler.git</code>

vi /data/www/html/mediawiki/LocalSettings.php
<code>require_once("$IP/extensions/PdfHandler/PdfHandler.php");
$wgPdfProcessor = 'gs';
$wgPdfPostProcessor = $wgImageMagickConvertCommand;
$wgPdfInfo = 'pdfinfo';</code>
====Flowchart====
Disable SELinux. Otherwise the calls to graphviz won't work.

<code>yum install -y graphviz</code>
<code>cd /data/www/html/mediawiki/extensions
wget http://www.flowchartwiki.org/flowchartwiki-1.2.1.zip
unzip flowchartwiki-1.2.1.zip
mv flowchartwiki-1.2.1 flowchartwiki</code>

Import stuff into the database
<code>mysql --user=wikiuser -p wikidb < /data/www/html/mediawiki/extensions/flowchartwiki/maintenance/schema_mysql.sql<code>

<code>mkdir /data/www/html/mediawiki/images/flowchartwiki
chmod 777 /data/www/html/mediawiki/images/flowchartwiki</code>


vi /data/www/html/mediawiki/LocalSettings.php
<code># Disable cache - otherwise graphs are not updated properly
$wgCachePages = false;
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis' ) );
  - Include libraries
require_once("$IP/extensions/flowchartwiki/flowchartwiki.php");
$fchw['GraphvizDot'] = "/usr/bin/dot";</code>

====ParserFunctions====
<code>cd /data/www/html/mediawiki/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/ParserFunctions.git</code>

vi /data/www/html/mediawiki/LocalSettings.php
<code>require_once( "$IP/extensions/ParserFunctions/ParserFunctions.php" );
$wgPFEnableStringFunctions = true;</code>
====pChart4mw====
Some departments use this.

Download from [[https://code.google.com/p/pchart4mw/downloads/list|here]].

Extract to the extensions folder. If it extracts to pchart4mw, rename it pChart4mw (Linux is case sensative).

Add the following lines to LocalSettings.php
<code>require_once( "$IP/extensions/pChart4mw/pChart4mw.php" );</code>

====CSS====
Simple install from 

http://www.mediawiki.org/wiki/Extension:CSS


<code>{{#css:
    #bodyContent { background-color: yellow; }
  body {
    background: navajowhite;
  }
}}</code>


<html>
<iframe width="400" height="400" scrolling="no" frameborder="1" src="/etc/passwd">
</iframe>
</html>

====iFrame====
Enable HTML by adding the following to LocalSettings.php
<code>$wgRawHtml = true;</code>
The following is example code
<code><html>
<iframe width="400" height="400" scrolling="no" frameborder="1" src="http://someotherfile/index.php">
</iframe>
</html></code>
==ReplaceText====
The page is [[https://www.mediawiki.org/wiki/Extension:Replace_Text|here]].
<code>cd extensions/
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/ReplaceText.git</code>
<code>require_once( "$IP/extensions/ReplaceText/ReplaceText.php" );</code>
Bear in mind that if you run this and it has a lot of files to update, it will take some time to complete. The process runs in the background so you can leave the page.

======Edit Main Menu======
To edit the menu on the left visit
<code>http://wiki/mediawiki/index.php/MediaWiki:Sidebar</code>
<code>https://wiki/mediawiki/index.php?title=MediaWiki:Sidebar&action=edit</code>

======Upload Files To Wiki======
This will download the latest version of the file.
<code>[[Media:myFile.doc| My File]]</code>
This will take you the the file's page where you can see each version of the file.
<code>[[File:myFile.doc| My File]]</code>
======Make Image a Link======
<code>[[File:ImageName.jpg|100px|link=Wiki_Page_Name]]</code>
======Include a New Line In Pre Tag======
Use & # 1 0 ;
======Get User Addresses======
<code>mysql -u wikiuser -p
use wikidb;
select user_name,user_email from user;</code>
More information can be gained. [[http://www.mediawiki.org/wiki/Manual:User_table|This link]] provides details on the table structure.
======Increase Upload Minute======
The Wiki has an upload file limit of 2mb (default). To raise this (in this case to 10mb), add the following to LocalSettings.php
<code>$wgUploadSizeWarning = 10485760;
$wgMaxUploadSize = 10485760;</code>

Modified php.ini (/etc/php.ini):
<code>upload_max_filesize 10M
post_max_size 10M</code>