User Tools

Site Tools


Sidebar

admin_menu:addons:geographic_navigation:sub_domains:start

This is an old revision of the document!


Sub Domains

This page controls whether sub-domains are used by the Geographic Navigation Addon.

Instructions for Using Sub Domains

You will need to set up a wild-card sub domain in your DNS configuration. How this is accomplished, will be different for every DNS or hosting company out there. The general principle is to set up the sub-domain "*" (without the quotes) to point to the same IP as your main domain does.

  • DO Technically speaking, configure an A Name Record for a wildcard sub-domain1), which goes to the exact same IP as your main A-Name record does. A CNAME record will work just as well, as long as it goes to your main domain name.
  • DO Once you have configured your wildcard sub-domain, wait until the changes take effect before attempting to use sub-domains in the software. Due to how it works, DNS changes can sometimes take up to a day to propagate.
  • Do NOT Make the sub-domain use a different document root (a different folder). For example, if you go to example.com it should use the same folder and files as any sub-domain like test.example.com.
  • Do NOT Create what is sometimes called "Masked Domain" or "Domain Re-direct".

<tip c n>Note: Using Sub-Domains requires that you configure your DNS properly using the instructions on this page. If you are not sure how to do this, you will need to contact the DNS that manages your domain name, in most cases this will be your hosting company. Setting up your DNS is not included in the installation service we provide, and sub-domain problems are beyond the scope of support we offer. We can usually tell you what is wrong and what needs to be changed, but support cannot do the configurations for you.</tip>

Sub Domain Usage

Whether to use sub-domains or not for the geographic location URL's. Not Used: Do not use sub-domains at all. You will not be able to add or edit sub-domains for any of the geographic locations, and it will use cookies to determine what geographic location to display based on what location the user has navigated to.

Configure, but Not Enabled: Will allow you to edit sub-domain for each geographic location. It will still not be enabled however, so it will still use cookies to determine what geographic location to display based on what location the user has navigated to.

Enabled: Use of sub-domain for locations is turned on. Any location that has a sub-domain configured for it, will use that sub-domain to browse listings for that location. If a geographic location does not have a subdomain configured, it will use cookies to determine what geographic location to display based on what location the user has navigated to.

List of Current Sub Domains

This section will list all sub-domains that are currently configured for each of the geographic navigation locations. This is a useful resource if you have no other option than to manually enter all sub-domains into the DNS configuration, if a wildcard sub-domain is not possible for whatever reason.

1)
For example, if your main domain name was example.com, the wildcard sub-domain would be *.example.com
admin_menu/addons/geographic_navigation/sub_domains/start.1283284524.txt.gz · Last modified: 2014/09/25 16:55 (external edit)