Differences

This shows you the differences between two versions of the page.

--- admin_menu:addons:geographic_navigation:sub_domains:start [2010/08/31 20:14]
jonyo
+++ admin_menu:addons:geographic_navigation:sub_domains:start [2014/09/25 16:55] (current)
@@ Line 3: / Line 3: @@
 This page controls whether sub-domains are used by the Geographic Navigation Addon.
+===== Settings =====
+You will find the following settings and buttons on this page in the admin panel.
+==== 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**
+This option 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**
+This option specifies that use of sub-domain for locations is turned on, and any configured sub-domains will be used for links in Geographic Navigation.  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.
+==== Force full sub-domain for listings? ====
+Setting **added in version 7.4.0**((See bug 1014)), previous versions will not have this option.
+This check-box will become available when [[#Sub Domain Usage]] is set to **enabled**.
+If this option is checked, when a visitor goes to a specific listing, it will make sure the sub-domain matches the region for that listing, using a 301 redirect.  This can help with SEO as it removes any duplicate content that may happen otherwise.
+In addition, if the SEO addon is enabled, the SEO addon will include the full subdomain in all re-written links for individual listings.  This applies to everywhere that the SEO addon would normally re-write the URL, including the RSS feed.
+<tip c w>**Warning:**  Turning this on will make the visitor automatically select a listing's full region when they view a listing.  This may not be expected by the visitor, if for instance, they are browsing listings at the top level, click on a listing.  After that point, any pages they go to will be filtered by the region set for the listing.
+Because of this behavior, we only recommend turning this option on for sites that are primarily "region based" where your visitors will typically want to only view listings "close to them".</tip>
+==== Sub Domain Settings ====
+If the [[#Sub Domain Usage]] setting is set to anything besides **Not Used**, you will be able to configure what sub-domain is used for each geographic navigation region, on the admin page [[admin_menu/geographic_setup/regions/start|Geographic Setup > Regions]], by editing the **unique name** for each region.  When viewing regions on that page, just click **Edit** for any of the regions to edit the unique name (used for the subdomain).
+==== Auto-Set Subdomains ====
+Clicking on this button will automatically set the "unique name" which is used for the sub-domain, for every geographic region in every level.  It will also make use of sub-sub domains for deeper regions, for example the sub-domain for United States would be **united-states.**example.com, for Alabama, US it would be **alabama.united-states.**example.com.
+If multiple locations would have the same generated subdomain, it would only automatically set the subdomain for the first duplicate, not the rest, since for the system to work the sub-domain for each location must be unique.  This is not common since it uses sub-sub domains as mentioned above to ensure less chances of having duplicates.
+==== Clear All Subdomains ====
+This button will clear all unique names (subdomains) for all regions in the system.  This is handy if you want to start over and want a way to keep track of which ones you have already changed and which ones you have not.
 ===== 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 **<nowiki>*</nowiki>** to point to the same IP as your main domain does.
+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 **<nowiki>*</nowiki>** to point to the same IP and same "document root" as your main domain does.
 While you are waiting for the changes to propagate, you can set the **Sub Domain Usage** setting to **Configure, but Not Enabled**, and start configuring the sub-domains for your geographic locations.  Just be sure not to enable sub-domains until the wildcard DNS entry has propagated, which you can tell by attempting to visit a sub-domain on your site.
@@ Line 20: / Line 67: @@
   * Do **NOT** manually configure every single sub-domain for all of the different locations.  While this will technically work if you do it correctly, why would you want to configure 50 sub-domains, 100 sub-domains, or even more, when you could just set up a single wild-card subdomain that does it for you?  See the info above for instructions on how to do this, or contact your DNS to have them set it up for you.
+===== Pages in SSL Mode =====
-==== Sub Domain Usage ====
+When using sub-domains, the sub-domain is removed when switching over to a page that uses SSL mode((using http**s**:<nowiki>//</nowiki> at beginning of URL)), for example during the listing placement process.  This is because typically **SSL certificates will only work on the main domain name**, not sub-domains.  After the user returns to normal mode, the user can re-select the geographic navigation location to continue filtering by that location.
-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.
+If NOT using sub-domains, it uses a cookie to remember what location is currently selected, so switching to SSL mode is not a problem.

Geodesic Solutions Community Wiki

User Tools

Site Tools

Differences

Page Tools