MediaWiki

From WickyWiki


Installation and configuration

MySQL database server and PHP Ubuntu

For more info: MySQL 

sudo apt install imagemagick php-fpm php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu php-zip

Create wiki database: 

sudo mysql -u root mysql -p

SQL: 

create database wikidb;
grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikidbadmin'@'127.0.0.1' identified by '**pwd**';
\q

Make sure the settings for your database in LocalSettings.php are correct, then go to the configuration web page, here you can create or upgrade the database:

MediaWiki website files

Download the code and copy to /var/www/mediawiki

Edit LocalSettings.php to add extensions and to customize.

Configuration LocalSettings.php

Note: generate a new LocalSettings.php during installation and use this example to make your changes.

The following are enabled in this example:

  • Vector skin
  • WikiEditor - a bit more help while editing
  • Syntax highlighting - easier reading of code
  • MobileFrontend - a view for smaller screens
  • Permissions - only registered users are allowed to edit pages and view history
  • Allow anonymous talk - everyone is allowed to start a discussion
  • ConfirmEdit - anonymous users need to answer a simple question
sudo gedit /var/www/mediawiki/LocalSettings.php
<?php
# Generated by the MediaWiki installer
# Further documentation for configuration settings may be found at:
# https://www.mediawiki.org/wiki/Manual:Configuration_settings

# Protect against web entry
if ( !defined( 'MEDIAWIKI' ) ) {
	exit;
}

# Uncomment this to disable output compression
# $wgDisableOutputCompression = true;

$wgSitename = "WikiWiki";

# The URL base path to the directory containing the wiki
$wgScriptPath = "/mediawiki";

# The protocol and server name to use in fully-qualified URLs
$wgServer = "https://wilbertvolkers.linkpc.net";

# The URL path to static resources (images, scripts, etc.)
$wgResourceBasePath = $wgScriptPath;

# The URL path to the logo.
$wgLogo = "$wgResourceBasePath/wiki.gif";
$wgFavicon = "$wgResourceBasePath/favicon.ico";

$wgEnableEmail = false;
$wgEnableUserEmail = false; # UPO (user preference option)

$wgEmergencyContact = "admin@wilbertvolkers.linkpc.net";
$wgPasswordSender = "admin@wilbertvolkers.linkpc.net";

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

# Database settings (MariaDB or MySQL)
$wgDBtype = "mysql";
$wgDBserver = "127.0.0.1";
$wgDBname = "wikidb";
$wgDBuser = "wikidbadmin";
$wgDBpassword = "***";
$wgDBprefix = "";
$wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
$wgDBmysql5 = false;

## Shared memory settings
$wgMainCacheType = CACHE_NONE;
$wgMemCachedServers = [];

## Image uploads, make sure the 'images' directory is writable
$wgEnableUploads = true;
#$wgUseImageMagick = true;
#$wgImageMagickConvertCommand = "/usr/bin/convert";

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

# Periodically send a pingback to https://www.mediawiki.org/ with basic data
$wgPingback = 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 = "C.UTF-8";

# 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/data/Names.php
$wgLanguageCode = "en";


# Changing this will log out all existing sessions.
$wgAuthenticationTokenVersion = "1";

# Site keys. Must be set to a strings (default provided) 
$wgSecretKey = "******";
$wgUpgradeKey = "***";

# For attaching licensing metadata to pages
$wgRightsPage = "";
$wgRightsUrl = "";
$wgRightsText = "";
$wgRightsIcon = "";

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

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

# Enabled skins.
wfLoadSkin( 'Vector' );

# extension: WikiEditor
wfLoadExtension( 'WikiEditor' );
# Enables use of WikiEditor by default but still allows users to disable it in preferences
$wgDefaultUserOptions['usebetatoolbar'] = 1;
# Enables link and table wizards by default but still allows users to disable them in preferences
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
# Displays the Preview and Changes tabs
$wgDefaultUserOptions['wikieditor-preview'] = 1;
# Displays the Publish and Cancel buttons on the top right side
#$wgDefaultUserOptions['wikieditor-publish'] = 1;

#extension: SyntaxHighlighting
wfLoadExtension("SyntaxHighlight_GeSHi");
$wgSyntaxHighlightDefaultLang = "bash";

