Differences

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

--- admin_menu:addons:geographic_navigation:settings:start [2012/01/06 17:22]
james [Template Tags]
+++ admin_menu:addons:geographic_navigation:settings:start [2014/09/25 16:55] (current)
@@ Line 4: / Line 4: @@
 This page holds the main settings for the Geographic Navigation Addon.
-<tip c w>**Note:** Countries and State/Provinces are **part of the main software**, and are used by payment gateways to process payments, and are also used to calculate taxes. The unlimited levels of regions and sub-regions added by this addon, however, are not restricted by having to conform to country or state/province level.</tip>
+<tip c w>**Note:** Geographic regions are **part of the main software**, and are used by payment gateways to process payments, and are also used to calculate taxes. This addon provides various ways to display and filter by the regions that otherwise already exist.</tip>
-In order to use the Geographic Navigation Addon, you must insert the addon tag into your template where you want the filter selection to be displayed.
+In order to use the Geographic Navigation Addon, you must insert the appropriate addon tag into your template where you want the filter selection to be displayed (the "navigation" addon tag is included in the front page template by default).
 ===== Navigation Settings =====
 These settings change how the geographic navigation will be displayed.
-==== Number of Columns ====
-This is the number of columns that will be used when displaying all the region or sub region choices.  The default value is 2 columns.
-==== Show Listing Counts ====
-The number of classifieds or auctions found in a region can be displayed beside the region when browsing geographic navigation regions, according to the setting set here.
-==== Show Sub-Regions ====
-Similar to how category navigation can display sub-categories, you can elect to show one sub-region level below the current geographic navigation regions.
-==== How to Order ====
-This setting refers to the display order of the regions, whether to order "down the column" (the default and recommended setting), or "across the column".
-==== Region Tree Display ====
-This setting dictates how (if at all) the currently selected region is displayed above the Geographic Navigation.  None obviously hides the currently selected region, compact makes it only show the furthest selected region and a link to clear the selection, and full breadcrumb shows the full breadcrumb.
 ==== Combine with Category Breadcrumb ====
