Trending Conversations - Vertical
Highlight the stories that are resonating with your community and feature the stories that are trending on your site, based on the recent number of comments, using the Trending Conversations tool.
For the trending articles images to appear an og:image meta tag or vf:image tag is required on the corresponding article linking to an appropriate image for the article. We recommend an aspect ratio of 3:2 and for optimal performance sized as 210px by 140px. More details on these meta tags can be found here.
<div class="viafoura">
<vf-trending-articles
title="Trending Articles"
limit="5"
days-published="7"
trend-window="1"
sort="comments"
view="full"
vf-container-id="currentPageContainer"
>
</vf-trending-articles>
</div>Trending Conversations can be configured using parameters outlined below.
Installation parameters:
Name | Description | Accepted Values | Default |
|---|---|---|---|
vf-container-id | The container id of the current page. Is used to exclude the current page from results. This is not required if the vf:container_id meta tag has been set on the page. | The value of | |
title | The title you want displayed at the top of the plugin. | Trending Articles | |
limit | The maximum number of articles to show. | 1 to 100 | 5 |
days-published | The number of days since the article was created. This is also referred to as the article age. Use 'all' to specify all articles regardless of age. | 1 to 30, all | 7 |
trend-window | This determines the size of the trend window in hours. For example, when set to 1, a list is retrieved with the articles that have received the most comments in the past 1 hour. trend-window must be less than or equal to the days-published or there will be no articles to return. | 1 to 48 | 3 |
sort | Used to determine how articles are sorted in the list, which is by comments count within the specified trend window. This is the only sort parameter at this time. We are using comment velocity (number of comments in the past x hours) as the primary filter for recommending articles. | comments | comments |
view | What style of widget to display. | full or condensed | full |
Trending Article LogicThe carousel ranks stories by commenting activity. Every few minutes, Viafoura looks at all pages on your site published within the last days-published days (max 30) and orders them by the number of visible comments and replies posted within the last trend-window hours (default 3, max 48). Pages with no recent comments are ranked next by their total comment count, and pages with no visible comments at all are never shown. If fewer than limit stories qualify, the widget automatically widens the trend window to 48 hours and then the published window to 30 days. The page the reader is currently viewing is always excluded, and results refresh approximately every 5 minutes.
Full widget example
Condensed widget example
Updated 4 days ago