This module renders a list of Blogs within a website.
This module supports Liquid.
Syntax
{bb_blog source="" filter="" sort="" limit="" displayPagination="true" resultsPerPage="10" emptyMessage="No items found." collectionName="" layout=""}
Properties
- source – This parameter identifies the Blog from which to pull the data to render on a web page. If left blank, returns blog items from every Blog within a website.
- filter - The filter parameter is used to filter out a subset on blog posts using the fields and associated values build a filter string as follows:
filter="fieldname1:fieldValue1 | fieldname2:fieldValue2"
Each name-value pair needs to be separated using a pipe character "|". - sort - These fields can be used for sorting and builds a sort string as follows:
sort="blogName:Ascending | publishedDate:Descending | sortOrder:Descending"
- limit - Set the maximum number of posts to return.
- displayPagination - Renders the pagination section when there are more in the data items than the resultsPerPage value.
- resultsPerPage - When displayPagination is set to "true" this number will determine the number of items displayed in a page. Enabled only if displayPagination check box is checked. Default value is 10 items per page.
- emptyMessage - Your custom value that is rendered. Default text is “No items found.”
- collectionName - Use this parameter to access the Liquid tags.
- layout - Renders the module output using:
layout="Default" or layout="List View Layout"
- renders the default list view template "List View Layout";layout="My Custom Layout"
- a custom layout template (see How to create a custom Blog module layout);layout=""
- which allows you to code a custom layout using Liquid right within the Web Page HTML.
Liquid Tags
- {{blogId}} – Renders the system generated blog ID.
- {{blogName}} – Name of the blog with a hyperlink to the blog overview page.
- {{blogNameNoLink}} – Name of the blog without a hyperlink.
- {{blogDescription}} – Renders the description of the blog.
- {{blogPublishDate}} – Date to publish the blog.
- {{blogExpiryDate}} – Expiry date of the blog. If the blog Is expired, hides all blog posts.
- {{blogLastUpdated}} – Date of the last update to the blog.
- {{blogLastPostDate}} – Date of the last post of the blog.
- {{blogRecentPosts | count:20}} – Renders a simple <ul> list of recent post in a blog. Default is 10.
- {{blogPageList}} – Renders a list of all the pages in your blog. Provides a hyperlink to each page. Number of pages In a post list based on resultsPerPage. (Future release)
- {{blogTagCloud | count:20}} – Displays a tag cloud of a blog’s post. Default is 10.
- {{blogTagList}} – List of all tags used in all blog posts (Creates an unordered list)
- {{blogTagCount}} – List of tags and the count of each use of a tag in all blog posts
- {{blogPostList}} - List of all the posts within a blog (Uses the Blog Post List Layout)
- {{blogPostCounter}} – Incremental count of the items on the page.
- {{blogTotalPosts}} – Number of total post within a blog.
- {{blogPostArchive}} – Archive of previous blog post by month. (Future release)
- {{blogPostUrl}} – URL to the item referred without host.
- {{blogPostUrlHost}} – URL to the item referred with host. (Future release)
- {{blogPostId}} – System generated ID number for the current post.
- {{blogPostTitle}} – Title of the post with a hyperlink to the blog post.
- {{blogPostTitleNoLink}} – Title of the post without a hyperlink.
- {{blogPostAuthor}} – Renders the name of the post Author.
- {{blogPostAuthorImage}} – Renders the post author’s image or the Gravitar image associated with the author if that is selected. If no author image or no author exists for the blog post, renders nothing.
- {{blogPostAuthorImageUrl}} – The author’s image URL.
- {{blogPostCalendar}} – Calendar to retrieve blog post by date. (Future release)
- {{blogPostContent}} – Renders the HTML content of the blog post.
- {{blogPostFeaturedImage}} – Renders the post’s featured image URL. If no featured image exists, renders nothing.
- {{blogPostFeaturedImageUrl}} – The post’s featured image URL.
- {{blogPostFeaturedImageAlt}} - Alternate text for the Featured Image of the Blog Post. (Future released)
- {{blogPostPublishDate}} - Date and time the post was published. Liquid date switches can be used to access the day, year, etc.
- {{blogPostCommentCount}} – Renders the number of comments for the current blog post.
- {{blogPostCommentList}} –
- {{blogPostCommentRating}} - User rating in stars of the current post.
- {{blogPostCommentPending}} –
- {{blogPostComment}} – User comment on the current blog post.
- {{blogPostCommentDate}} – Date and time when the comment was submitted.
- {{blogPostCommentAuthor}} – Full name of the person who submitted the comment displayed as a hyperlink. Anonymous is not provided.
- {{blogPostCommentAuthorNoLink}} – Full name of the person who submitted the comment displayed without a hyperlink. Anonymous is not provided.
- {{blogPostPermalink}} – Renders a link for the permalink with anchor.
- {{blogPostPermalinkUrl}} – Renders the URL for the permalink.
- {{blogPostSeoTitle}} – SEO title for the Blog Post.
- {{blogPostSeoDescription}} – SEO description for the Blog Post.
- {{blogPostNextPage}} –
- {{blogPostPreviousPage}} –
- {{blogPostPagination}} – Enhanced pagination to navigate through blog posts. If enabled in in “displayPagination” module parameter.
- {{blogPostCommentsEnabled}} – true|false
- {{blogPostIsPublished}} – true|false
- {{blogPostTrackbackCount}} – Number of trackbacks for the current post.
- {{blogPostTrackbackUrl}} – Link for trackback.
- {{blogPostTrackbackList}} –
- {{blogPostCanonicalUrl}} -
- {{blogPostTags}} – Renders a
<ul>
list of the tags assigned to a blog post.
Comments
0 comments
Please sign in to leave a comment.