This is the general settings page for the SEO addon settings.

<tip c n>Note: This feature does not create files within the system. It only rewrites the urls used by the system following the instructions in the htaccess file so that they do not appear like dynamic website urls which contain a lot of data within the query string of the url. By "moving" the data passed within the query string into the url itself it is believed that the urls produced are much more "human readable" and descriptive to search engines.</tip>

This will be displayed when you have updated the SEO addon, and changes to the addon require that the .htaccess file are re-generated, and applied to your .htaccess file. In most cases, the old .htaccess file will continue to work, but will not be taking advantage of new features in the new version of the SEO addon.

In cases where the URL will be changed, once you do re-generate the .htaccess file to start using the new URL, if an old URL is used (such as an old bookmark, or if an old URL is still indexed by a search engine), visiting the old URL will redirect (301 permanent redirect) to the new URL. Doing this will require that Force SEO URL's is turned on, and as noted in that setting's documentation, may not work for all servers.

So far, there are 3 updates that require changes to the .htaccess file in order to take advantage of new features.

<tip c n>Note: We now recommend that you re-generate the .htaccess file any time the SEO addon needs to be updated. The versions listed below are the "main" versions that changes to the .htaccess file were required, but it does not list every single version that requires the .htaccess to be updated. Also if any other addons "use" SEO URL's, such as the Storefront addon, the .htaccess may need to be updated for changes from those addons. The best practice is any time the SEO addon is updated, go ahead and re-generate the .htaccess contents.</tip>

When you update from SEO 1.0.0 (used for Geo 3.1.9 and earlier versions) to SEO 2.0.0 or higher: The first time you attempt to access the SEO settings, it will inform you that proceeding will require changes to your .htaccess and will make it start using the newer format for URL's. Before that, it will still re-write URL's in the same way that was done in SEO 1.0 so that your existing URL's will not suddenly "break" when you update.

In SEO version 2.0.*, the titles that are used in the URL (such as the Category title or listing title) used underscores "_" for the word separator. Starting in SEO 2.1.0 and up, it now uses dashes "-" to separate words, since this is Google's recommended word separator¹⁾.

This change requires changes to the .htaccess file, therefore until you re-generate the .htaccess file, the SEO will continue to generate the URL using underscores for the word separator. And to make it clear that you are still using underscores, it will display the message:

You are still using underscores "_" in titles! Re-generate the .htaccess file
and copy the changes to your .htaccess file to be able to start using dashes
"-" instead. 

The title in the URL can now have more than just alpha-numeric characters, such as punctuation and similar. The change was actually done to allow it to work with languages that use non-Latin characters, such as Arabic. These changes however, require that the .htaccess file is re-generated.

This is the main on/off switch for the SEO addon. It allows you to enable or disable the re-writing of URL's without having to enable/disable the addon itself like was done in SEO 1.0 (Although, you can still disable URL re-writing by disabling the SEO addon).

Changing the URL settings will not have an effect on your site, until you click the "Apply All Settings" button. This is to give you time to set up your URLs how you want them, and in the mean time the links won't be broken on your site.

Click the button, then it will display a warning. If you are sure you want to apply the settings, click "Yes". Then it will display the new generated .htaccess contents. You will need to copy/paste the generated contents to your .htaccess file and upload the changes. Failure to do this can result in broken links.

<tip c w>Warning: When you click "Apply All Settings", you need to copy/paste the new .htaccess contents to your .htaccess file and upload the changes. If you don't do this, it will result in broken links on your site!</tip>

If there are new .htaccess contents being displayed, click this button to select the contents of the .htaccess file. You would then copy (CTRL+C in Windows) the text and paste into your .htaccess file.

This will list all of the different types of URL that can be re-written, along with a link to edit the configuration of any of the different types. Underneith each one it will list an example of what the URL might look like, note that this will display the live settings, so if you've made changes to a URL it will not be reflected here (or on the site) until you click on the Apply All Settings button.

<tip c w>Warning: The URL Configuration is able to be changed for every different type of URL, but is meant to be changed when you are first setting up your site. It will not create re-directs from "old" configurations to "new" configurations. If you wish to change a URL configuration and need the old configuration URL to re-direct to the new configuration URL, you will need to manually create such a re-direct in your .htaccess file.

