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.

<tip c n>Note: This addon does not affect the category counts within any category navigation of the software. The category counts will remain the same before and after selections made in this tool.</tip>

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

This affects how the current region or sub region that is selected is displayed.

This is the default setting. Displays similar to "Category Tree" if category tree view is turned on when browsing categories.

No regions or sub regions selected:

Region (United States) selected:

Sub-Region (California) selected:

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:

Region (United States) selected:

Sub-Region (California) selected:

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 is the equivalent of the Listing Setup > Fields to Use for the Geographic Navigation addon, in order to allow more control these settings are Plan Item Based meaning they are set on a per price plan basis, in the Plan Item section.

Because of how Plan Item Settings work, within fee-based price plans you have the ability to set category based pricing, and thus, are able to set the settings noted below on a per category basis within fee-based price plans.

<tip c n>Note: If a Location is not set for a listing, either because the user did not fill it out, or the "use" setting is not checked in the settings described below: when a user has selected a geographic location in the geographic navigation, any listings with no location data will automatically be filtered out. There is not currently a way to make a particular listing display no matter what geographic location is selected.</tip>

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 Pricing > Price Plans Home > Edit > Cost Specifics/Category Specific Costs > Configure for Geographic Navigation Location, as illustrated in the screen shot below.

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.

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). By default, upon installation "use" is checked for all price plans.

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.

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.

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 countries and has a couple of selectable options within the addon management tool for this addon.

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