# extension: MobileFrontend - view for smaller screens
wfLoadExtension( "MobileFrontend" );
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = "SkinVector";

# extension: allow anonymous discussion/talk
# Note: with a small change in TalkRight.class.php to make it work
require_once("$IP/extensions/TalkRight/TalkRight.php");
$wgGroupPermissions['*']['talk'] = true;

# extension: ConfirmEdit - to prevent automated edits
wfLoadExtensions([ 'ConfirmEdit', 'ConfirmEdit/QuestyCaptcha' ]);
$wgCaptchaQuestions = [
        '2-1=' => [1,'one'],
        '1+1=' => [2,'two'],
        '8/2=' => [4,'four'],
        '2x2x2=' => [8, 'eight'],
];
$wgCaptchaTriggers['edit'] = true;
$wgGroupPermissions['user']['skipcaptcha'] = true;

# Permissions: allow admin to delete revisions (visibility)
$wgGroupPermissions['sysop']['deleterevision'] = true;

# Permissions: deny anonymous page editing
$wgGroupPermissions['*']['createaccount'] = false;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;

# Permissions: hide history for anonymous users
$wgHooks['MediaWikiPerformAction'][] = 
        function( $output, $article, $title, $user, $request, $wiki ) {
          if( ( !$user || $user->isAnon() ) && ( $request->getVal('action') == 'history' ) ) {
            return false;
          }
          return true;
        };

# Show errors in the browser
#$wgShowExceptionDetails = true;

# Debugging
#error_reporting( -1 );
#ini_set( 'display_errors', 1 );
#$wgDebugLogFile = "/tmp/wikiwiki.log";

System permissions for uploads

sudo chown -R www-data:www-data /var/www/mediawiki/images/
sudo chmod -R 755 /var/www/mediawiki/images/

Change user password using commandline

Set the password for username 'user1' to '**pwd**'. 

cd /var/www/mediawiki
php maintenance/changePassword.php --user=user1 --password=**pwd**

Apache2 webserver configuration

If you login using http your password will be send over the net in 'clear text'. To force login via https the RewriteRule is added, however, you will also need to configure the SSL part of your website. Read Create certificates for Apache2. See also Apache2 configuration for SOGo and MediaWiki.

Nginx conf webserver configuration

See:

PHP configuration

With wikimedia, when you import or export all pages or when you upload images and files, this will take more space and time that normally is allowed by PHP. Change these settings: 


