Sitefinity CMS

Blogs Public Controls Send comments on this topic.
See Also
Sitefinity Building Parts > Modules > Generic Content Based Modules > Blogs > Blogs Public Controls

Glossary Item Box

This topic provides a description of the public controls of the Blogs module available in Page Edit mode:

Blogs: Public Controls

Figure 1

Blog Posts

Description 

This is the Blogs public control that is based on theContent View control . Blog Posts is the only available control that displays one or more blogs.

There is no longer a separate control that displays single posts. The Blog Posts control should be used instead.

Figure 2 shows what the BlogPosts control displays after added to a page. The control is bound to an already created blog item. For more on blog items creation and manipulation, see Blogs Overview

Blogs Public Controls: BlogPosts Content Display

Figure 2

 

Setting the Public Controls

Following are some basic settings that need to be made to work with the Blog Posts control:

       1. Behavior section: DisplayMode should be set to Auto
       2. Behavior section: Visible should be True
       3. Behavior section: ParentIDs should be set to the blogs to be displayed
       4. Data section: ProviderName should contain the name of the provider
       5. Paging section: AllowPaging to True

 

Figure 3 illustrates the available sections for the Properties of BlogPosts:  

Blogs Public Controls: BlogPosts Properties Sections

Figure 3 

  

Social Bookmarks

Soical Bookmarks are a new feature added to the Blogs module. They are added at the end of each post.

Enabling This Feature

In order to use this feature, check the Social Bookmarks checkbox in the third step of the Blogs Basic tab of the Properties. Another way is to change the BookmarkEnabled property in the Social Bookmarks section in the Advanced Tab to True (see Figure 4).

Blogs Public Controls: Social Bookmarks Property of Blog Posts Control

Figure 4

 

Other Social Bookmark Properties

There are two properties called SocialBookmarkImageFolder and SocialBookmarkTemplate. The former holds the images to be shown, and the latter is the template of the bookmark list.

The default URL is for imageFolderPath is  ~/Sitfinity/ControlTemplates/Blogs/SocialBookmark

The default url is for TemplatePath is  ~/Sitfinity/ControlTemplates/Blogs/socialBookmarkTemplate.xml

This can be changed either from the blog section under genericContentElement in web.config or from the properties of the BlogPosts control.

 

The site must be hosted in a public location prior to testing this feature. Some social provider validates the url, otherwise a "bad url" exception is thrown.

 

Bloggers

Description 

This is the Blogs public control that displays a list of active bloggers (people who create blogs or add content to them).

 

Setting the Public Controls

Following are some basic settings that need to be made to to work with the Bloggers control:

       1. Behavior section: Visible should be True
       2. Behavior section: ControlTitle should be set to the desired title
       3. Behavior section: NumberOfMonthsForActiveBloggers to number of months for which a blogger is allowed to be inactive and still be considered an active blogger
       4. Data section: ProviderName should contain the name of the provider
       5. Click on the Blog Settings link in the Modules -> Blogs tab, for a specific blog. In the comments region, select a specific blog page that will be displayed when a blogger is accessed in the Blogger list

 

Figure 5 illustrates the available sections for the Properties of Bloggers:

Blogs Public Controls: Bloggers Properties Sections

Figure 5

 

Archive

Description 

This control displays blogs filtered by date. Expired blogs are also included. 

 

Figure 6 demonstrates how are blogs organized and displayed on a page after adding the Archive control:

Blogs Public Controls: Archive Display

Figure 6

 

Setting the Public Controls

Following are some basic settings that need to be made to work with the Archive control:

       1. Behavior section: ParentIDs should be set to the blogs to be displayed
       2. Data section: ProviderName should contain the name of the provider

 

Figure 7 illustrates the available sections for the Properties of Archive:

Blogs Public Controls: Archive Properties Sections

Figure 7

 

Calendar

Description 

This control displays a calendar with dates enabled only when there is a blog published on that day.  

 

Figure 8 demonstrates what the Calendar control displays after it is added to a page. When there is a blog published on a particular date, there is a link underneath it. As shown in Figure 7, the red rectangles are dates that contain one or more blogs. The other dates do not have links and are disabled.

Blogs Public Controls: Calendar Content Display

Figure 8

 

Setting the Public Controls

Following are some basic settings that need to be made to work with the Calendar control:

       1. Behavior section: Visible should be True
       2. Data section: ProviderName should contain the name of the provider; in this case - Blogs

 

Figure 9 illustrates the available sections for the Properties of Calendar:

Blogs Public Controls: Calendar Properties Sections

Figure 9

 

See Also