Difference between revisions of "Enabling Search Engine Friendly (SEF) URLs on IIS/IIS6/1.5"
From Joomla! Documentation
< Enabling Search Engine Friendly (SEF) URLs on IIS | IIS6
(Find the period once then pattern match from that point on. The html|htm pattern simplifies to html? here. Old code matched "/" in two places. Only one is needed.) |
m (Code correction: added a slash to "RewriteRule .* index.php" line) |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | There are several steps one must take to get [[ | + | There are several steps one must take to get [[Search Engine Friendly URLs|Search Engine Friendly (SEF) URLs]] to work properly when using Joomla! on Microsoft's Internet Information Server (IIS) web servers. The following instructions should result in functional SEF URLs using Joomla! 1.5 and IIS6. The only caveat is that you need access to the server itself to install the ISAPI filter in step 1, so either you should be hosting your own server (not shared) or leasing a dedicated server from your web host. If you're using shared hosting, you will have to convince your web host to install it for you. |
1) Install an ISAPI filter onto the web server that mimics mod_rewrite. There are several, some may be free but most are commercial applications. The important thing to remember is that it must mimic Apache's mod_rewrite. For example, [http://www.helicontech.com/isapi_rewrite/ Helicon's ISAPI_Rewrite 3] is commercial. There is a [http://www.helicontech.com/isapi_rewrite/doc/litever.htm free version] of the program which is limited in that it only allows a single configuration for all sites hosted on the server. To get individual site or directory configurations, you must pay for the full version. | 1) Install an ISAPI filter onto the web server that mimics mod_rewrite. There are several, some may be free but most are commercial applications. The important thing to remember is that it must mimic Apache's mod_rewrite. For example, [http://www.helicontech.com/isapi_rewrite/ Helicon's ISAPI_Rewrite 3] is commercial. There is a [http://www.helicontech.com/isapi_rewrite/doc/litever.htm free version] of the program which is limited in that it only allows a single configuration for all sites hosted on the server. To get individual site or directory configurations, you must pay for the full version. | ||
| Line 7: | Line 7: | ||
<source lang="apache"> | <source lang="apache"> | ||
RewriteEngine On | RewriteEngine On | ||
| − | RewriteCond %{REQUEST_URI} (/[^.]*|\.(html?|php | + | RewriteCond %{REQUEST_URI} (/[^.]*|\.(html?|php))$ [NC] |
RewriteCond %{REQUEST_FILENAME} !-f | RewriteCond %{REQUEST_FILENAME} !-f | ||
RewriteCond %{REQUEST_FILENAME} !-d | RewriteCond %{REQUEST_FILENAME} !-d | ||
| − | RewriteRule | + | RewriteRule .* /index.php |
</source> | </source> | ||
| Line 30: | Line 30: | ||
At this point you should have a working Joomla! install utilising SEF URL's. | At this point you should have a working Joomla! install utilising SEF URL's. | ||
[[Category:IIS]] | [[Category:IIS]] | ||
| − | [[Category:Search Engine | + | [[Category:Search Engine Friendly URLs]] |
Latest revision as of 01:45, 21 August 2011
There are several steps one must take to get Search Engine Friendly (SEF) URLs to work properly when using Joomla! on Microsoft's Internet Information Server (IIS) web servers. The following instructions should result in functional SEF URLs using Joomla! 1.5 and IIS6. The only caveat is that you need access to the server itself to install the ISAPI filter in step 1, so either you should be hosting your own server (not shared) or leasing a dedicated server from your web host. If you're using shared hosting, you will have to convince your web host to install it for you.
1) Install an ISAPI filter onto the web server that mimics mod_rewrite. There are several, some may be free but most are commercial applications. The important thing to remember is that it must mimic Apache's mod_rewrite. For example, Helicon's ISAPI_Rewrite 3 is commercial. There is a free version of the program which is limited in that it only allows a single configuration for all sites hosted on the server. To get individual site or directory configurations, you must pay for the full version.
2) Create a new file at the root of the Joomla! site called .htaccess and place the following in that file:
RewriteEngine On
RewriteCond %{REQUEST_URI} (/[^.]*|\.(html?|php))$ [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule .* /index.php3) Put the following after the opening <?php tag in Joomla!'s main index.php file:
if (isset($_SERVER['HTTP_X_REWRITE_URL']))
{
$_SERVER['REQUEST_URI'] = $_SERVER['HTTP_X_REWRITE_URL'];
}4) Enter a value for $live_site in Joomla!'s configuration.php file:
var $live_site = 'http://www.example.com/site1';5) In Joomla!'s Global Configuration page, check the boxes next to all three SEF options and save the configuration, OR install a 3rd-party SEF component and enable it ([1] is known to work with this configuration).
At this point you should have a working Joomla! install utilising SEF URL's.