Requirements

• MediaWiki v1.6.8+ (v1.7.1+ is recommended).
  
• vBulletin v3.6.x
• PHP4 or PHP5
• MySQL

Installing vbWiki Pro

Steps

1. Extract the content of the vbWiki Pro package to a directory in your computer.
2. If this is a new installation, find vbWikiPro_Init.php-dist in forums_upload/vbWiki and rename it to vbWikiPro_Init.php.
3. Upload the content of the forums_upload directory to your forums directory. (e.g. if your forum is installed on /home/user/www/forums, then resulting path to vbWiki would be /home/user/www/forums/vbWiki)
4. Upload the content of the wiki_upload directory to your wiki directory. (e.g. if your wiki is installed on /home/user/www/wiki, the content of wiki_upload/skins will go into /home/user/www/wiki/skins)
5. Open MediaWiki's config file: LocalSettings.php (located in your wiki's directory, e.g. /home/user/www/wiki_, and, at the end of the file, before the ?>, add the following line:

require_once "/absolute/path/to/your/forums/vbWiki/vbWikiPro_Init.php";

6. Log onto your forums' Admin CP, go to Plugins & Products > Manage Products > Add/Import Product, click browse and locate the Product-NuHit_vbWikiPro.xml file in your computer. Select 'allow override' and click on 'Import'
7. If you want to enable forum headers, then edit the FORUMDISPLAY template and add the following line wherever you want the forum headers to be included:

$vbwiki_forumheader_bits

• In the Admin CP, go to vBulletin Options, and select vbWiki Pro Settings (towards the end of the list). Change any settings you would like and click save. Some settings to consider:
  • Redirect Talk Pages to vBulletin?
  • When redirecting Talk Pages, use a thread per article or a forum per article?
  • Name of forum that will host Talk Pages (this setting should be the name of an existing forum that will contain all threads for wiki Talk Pages.)
  • Enable Forum Guides?
  • For non-english forums:
    
    • Translate encoding to UTF-8?
    • Language Code: Leave empty for automatic wiki translation (when using forums with multiple languages)
  • If your wiki and forums are installed in different subdomains (e.g. forums.your-domain.com and wiki.your-domain.com) cookie domain settings will need to be adjusted. Refer to this vbWiki FAQ for more information.

Further customization and configuration

• In the Admin CP, go to Usergroups > Usergroups Manager, and configure per-usergroup vbWiki Pro permissions.
• Forum Templates and Wiki Skin Integration:
  
  • By default by using vbWiki Pro, your wiki pages will be displayed using your forums header and footer (including any banners, backgrounds, navbar, menues, etc). However, if you would like to customize further the look of the wiki pages, follow these steps:
    • In the Admin CP, go to Styles & Template > Styles Manager
      
    • In the style you would like to customize find the template vbWiki_MAIN (used for all wiki pages) and customize it as needed.
      
    • There is another template, named vbWiki_THREADLIST, which is used to show the latest threads in a wiki page.
  • Note that these templates are only used if vbWiki Pro is enabled and vbWikiSkin is used on the wiki side. Refer to this vbWiki FAQ if your wiki does not seem to use the newly installed vbWikiSkin.
• It is important to ensure that your MediaWiki installation is properly configured to avoid spamming. For more information please visit this page on how to configure MediaWiki against spam attacks.

Upgrading vbWiki Pro

• If you are upgrading from a version 0.9.6 or older, please uninstall the vbWiki Pro 'product' from the Product Manager in the fourms' Admin CP.
• The rest of the steps to upgrade an existing vbWiki Pro installation are pretty much the same as outlined above with these exceptions:
  • Do not overwrite your existing vbWikiPro_Init.php.
  • When installing Product-NuHit_vbWikiPro.xml, select 'Allow overwrite'.
    

What to expect

• vbWiki Pro successful installation can be verified as follows:
  • Go to Special:Version in your wiki. vbWiki Pro should be listed as an installed extension.
  • At the bottom of the pages in the wiki, vbWiki Pro copyright information will be displayed (the copyright information can be removed by purchasing the Branding Free Option).
• User login integration:
  • 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.
• Wiki Skin Integration:
  • When vbWikiSkin is used all wiki pages will use the forum's look and feel. Which can be customized as indicated above.
• Talk Page integration:
  • If Talk Page redirection was enabled in the Admin CP's vbWiki Pro's settings, clicking on the talk page on the wiki side will forward the user to a thread or forum (configurable through the Admin CP) on your board.
• New wiki tags:
  • The following tags can be used from within a wiki page: vbWiki_Stats and vbWiki_ShowThreads.

How to uninstall vbWiki Pro

• Comment (or remove) the line added during the installation from your wiki's LocalSettings.php.
  
• Disable or uninstall vbWiki Pro Product from within your forums' Admin CP (Plugins & Products). Important: This step must be done before removing any vbWiki Pro files.
  
• Optionally, remove the vbWiki directory from your forums directory.
• Remove vbWikiSkin.php and the folder vbwikiskin from your wiki's skins directory.
• Remove bitfield_nuhit_vbwikipro.xml from your forum's includes/xml directory.
  
• Remove hooks_nuhit_vbwikipro.xml from your forum's includes/xml directory.

Common Installation Questions

Answers to common questions can be found in this vbWiki FAQ. If you are installing vbWiki Pro with MediaWiki version 1.6.8 there are some small differences in operation which can be found in the vbWiki Pro and MW 1.6.8 page.