People Index Block

Details

What is the People index block?

The People Index block versus the People Index Page is a secondary option in the event you want to customize your output in a more granular fashion or create a different people directory outside the defaulted /people folder or folder created while using a People Index Page.

Who can use it?

The Person Index block is available to publishers and managers.

How to create a People Index Block

  1. Go to New > Blocks > People Index Block.
  2. Provide a System Name (if this page isn't named 'index', remember that you have to create an index page for your folder.
  3. Designate the Parent Folder location as the folder you've created to hold your listing of people and their profiles.
  4. Configure the settings as you prefer. So long as one Person Page profile exists in the folder or one of its subfolders, the default settings will display the results immediately.
  5. Click Submit.

Please note that the the block portion is automatically embedded in the People Index Page.



How to configure a People Index block or page

The People Index contains the following sections:

  • Title
  • Categories
  • Layout
  • Paginate
  • Search
  • Tags
  • Order
  • Group
  • Settings

People Index block grouping list

Categories

This setting lets you decide how your people will be grouped:

  • All - No separation between people groupings, all-inclusive
  • Staff - Staff only
  • Faculty - Faculty only
  • Student - Students only

People index - categories

As illustrated in the image above, you can break your list of people into groups based on career type and have more than one listed at a time.

Layout

Person Index layout options

  • Display type: Select either List (top to bottom list) or Tile (a vertical display of contacts)
  • Show image: If a profile image has been set, indcate if it should be displayed or not
  • Extra page link?: If a person block has also been attached to its own page, decide if you want to include a link to that page
  • Name order: Choose from First then Last or Last then First
  • Middle Name: toggle on or off
  • @UCDavis(position,etc): If this information is included in the Person block, toggle it on or off
  • Short bio: If this information is included in the Person block, toggle it on or off
  • Contact info: If this information is included in the Person block, toggle it on or off
  • Office hours?: If this information is included in the Person block, toggle it on or off

Layout - Advanced

The Advanced section of Layout gives you more granular control over how much information from the above section is displayed. Remove or add back in the field information:

  • Active?: Leave this blank to allow the default presentation to be used, otherwise toggle this on to refine what information is displayed.
  • Line 1 (bold): %prefix %firstname %midname %lastname %suffix, %credential
  • Line 2: %dept, %unit|%worktitle|%desc
  • Line 3: %shortbio
  • Line 4: %phone|%email|%site|%street|%city %state, %zip
  • More lines [+]: %officehours
    The [+] gives you the option to include additional information based on tags you've included in Person blocks

Paginate

People Index paginate options

By default, the system will list or tile up to 10 people per page. Change this number to whatever seems most appropriate. 

Search

People Index - Search options

By default, this is turned off, but by toggling it on, it will create a search box that will appear at the top of your directory pages.

Tags

People Index - Tag options

If you decide to incorporate custom tags into your person blocks, you can then decide what will or will not be included in the Tag fields.

Order

People index - List order

Choose from:

  • A-Z on last name
  • A-Z on first name
  • Folder order

Group

People Index - Group

Settings

People Index - Settings options

Language Code: If any characters from a foreign language will be used in your page, you can list the language code in the field.

Path to People: If you're using the generic All, then link to the /people/index page. If you want to specifically list only one category of people (Staff, Faculty, Student), you can link to the index file of that particular folder under /people/.

How to attach a People Index block

A People Index block can only be attached to one, some or all of these specific pages:

  • Base folder/people/index
  • Base folder/people/faculty/index
  • Base folder/people/staff/index
  • Base folder/people/student/index

The block will only work when attached within the Page content » Main content area » Main content row » Main content column(s) » Block content area. All of the index pages under the /people/ folder use the Flex page template and, programmatically, this set-up is required in order for the Person blocks to display properly.

  1. Browse to the location of your People Index block in the Base Folder/_user-blocks/ folder and click to choose and select Confirm to attach.
  2. Open the index page(s) that will display the block. Click Edit.
  3. Block's vertical position: Select "below section heading".
  4. Width of block content: Choose 100% will result in the basic block filling the entire width of the available page space.
  5. Content box alignment: Select none.
  6. Block not bordered?: Toggle the box for yes.
  7. Click Submit to save your changes.
  8. IMPORTANT NOTE: Your list of people will NOT display within the CMS, though you will see the search box. Only when the /people/ folder and its contents have been published out to a development or production server will the content appear. It is IMPERATIVE that the /people/ folder sit at the root domain of your site in order for it to function (e.g.: http://yourSiteName.ucdavis.edu/people/)

People Index Demo

As the index of people will not display directly inside of the CMS, it's necessary to point you to a live page where a directory already exists. See the Web CMS Service team's page.

CSS Stylings

Due to the amount of back-end programming involved in this offering, custom styles are discouraged. Should you still wish to apply such styles, it will be considered custom work and not supported by the Web CMS Service team.