黑料网

Creating An Event Syndication Cell

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. This is a list of fields for all three layouts (list types). Not all fields are available for every layout.

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 button.
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: Syndication
6. Select the syndication type:
   1. This Site Only – allows you to display the events from your website using the custom styles and layouts in the Cells product.
   2. This Site + Syndication – allows you to display your site’s events mixed with that of another site.
   3. Syndication Only – displays only events from another site.
7. Post Type: Events
8. List Type: there are 3 different layout styles to chose from. View the example pages for the Vertical, Multi-Column 补苍诲听Carousel,聽layouts to see which best suits your needs.
9. Timeframe: you have the option of displaying either future or past events.
   1. Four Digit Start Year: use this setting to control the range of past events displayed in the Cell. Define the earliest year from which the plugin should pull events. Only events occurring from the specified year onwards are included in the display. For example, if you set this to “2023,” the plugin will only display events occurring from the year 2023 onwards.
10. Read More Link: enabling this option adds a customizable link to the end of the events. Use this when you wish to direct site visitors to additional events.
    1. More Link Text:聽ensure the link text is meaningful and descriptive. It should accurately describe the link鈥檚 destination and/or purpose (e.g. 鈥淪ee all grand rounds鈥�).聽 Avoid uninformative link phrases such as “Read More.”
    2. More Link URL:聽provide the URL you want the More Link Text to link to.
11. Amount To Display: defines how many events to display. Setting this to 0 will display all events.
12. Include Image: this option allows you to specify whether you want to display an image or stylized date within the Cell.
    1. Image Type:
       1. Featured Image: Selecting this option will display the featured image associated with the event. If no featured image is assigned, a placeholder image related to 黑料网 will display instead.
       2. Stylized Date: this will display a more prominent and stylized representation of the event date. This option offers a visually appealing alternative to the featured image, focusing attention on the date itself.
    2. Image Aspect Ratio:聽there and four image size options to chose from. Note that image clipping my occur due to the responsive design of Cells.
13. Include Day and Time: this options adds the day of the week and time of the event. This option is not available on the Vertical list type (layout).
14. Title Lines: this option controls the display of event titles within the Cell. It allows you to limit the amount of the title that is shown. This can be useful if there are events with lengthy titles.
    • Custom Title Lines: If you chose the “Custom” option for Title Lines, you will need to define the max number of lines dedicated to displaying the title of the event. If a title is longer than the number of lines specified, it will be truncated.
15. Include Excerpt: this option controls whether the event excerpt content will be displayed in the Cell.
    1. Tip:聽It is important to provide an excerpt when creating events. This ensures that your event’s key information is presented correctly. If no excerpt is provided, the system will use text from the body of the event but will strip out any images, buttons, lists, and multimedia like videos or iframes. Only plain text will be used to create the description. This can lead to the omission of important details and formatting issues.
    2. Custom Excerpt Lines: if you chose the “Custom” option for Excerpt Lines, you will need to define the max number of lines dedicated to displaying the excerpt of the event. If an excerpt is longer than the number of lines specified, it will be truncated.
16. Include Categories and Include Tags: these options display any categories and/or tags assigned to the event.
    • Custom Category / Tag Lines:聽If you chose the “Custom” option for Category Lines or Tag Lines, you will need to define the max number of lines dedicated to displaying the categories/tags of the event. If the number of categories/tags is longer than the number of lines specified, it will be truncated.
17. Syndication Site URLs:
    1. In the 鈥�Enter Site Slug or URL鈥� field, enter the slug of the site you wish to pull events from then click the Add Site button. See below for a detailed explanation of what a site slug is.
    2. Categories and Tags: this offers the ability to limit the syndication feed to events assigned specific Categories or Tags. Rather than display all events, this allows you to control which subset of events get displayed. See below for a detailed explanation of how to refine the syndication using Categories and/or Tags.
18. Click the Create Cell button.
19. 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 events 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 events from.
3. Syndication Only 鈥� add the School of Medicine site(s) you wish to pull events 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.

Categories and Tags

You can refine the syndication to events assigned a specific category and/or tag. For example, if you wanted to display just the Grand Rounds events from the Pediatric web site.

Example Use Case

Site A (Pediatrics): Has many events, including Grand Round sessions. The grand round events have all been assigned a “grand rounds” category.

Site B (Pediatric Education): Syndicates only Grand Round events by filtering for the “grand rounds” Category.

How To Filter For Categories and Tags

1. Once you’ve added the site slug and clicked the Add Site button, click on the View Categories or View Tags links to see a list of available options from the site. 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 category/tag you wish to filter for and add it to the corresponding Categories or Tags field.

I Don鈥檛 Want To Install An Extension

If you鈥檙e using Chrome or Safari and don鈥檛 wish to install a browser extension to make the list of categories/tags more legible, here鈥檚 how you decipher the information and find the ID:

1. The information for each category/tag is contained within { } brackets.
2. The name of each category/tag will be preceded by “name”.
   • Tip: if you know the name of the category/tag 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 category/tag name (in this example that would be “research”) to easily find it in the list.
3. Once you find the category/tag name of your choice, look for the “id” number contained within the same { } brackets.
4. That ID number is what goes into the Categories and Tags fields.