How to create a Person Listing Widget in dotCMS

Heidi Macwan -

Learn how to create a Person Listing Widget in dotCMS.

The dotCMS content dashboard with Type drop down menu showing the different content types that can be selected, such as Person Listing.
  1. Log into dotCMS.
  2. Select Content on the left side of the screen.
  3. Select Search.

Content Dashboard

  1. Select Person Listing from the Type drop-down menu.

Shows the dotCMS content dashboard with Type drop down menu showing the different content types that can be selected, such as Person Listing. 

  1. Select the Triple Vertical Dots button in the upper right-hand corner of the page.
  2. Select Add New Content.

Shows a button with triple dots to select where you can choose the Add New Content button.

Person Listing Content Tab

  1. REQUIRED FIELD: Open the Host/Folder drop-down menu.
  2. Select the Plus Sign (+) to twirl open the www.canr.msu.edu folder.
  3. Select the Folder of the site you where you want to save your person listing widget.

TIP: If you forget to select your folder for the Host/Folder, then when you attempt to publish the person listing widget you will receive an error stating that “You don't have the required permissions to save the asset. User has no Add Children Permissions on selected host.” Follow the steps above and republish your person listing widget. It should publish properly this time.

Shows the Host/Folder drop down menu where you need to select your website folder where you will save the person listing widget.

  1. REQUIRED FIELD: Enter the Widget Title of the person listing.

NOTE: This title is for back-end searching only.

NOTE 2: Above most fields in the Content tab is Hint Text that may help you to use the field more successfully. It is recommended to read this information prior to filling in a particular field.

  1. OPTIONAL: Fill in a Widget Headline to appear on the page above the person listing widget.

TIP: Most often, this is used for person listing widgets appearing on a web page that is not the directory main page, but instead as part of content on a page.

NOTE: When creating a web page that will become a website directory, skip this field as the Page Title becomes the Widget Headline.

Shows the Widget Title and Widget Headline fields.

  1. OPTIONAL: If a Widget Headline was input (Step 11), select the corresponding Headline Type style number from the drop-down between one (1) and six (6).

TIP: Most often, the Headline 3 style is selected, as the Headline 1 style is strictly used for the name of the website and the Headline 2 style is used for Page Titles.

Shows the Headline Type drop-down menu with options to select for Headline 1 through Headline 6.   

  1. OPTIONAL: Select the Person Type from the drop-down menu. 

TIP: Most often, this is used on websites that include more than one person listing widget.

NOTE: If Person Type is selected, then any person profiles to be displayed in this person listing widget will need to have the corresponding Person Type category identified within the profiles.

Shows the Person Type drop-down menu, including options to select for 4-H Program Coordinator, Adjunct Faculty, Alumni, Community Nutrition Instructor, Emeritus Faculty, Faculty, Graduate Students, Postdoctoral Researchers, Specialists, Staff, Statewide Educator and Visiting Scholars.

  1. OPTIONAL: Select the Tags for the person profiles that you want to appear within this person listing widget.

NOTE: If Tags are selected, then any person profiles to be displayed in this person listing widget will need to have the corresponding tag(s) identified within the profiles.

Shows the Person Tags field where tags can be input.

  1. OPTIONAL: Select the Number of Columns for the person listing widget.

TIP: Most often, Two Columns is selected for use within a main directory web page.

NOTE: The default selection is One Column.

  1. OPTIONAL: Select the Layout Axis for the person listing widget as Horizontal or Vertical.

TIP: Most often, Horizontal is selected, but both types can be used depending on the how the person listing widget is intended to display on a web page.

NOTE: The default selection is Horizontal.

NOTE 2: Horizontal orientation will show the contact information to the right of the photo. Vertical orientation will show the contact information below the photo.

Shows the Number of Columns with options to select for One to Four columns. It also shows the Layout Axis with options to select for Horizontal or Vertical layout.

  1. OPTIONAL: Keep the Display Images field check box selected if person profile images should appear within the person listing widget.

NOTE: This is a default selection for person listing widgets.

  1. OPTIONAL: Keep the Display Summaries field check box selected if the person profile summary fields should appear within the person listing widget. Summary fields include job title, telephone and email.

NOTE: This is a default selection for person listing widgets.

  1. OPTIONAL: Keep the Display Job Title field check box selected if the person profile job title field should appear within the person listing widget.

NOTE: This is a default selection for person listing widgets.

NOTE 2: The Display Summaries field check box will also need to remain selected to show the job title field.

  1. OPTIONAL: Select the Display Area of Expertise field check box if the person profile area of expertise field should appear within the person listing widget.

NOTE: This is not a default selection for person listing widgets.

NOTE 2: If selected, the Display Summaries field check box will also need to remain selected to show the Display Area of Expertise field.

  1. OPTIONAL: Select the Display Degree field check box if the person profile degree field should appear within the person listing widget.

NOTE: This is not a default selection for person listing widgets.

NOTE 2: If selected, the Display Summaries field check box will also need to remain selected to show the Display Degree field.