Note that this only applies to changes to the URL configurations (for instance, changing "category" to "cat" or removing it altogether from the category URL's configuration). Some things do automatically redirect and will be documented on this page, for example if you have the Force SEO URLs turned on and you re-name a category. </tip>

Note: Changing any settings in this section does not require re-generating the .htaccess file.

Turning this setting on (checked): Accented characters²⁾ found in a title inserted in an URL will be converted into the non-accented equivalent.

A listing titled "¿Dónde está el baño?":

Setting Enabled:
www.example.com/categorias/83/cuestiones-importantes/anuncios/423/¿Donde-esta-el-bano.html

Setting Disabled:
www.example.com/categorias/83/cuestiones-importantes/anuncios/423/¿Dónde-está-el-baño.html

<tip c w>Only turn this setting on if you need it! It will cause the software to have to do a lot of extra work if you turn this on when it is not needed.</tip>

This setting is known to work with the following charsets:

• UTF-8 (considered safest charset)
• ISO-8859-1
• Any other charset: Be sure to test thoroughly as the results of the conversion may be unreliable. If possible, we recommend using UTF-8 as your site-wide charset to avoid possible conversion problems.

If turning this on converts accented characters to the wrong thing, you are most likely not using one of the safe charsets. If this happens for you, you may have to turn the feature off as it will not work with your charset.

This setting affects how & in titles are displayed in a URL that has been re-written by the SEO addon to be search engine friendly.

The SEO addon can include titles in the URL, for example the category name if viewing a category, or the listing title if viewing a certain listing. When it does this however, it must "clean up" the title so that it is suitable for using in an URL. It needs to replace spaces, and any characters that are not alpha-numeric.

When the character & is found in a title, it will be converted to whatever you set this setting to. The default is to convert it to -and-.

Here's an example of how the setting would affect the URL:

Replace & with: -ampersand-
Category Name: DVDs & Movies
Name in URL: DVDs-ampersand-Movies

These are advanced settings.

If checked, this will OMIT the following line when generating the contents of the .htaccess file for you to copy/paste:

Options +FollowSymlinks

Some servers produce a 500 internal server error, when using the line noted above. Other servers will not work without the line noted above. If SEO re-written URLs are not working, or if you are getting a 500 server error on re-written URLs, check or un-check the setting. Then Apply All and re-copy the contents for the .htaccess file.

Changing this setting affects the generated .htaccess file.

Turn this on if you previously used the SEO 1.0 version for any length of time, and search engines have the URLs used by that version still indexed.

This will add additional lines to the generated .htaccess file contents necessary so that "old" links will re-direct (301) to the new URLs.

Once search engines have had time to update their indexes to the new URLs for your site (usually after a few months), you can turn this back off and re-generate the .htaccess file contents. If you suspect that there are still other sites that link to yours that still use the old-style URL's, you will want to keep this turned on.

Changing this setting requires re-generating the .htaccess file.

Simply put, turning this on will force a 301 permanent redirect from an incorrect URL to the correct URL.

Changing this setting does not require re-generating the .htaccess file.

<tip c w> Warning: Turning this on can cause problems on some servers, or if certain settings are not set correctly in your admin. See Server Compatibility Warning below for more info. </tip>

To clarify what we mean by redirecting from an incorrect URL to a correct URL, see the following examples of some URL's that would result in a 301 redirect to the new or correct re-written URL.

All the following URL examples use a URL for a listing with the following criteria:

listing ID: 1234
Listing Title: Batman Begins
Listing Category ID: 111
Listing Category Title: DVDs & Movies
Correct URL: /category/111/DVDs-and-Movies/listings/1234/Batman-Begins.html

Note: The domain name is left off of every URL in this example to make things easier.

If any of the URL's were visited, and you have the Force SEO URLs setting turned on, it will automatically do a 301 redirect to the correct URL, which for the example above would be /category/111/DVDs-and-Movies/listings/1234/Batman-Begins.html.

Use this to help prevent duplicate pages with the same content, which can have a negative effect on search engine rankings. We recommend turning this feature on, as long as your site does not have any problems when it is turned on.

The Force SEO URLs feature relies on 3 things to work:

• Site URL set in your admin, for NON-SSL pages.
• Secure SSL Site URL set in your admin, for SSL pages.
• _SERVER[REQUEST_URI] as reported by the server. If you have the above 2 admin settings set correctly and still have problems with turning on Force SEO URLs, most likely your server is not reporting REQUEST_URI the standard way (or possibly not at all).

Since it relies on the above 3 things to detect whether the current URL is correct or not, if any of them are not working properly, it can break the site to turn on Force SEO URLs. If you turn the feature on, make sure that it does not cause endless redirects or cause it to redirect to the wrong URL, when you visit a re-written URL. It is rare, but if you do experience any problems, turn the feature back off immediately if your site is live, until you are able to determine cause.

Technical details:

• If the Site URL or Secure SSL Site URL is set incorrectly, it can re-direct to the wrong place or cause endless redirects, or any number of different problems depending on what you have those settings set to, so be sure they are set correctly according to the linked help page.
• If your server improperly reports the REQUEST_URI of the page, it can cause "endless redirects".
• If your server does not report the REQUEST_URI at all, the force SEO URL feature will simply have no effect when turned on.

This support wiki article has been moved here