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>

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.

These settings change how the geographic navigation will be displayed.

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.

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.

Similar to how category navigation can display sub-categories, you can elect to show one sub-region level below the current geographic navigation regions.

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".

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.

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, 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 enabled, on the listing details page, it will add the listing's geographic location to the title module output.

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.

These settings are synonymous with the main Fields to Use settings, as it pertains to information collected during user registration.

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.

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.

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.

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 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.

{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='listing_regions'} is a tag that is used in the listing details template to show the region of that particular listing.