BlueSpice

What can this extension do?
The software of Wikipedia becomes an enterprise solution. Blue spice offers a range of improvements in the areas of usability, administration, organisation of information, extensibility and personalization. In the basic version you are able to edit tables via WYSIWYG-editor, dialogues simplify the integration of links, categories, pictures and files. Thanks to the user administration and the wiki-preferences the administration of the wiki is quickly done. Via a newsblog you keep your colleagues up-to-date.

blue spice

 * Number of threads: Is there a discussion about the article and is it highly frequented? That’s what you can see at the tab “discussion” because the number of edits is shown.
 * ArticleInfo: Is the last editing up-to-date? Who’s responsible? And what categories are dedicated? ArticleInfo shows you the relevant information. If you want to know more detailed, just look inside there you find a summary of recent changes.
 * Authors: Get an idea of the authors. Below the article you find the authors'pictures.
 * UserAdministration: User, permissions, passwords - the admin rules the users.
 * Wiki or Blog? Why take a decision? With an internal blog you can refer information etc.
 * My preferences: Fit your Wiki - every user can change his array.
 * Settings: Some settings apply to everybody. Only the admin can change it.
 * Emoticons: certain signs become Icons :-)
 * Extensioninformation: Want to know what functions are integrated in blue spice? As an admin you can have a look at Extentioninformation.
 * Wanted article: Want to have an article about a special theme? Let others know that there is a requirement.
 * InsertFile, InsertCategory, InsertLink: Want to integrate files, categories or links in the article? There are some intuitive dialogue windows that help you.
 * Recent changes: There you can see the articles that have been edited recently.
 * PagesVisited: You visited a page and want to see it again? PagesVisited lists the pages you have visited recently.
 * Personalsidebar: You focus on specific pages? You can link them in the navigation. With blue spice you can compile a navigation in a personal sidebar.
 * Shoutbox: Use the shoutbox to comment on articles
 * Skin: Neat and functional - the new skin facilitates functionality.
 * Who is online: Now you know who’s online in the Wiki.
 * Widgets: Behind the star you find tools, recent changes, Who’s online, etc. Point-and-Click the you can show or hide functions.
 * WYSIWYG-Editor: With this editor you can easily edit articles. It’s similar to a text prosessing program, so you don’t need wiki code.

MediaWiki

 * categoryTree: It provides a dynamic view of the wiki's category structure (main catgeories and sub-categories) as a tree.
 * ImageMap: One image, many links. You can hyperlink areas of the image to multiple destinations
 * InputBox: Users can "complete" a form (entering text, selecting menu items, etc.) by entering text into the box.
 * Lockdown: Allows to restrict access to specific namespaces and special pages to a given set of user groups.
 * Nuke: There is somebody who create some spampages? Nuke makes it possible for sysops to mass delete pages
 * ParserFunctions: enhances parser with logical functions makes a text a separate paragraph, with < br / > after every line, i.e., it suppresses reformatting of a single newline to a blank space.
 * Create your own Quiz.
 * SyntaxHighlight_GeSHi: This extension adds the . 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