soHeadlines
Tag Name
soHeadlinesDescription
Shows a list of articles or headlines from the Articles & Blogs manager. This tag is commonly used on internal pages to display a dynamic list of headlines from your blog. It will be used for one of two pages in your blog setup.When initially setting up a blog, the soHeadlines tag will be auto-generated with a blog ID number, and you can simply copy/paste the tag into the body section of a page. You will find the tag under edit site > articles/blogs > select group where blog is created > and the Tag Syntax for your blog will display next to the title.
NOTE: This tag is designed for use with the soArticle tag.
Optional Parameters
- id: the blog/collection ID number of the blog headlines you want to show.
- groupId: the group ID number of the blogs you want to show.
NOTE: if you would like your blog headlines page to display the latest blog headlines from the entire organization, do not enter a blog ID or group ID in the tag.
- groupBy: (day/month/topic/author) by default, the side column of the blog headlines tag will display blog posts categorized by day, month, and topic. You can control which sections appear by specifying the ones you want to display. Each item needs to include a pipe symbol in between (ex: groupBy=month|topic). The order in which the parameters are listed in the tag will be the order on the site.
NOTE: using the "authors" parameter will add a new Authors section to the side column of the blog setup, which will display the blog contacts for your posts, if specified. The contact name needs to be entered exactly the same for each entry, otherwise two separate authors will be listed in the category. - groupByTitle: (used in conjunction with the "groupBy" parameter) allows you to change the title of the different sections in the left-hand column. Each section title needs to include a pipe symbol in between (ex: groupByTitle=Archives|Categories).
- headlinesBody: ("intro" or "body") use the "body" parameter to the display the full article post on the headlines page. Default is "intro".
- num: number of headlines/posts to show. The default will vary from one organization to the next.
Example
{soHeadlines(id=2958,groupBy=topic,groupByTitle=Categories,headlinesBody=body)}In the above example, only posts from the blog/collection # "2958" will be shown, only the "topic" category in the side column will display (not day and month), the title of the "topic" section will display as "Categories", and the full article post will display on the headlines page (instead of just the blog intro text).