sudo gedit `locate php.ini | head -n 1``

#where is php.ini
php -r \@phpinfo\(\)\; | grep 'php.ini' -m 1
	...
	upload_max_filesize = 5M
	...
	post_max_size = 5M
	...
	max_execution_time = 180 ; 3min
	...
	max_input_time = 180 ; 3min
	...
	#logon session time (garbage collection)
	session.gc_maxlifetime=3600 ; 60 min
	...
	#nginx webserver requirement
	cgi.fix_pathinfo = 0	
	...
	date.timezone = Europe/Amsterdam

Restart Apache2 to apply the settings: 

sudo service apache2 restart

Backup

The most important part to backup is the database, see MySQL#Backup for more information.

The second part is the files that where uploaded, these are typically located in: 

/var/www/mediawiki/images/

We could backup this folder but then you will also have thumbnails and other temporary files. Instead we will use the following command to list the mediafiles we want to backup: 

cd /var/www/mediawiki/
php maintenance/dumpUploads.php | sed 's~images/~./images/~' | zip ~/Mediafiles.zip -@

To add these to a zip file for example: 

cd /var/www/mediawiki/
php maintenance/dumpUploads.php | sed 's~images/~./images/~' | zip ~/MediaWikiImages.zip -@

Categories

Use categories to group your pages by including one or more Category tags: 

 [[Category:Name]]

Try to distribute your pages evenly over categories, first look here if any of the available categories can be used:

Special:Categories

Tips

Keywords

You can make the search tool more efficient if you add synonyms and keywords to a page. You might want to keep these hidden from the reader to keep the text readable . Insert like this:

<!-- hidden text -->

Special Import / Export pages

Import (as Admin)

Special:Import

Export pages

Special:Export

Export full contents

Uploaded files (like images) are not included an need to be copied and linked separately. 

cd /var/www/mediawiki/
sudo php maintenance/dumpBackup.php --full --uploads > ../wiki_dump.xml

Change where "Main Page" in the menu links to

By default "Main Page" in the menu links to 'Main Page' but you can replace this with with your own page.

Change where "Main Page" in the menu links to:

  1. Go to MediaWiki:Mainpage ( http://www.yourdomain.com/mediawiki/index.php/MediaWiki:Mainpage )
  2. Edit the page so it is the name of the page you want and save it
  3. Now click "Main Page" in the menu and create it

Note: you need to be Administrator to be allowed to do this.

Pages to configure MediaWiki

More info:

You might want to hide when you have been editing pages. We want to show the date but hide the time.

Require login for certain pages with Extension:Lockdown =

Enable this extension and configure LocalSettings.php to hide pages you only want to logged-in users to see.

For example: 

$wgSpecialPageLockdown['ComparePages']        = [ 'user' ];
$wgSpecialPageLockdown['Redirect']            = [ 'user' ];
$wgSpecialPageLockdown['PermanentLink']       = [ 'user' ];
$wgSpecialPageLockdown['PageInfo']            = [ 'user' ];
$wgSpecialPageLockdown['ApiSandbox']          = [ 'user' ];
$wgSpecialPageLockdown['Contributions']       = [ 'user' ];
$wgSpecialPageLockdown['Recentchanges']       = [ 'user' ];
$wgSpecialPageLockdown['Recentchangeslinked'] = [ 'user' ];
$wgSpecialPageLockdown['Ancientpages']        = [ 'user' ];
$wgSpecialPageLockdown['Newimages']           = [ 'user' ];
$wgSpecialPageLockdown['Log']                 = [ 'user' ];
$wgSpecialPageLockdown['Diff']                = [ 'user' ];
$wgSpecialPageLockdown['Export']              = [ 'user' ];
$wgSpecialPageLockdown['Newpages']            = [ 'user' ];
$wgActionLockdown['history'] = [ 'user' ];
$wgActionLockdown['historysubmit'] = [ 'user' ];

Hide 'last modified' time from the pages

Allowing 'Search' to be used you might want to hide the 'last changed' time from the search results. Unfortunately this is not a standard function but we can get what we want if we modify a .php file. 

sudo nano -l +66 /var/www/mediawiki/includes/search/searchwidgets/FullSearchResultWidget.php
$date = $this->specialPage->getLanguage()->userTimeAndDate(

Replace with: 

$date = $this->specialPage->getLanguage()->userDate(

Note: these are both functions defined in 'languages/Language.php'.

VisualEditor

VisualEditor is a WYSIWYG editor that generates readable Wiki text. Due to limitations I prefer to use WikiEdit.

Limitations:

  • Can not edit syntax parts and many other type of blocks, for this you still need to edit the wiki text.
  • Depends on Parsoid which runs as an independed server and is a pain to configure

Info:

At the time I needed to checkout beta version 'MediaWiki 1.22wmf8': 

git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git
cd core
git branch -r | sort -V
git checkout origin/wmf/1.22wmf9
cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/VisualEditor.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Parsoid.git
node.js

Download 'node-v0.8.22.tar.gz' (the core files) and 'node-v0.8.22-linux-x64.tar.gz' (the 64 bit specific files) from http://nodejs.org/dist/v0.8.22/ extract these in this order in one folder.

It needed to be exactly this version, newer and older did not work yet.

Go into the folder and build and install this version of node: 

./configure --prefix=/opt/nodejs
make -j 3
make install

Install Parsoid using npm. Note: you can uninstall by deleting /opt/nodejs: 

sudo -i
cd Parsoid/js
export PATH=$PATH:/opt/nodejs/bin
npm install

Start server: 

export PATH=$PATH:/opt/nodejs/bin
cd /var/www/mediawiki/extensions/Parsoid/js
node api/server.js

Go to:

If you want to modify this service you can edit this file: 

sudo gedit /var/www/mediawiki/extensions/Parsoid/js/api/ParserService.js

See also

Go to Apache2 webserver to read about installing and configuring Apache2 webserver.

Accidentally committed information that really needs to be removed? Go to: Permanently remove a MediaWiki revision using SQL.

MediaWiki.org help pages

Other sources

Retrieved from "https://wjv.duckdns.org/mediawiki/index.php?title=MediaWiki&oldid=3327"