How do I allow users to search directory listings by location?

Directory search by location allows users to filter directory listings by city, state and country. See a live example on the ePublishing demo site here .

By default, directory search by location is hidden on directory search forms.  When enabled the directory search form will display city, stage and country fields. To display search by location on a directory search form enter the directory ID(s) in the "Value" field of system setting directories.display.location.search.

  1. Go to Sys Admin > System Settings
  2. Click Create & Edit
  3. Find the system setting named directories.display.location.search
  4. Click the "Edit" link next to the directories.display.location.search
  5. A form will drop down that includes the system setting name and value
  6. Insert the ID of the directory or directories you would like to display location by search on in the "Value" field. To display search by location on multiple directories enter the directory IDs separated by a comma (see screenshot below). Please be careful not to inadvertently change the name of the system setting as it could cause the site to break. Click here for information on how to locate directory IDs in the admin tools.
  7. Click "Save"
  8. Go to the front-end of the site to view your changes.

Note it may take a moment for the changes to appear due to caching.

How do I locate the ID of a directory?

  1. Go to Sales/Marketing > Topic
  2. Click "Manage Topics/Categories"
  3. Click the plus sign adjacent to "Directory Categories"
  4. Click the child folder of the directory
  5. The directory ID number is located in the frame right of folder tree structure (see screenshot above)