Skip to content

This guide provides instructions and information about Stanford Web Services Jumpstart platform, based on Drupal 7.

We've released our new Stanford Sites on Drupal 8 (D8) platform — the new framework for Stanford Sites in 2020 and beyond. Check out our new User Guide to help you set up your website on the D8 platform. 

Read more about our road to D8 

Customizing People Listing Pages

Need to create an additional page displaying a subset of your people? You can create pages that show content based on a single taxonomy term and choose your layout using an existing People page layout.

Adding a new Person page under the default Affiliations 

People pages are organized by taxonomy, under Affiliation. See Manage Taxonomy. By default, there are three Affiliations to consider when organizing your people: FacultyStaff, and Student

  1. Choose the Affiliation you would like for that Person page; for the defaults, it would be any of: FacultyStudents, and Staff. A Person can have multiple Affiliations; they will be listed on each of the pages for that taxonomy (more details below).
  2. Each of the default Affiliations have a default layout associated with the term: the Faculty page will list people in a Profiles layout (at /people/faculty); the Students page will list people in a List layout (at /people/students); the Staff page will list people in a Directory layout (at /people/staff).

Advanced People layout options JSE

You can add custom terms to the Affiliation taxonomy to help organize your people, or remove any of the default options; you can then combine these custom terms with a specific page layout by appending the URL.

  1. In your Affiliation taxonomy (Site Actions -> Manage Taxonomies -> Affiliation), add a term with the name of the Affiliation you would like to display, e.g., Program Leadership. This taxonomy term will also be the page title for the page listing the affiliated people. You can also remove any of the default options. Removing terms does not remove the Person pages associated with that term; the Person pages will simply become unassociated.
  2. Tag all necessary people with the new category by editing each Person page individually or using Manage Content, and checking the appropriate box under Affiliation.
  3. NOTE: Based on your choice of Affiliation and layout, navigate to your new page based on the format: /people/{taxonomy term}/{layout}. e.g., if you prefer the Grid layout and have affiliated people under a custom term: "Co-Term Students", your page is at /people/co-term-students/grid.
  4. Optionally, add this page URL to the main menu (Site Actions -> Edit Main Menu -> Add link).

Note: The {taxonomy term} field in the URL can only accept one taxonomy term out of these Vocabularies: AffiliationFaculty TypeStaff Type, and Student Type.

There are four layout options for listing People:

  • Profile (default faculty page): Displays photo and extensive profile information.

Faculty listing

 

  • Directory (default staff page): Displays photo and contact information.

Staff listing

  • List (default student page): Displays list of names with limited details and no photo.

Student listing

  • Grid: Displays photo and title in a grid layout.

Grid listing

Example combinations of Affiliations and Layouts

The default Affiliations (FacultyStudents, and Staff) have default layouts associated with them (ProfilesList, and Directory respectively), so you are not required to specify the layout in the URL. However, the default Affiliations can be modified by appending the URL with the layout based on Step 3 in the instructions above. The variations of layouts with the default Affiliations can be accessed simply by changing the URL path:

/people/faculty/profiles
/people/faculty/directory
/people/faculty/list
/people/faculty/grid
/people/staff/profiles
/people/staff/directory
/people/staff/list
/people/staff/grid
/people/students/profiles
/people/students/directory
/people/students/list
/people/students/grid

And if you have any custom terms, such as "Advisors", your layout options would be under:

/people/advisors/profiles
/people/advisors/directory
/people/advisors/list
/people/advisors/grid

Note: Custom Affiliations do not have a default layout associated with them, so you will have to specify the layout in the URL. Otherwise, you will get a 404 Page Not Found error, such as if you go to /people/advisors.

Listing all people

It is also possible to list all people on a single page using the /all keyword in place of the Affiliation in the URL. For example, using the path /people/all/profiles will generate a page listing all people, sorted by last name, in the Profile view:

All profiles

Grouping by Affiliation JSE

In addition to listing all people by using the /all keyword for Affiliation in the URL, it is also possible to group the people in the view by Affiliation by adding /grouped at the end of the URL. For example, using the path /people/all/grid/grouped will generate a page listing all people, in the Grid view, grouped by Affiliation, sorted alphabetically within each group (unless weights have been applied). This is the default view for the the /people path. The order of the taxonomy groups is set by the weights of the Affiliation taxonomy terms. 

People grouped

* Note that the /grouped view option does not affect views set by an Affiliation taxonomy term.

Grouping by Type for default People types (Faculty, Students, and Staff) JSE

There are built-in taxonomies for FacultyStudents, and Staff, which are Faculty TypeStudent Type, and Staff Type respectively. When using one of these taxonomies, the /grouped option can also be used with each default view. For example, under Staff Type, it is possible to add terms such as "Research Staff" and "Administrative Staff". Then using the path: /people/staff/grouped, you can get a list of staff members grouped by Staff Type. The same would apply for the default Student view; the default Faculty view is already grouped.

Staff grouping layout

Changing the default layouts for the default Affiliations JSE

To change the default layout of one of the default Affiliations (Faculty, Staff, or Student) in the menu, you will have to edit the URL in the menu.

  1. From the Site Actions menu, click Edit Main Menu.
  2. Scroll down until you see People.
  3. Under People, find which page you wish to change the display of (FacultyStaff, or Student) and click edit.
  4. Under the Path field, add /profile/directory/list, or /grid to the end of the path to specify your layout. E.g.: people/faculty/grid.
  5. Click Save.

Adding your custom Affiliations to the menu JSE

If you create any custom Affiliations, you will want to add the paths to them (with the specified layout) to the menu.

  1. From the Site Actions menu, click Edit Main Menu.
  2. Click +Add Link at the top of the page.
  3. In the Menu link title field, add the title you wish to be displayed in the menu, e.g. Advisors.
  4. Under the Path field, add the URL of the page you wish to add to the menu. For example, if you wish to add an Advisors page in directory view, you would enter: people/advisors/directory.
  5. In the Parent Link drop down, select People. This ensures your link will show up under the People section of the menu.
  6. If you wish for the menu item to be displayed in a certain order under the People section of the menu, you can choose the necessary number from the drop down under WeightNote: The larger the number the lower it will appear on the list. Alternatively, once the menu has been saved you can drag the items into the preferred order.
  7. Click Save.