Location Explorer Setup

1. Settings
   1. Explorer Settings
   2. Detail Settings
   3. Category Settings
   4. Location Settings
   5. Moderation Settings
   6. Single Map Settings
   7. Landing Page 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.

Explorer Settings

• 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
• Enable Paging and Page Size - When selected, the locations will be paged for more readable results
• 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. This template makes use of replacement tokens, which are as follows:
  • [LOCATION_NAME] - The location name
  • [LOCATION_NUMBER] - The location number, if enabled
  • [LOCATION_ADDRESS] - The location street address
  • [LOCATION_CITY] - The location city
  • [LOCATION_REGION] - The location state or region
  • [LOCATION_POSTALCODE] - The location zip or postal code
  • [LOCATION_COUNTRY] - The location country
  • [LOCATION_TELEPHONE] - The location telephone number, if enabled
  • [LOCATION_EMAIL] - The location email address, if enabled
  • [LOCATION_WEBSITE] - The location website URL, if enabled
  • [LOCATION_EDIT_TEXT] - The "Edit" label
  • [LOCATION_EDIT_URL] - The URL of the location edit page
  • [LOCATION_VIEW_TEXT] - The "View" label
  • [LOCATION_VIEW_URL] - The URL of the location landing page
  To provide a clickable hyperlink to the location landing page, you could enter <a href="[LOCATION_VIEW_URL]">[LOCATION_VIEW_TEXT]</a>.

Detail Settings

• 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
• Map Type - The default map type: normal (illustrated), satellite, hybrid (satellite with illustration), or terrain
• Zoom Level - The default zoom level of the map image: street, city, region, or country
• Enable Directions - Allows the user to get directions to the specified location
• Directions Display - If directions are enabled, select how directions will be displayed (same window or pop-up window)
• Enable Directions Email - If directions are enabled, selecting this option will allow the user to email the directions
• Enable CAPTCHA - If directions are enabled, and emailing the directions is enabled, selecting this option will require CAPTCHA, which prevents automated submissions

Category Settings

• 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
• Category Name (Singular) and Category Name (Plural) - Singular and plural labels for categories. If left blank, "category" and "categories" will be used, respectively
• Enable Alt. Categories - When selected, you can create and apply alternate categories to your locations. This is used in the Location Finder search

Location Settings

• 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 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 Anonymous Ratings - If selected, and Enable Ratings is selected, unregistered (anonymous) users will be able to add their own ratings.
• Enable Image - Select to allow an image to be uploaded for each location, which will be displayed in the Explorer
• Save Image As Blob - If Enable Image is selected, select whether to save the image in the database as a blog, or on the website file system
• Enable Custom Fields - Select to enable custom fields for locations. If selected, the Manage Custom Fields option will be displayed in the Explorer module menu.
• Enable Auto-Verification - Select to enable auto-verification (calculate latitude and longitude) when user saves the location
• Read-Only Latitude/Longitude - Select to prevent the user from entering or modifying the latitude and longitude, when editing a location

Moderation Settings

• 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 Moderation - If selected, and Enable User Locations is selected, Edit user locations will be moderated by the administrator.
• Enable Moderation Notification - If selected, and Enable User Locations and Enable Moderation are selected, an email will be sent when a location is added, updated, or deleted.
• Notification From Address - If Enable Moderation Notification is selected, the "from" email address of the notification.
• Notification To Address - If Enable Moderation Notification is selected, the "to" email address of the notification.
• Notification Subject - If Enable Moderation Notification is selected, the email subject of the notification.

Single Map Settings

• 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 Type - The default map type of the single map: normal (illustrated), satellite, hybrid (satellite with illustration), or terrain
• Single Map Zoom - The default zoom level of the single map. This can be overridden per category, in the Edit Category page.
• Single Map Marker Label - Select a customized marker (map point) icon label, instead of a marker with no caption or label
• Single Map Marker Label Color - The customized marker label text color
• Single Map Label Type - Select a marker label type: Pin or Flat
• Single Map Latitude and Single Map Longitude - If Enable Single Map is selected, the coordinates on which the map will be displayed by default. This can be overridden by category-level coordinates.
• Hide Location Details - If selected, only the single map will be displayed, and the list of locations will not be display

Landing Page Settings

• Map Height and Map Width - The pixel height and width of the map, when the user views the location landing page
• Map Type - The default map type of the landing page map: normal (illustrated), satellite, hybrid (satellite with illustration), or terrain
• Zoom Level - The default zoom level of the landing page map image: street, city, region, or country
• Enable Directions - Allows the user to get directions to the specified location
• Directions Display - If directions are enabled, select how directions will be displayed (same window or pop-up window)
• Enable Directions Email - If directions are enabled, selecting this option will allow the user to email the directions

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
• Parent Category - This is current category's optional parent
• Category Name - The name by which the category will be referred
• Published - Select whether the category will be displayed
• Is Alt. Category - Select whether the category is an alternate category
• Is Default - Select whether the category is the default category, which will be rendered by the Explorer
• 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
• Additional Fields - Optional custom fields, if enabled
• 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.

This has been updated for version 1.7