Web Directory Block

Deploy an entire directory from ASU Search onto a page. The faculty rank display is required for any listing of faculty within an academic unit. The web directory block is more versitile and can list faculty, staff and mixed groups.

Styles and layouts

Within the dimensions panel, users can adjust the top and bottom margin of the block as needed.

Other styles and layout decisions for the directories produced by this block are all enforced at the package level directly from the Unity project.

Required settings

The web directory block requires three configured fields in order to display a full directory from ASU Search.

The block provides for the display of two different directory styles. Both styles can be displayed with one or more departments selected and can be limited to a specific number of results per returned page.

Number of records per page

  • The default setting for the number of returned records for this block is 20.
  • The recommended range for the number of returned records is between 10 and 25.
  • Returning additional results will slow down the page’s load time due to a large number of records being returned from Search.
  • A returned list of greater than 25 records also results in a page length that is hard to navigate particularly on a mobile device.

Department selection

The select box within the settings panel for the block provides a list of all directory groups within ASU Search. This list is automatically populated each time the block edit screen is accessed.

  • Select one or more departments from the dropdown menu.
  • The order of the selected departments is configurable by rearranging the selected names in the dropdown list.

Display Type

The block provides two different methods to display a directory.

Directory

  • Useful for displaying lists of staff and mixed groups of faculty and staff members.
  • View an example from the Storybook component browser within the Unity project.

When the web-directory block is configured to display a standard directory, it optionally can be enclosed in a set of column blocks. This layout is typically used in conjunction with the sidebar block to provide for a secondary navigation to other directory pages within the same site.

There is no current option to adjust the select box for sorting the results so that it aligns with the left side of the block.

Ranked Faculty

  • Displays a list of faculty members ranked by academic achievement and bestowed titles.
  • This display will omit any member of a department that is not explicitly a faculty member in ASU Search.
  • View an example from the Storybook component browser within the Unity project.

Ordinarily, the web-directory block should not be enclosed in a column block when it is configured to display a ranked faculty list.

  • At widths of less than about 1200px, the tabs within the component will begin to scroll horizontally which is an undesirable look on desktop.

Filters and Exclusions

The list of people produced by the web directory block can be filtered in a few different ways. People can either be manually excluded from appearing within the directory results or the list can be filtered by specific criteria.

Exclusions

Enter a comma separated list of ASURITE IDs into the appropriate field in the sidebar to exclude people from a given directory list.

As ASURITE IDs are entered, the excluded profile will be outlined in red. The pagination indicator will also adjust to show how the exclusion has effected the results on each page.

Screenshot of how to enter exclusions within the web directory block.

Filters

Results from a directory can be filtered by any combination of three available criteria. A toggle within the block editor will reveal the filterable data points available to each profile within the directory.

As filters are applied, the resulting list displays ONLY people that match the given criteria.

Multiple criteria can be used within the same filter and multiple filters can be combined together to customize your list.

The available filters are:

  • Expertise area
  • Employee type
  • Campus
Screen shot of filters available within the web directory block.

Multiple blocks per page

As of Pitchfork People v1.4.1, page editors should assign a unique HTML anchor to each web-directory block that is placed on a page. If there is no anchor provided, only the first web-directory block on the page will render results correctly.

Multiple web-directory blocks can be used on the same page to create complex layouts for on-campus groups with large organizational structures.

  • Be sure to assign a unique HTML anchor to each block you add to the page. Only one of the blocks will render correctly if you omit this step.
  • Also be sure to set the pagination number on each web-directory block to a relatively small number. This will greatly speed up the initial page load time.