User Tools

Site Tools


Sidebar

addons:geographic_navigation:start

This is an old revision of the document!


Geographic Navigation

The Geographic Navigation Addon is an addon that allows the listings on the site to be "filtered" using the Country and State/Province, along with unlimited levels of sub-regions.

To use this addon, you would place the addon's tag somewhere in the template for the page you want to display the geographic navigation on. Then it will show the geographic navigation, where the user would first select the top level region1), then optionally the sub region, then sub-sub-region, etc. to filter by. The user does not have to filter by sub region, if they only select the top level region it will only display listings from that main region.

If the site only has 1 main region configured, that region will automatically be selected and it will start out displaying the sub-regions of that main region.

See the screenshots on the settings page for examples of what the "Geographic Navigation" looks like, and further details on the optional mixing of unlimited sub-region levels with built in countries and state/provinces.

Updates Planned

Currently the geographic navigation module only works with the 2 levels of regions built into the software already, the Main Region2) and the Sub Region3). We are currently making plans to add additional levels of sub-regions "below" the sub-region level built into the software, as part of this geographic navigation addon. This would allow a site owner to configure additional sub-levels of regions, for example to narrow it down further by "county", "city", "neighborhood", or however the site owner wishes to configure the additional sub-levels.

The official release date for these planned improvements are not known since the improvements are currently still in planning stages.

1)
optionally can be one of the built in countries
2)
AKA Country
3)
AKA State/Province
addons/geographic_navigation/start.1249579760.txt.gz · Last modified: 2014/09/25 16:55 (external edit)