Differences

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

--- admin_menu:addons:geographic_navigation:settings:start [2009/09/24 15:12]
james
+++ 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).
-===== Display Settings =====
+===== 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 1 column.
-==== Display full tree ====
+==== Combine with Category Breadcrumb ====
-This affects how the current region or sub region that is selected is displayed.
-=== Display full tree: Checked ===
+If this option is turned on, where it displays the category breadcrumb, it will prepend the breadcrumb with the currently selected Geographic Navigation location.
-This is the default setting.  Displays similar to "Category Tree" if category tree view is turned on when browsing categories.
+==== Show in Module Search Box 1 ====
-**No regions or sub regions selected:**
+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.
-{{:admin_menu:addons:geographic_navigation:settings:regions_tree_all.png|}}
+==== Show listing's region in Title Module ====
-**Region (United States) selected:**
+If this option is enabled, on the listing details page, it will add the listing's geographic location to the title module output.
-{{:admin_menu:addons:geographic_navigation:settings:regions_tree_region.png|}}
+==== Show current selected region in Title Module ====
-**Sub-Region (California) selected:**
+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.
-{{:admin_menu:addons:geographic_navigation:settings:regions_tree_sub.png|}}
+==== Allow Legacy (Geographic Navigation 4.x) URLs ====
-=== Display full tree: Un-Checked ===
+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.
-With the setting un-checked, the first line only shows the current region or sub-region.  This is ideal if you need a more "compact" look to match your design needs.
-**No regions or sub regions selected:**
+==== 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.
-{{:admin_menu:addons:geographic_navigation:settings:regions_tree_off_all.png|}}
+==== 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.
-**Region (United States) selected:**
+**use_cat_counts=1**
-{{:admin_menu:addons:geographic_navigation:settings:regions_tree_off_region.png|}}
+**Parameter added in version 6.0.7**
-**Sub-Region (California) selected:**
+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.
-{{:admin_menu:addons:geographic_navigation:settings:regions_tree_off_sub.png|}}
+Example tag with parameter added:
+<code html>{addon author='geo_addons' addon='geographic_navigation' tag='navigation' use_cat_counts=1}</code>
-==== Location in Registration Data ====
+Without this parameter added, the listing counts will be for listings in the specific region in all categories.
-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.
+==== 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.
-=== Use ===
-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 ===
+==== Automatically assign visitors' regions based on their IPs ====
-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 will read a new visitor's IP address and then attempt to automatically assign him to the correct country based on his physical location.
-=== Require Full Location Depth ===
+Using this feature requires that you register for a free API key with ipinfodb.com.
-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.
-==== Price Plan Based Use Configuration ====
-Within fee-based price plans you have the ability to set category based pricing.  You also have the ability to have this addons geographical filtering affect or not affect within a specific category.
-The settings specific to listing detail collection are set per price plan, and per category if you elect to use category specific cost for a particular price plan.  In this section will be "shortcut" links to go directly to the configuration settings for each price plan that is configured in the system, one link for each price plan.  Each "shortcut link" takes you to [[admin_menu/pricing/price_plans_home/plan_items/start|Pricing > Price Plans Home > Edit > Cost Specifics/Category Specific Costs > Configure for Geographic Navigation Location]], as illustrated in the screen shot below.
-=== Geographic Navigation Location - Plan Item Settings ===
-{{ :admin_menu:addons:geographic_navigation:settings:plan-item-geographic.png |}}
-When you click on one of the //shortcut links// in the [[#Location in Listing Fields to Use]] section, it will take you to a page with something similar to the screen shot above.
-**Use**
-If this is checked, during listing placement or listing edit, it will display drop downs for the user to select the geographic location, using regions from the Geographic Navigation Addon.  It can also display geographic location information on the listing details page, if the correct tag is added to the listing details template(s).
-**Require**
-If **Use** is un-checked, **this setting does not apply**.  If checked, when placing or editing a listing, the user is required to select at least the top level region.
-**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.
 ===== 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 2 different types of tags, the **DB Based (normal) Template Tags** which is what most people need to use: these are the tags that are used in templates administered through the admin at [[admin_menu/templates/templates_home/start|Templates > Templates Home]].  Then there is the **File-Based (Smarty) Tags** which are used on sites that have elected to use file-based overall design, so that you edit templates in the file system instead of through the admin panel.
+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.
-No matter which type of templates you use, there are 2 main template tags, noted below:
+**{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.
-==== Geographic Navigation Tag ====
+**{addon author='geo_addons' addon='geographic_navigation' tag='change_region_link'}** is a tag that is used to display the "change location" link.
-This tag displays the geographic navigation that the user would use to narrow the listings displayed by a particular region.  We recommend placing this tag on the front page template, and any basic page templates which you want to display the geographic navigation on.  One possible spot is right under the main category navigation module tag, you might just find everywhere that module tag is used in the templates, and place this one right below it in every template.
+**{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.
-==== Listing's Geographic Location Tag ====
+**{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.
-This tag displays the geographic location specific to a listing.  It should be placed in the listing details template(s) if you wish to display that info to the user.  A good spot might be right below where the listing title is displayed.
+**{addon author='geo_addons' addon='geographic_navigation' tag='current_region'}** is a tag that is used to display the current region selected.
-==== File-Based (Smarty) Template Tags ====
+**{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.
-If you have elected to use File Based (Smarty) Design, be sure to use the template tags for those type of templates.
-<tip c n>**Note:** When using File-based design, the attachments are not done automatically for you like with DB-Based design.  If you add this to a template file, you will also need to add the "addon attachment" by editing the appropriate "module to template" attachment file in your template set.  Doing this is not supported, but we can still try to help you with it if you are having trouble getting it to work.</tip>

Geodesic Solutions Community Wiki

User Tools

Site Tools

Differences

Page Tools