How To Use The Directory Component

The Directory component displays a directory of people for a selected department. This component uses the global CWU directory as its source and creates a local version of it to be used within a department's site.

Table of Contents

• What is the Directory Component
• Before You Begin
• Adding a Directory Component to a New Page
• Adding a Directory Component to an Existing Page
• Component Fields
• Using Filters
• Best Practices

What is the Directory Component

The directory component displays a list of people for a selected department in a card style similar to how the global CWU directory does it. You can optionally narrow the results by college, location, or position type, and add introductory content above the cards displayed.

Before You Begin

Note:

Before starting, you must be logged in to CascadeCMS.

Step 1. Log in at https://cwu.cascadecms.com using your CWU credentials.

Step 2. After logging in, select the CWU site from the “Go to a Site” drop down in the upper-left corner.

 

Step 3. Navigate to your site folder. In this example, we'll be using Web Services' site folder.

Step 3a. On the left "SITE CONTENT" panel, locate your site folder's location. If you're not sure where the location is, refer to the URL of your site. Web Services' URL is 

• https://www.cwu.edu/about/offices/information-services/web-services/index.php,

which tells us we can navigate to the site folder location by clicking the following folder within the "SITE CONTENT" panel:

CWU > about > offices > information-services/web-services

 

If you want to add a Directory component to a new page, continue to the step below, Adding a Directory Component to a New Page. If you are adding a Directory component to an existing page, skip the next step and continue at Adding a Directory Component to an Existing Page.

Adding a Directory Component to a New Page

1. Click Add Content > Standard.
   
   
   
   
    

2. Scroll down to the Components section in the Edit pop up.
3. Click the "Type" area in the Component field.
4. Select directory from the dropdown.
5. Click within the directory component to display its options.
   

 

Adding a Directory Component to an Existing Page

 

• Once you have navigated to your site's folder, choose the page you want to add the directory component to on the "SITE CONTENT" panel. You will see the contents of the page on the right panel.
  
  
   
• Click Edit near the top-right corner of the page
  
  
   
• If the page already has components:
  • Scroll down to the Components area and click the “+” (Add Component) icon next to any existing component.
    
    
     
  • Once the new component group has been added, click the Type area
    
    
     
  • Click on the dropdown and select Directory
    
    
     
  • Click on the new Directory component area to display its fields
    
    
     
  • We recommend filling out the fields following the example below. While Headline and Content are optional, we recommend them to be filled in, especially if the Directory component is the only component on the page. When choosing a value for the "Choose Department" dropdown, you are able to type into the box to make searching easier. 
    Note: Filter by College, Filter by Location, nd Position are completely optional and not needed most of the time.
    
    
     
  • After setting up the Directory Component, you are ready to Submit your updates to the page.
    
    
     
  • Finally, review and publish your page.
    Note: It can take up to 5 minutes for your changes to be live on the website.
    
    
     
  • Click on Publish on the top-right corner of the publish pop-up.
    

 

Component Fields

 

• Choose Department: Required. Select the department whose people you want to display.
• Headline: Optional. Adds a heading above the cards displayed.
• Content: Optional. Displays introductory text above the cards displayed.
• Filter by College Optional. Limits the directory component to people associated with a specific college. Leave blank or choose None to display all results.
• Filter by Location: Optional. Limits the directory component to a specific campus or location. Leave blank or choose None to display all results.
• Position: Optional: Optional. Displays Faculty, Staff, or All positions.

Using Filters

The optional filters help narrow the results after selecting a department.

Example:

• Choose Department: Biological Sciences
• Filter by College: College of Sciences
• Filter by Location: Ellensburg
• Position: Faculty

This configuration displays only faculty members in the Biological Sciences department who are located on the Ellensburg campus.

Best Practices

• Always verify that Choose Department is correct before publishing.
• Only use optional filters when you want to narrow the results.
• Add a headline when the directory component is the primary content on the page.
• Use the Content field to provide helpful context for visitors.
• Preview the page before publishing.
• Do not place more than two directory components on the same page.