Location Explorer Setup

1. Settings
2. Categories
   1. Edit Categories
   2. Edit Category Detail
3. Locations
   1. Edit Locations
   2. Edit Location Detail
   3. Ambiguous Locations
   4. Edit Location Categories & Tags
4. Usage Practices

Settings

The Explorer-specific settings will need to be configured prior to using the module.

• Mapping Service - The mapping service you wish to use (Google or Yahoo!)
• Mapping API Key - The application key provided by the service, which allows your website to access those services
• Map Height and Map Width - The pixel height and width of the map, when the user views the details of a location
• Map Position - The position of the map in relation to the location description: above, below, or beside text
• Zoom Level - The default zoom level of the map image: street, city, region, or country
• Enable Categories - When selected, you can categorize your locations in any way that makes sense to your organization
• Show Category Summary - If you have entered a category description, it can now be displayed
• Enable Paging and Page Size - When selected, the locations will be paged for more readable results
• Enable Directions - Allows the user to get directions to the specified location
• Enable Directions Email - If directions are enabled, selecting this option will allow the user to email the directions
• Enable Telephone - If selected, you will be able to edit the telephone number, and the user will be able to view it
• Enable Website - If selected, you will be able to edit the website, and the user will be able to view it
• Enable Email - If selected, you will be able to edit the email address, and the user will be able to view it
• Enable Location Number - If selected, you will be able to edit a location number (custom "number" for your location), and the user will be able to view it
• Enable Batch Geocode - If the DotNetNuke Scheduler includes the Zero-In batch geocode process, selecting this option will allow the locations to be automatically geocoded
• Export Option, Export Type, and Export Delimiter - The export option determines which users can export locations. The export type indicates the output type: Excel (*.xls) or comma-separated values (*.csv). If CSV is selected, the export delimiter is used
• HTML Overlay Template - This allows you to customize the HTML information balloon that is displayed on the map.
• Enable Tags - If selected, you can add custom tags, which allow you to provide an alternate categorization or grouping, and your site visitors to search by those tags.
• Enable Ratings - If selected, you can add ratings to your locations, which will be visible to your site visitors.
• Enable User Ratings - If selected, and Enable Ratings is selected, registered users will be able to add their own ratings. The rating displayed per location will be the average user rating.
• Enable User Locations - If selected, users with Edit permission on the Zero-In module instance will be able to create and edit their own locations. Edit Categories will only be available to Administrators (normally, this is available to all Edit users).
• Enable Single Map - If selected, all locations displayed on a page will have points plotted on a single map above the listed locations. If paging is enabled, only the locations currently displayed will be plotted.
• Single Map Width and Single Map Height - If Enable Single Map is selected, the pixel width and height of the single map
• Single Map Zoom - The default zoom level of the single map. This can be overridden per category, in the Edit Category page.

Categories

When categories are enabled, the Edit Categories option will be made available in the module menu.

Edit Categories

• Cancel / Back - The button with the upper-left-pointing arrow navigates back to the Explorer default display
• Edit Locations - This button navigates to the Edit Locations page
• Move - The up and down arrows allow you to change the sort order of the categories. Categories will be displayed in that order. The Sort Alphabetically button sorts all categories, respective to their parent categories.
• Actions - These options allow you to Edit or Delete the selected category, or Add a new category
• The asterick (*) denotes categories that have not been published

Edit Category Detail

• Category ID - This is the database key of the current category
• Category Name - The name by which the category will be referred
• Published - Select whether the category will be displayed
• Summary - A summary or description of the category
• Center Location - If Enable Single Map is selected in the Explorer Settings, you can select the location at which the map will be centered. This can be a published or unpublished location, as long as it has latitude and longitude coordinates.
• Zoom Level - If Enable Single Map is selected in the Explorer Settings, you can select the zoom level at which the map will be displayed.

Locations

Locations are the core of the Zero-In module. While the Location Explorer can act as a stand-alone directory, the Location Finder requires each location to be geocoded (have a latitude and longitude) in order calculate distances.

Edit Locations

• Cancel / Back - This button with the upper-left-pointing arrow navigates back to the Explorer default display
• Edit Categories - This button navigates to the Edit Categories page. When Enable User Locations is enabled in the Explorer Settings, this will only be displayed to Administrators.
• Move - The up and down arrows allow you to change the sort order of the categories. Categories will be displayed in that order. The Sort Alphabetically button sorts all locations alphabetically by name
• Actions - These options allow you to Edit or Delete the selected category, or Add a new category
• The asterick (*) denotes categories that have not been published

Edit Location Detail

• Location ID - This is the database key of the location
• Name - Public name by which location will be referred
• Location Number - Optional field. A number used to identify the location
• Address - Street address
• City - City name
• Country - When country is selected, a list of states or provinces will be displayed, or a textbox for regions
• Region - This is the state, province, or region
• Postal Code - This is the postal code or zip code
• Validate Address - This option runs the address through the mapping service, and returns a geocode point
• Latitude and Longitude - These are the horizontal and vertical coordinates returned from the mapping service, but which can also be manually entered
• Telephone - Optional field. Location telephone number
• Website - Optional field. Location website URL
• Email - Optional field. Location email address
• Published - Select whether the location will be displayed
• Rating - If ratings are enabled, the pre-assigned location rating
• Summary - This is the summary or description of the location. This is rich text, which can be specially formatted
• Search Keywords - A list of keywords that can be included in the DNN search.

Ambiguous Locations

If an address cannot be accurately determined, the mapping service will sometimes return potential candidates, which you can then select.

Edit Location Categories & Tags

After a location has been saved, categories and tags (if enabled) can then be added to or removed from the location.

Usage Practices

Zero-In is meant to provide two solutions every retailer or organization needs. Location Explorer provides the location directory, listing all locations to the potential customer. It also acts as the data source for the Location Finder, which provides store location services to your potential customers. The Explorer does not have to be made public to your users; however, it is required for the Finder to function.