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 Main Region 1) and Sub Region 2).

<tip c n>Note: Regions and Sub Regions are part of the main software. This addon merely filters what listings are displayed, according to those regions and sub regions that are built into the software.</tip>

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 main region, then optionally the sub region to filter by. The user does not have to filter by sub region, if they only select the main 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.

See the screenshots on the settings page for examples of what the "Geographic Navigation" looks like.

Updates Planned

Currently the geographic navigation module only works with the 2 levels of regions built into the software already, the Main Region3) and the Sub Region4). 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) , 3)
AKA Country
2) , 4)
AKA State/Province
addons/geographic_navigation/start.1241467461.txt.gz · Last modified: 2014/09/25 16:55 (external edit)