Precautions: Please backup your database and site before installing this extension or following any of the instructions contained in this page and in the rest of this site. Always make your changes first in a test/development setup, and never in a live production environment.
This page contains the instructions on how to install vbWiki on your server. For instructions on installing vbWiki Pro, go to vbWiki Pro Installation Instructions.
Installing vbWiki
- Extract the content of the vbWiki package to a directory in your computer.
- Find vbWiki_Init.php-dist and rename it to vbWiki_Init.php.
- If you would like to change any of the default settings, find the setting you would like to customize in vbWiki_Settings.php, copy it to vbWiki_Init.php, and modify its value.
- Create a new directory named vbWiki in your forums directory directory (e.g. /absolute/path/to/your/forums/vbWiki)
- Upload all vbWiki files from your computer to this new directory.
- Open MediaWiki's config file: LocalSettings.php, and, at the end of the file, before the ?>, add the following line:
require_once "/absolute/path/to/your/forums/vbWiki/vbWiki_Init.php";
What to expect
- vbWiki successful installation can be verified by going to Special:Version in your wiki. vbWiki should be listed as an installed extension.
- When a new user tries to register he/she is directed to your forums registration page.
- When a user logs in through the forum, he/she will be automatically logged in when visiting a wiki page.
- When a user logs in through the wiki, he/she will be automatically logged in when visiting the forums. (The user will be shown also on the forum's "What's Going On" section, even if the user doesn't visit a forum page).
- When a user logs out, he/she gets logged out from both the wiki and the forum.
How to uninstall vbWiki
To disable vbWiki, simply comment (or remove) the lines added to your wiki's LocalSettings.php during the installation. Optionally, remove the vbWiki directory from your wiki's extensions directory.
Common Installation Questions
Answers to common questions can be found in this vbWiki FAQ.
|