Extension:BlueSpice/BlueSpice basic install

Download instructions
Goto http://sourceforge.net/projects/bluespice/ and download the most up-to-date package for BlueSpice basic.

MediaWiki
For the installation of blue spice we assume that MediaWiki (version 1.15x and 1.16x) is installed and configured. It can be accessed via browser through. For the usage of blue spice Firefox from version 3.0 is recommended. Other browsers (especially IE 7 and 8) should work, but have not been tested properly so far.

Server
These login credentials to the database server should be known: (probably created during the installation of MediaWiki) With an installation on Xampp the username "root" with empty password is preset.
 * Web server (Apache 2)
 * PHP (versions 5.2.0, 5.2.6, 5.2.9, 5.3.0 and 5.3.2) was tested sucessfully.
 * PHP version 5.3.1 has a Bug because of which MediaWiki does not work. This affects e.&#x202f;g. Xampp 1.7.3.
 * MySQL from version 5.x
 * Host/IP address and port
 * Username and password for the root user (Create/Drop-Statements) and the Wiki-User
 * Name of the used database
 * The table prefix of the used database

Installation
This document describes the installation of the second beta version of blue spice for MediaWiki.

You can find a pdf version of the installation instructions on sourceforge.org
 * Installation instructions for Windows
 * Installation instructions for Linux

Components of blue spice and installation
If the above mentioned requirements are met and the readily configured MediaWiki 1.15.x or 1.16.x is accessible via browser, download the file bluespice_beta2.zip. It includes the following directories and files:


 * bluespice-core
 * bluespice-mw
 * skins
 * installcheck.php
 * Blue spice beta 2 - Installation Manual Windows.pdf
 * Blue spice beta 2 - Installation Manual Linux.pdf
 * Blue spice beta 2 - Installationsanleitung Windows.pdf
 * Blue spice beta 2 - Installationsanleitung Linux.pdf

Copy the content of this file, resp. the unpacked elements, directly into the directory. There already exists a folder  which was created by MediaWiki. Copy the content of the downloaded folder  into the already existing folder.

Checking the requirements
To check further requirements for the installation, access  via browser. The page shows additional information about the installation as well as occurring errors (e.&#x202f;g. concerning missing rights).



Please make sure that the directories  and are writable by the PHP-module of the webserver.

If everything is ok, go on to the configuration of blue spice.

Setup of blue spice
Please go to the directory of the web server and add in file  at the end the following lines:

 $wgUseAjax = true; $wgDefaultSkin = 'bluespice'; require_once( dirname(__FILE__).'/bluespice-core/index.php' ); BsCore::getInstance('MW')->setup;

The extensions are already part of the installation.To activate them please add the following lines in :  // MediaWiki Erweiterungen require_once( BsConfig::get('MW::AdapterPath').DS.'ext-dist/Lockdown/Lockdown.php' ); require_once( BsConfig::get('MW::AdapterPath').DS.'ext-dist/Quiz/Quiz.php' ); require_once( BsConfig::get('MW::AdapterPath').DS.'ext-dist/Poem/Poem.php' ); require_once( BsConfig::get('MW::AdapterPath').DS.'ext-dist/CategoryTree/CategoryTree.php' ); require_once( BsConfig::get('MW::AdapterPath').DS.'ext-dist/ImageMap/ImageMap.php' ); require_once( BsConfig::get('MW::AdapterPath')             .DS.'ext-dist/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php' ); require_once( BsConfig::get('MW::AdapterPath')             .DS.'ext-dist/ParserFunctions/ParserFunctions.php' ); require_once( BsConfig::get('MW::AdapterPath').DS.'ext-dist/InputBox/InputBox.php' ); require_once( BsConfig::get('MW::AdapterPath').DS.'ext-dist/Nuke/Nuke.php' );
 * Lockdown,
 * Quiz,
 * Poem,
 * CategoryTree,
 * ImageMap,
 * SyntaxHighlight (GeSHi),
 * ParserFunctions,
 * InputBox and
 * Nuke

A pageview of  at this moment of the installation would produce the following error message: Failed opening required '\bluespice-core\config\base-settings.php'

To solve this error go to the next step.

Configuration of blue spice
Access the address.

Fill in the required parameter or leave the default values if they are right.



User: Provide a database user who has the right to create tables in the database. The database user who is created via a standard MediaWiki installation does not have these rights! For testing (only!) you can use the MySQL-root-user.

Database: The database with the used prefix can differ from the database used by MediaWiki. But normally this is not necessary.

 : Fill in the path of the  installation starting at the   directory.(Example:   was installed in   . Therefore the correct input for Core::BlueSpiceScriptPath is:.

If the submission of the configuration was successful, the message Configuration successfully finished. is shown in the browser.

Recommendation: For security reasons we recommend to delete the file.

Executing update.php
blue spice requires additional database tables, which (in this step) can be automatically input into the database server. The blue spice extensions do not start working until  is executed.
 * ShoutBox,
 * WhoIsOnline and
 * PagesVisited (Navigation->Fokus)

To do so, follow the next steps:
 * Make sure that the file  exists, which contains the login of a root user for the MediaWiki database. If this file does not exist yet, create it or copy the file   to.
 * Edit the file, to fill in the necessary login data:

 $wgDBadminuser = 'root'; $wgDBadminpassword = '';

Find further information about the  at mediawiki.org/wiki/AdminSettings.php.

cd  \php.exe maintenance\update.php
 * Execute the file  via command line, e.&#x202f;g.

The missing tables are now created. Following message should be seen on the screen:

Creating whoisonline table...ok Creating shoutbox table...ok

Finish
Your blue spice installation should be working now.

Support
Get help, report bugs and consult the forums