- VW3
- Mod Rewrite Configuration
Return to current revision
General Differences
made the following changes
- changed the title from 'Configuring .htaccess' to 'Mod Rewrite Configuration'
- changed the meta description
-
-
When installing VaultWiki for the first time, or you need to change some .htaccess code because of a recent change to VaultWiki: Server Settings, there are several possible variations on these instructions. -
+
When installing VaultWiki for the first time, or if you have made changes recently to VaultWiki: Server Settings, you may need to update your server's Mod Rewrite configuration.
-
Differences in Content
-
-
When installing VaultWiki for the first time, or you need to change some [I].htaccess[/I] code because of a recent change to [HELP]VaultWiki: Server Settings[/HELP], there are several possible variations on these instructions. -
+
When installing VaultWiki for the first time, or if you have made changes recently to [HELP]VaultWiki: Server Settings[/HELP], you may need to update your server's Mod Rewrite configuration. -
-
-
Please note that throughout these instructions:
[list][*]FILE refers to the setting value for "Wiki PHP File".
[*]VAR refers to the setting value for "REQUEST Title Variable".
[*]DEFAULT refers to the encoded title of your Default namespace. To determine the encoded title, view the title in parentheses in your Namespace Manager. If there are no parentheses, just the Title will suffice.[/list] -
+
Visit [color="DimGray"]VaultWiki > Initial Wiki Setup[/code]. In the section called "Mod Rewrite Generator," it asks "What type of rewrite does your server use?" Select the format your server uses. [i].htaccess[/i] is the most common and is selected by default, but your configuration might be different. If you're not sure what to do here, contact your server administrator. -
-
-
[U]Case #1[/U]
Your forum resides at [COLOR="DimGray"]http://www.example.com/forums/[/COLOR]
Your wiki resides at [COLOR="DimGray"]http://www.example.com/wiki/[/COLOR] -
+
[template]Warning Box | Important | If you discover that your server does not support Mod Rewrite, you will have to use the default values for the following "VaultWiki: Server Settings":
[list][*]Wiki Base URL: (This should match [color="DimGray"]vBulletin Options (aka Settings) > vBulletin Options (aka Options) > Site Name / URL / Contact Details > Forum URL[/color])
[*]Wiki PHP File Name: showwiki
[*]REQUEST Title Variable: title
[*]Simplify Wiki Links: No[/list][/template] -
-
-
[U]Case #2[/U]
Your wiki resides in your forum root. -
+
When you've selected the appropriate Mod Rewrite format, click the "Generate" button. Most setups will show 1 text box - this box shows the contents that must be added to your server's Mod Rewrite settings for the location specified.
If you are using vBulletin 4 Mod Rewrite, this code should be added [i]before[/i] the vBulletin 4 Rewrite code.
Some setups will show more than 1 box. In this case, the contents of each box must be added for the corresponding locations. If both boxes actually point to the same directory on your server (like if [i][url]http://wiki.site.com[/url][/i] and [i][url]http://forum.site.com[/url][/i] both point to the main [i]site.com[/i] directory), then ignore the first box.