Mediawiki4Intranet/en

From Wiki4Intranet
< Mediawiki4Intranet
Revision as of 20:43, 27 December 2011 by VitaliyFilippov (Talk | contribs) (Created page with "[http://mediawiki.org/ MediaWiki] is a popular «Wiki»-system, written in PHP and originally created as the [http://wikipedia.org/ Wikipedia]'s engine. MediaW...")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

MediaWiki is a popular «Wiki»-system, written in PHP and originally created as the Wikipedia's engine. MediaWiki is very extensible - there is more than 1700 useful extensions, and it's very easy to write a new one.

Mediawiki4Intranet is a MediaWiki distribution containing many extensions and patches useful for intranet (and not only for intranet). It is important to mention that all these extensions are improved and tested to work together — integrations bugs are fixed and some features are added.

This page (english documentation) just contains the basic information. For more information see russian documentation.

Installation information: see #Installation.

Bundle contents

  • Original MediaWiki code.
  • Extensions.
  • Patches.
  • Base configuration files for easily creating your LocalSettings.php.

Most of these is distributed under the GPLv2 license, like the MediaWiki itself. /* I hope the tivoisation isn't a threat for us :) */ Some extensions are under GPLv3.

MediaWiki

MediaWiki is taken from SVN Wikimedia.

Mediawiki4Intranet version may be lesser than the last stable, because the differences between MediaWiki versions are not that big, but patches always need updating.

MediaWiki used in 4Intranet:

  • 2011-02-08 → current: 1.16.2.
  • 2010-10-09 → 2011-02-08: 1.14.1.
  • → 2010-10-09: 1.13.1 (doesn't exist in Google Code).

Patches

Minor changes to the base code of MW and basic extensions are split into and maintained as patches.

Russian description of all patches.

Extensions

Mediawiki4Intranet contains many useful extensions, and many of them were created specially for it.

Russian description of all Mediawiki4Intranet extensions.

Installation

The simplest way to try MediaWiki4Intranet for Windows users is to download Windows bundle (approx. 200 MB). It's rarely updated (now it's Mediawiki4Intranet/en/WindowsBundleVersion), but it's fully standalone and includes ALL needed third-party software, even LaTeX. Windows-сборка Mediawiki4Intranet.

To install MediaWiki4Intranet on your site, you need:

  • Get the code:
  • Create images folder in the installation directory, grant web server user read and write access there.
  • Create an empty MySQL database and a user with full access to it.
  • Initialise the database:
    • Either import maintenance/tables.sql:
      • At first create minimal configuration (LocalSettings.php)
      • Run php maintenance/patchSql.php maintenance/tables.sql from the installation directory.
    • Or run the MediaWiki installer from config folder — the plus is it also does additional environment checks:
      • Go to http://server/wiki/config/, answer questions, fix issues, select database type MySQL, InnoDB, 4.1/5.0 utf8 binary. Installer will initialise the DB and create a basic config LocalSettings.php.
      • Remove the generated configuration — it has plenty of options which are already in MediaWiki4Intranet configs.
      • At last, create minimal MediaWiki4Intranet configuration (LocalSettings.php)
  • Then run php maintenance/update.php from the installation directory.

Minimal configuration (LocalSettings.php):

<?php
require_once 'custisinstall/ServerSettings.php'; # use this under UNIX, use BaseSettings.php under Windows
$wgDBname = 'wiki'; # database name
$wgDBuser = ''; # login and password for database user
$wgDBpassword = '';
$wgDBadminuser = $wgDBuser;
$wgDBadminpassword = $wgDBpassword;
$wgScriptPath = '/wiki';

System requirements

Minimal requirements:

  • PHP 5 or later.
  • Notice: now there are Notice errors in the MW4Intranet, we'll fix them all, but now, use error_reporting = E_ALL & ~E_NOTICE in php.ini.
  • Web server. The simplest is to use Apache, but IIS, nginx + php_fpm and others are also supported in theory.
  • MySQL DBMS, preferably version 5 or later.
  • UNIX system is preferred.

PHP extensions:

  • php5-mysql! :-)
  • php5-gd for images.
  • php5-curl for uploading files via URL.

PHP configuration (php.ini):

  • error_reporting = E_ALL & ~E_NOTICE
  • If your PHP is < 5.3: short_open_tag = Off
  • magic_quotes_gpc = Off (should be Off on every web server which respects itself)
  • For SUPA screenshot upload: either disabled Suhosin, or suhosin.post.max_value_length = 8000000 and suhosin.request.max_value_length = 8000000. 8000000 is an example, you can set a bigger value.

Optional extensions:

  • php5-xcache for overall performance.
  • php5-fss for string operations.
  • Mail и Net_SMTP PEAR packages for e-mail.

Third-party software is also required - there are many of them, but Linux users usually may 'apt-get' them, and Windows users may use our standalone bundle (see above).