(Created page with " __TOC__ An existing BlueSpice pro installation can easily be extended with BlueSpiceWikiFarm. The existing installation assumes the role of the main wiki (=farm management)....") Tag: 2017 source edit |
No edit summary |
||
| Line 10: | Line 10: | ||
Important for the operation of BlueSpiceWikiFarm is that BlueSpice is located in the directory <code>/w</code> of the DocumentRoot of your web server or VirtualHost. <br /> | Important for the operation of BlueSpiceWikiFarm is that BlueSpice is located in the directory <code>/w</code> of the DocumentRoot of your web server or VirtualHost. <br /> | ||
If this is not the case, you have to move the entire codebase there. <br /> <br /> | If this is not the case, you have to move the entire codebase there. <br /><br />After that, the variable<code>$wgScriptPath</code> in the <code>LocalSettings.php</code> contains the path <code>/w</code>. <br /> | ||
After that, the variable <code>$wgScriptPath</code> in the <code>LocalSettings.php</code> contains the path <code>/w</code>. <br /> | |||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
$ wgScriptPath = "/w"; | $ wgScriptPath = "/w"; | ||
| Line 30: | Line 29: | ||
require_once "$IP/LocalSettings.BlueSpice.php"; | require_once "$IP/LocalSettings.BlueSpice.php"; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | |||
Including the extension "BlueSpiceWikiFarm" == | == Including the extension "BlueSpiceWikiFarm" == | ||
In the <code>LocalSettings.php</code> replace the line | In the <code>LocalSettings.php</code> replace the line | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
| Line 48: | Line 47: | ||
Configure these RewriteRules for the DocumentRoot level of your Web server or VirtualHost. | Configure these RewriteRules for the DocumentRoot level of your Web server or VirtualHost. | ||
{{Textbox|boxtype=note|header=|text=If you experience issues with spaces in page names: Add <code>RewriteRule ^([^\ ]*)\ (.*)$ $1_$2 [E=rspace:yes,N]</code> if it is not already included in your rewrite rules.|icon=yes}} | |||
==Completion== | ==Completion== | ||
Revision as of 12:26, 25 July 2023
An existing BlueSpice pro installation can easily be extended with BlueSpiceWikiFarm. The existing installation assumes the role of the main wiki (=farm management). The contents remain there and can be maintained as usually.
PHP prerequisites
Please ensure that the PHP extension ZIP is archived, which is required for BlueSpiceWikFarm.
Ensuring the correct path in the file system
Important for the operation of BlueSpiceWikiFarm is that BlueSpice is located in the directory /w of the DocumentRoot of your web server or VirtualHost.
If this is not the case, you have to move the entire codebase there.
After that, the variable$wgScriptPath in the LocalSettings.php contains the path /w.
$ wgScriptPath = "/w";
Creating the necessary folders for BlueSpiceWikiFarm
BlueSpiceWikiFarm needs two additional folders in the folder /w at the same level as the LocalSettings.php. You have to create these two folders:
_sf_instances- all data and configurations for the respective instances are stored here_sf_archive- deleted farm instances including your database dump are stored here as ZIP archive
Make sure that these folders are writable by the web server. See also our (notes in the helpdesk ) for this purpose.
Creating the LocalSettingsAppend.php
Including the extension "BlueSpiceWikiFarm" first requires an additional configuration file with the name LocalSettingsAppend.php. Create this file on the same level as the LocalSettings.php and add the following content:
<?php
require_once "$IP/LocalSettings.BlueSpice.php";
Including the extension "BlueSpiceWikiFarm"
In the LocalSettings.php replace the line
require_once "$IP/LocalSettings.BlueSpice.php";
with
require_once "$IP/extensions/BlueSpiceWikiFarm/BlueSpiceWikiFarm.php";
Configuring the web server
In the folder extensions/BlueSpiceWikiFarm/SimpleFarmer/doc you will find example files for RewriteRules, which are necessary for BlueSpiceWikiFarm:
htaccess.template- RewriteRules for Apacheweb.config.template- RewriteRules for IIS
Configure these RewriteRules for the DocumentRoot level of your Web server or VirtualHost.
RewriteRule ^([^\ ]*)\ (.*)$ $1_$2 [E=rspace:yes,N] if it is not already included in your rewrite rules.
Completion
The installation of BlueSpiceWikiFarm is now complete. From now on, you can reach the farm administration in the main wiki under the special page "Special:SimpleFarmer".
