Directory Application

Directory Application

Last updated 04.01.24

The Directory Application is a database of location, department and employee information built into Atlas. This information is automatically pulled into four Atlas widgets: the Department Directory Widget, Location Employees Widget, Location Map Widget, Location Special Hours Widget and Location Cards Widget
 
Any changes in the Directory Application will propagate through the website automatically. 
 
You can add all three types of data by selecting the Directory Application.  

How to access the Directory Application

From the Atlas Kentico main dashboard open the Application List by clicking on the white sun icon on orange on the upper left. From here, shortcut to the Directory application by typing “Directory” in the search applications field. Click on “Directory” to open application.

Atlas Widgets that Display Directory Data

Department Directory Widget 
Department Directory Widget displays employee’s photos and names in rows. The employees displayed are governed by the departments to which they are assigned. If the employee is assigned more than one department, they can appear on more than one page in the website. Working with the widget first requires adding this data to the Directory Application. 
 
Location Employees Widget 
The Location Employees Widget functions only on the Locations Details page type. It displays the employee’s photos and names in rows. The employees displayed are governed by the locations to which they are assigned. If the employee is assigned to more than one location, they can appear on more than one page in the website. Working with the widget first requires adding this data to the Directory Application. 
 
Location Map Widget 
The Location Map widget automatically displays map data entered into the directory database onto an interactive, responsive Open Street map. Clickable pins open popup windows containing location detail information. The standard map will automatically resize to fill the space available within a grid, accordion or tab. 
 
The map data can be styled to appear in different visuals including a standard map, a standard map with a text table below or a series of individual cards with or without a location photo. 

Location Cards Widget 
The Location Cards Widget automatically displays map data as individual cards with or without a location photo. This widget allows the user to display a single location that is entered in the Directory Application. The information is displayed in the visual form of a card. This location card will provide a photo, address, phone number and the directions link along with the option to display the location details link. Because it dynamically pulls information from the Locations Application it is a great way to feature one location.  
 
Location Special Hours Widget 
The Location Special Hours widget allows content editors to create expandable accordion panels containing detailed information for one or more locations. This includes opening and closing times by day, additional explanatory text and the contact phone number.  

Special hours information is added to the location in the Directory Application. Any location with special hours added will appear in an accordion panel automatically. 

Adding Employee Data

Each employee can be categorized by department(s) and location(s). Employees names appear in the Directory Widget and the Location Employees Widget. 

  1. In the Directory Application, navigate to the Employees tab and click on “New Employee” button 
  2. Enter new employee’s first name, last name and photo at minimum. The Code Name will be automatically generated by the system. Add any additional information as needed. 
  3. While still in the individual employee’s data entry dashboard, navigate to the Departments tab and click “Add Items” button to assign department(s) to this employee. The popup lists all the departments you have added to the directory via the main Departments tab. Check as many as applicable and click Select.
  4. While still in the individual employee’s data entry dashboard, navigate to the Locations tab and click “Add Items” button to assign location(s) to this employee. The popup lists all the locations you have added to the directory via the main Locations tab. Check as many as applicable and click Select.

Employee Data Properties

PROPERTYDESCRIPTION
First Name
Text entry (required)
Last Name
Text entry (required)
Title
Job title recommended. Location is also an option or any other consistent key info.
Bio
Text of any descriptive copy needed. This could be a paragraph about the person or any additional info that would be helpful.
Image
Image (required)  175 x 175 pixel photo or other image stored in media library. Note that the image size can be different from the recommended, for instance to accommodate a portrait image, but all images used in the directory should be the same dimensions for a consistent, professional look.
Image Title
Tooltip type text which appears on image hover
Image Description
Text describing details of an image to provide more complete information
Image Alt Text
The purpose of alt text is to describe visual elements to users who can’t see them, either because the image failed to load or because they are using a screen reader.
Phone (Office)
Number entry
Phone (Office) Extension
Number entry
Phone (Cell)
Number entry
FaxNumber entry
Email
Email address entry
Code Name (System)
Automatically generated by the system
Blog Author
Checkbox to administer blog authorship permission to employee

