1. VW3
2. VaultWiki: Server Settings

Printable Version

This page is about the "VaultWiki: Server Settings" group located in vBulletin Options > vBulletin Options (Settings > Options in vBulletin 4). This group will allow the Administrator to change important configuration settings for VaultWiki.
server-settings.jpg

Note:

Some "VaultWiki: Server Settings" require you to make changes to your server's Mod Rewrite Configuration. If your server or host does not support this, do not make changes to those settings.

Turn on the Wiki

From time to time, you may want to turn your wiki off to the public while you perform maintenance, update versions, etc.

Selecting 'Yes' will show the wiki to your visitors.
Selecting 'No' will hide the wiki from your visitors.

When the wiki is Disabled, users in the Administrator usergroup will still be able to browse the wiki. Other visitors will see an error message stating that the wiki is temporarily unavailable.

Wiki Base URL

Even though VaultWiki's files must stored in your forum directory, VaultWiki allows Administrators to change the URL to the wiki that your visitors will see.

For example, normally your wiki URL may look like:
http://www.example.com/forums/wiki

But you might instead want the following URL:
http://www.example.com/wiki

To achieve this, you would enter a base URL of:
http://www.example.com

However, the setting value shouldn't have a trailing slash (http://www.example.com/) or include parts like /wiki, because both will automatically be added by the script.

Note:

This setting only affects the HTML output of pages containing wiki URLs. In order for your server to recognize these URLs, you will still need to make changes to your server's Mod Rewrite Configuration.

Filename of the Wiki PHP File

Even though the file that serves VaultWiki pages is called showwiki.php, the file name can be changed using this setting.

When the Simplify Wiki Links option is also enabled, this setting value will be used as the wiki directory name.

Important:

Never physically rename the showwiki.php file in your forum directory. Instead, when this setting value changes, you should update your server's Mod Rewrite Configuration.

REQUEST Title Variable

The REQUEST Title Variable is the part of the URL that points to the wiki page a visitor is trying to view.

Consider the URL: http://www.example.com/showwiki.php?title=page

In this case, 'title' is the REQUEST variable that points to a specific page. This setting allows Administrators to change 'title' to something else.

When the Simplify Wiki Links option is also enabled, this part of the URL will not be visible to users.

Note:

When this setting value changes, you should update your server's Mod Rewrite Configuration.

Replace Spaces in URLs

VaultWiki encodes whitespace characters when creating URLs to wiki pages. This setting allows you to select what character will replace whitespace characters: +, -, or _.

Note:

If you have already created some articles and you change this value, you will need to visit VaultWiki > Wiki URL Manager and click '[Rebuild Page URLs]'. You should update your server's Mod Rewrite Configuration if: Your Default Namespace's Title (or its Translations) has spaces in it (optional) Any Namespace's Custom Path (or its Translations) has spaces in it (required) See Adding and Editing Namespaces for more information on the Namespace settings.

Simplify Wiki URLs

Enabling this will leave out the .php extension and title variable from VaultWiki's URLs. Instead URLs will look like: http://www.example.com/wiki/Title

Note:

When this setting value changes, you should update your server's Mod Rewrite Configuration.

Enable UTF-8 Support for URLs

VaultWiki usually attempts to remove foreign language characters from URLs. However, if your board is non-English speaking and already uses UTF-8 encoding, you may opt to allow your language's characters in wiki URLs by turning this feature on.

Note:

If you change this value and you have already created some articles that have titles containing foreign language characters, you will need to visit VaultWiki > Wiki URL Manager and click '[Rebuild Page URLs]'.

Enable Link Caching

VaultWiki attempts to track certain links between wiki pages, like redirects and template inclusions. When this setting is enabled, VaultWiki will track all wiki-related links throughout your forum.

When link caching is disabled, certain Special pages, like Special:Whatlinkshere, will not be available.

The more posts your forum has, the more intensive tracking this information can be. If you have a forum with a lot of posts, you may consider turning link caching off.

Enable Multi-Language Support

Multi-Language Support allows your users to post articles in different languages. Users can assign pages to each other as translations.

For example, you might have different versions of a page in English, German, and Russian. If you were reading the English page, you could easily select to view the page in German or Russian.

When Multi-Language Support is enabled, you can also translate certain Namespace fields for each forum language. For more information about editing namespaces, see Adding and Editing Namespaces.

Replace Wiki Tab by URL

Normally the Wiki Home Page shows a list of all namespaces that the user can view and a search box allowing the user to jump to any wiki page.
replace-wiki-tab.jpg
You can define your own page to replace the Wiki Home Page by entering its URL here. Only URLs that would resolve to another wiki page will be accepted.

Note:

Once you enter the URL here, the page will not be accessible from that URL, but from the Wiki Home URL. A 301 permanent redirect will be added at the old location to ensure users find the new location.