-If this option is turned on, where it displays the category breadcrumb, it will prepend the breadcrumb with the currently selected Geographic Navigation location.  You may wish to enable this option and turn [[#Region Tree Display]] to **none**.
+If this option is turned on, where it displays the category breadcrumb, it will prepend the breadcrumb with the currently selected Geographic Navigation location.
 ==== Show in Module Search Box 1 ====
-If this option is turned on, it will display category navigation drop-down in the search box 1 module, exactly like it displays on the advanced search form.  The drop-downs will have the currently selected navigation location pre-selected, something that is not always done in other areas.
+If this option is turned on, it will display category navigation dropdowns in the search box 1 module.  The dropdowns will have the currently selected navigation location pre-selected, something that is not always done in other areas.
 ==== Show listing's region in Title Module ====
@@ Line 42: / Line 28: @@
 If this option is enabled, and the user is currently viewing listings for a specific geographic navigation location, it will display the current selection in the title module similar to how the category being browsed is displayed in the title module.
-===== Geographic Location in Registration Data =====
+==== Allow Legacy (Geographic Navigation 4.x) URLs ====
-These settings are synonymous with the main [[admin_menu/listing_setup/fields_to_use/start]] settings, as it pertains to information collected during user registration.
-==== Use ====
+If enabled, non-SEO-rewritten URLs in the old (pre-GeoCore) style will be 301 redirected to their corresponding locations in the new region system. This is primarily useful for sites with links to old region pages indexed on search engines who want to preserve those indexes to the new URLs. For sites that did not upgrade from pre-GeoCore, this setting has no useful effect.
-If this is checked, during user registration or when displaying/editing user details, it will use Geographic Navigation tied to the user.  If used, and the user selects the region they are in, when that user places a listing the Geographic Navigation drop-downs will be pre-populated, and will be able to change on a per listing basis to be different than info tied to User info.
-====Require ====
+==== Number of Columns ====
-If [[#Use]] is un-checked, **this setting does not apply**.  If checked, when the user registers or edits user data, they are required to select at least the top level region.
+This is the number of columns that will be used when displaying all the region or sub region choices.  The default value is 2 columns.
+==== Show Listing Counts ====
+The number of classifieds or auctions found in a region can be displayed beside the region when browsing geographic navigation regions, according to the setting set here.
+**use_cat_counts=1**
+**Parameter added in version 6.0.7**
+This is a parameter that can be added to the navigation tag in your templates.  When the //Show Listing Counts// is set to display listing counts, and this is added to the navigation tag, when the user is browsing a specific category the counts will reflect only listings in that category.
+Example tag with parameter added:
+<code html>{addon author='geo_addons' addon='geographic_navigation' tag='navigation' use_cat_counts=1}</code>
+Without this parameter added, the listing counts will be for listings in the specific region in all categories.
+==== Show Sub-Regions ====
+Similar to how category navigation can display sub-categories, you can elect to show one sub-region level below the current geographic navigation regions.
+==== Automatically assign visitors' regions based on their IPs ====
+This will read a new visitor's IP address and then attempt to automatically assign him to the correct country based on his physical location.
+Using this feature requires that you register for a free API key with ipinfodb.com.
-==== Require Full Location Depth ====
-If [[#Use]] is un-checked, **this setting does not apply**.  If checked, the user can't stop on a region if that region has any sub-regions under it.  They must keep selecting sub-region levels until they get to a region that has no sub-regions attached to it.  Note that if [[#Require]] is un-checked, and this setting is checked, the user would be allowed to not select any location at all, but if they did select a location the above mentioned restrictions would be in effect.
 ===== Template Tags =====
 This section lists the different template tags that must be placed in certain templates, in order to display certain things pertaining to the Geographic Navigation addon.
-It will list 3 different tags within your Geographic Navigation addon admin tool.  These tags are used within your design to place that specific functionality at that spot in the design.  You can use the "insert tag" feature of the source code editor within the [[admin_menu/design/manager/edit/start|Design > Manager]] admin tool to place the proper tag where you have selected within the source code editor.
+It will list 7 different tags within your Geographic Navigation addon admin tool.  These tags are used within your design to place that specific functionality at that spot in the design.  You can use the "insert tag" feature of the source code editor within the [[admin_menu/design/manager/edit/start|Design > Manager]] admin tool to place the proper tag where you have selected within the source code editor.
 **{addon author='geo_addons' addon='geographic_navigation' tag='navigation'}** is the tag that shows all the regions in a selectable menu currently like on the front page of our default design on our site.
@@ Line 63: / Line 67: @@
 **{addon author='geo_addons' addon='geographic_navigation' tag='navigation_top'}** is duplicate of the navigation tag above but always starts out at the top level region.
-**{addon author='geo_addons' addon='geographic_navigation' tag='breadcrumb'}** is the tag that can be used to show the trail of currently selected geographic location.
+**{addon author='geo_addons' addon='geographic_navigation' tag='change_region_link'}** is a tag that is used to display the "change location" link.
 **{addon author='geo_addons' addon='geographic_navigation' tag='listing_regions'}** is a tag that is used in the listing details template to show the region of that particular listing.
-**{addon author='geo_addons' addon='geographic_navigation' tag='insert_head'}** is a tag that is used in the html head of any page that will use the geographic navigation feature.  This tags places the necessary Navigation Javascript needed for any of the "change location" functionality of this addon.  Once added to the html head this allows the developer to assign "geographic_navigation_changeLink" to any element turning that into a "change location link".
+**{addon author='geo_addons' addon='geographic_navigation' tag='breadcrumb'}** is the tag that can be used to show the trail of currently selected geographic location.
-**{addon author='geo_addons' addon='geographic_navigation' tag='change_region_link'}** is a tag that is used to display the "change location" link.
 **{addon author='geo_addons' addon='geographic_navigation' tag='current_region'}** is a tag that is used to display the current region selected.
+**{addon author='geo_addons' addon='geographic_navigation' tag='insert_head'}** Use this tag, then use the CSS class **geographic_navigation_changeLink** on any HTML element, to turn it into a "Change Region" link!  This is useful on sites that want to have a "change region" link like generated by the "change_region_link" tag but wish to make custom styling for it.

Geodesic Solutions Community Wiki

User Tools

Site Tools

Differences

Page Tools