Adding Department Data

Employee’s appearance in a department directory can be ordered alphabetically but also by priority order. This affects the order in which they appear on the page in the Department Directory Widget.  

  1. In the Directory Application, navigate to Departments tab and click on “New Department” button.
  2. Enter new department name then click the save button. The Code Name will be automatically generated by the system. Other data shown is optional. Continue to add as many department names as needed.  
  3. While in the individual department’s data entry dashboard, navigate to the Department Employees tab to view all employees currently assigned to this department. From here remove or add employees to this department. 
  4. While in the individual department’s data entry dashboard, navigate to the Employee Priority tab to view the order this department’s employees will appear on the page in the Department Directory Widget.
  5. Assign an order number by clicking on the pencil icon for each employee then entering a number into the Display Order field. 
  6. If only one employee needs to be first and the rest remain in alphabetical order, simply assign the number one to that employee. 
  7. To activate the Priority Order in the Department Directory ATLAS Widget click the properties. In the properties pop up, adjust the “Order By” setting to Priority Order. Be sure to select the correct department. 

Department Data Properties

PROPERTYDESCRIPTION
DepartmentName that will appear in any department selection menu
TitleName that will appear in Directory list
DescriptionFor internal use – add any identifying text to help with recognition
Alt TextAlternative description
Code Name (System)Automatically generated by the system

Adding Location Data

Location data appears in the Location Employees Widget, Location Map Widget, and Location Card Widget.

  1. Click on “New Location”
  2. Enter Location data. Note that the two key properties for connecting to the live map are the Location Name and the Latitude and Longitude. Additional data can be added as needed.  
  3.  Click “Save” when complete but return any time to edit.

Location Data Properties

PROPERTYDESCRIPTION
Set as Default LocationCheck if true. This will automatically pin the default location to the top of the locations list in the Location Map Widget.
Name (Required)Location name which will appear on all map instances
Street AddressText entry
CityText entry
StateText entry
CountryText entry
Zip CodeNumerical entry
PhoneNumerical entry
Toll FreeNumerical entry
FaxNumerical entry
EmailText entry
ServicesChecklist generated by Widgets Application. Check services for this individual location.
Featured EmployeesList automatically generated by employee data section of Directory application
Latitude (Required)GPS coordinate required for map pin positioning
Longitude (Required)GPS coordinate required for map pin positioning
HoursFlexible text area for hours information. Light HTML required for styling.
DescriptionFlexible text area for additional information such as fax number. Light HTML required for styling.
Image1Recommended size 320x160 pixels image stored in media library
Image1 TitleTooltip type text which appears on image hover
Image1 DescriptionText describing details of an image to provide more complete information
Image1 Alt TextThe purpose of alt text is to describe visual elements to users who can’t see them, either because the image failed to load or because they are using a screen reader.
Image2Recommended size 320x160 pixels image stored in media library
Image2 TitleTooltip type text which appears on image hover
Image2 DescriptionText describing details of an image to provide more complete information
Image2 Alt TextThe purpose of alt text is to describe visual elements to users who can’t see them, either because the image failed to load or because they are using a screen reader.
OrderUsed for ordering the location and accepts 1 or 0 numeric value. If you enter 1, then that location would always appear on top of the list on live site page.
E-Commerce LocationFor ATLAS ecommerce platform users only - This is used by E-comm/ Marketplace team to have the Store Location displayed for Retailers on E-comm platform.
ERP IDFor ATLAS ecommerce platform users only - This is used by E-comm/ Marketplace team to have the Store Location displayed for Retailers on E-comm platform. They track it by ERP ID.
Specialty Hours(Data displayed in Specialty Hours Widget) Check box for additional entry fields to be displayed
Provide DetailsAny additional descriptive text needed. Will appear on the page in the Specialty Hours Widget.
Monday - Sunday HoursCheck selection:
  • Closed (default - uncheck for more options)
  • TBD 
  • Or select specific opening and closing hours