黑料网

Creating A News 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 four 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 news from your website using the custom styles and layouts in the Cells product.
   2. This Site + Syndication – allows you to display your site’s news mixed with that of another site.
   3. Syndication Only – displays only news from another site.
7. Post Type: News
8. List Type: there are 4 different layout styles to chose from. View the example pages for the Mult-column, Carousel, Ribbon and Vertical layouts to see which best suits your needs.
9. View the options specific to each List Type (Multi-column, Carousel, Ribbon & Vertical) below then come back here and finish these steps.
10. Syndication Site URLs:
    1. In the 鈥淓nter Site Slug or URL鈥� field, enter the slug of the site you wish to pull news posts from then click the Add Site button. See below for a detailed explanation of what a site slug is.
    2. Include Categories and Include Tags: this limits the syndication feed to posts assigned specific categories or tags. For example, the Newsroom website has a category for Research related news. You can define that category as a parameter in your Cell so that it only pulls research news from the Newsroom site. See below for a detailed explanation of how to refine the syndication using Categories and/or Tags.
    3. By default, the Cell uses OR logic within taxonomy types and AND logic between taxonomy types. Detailed explanation can be found below that explains the different logic options that are available.
11. Click the Create Cell button.
12. If you’re ready, you can display the Cell on your website.

Multi-Column and Carousel Layout Options

1. Search: enabling this option will add a search bar that displays just above the news posts and pagination underneath.聽 The search option is not available on the Carousel list type (layout).

   

2. Read More Link: enabling this option adds a customizable link under the news posts. Use this when you wish to direct site visitors to additional news. This option is not available when the Search is enabled.
   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 research related news鈥�).聽 Avoid uninformative link phrases such as “Read More.”
   2. More Link URL:聽provide the URL you want the More Link Text to link to.
3. Amount To Display: defines how many news posts to display. Setting this to 0 will display all posts.
4. Include Image: choosing ‘yes’ for this option will display the Featured Image associated with the post. If no featured image is assigned, a random placeholder image related to 黑料网 will display instead.
   • 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.
5. Include Date: displays the date the post was published.
6. Title Lines: this option controls the display of news post titles within the Cell. It allows you to limit the amount of the title that is shown. This can be useful if there are posts with lengthy titles.
   • Custom Title Lines: If you chose the “Custom” option for Title Lines, you will need to define how many lines should be dedicated to displaying the title of the post. If a title is longer than the number of lines specified, it will be truncated to fit within the specified number of lines.
7. Include Excerpt: this option controls whether the post excerpt content will be displayed in the Cell.
   1. Tip: It is important to provide an excerpt when creating News posts. This ensures that your posts’ key information is presented correctly. If no excerpt is provided, the system will use text from the body of the post 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 how many lines should be dedicated to displaying the excerpt of the post. If an excerpt is longer than the number of lines specified, it will be truncated to fit within the specified number of lines.
8. Include Categories and Include Tags: these options display any categories and/or tags assigned to the news post.

Vertical Options

1. Include Image: choosing ‘yes’ for this option will display the Featured Image associated with the post. If no featured image is assigned, a random placeholder image related to 黑料网 will display instead.
2. Search Enabled: enabling this option will add a search bar that displays just above the news posts and pagination underneath.
3. Read More Link: enabling this option adds a customizable link under the news posts. Use this when you wish to direct site visitors to additional news. This option is not available when the Search is enabled.
   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 research related news鈥�).聽 Avoid uninformative link phrases such as “Read More.”
   2. More Link URL:聽provide the URL you want the More Link Text to link to.
4. Amount To Display: defines how many news posts to display. Setting this to 0 will display all posts.

Ribbon Options

1. Background Color: select the background color of the Cell.
2. Image Size: there are 4 sizes to choose from.
3. Add Title Accent Underline: show or hide the small yellow accent line that displays under the Primary Heading.
4. Primary Heading and Primary Text: the title and paragraph text that displays above the news posts.
5. Search Enabled: enabling this option will add a search bar across the top of the Cell and pagination bellow it.
6. Read More Link: enabling this option adds a customizable link under the news posts. Use this when you wish to direct site visitors to additional news. This option is not available when the Search is enabled.
   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 research related news鈥�).聽 Avoid uninformative link phrases such as “Read More.”
   2. More Link URL:聽provide the URL you want the More Link Text to link to.
7. Amount To Display: defines how many news posts to display. Setting this to 0 will display all posts.

Syndication Site URLs

This field tells the Cell which website(s) to pull news posts 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 news posts from.
3. Syndication Only 鈥� add the School of Medicine site(s) you wish to pull news posts 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 your syndication to only include posts assigned to a specific category and/or tag. For example, if you are working on a lab website, you might choose to display only research-related news from your department’s website.

How to View Available Categories and Tags

After you’ve added a source site, click the View Categories or View Tags link.

A list of available categories or tags will open in a new browser tab. Note: The format of this data depends on your browser and extensions.

• Firefox and Edge: Automatically format the data into a readable layout.
• Chrome and Safari: Display the data as raw text (unformatted JSON), which can be hard to read.
  To improve readability, consider installing a JSON viewer extension to your browser:
• if you don’t wish to install an extension, documentation is provided below to help you filter the data.

Add a Category/Tag To The Cell

On the categories/tags page, locate the ID number of the category or tag you wish to use.

Return to the Cell settings and enter that ID into the Categories or Tags field.

Pagination for Long Lists of Categories/Tags

The category or tag list is limited to 100 results per page. If the site has more than 100 entries:

• Add &page=2 to the end of the page URL to view the next set.
• Use &page=3, &page=4, etc., to continue browsing additional pages as needed.

If You Don鈥檛 Want To Install A Browser 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.

   

AND and OR Logic

The plugin uses any defined categories and tags along with logic to determine which posts to display. By default, the plugin employs OR logic, but it can be configured to use AND logic.

OR Logic

OR logic broadens the scope of the results, including all posts associated with any of the listed categories or tags.

Example Use Case

If you assign the categories 鈥淎wards鈥� and 鈥淩ankings and Recognitions,鈥� the Cell will:

• Include all posts assigned the “Awards” category.
• Include all posts assigned the 鈥淩ankings and Recognitions鈥� category.

AND Logic

AND logic narrows the scope of the results by including only posts tagged with all specified categories or tags.

Example Use Case

If you assign the categories 鈥淢ental Health鈥� and 鈥淪tudents,鈥� the Cell will:

• Include only posts assigned the 鈥淢ental Health鈥� AND 鈥淪tudents鈥� categories.
• Exclude posts tagged with just 鈥淢ental Health鈥� or just 鈥淪tudents.鈥�

Combining AND and OR Logic

Default Behavior

• Within Taxonomy Types: OR logic.
• Between Taxonomy Types: AND logic.

Example

• (Category 1 OR Category 2 OR Category 3) AND (Tag 1 OR Tag 2 OR Tag 3)

Checkbox Configurations:

• If the first box is checked the API will return AND logic within taxonomy types.
  • Example: (Category 1 AND Category 2 AND Category 3) AND (Tag 1 AND Tag 2 AND Tag 3)
• If the first box is checked AND the second box is checked the API will return AND logic within taxonomy types and OR logic between taxonomy types.
  • Example: (Category 1 AND Category 2 AND Category 3) OR (Tag 1 AND Tag 2 AND Tag 3)
• If the first box is unchecked AND second box is checked the API will return OR logic within taxonomy types and OR logic between taxonomy types.
  • Example: (Category 1 OR Category 2 OR Category 3) OR (Tag 1 OR Tag 2 OR Tag 3)