The {bb_news} module displays a list of News items on a web page.
This module supports Liquid.
Syntax
{bb_news filter="" sort="" limit="" emptyMessage="No items found." showExpired="true|false" collectionName="" layout=""}
Parameters
- filter - These fields and associated values build a filter string as follows:
filter="option1:optionvalue1 | option2:optionvalue2"
.
Options:
- id - Returns a specific news item.
- tags - Returns news items that are tagged. Separate individual tags with semi-colon. Example: filter="tags:Tag 1;Tag 2"
- sort - These fields can be used for sorting and builds a sort string as follows:
sort="newsTitle:ascending"
. Use ascending or descending to determine sort order direction.
Options:
- newsTitle
- newsPublishDate
- limit - Set the maximum number of news items to display.
- emptyMessage - Custom message value that is rendered. Default text is "No items found.".
- showExpired - Accepts a true | false value. This parameter is "false" by default does not show any expired articles. Set to "true" if you would like to include articles that have expired.
- collectionName - The parameter is used to access the collection the Liquid tags.
- layout - Renders the module output using:
layout="Default" or layout="List View Layout"
- sets the layout to the Default module layout;layout="My Custom Layout"
- set the layout to use a custom layout template;layout=""
- allows you to code a custom layout right within the web page HTML.
Areas Available
The {bb_news} module tag can be placed within these areas.
- Page Templates
- Web Pages
- Landing Pages
- Content Holders
Liquid Tags
{{newsId}}
– Renders the system generated ID of the news item.{{newsTitle}}
– Renders the title of the news item with a hyperlink.{{newsTitleNoLink}}
– Renders the title of the news item without a hyperlink.{{newsContent}}
– Content details of the news item.{{newsUrl}}
– Renders the URL of the news item.{{newsPublishDate}}
– Renders the the publish date of the news item.{{newsExpiryDate}}
- Renders the expiry date of the news item.{{newsLastUpdated}}
- Renders the date the news item was last updated.{{newsIsEnabled}}
– Defines whether the news item is enabled for display.{{newsTags}}
- Renders a list of tags that are assigned to the news item.{{newsCounter}}
– Incremental count of the number of news items on the page.{{newsButton | text:"Your Text"}}
– Displays a button that clicks to the news item details. Does not render on detail page. (Future release)