Shows the Display Fields with check boxes to indicate selection preference. These preferences include Display images (default), Display Summaries (default), Display Job Title (default), Display Areas of Expertise (non-default) and Display Degree (non-default).

Person Listing Widget Relationship Filters

  1. Select the related Works For Organization folder from the drop-down menu.

TIP: This is one of the most commonly used relationship filters for the creation of a main directory web page.

NOTE: If the Works For relationship is selected, then any person profiles to be displayed in this person listing widget will need to have the corresponding relationship selected within the profiles.  

  1. Select the related Member Of Organization folder from the drop-down menu.

TIP: This relationship type is typically used for the creation of committee or student organization directory web pages.

NOTE: If the Member Of relationship is selected, then any person profiles to be displayed in this person listing widget will need to have the corresponding relationship selected within the profiles.

  1. Select the related Work Location Place relationship from the drop-down menu.

NOTE: This relationship type is typically used for websites that designate location(s) as a Place relationship in the relationships tab for person profiles. These websites often have a web page showing their locations using a Place Listing Widget.

NOTE 2: If the Work Location relationships is selected, then any person profiles to be displayed in this person listing widget will need to have the corresponding relationship selected within the profiles.

  1. Select the related Dataset folder from the drop-down menu.

TIP: This is another commonly used relationship type field for the creation of a main directory web page.

NOTE: If the Dataset relationship is selected, then any person profiles to be displayed in this person listing widget will need to have the corresponding relationship selected within the profiles.

  1. Select the related Series relationship from the drop-down menu.

NOTE: If the Series relationships is selected, then any person profiles to be displayed in this person listing widget will need to have the corresponding relationship selected within the profiles.

Shows the Relationship Filter drop-down menus, including Works For, Member Of, Work Location, Dataset and Series.

Person Listing Widget Search and Filter

  1. OPTIONAL: Select the Search Box field check box. If selected, this field will display at the top of the person listing widget to allow visitors the option to type in search criteria.
  2. OPTIONAL: Select the Category Dropdown field check box. If selected, a Category drop-down menu will display at the top of the person listing widget to allow visitors the option to filter the results by person profile categories.
  3. OPTIONAL: Select the Tag Dropdown field check box. If selected, a Tags drop-down menu will display at the top of the person listing widget to allow visitors the option to filter the results by tag(s).

Shows the Search and Filter check boxes for Search Box, Category Drop-Down and Tag Drop-Down.

Person Listing Widget Person Listing Index

  1. OPTIONAL: Insert the Person Homepage URL or web address for the directory main page.

TIP: Most often, this is used for person listing widgets that appear on a home page to direct visitors to the main directory web page on the website.

Shows the Person Homepage URL field for the Person Listing Index.

Person Listing Widget Person Short List

  1. OPTIONAL: Insert a number limit on the Number of Results to show within the widget, e.g., insert 10 to show only 10 profiles within the listing widget.

NOTE: This is a sort list of items that will be limited to the number of results input for this field.

Shows the Number of Results field for Person Short List..

Person Listing Widget Person Pagination

  1. OPTIONAL: Select the Pagination field check box. If selected, it will allow for the widget to paginate results on the website.
  2. OPTIONAL: Insert a number limit on Items per page, i.e., person profiles, to show on the web page, e.g., insert 10 to show only 10 profiles on a single web page.

NOTE: This pulls everything from the widget and limits the number of items that show on a single page.

Shows the Person Pagination fields, including the Pagination check box and Items per Page field.

Person Listing Widget Final Steps

  1. OPTIONAL: Select the Language for your person listing widget. The English (US) language is the default. Other options include Espanol, French and Arabic. To choose another language other than English, select the drop-down menu and choose the appropriate language.

Shows the publishing buttons, including Language drop-down menu with English set as default, the Save button and the Save/Publish button.

  1. OPTIONAL: Select the Save button to save your person listing widget to the back-end of dotCMS. This will allow you to still work on it before publishing it live.
  2. OPTIONAL: Select the Save/Publish button to publish your person listing widget so it will appear live on your website.

Did you find this article useful?

You Might Also Be Interested In

Tag List
  • dotcms,
  • person content type,
  • widgets,
  • web team
Michigan State University
  • Spartans Will.
  • © Michigan State University

MSU is an affirmative-action, equal-opportunity employer, committed to achieving excellence through a diverse workforce and inclusive culture that encourages all people to reach their full potential.

Michigan State University Extension programs and materials are open to all without regard to race, color, national origin, gender, gender identity, religion, age, height, weight, disability, political beliefs, sexual orientation, marital status, family status or veteran status. Issued in furtherance of MSU Extension work, acts of May 8 and June 30, 1914, in cooperation with the U.S. Department of Agriculture. Quentin Tyler, Director, MSU Extension, East Lansing, MI 48824. This information is for educational purposes only. Reference to commercial products or trade names does not imply endorsement by MSU Extension or bias against those not mentioned.

The 4-H Name and Emblem have special protections from Congress, protected by code 18 USC 707.

We comply with the Federal Trade Commission 1998 Children’s Online Privacy Protection Act (COPPA).