大象传媒

The People syndication allows sites to display faculty/staff profiles from other School of Medicine (SOM) web sites on their own site. This functionality is often used on division and lab websites where profiles are already created on their department website. They simply syndicate the desired profiles rather than recreate them.

Note: The People syndication only works with the聽NEW Directory plugin, not the old one.

There are two layout styles to chose from: a Vertical (single column) layout or a multi-column layout.

How To Syndicate Directory Profiles

Many fields are self explanatory and will not be addressed in this documentation. This documentation will focus on tips, best practices and explanation of fields that generally need some clarification.

1. Determine where the Cell will be used.
2. In the Dashboard, select聽Cells聽in either the top or left-hand navigation.
   • If you do not see this option, then the聽大象传媒SOM Cells聽plugin needs to be activated.
3. Select the聽Add New听产耻迟迟辞苍.
4. Cell Name:聽 be descriptive! Our recommendation is to use a naming convention that is clear as to what the cell is, and where it is likely to be used. This name will not be visible on the front end of the website. It only displays on the Cells page in the Dashboard.
5. Layout:听厂测苍诲颈肠补迟颈辞苍
6. Select the聽syndication type:
   1. This Site Only 鈥� allows you to display profiles from your website using the custom styles and layouts in the Cells product.
   2. This Site + Syndication 鈥� allows you to display your site鈥檚 profiles mixed with that of another SOM site.
   3. Syndication Only 鈥� displays profiles from other SOM site(s).
7. Post Type: People
8. List Type: there are 2 layout styles to chose from – Vertical, which is a single-column layout, and Multi-column.
9. Column Layout: this option is only available with the multi-column layout. It allows you to define how many columns are used to layout the profiles.
   1. The gallery will sometimes display in fewer columns than specified. This is because the gallery was designed to be responsive. This ensures a good user experience across various devices and screen sizes. As screen size decreases, such as on mobile devices or smaller browser windows, the number of columns adjusts dynamically to prevent content from becoming cramped or difficult to read. This responsive behavior ensures that your content remains accessible and visually pleasing, regardless of the device or screen size used to view it.
   2. The 4-column layout only works on pages that don’t have left-hand navigation.
10. Search: enabling this option will add a search bar that displays above the profiles and pagination underneath
    1. The People Search option will search First/Last Name, Position Title, Gallery Summary and Post Title (usually same as first/last name).
    2. Search results are based on content indexed from the Post Title, First and Last Name, Position Title(s) and Gallery Summary fields.
11. Syndication Site URLs: In the “Enter Site Slug or URL” field, enter the slug of the site you wish to pull profiles from then click the Add Site button. See below for a detailed explanation.
    1. Logic – by default, the Cell uses OR logic. Detailed explanation can be found below that explains the different logic options that are available.
12. Divisions: this optional field allows you to limit the syndication feed to profiles assigned specific Division category. For example, this allows you pull a subset of profiles, such as ones associated with Research, rather than the entire department directory.聽 Simply add聽the Division ID(s) to to this field. See below for a detailed explanation of how to refine the syndication using Divisions.
13. Click the Create Cell button.
14. If you’re ready, you can display the Cell on your website.

Syndication Site URLs

This field tells the Cell which website(s) to pull profiles from. The sites you enter here depend on the syndication type you selected when setting up the Cell (This Site Only, This Site + Syndication, or Syndication Only).

By default, the website you are working on will automatically be listed as the first source site.

Whether content is actually pulled from the site you are working on is dependent on these settings:

1. This Site Only 鈥� the site you鈥檙e currently working on is automatically listed as a source. No additional source sites need to be defined.
2. This Site + Syndication 鈥� your current site is already included. Simply add any additional School of Medicine site(s) you wish to pull profiles from.
3. Syndication Only 鈥� add the School of Medicine site(s) you wish to pull profiles from. Although your current site is listed as a source, it will be ignored.

How To Add a Source Site

Additional sites will be added to the “Enter Site Slug or URL” field.

Adding a Site by URL

1. Navigate to the homepage of the site you want to add.
2. Copy the base URL (e.g., /medicine/cardiology). Copying the URL from the site will ensure you don’t mis-type it.
3. Paste it into the field and click the Add Site button.
4. Important: Only use the homepage URL. Do not paste a URL from a deeper page (e.g., /medicine/cardiology/patient-care/patient-resources/)鈥攖his will not work.

Adding a Site by Slug

If the site is part of the med.unc.edu domain, you can enter just the slug instead of the full URL. A slug is the part of the URL that immediately follows med.unc.edu/.

For example, 鈥渕ed.unc.edu/medicine鈥� is just 鈥渕edicine鈥� and 鈥渕ed.unc.edu/medicine/cardiology鈥� is 鈥渕edicine/cardiology鈥�.

Once the slug is entered, click the Add Site button.

Sites with Unique URLs

Some School of Medicine sites have their own domain names. For these sites, you can enter either the base URL or the custom slug that was created for them.

For example, the site is just “news” and the site is “lccc”.To view a complete list of sites with custom slugs, click on the Help button located under the “Enter Site Slug or URL” field.

Divisions

Divisions limit the syndication feed to profiles assigned specific Division categories. Some commonly used divisions include: Faculty, Staff, Administration, Research, etc. You can define a Division as a parameter in your Cell so that it only pulls those associated profiles from the site.

1. Click on the View Divisions (JSON) link to see a list of available options. These options will open in a new browser tab.
   • What the data looks like depends on the browser and browser extensions you have.
   • Firefox and Edge will automatically format the results into a human readable format.
   • Chrome and Safari will display the results as an unformatted text list that can be difficult to read. However, a JSON browser extension can be added to make the information legible.
2. Find the ID number for the Division you wish to filter for and add it to the Divisions field.
   • Profiles from multiple Divisions can be pulled in one syndication feed. Simply list them as a comma separated list of ID numbers. An example use case is if there are multiple divisions for students (PGY-1, PGY-2, PGY-3, PGY-4) and you wish to display all students in one Cell. You would find the ID for each and add them to the

I Don’t Want To Install An Extension

If you’re using Chrome or Safari and don’t wish to install a browser extension to make the list of Divisions more legible, here’s how you decipher the information and find the ID:

1. The information for each Division is contained within { } brackets.
2. The name of each Division will be preceded by “name”.
   • Tip: if you know the name of the Division you wish to filter for, for example “research,” you can hit Ctrl + F (on windows) or Cmd + F (on Mac), to bring up a search box. Type in the Division name (in this example that would be “research”) to easily find it in the list.
3. Once you find the Division name of your choice, look for the “id” number contained within the same { } brackets.
4. That ID number is what goes into the Divisions field.

AND and OR Logic

AND and OR logic affects which profiles are displayed by either broadening or narrowing the scope of profiles included in the results. The cell uses OR logic by default but can be switched to AND logic.

OR Logic

Broadens the results by including ALL profiles from any of the listed Divisions. For example, if you listed two divisions for “Fellows” and “2024-2025,” the Cell will display all the fellows as well as any profiles tagged with the 2024-2025 division.

AND Logic

Narrows the results by including only profiles that are tagged with all specified divisions. For example, if you listed two divisions for “Fellows” and “2024-2025,” the Cell will display only the 2024-2025 fellows, not all fellows.