Click here to Skip to main content
12,358,510 members (62,388 online)
Click here to Skip to main content
Add your own
alternative version

Stats

25.4K views
99 downloads
23 bookmarked
Posted

A "Most Viewed Blog Posts" Control for Community Server 2.0

, 15 Sep 2006 CPOL
Rate this:
Please Sign up or sign in to vote.
A web user control and class that displays the most viewed blog posts for a single blog.

Introduction

I developed a blog (http://www.pushingback.com) for one of Lockheed Martin's civilian government agency clients using Community Server 2.0. One of a number of nice features the product offers is a blog aggregation page that displays the most viewed and most commented-on blog posts in separate sidebar widgets in descending order. One of our project requirements was to implement this functionality for the single blog we're doing. Since Community Server 2.0 didn't offer this feature out of the box at the time, it meant I would have to build it.

Background

Community Server 2.0 combines a number of previously-separate, Open-Source projects on the .NET platform that provides blogging, forums, photo gallery, and other functionality. The vendor, Telligent Systems, markets it as a platform for collaboration and knowledge management. The product can be customized quite significantly because virtually all the source is open. Lockheed Martin used an earlier version (Community Server 1.1) to build an extranet for the nation's AMBER Alert coordinators.

Features

  • Number of links displayed can be set via a tag attribute
  • Title length can be shortened via a tag attribute

Developing the Code

The most flexible way to customize the look-and-feel of a Community Server blog is to develop a theme. Once you've installed Community Server 2.0 on your machine, the [installdir]\Web\Themes\Blogs folder provides nine sample themes for you to choose from. I needed a three-column layout for this blog, so I copied the "Marvin3" theme to a new folder. We'll name the folder "MyBlog" for the purpose of this article.

The next step was to modify LayoutTemplate.ascx so it would display the "most viewed" widget on the blog. Once modified, the HTML for the right-hand column looked like this:

<div id="sidebar-b">
  <Blog:WeblogCalendar runat="Server" id="Cal" /> 
  <Blog:SingleWeblogSearch runat="Server" id="sw" NAME="sw"/>
  <Blog:CategoryList ResourceTitleName = "Weblog_PostCategories_Label" 
               runat="Server" id="Categorylist1"/>
  <!-- Start of Most Viewed blog entries-->
  <MBC:MostViewed runat="server" id="mv" PageSize="3" />
  <!-- End of Most View blog entries-->
  <Blog:Subscriptions runat="Server" id="subs" />
</div>

As you can see from this tag prefix:

<%@ Register TagPrefix="MBC" 
    Namespace="MyBlogControls" Assembly="MyBlogControls" %>

I chose to store the logic for the control in a separate assembly. The primary reason for this was the number of custom controls this project required. In the vast majority of cases, the core controls of Community Server 2.0 are also built in this fashion.

After modifying LayoutTemplate.ascx, I needed to create a skin for the MostViewed tag to retrieve. By convention, skin files in Community Server are named "Skin-[skin name].ascx", so I created a file named Skin-MostViewed.ascx. Here's the entire file:

<%@ Register TagPrefix="CS" Namespace="CommunityServer.Controls" 
             Assembly="CommunityServer.Controls" %>
<%@ Control Language="C#" %>
<h3><CS:ResourceControl id="MostViewed" 
             runat="Server" ResourceName="MostViewed" /></h3>
<ul>
<asp:Repeater Runat="server" ID="posts">
 <ItemTemplate>
 <li>
  <asp:HyperLink Runat="server" id="TitleLink" />
 </li>
 </ItemTemplate>
</asp:Repeater>
</ul>

I placed the Repeater inside unordered list tags and the HyperLink control between list item tags so the stylesheet would format them in a way that matched the other controls in the column. Without the additional tags, the links displayed as left-justified, instead of lining up with the other links in the right-hand column.

With Skin-MostViewed.ascx complete, the work remaining was the logic to retrieve the most-viewed blog posts and bind them to the Repeater in the skin. Most of the code for actually retrieving the appropriate blog posts came from reading core source code of Community Server and a few extremely useful posts by Keyvan Nayyeri. Here's the code that actually gets the appropriate posts:

private WeblogPost[] GetMostViewedPosts(int PageCount)
{
    Weblog weblog = Weblogs.GetWeblog(CSContext.Current.ApplicationKey);
    BlogThreadQuery query = new BlogThreadQuery();
    query.SectionID = weblog.SectionID;
    query.SortBy = BlogThreadSortBy.MostViewed;
    query.SortOrder = SortOrder.Descending;
    query.PageSize = PageCount;
    query.PageIndex = 0;
    ThreadSet posts = WeblogPosts.GetBlogThreads(query);
    ArrayList al = new ArrayList(posts.Threads.Count);
    foreach(WeblogPost p in posts.Threads)
    {
        al.Add(p);
    }
    return (WeblogPost[])al.ToArray(typeof(WeblogPost));
}

The array returned by this function is the data source that will be bound to the Repeater in Skin-MostViewed.ascx. When I was testing my code, I found that if query.SectionID isn't set to weblog.SectionID, the links that display will be for the entire Community Server installation, instead of the selected blog. The PageCount parameter allows the developer to set how many "most viewed" posts are displayed. Rather than hard code a value, I created a public PageSize property which could be set to the desired value using a tag attribute.

GetMostViewedPosts must be called before data is bound. In order to ensure this, the MostViewed class overrides AttachChildControls and DataBind. It also contains an event handler for setting specific attributes of the HyperLink in Skin-MostViewed.ascx. One useful feature the custom control provides is the ability to set how many characters of the blog post title are displayed in the control. Here's the snippet of code from the event handler that controls this:

if (TitleTextLength > 0) 
{
    titleLink.Text = Formatter.CheckStringLength(post.Subject, TitleTextLength);
    titleLink.NavigateUrl = BlogUrls.Instance().Post(post);
    titleLink.ToolTip = post.Subject;
}

Conclusion

The MostViewed control provides a useful enhancement to individual blogs in Community Server 2.0. If Telligent hasn't already built this functionality into the as-yet-unlaunched Community Server 2.1, I will probably do so for ease of use on future projects.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Scott A. Lawrence
Web Developer
United States United States
Scott has been involved in the design and implementation of database-driven websites since 1996. He's earned a B.S. in computer science and an MBA from the University of Maryland College Park.

His career in technology to date includes consulting and IT department work for companies including The Washington Post, Claritas, USWeb/CKS, Ciena Corporation, and Lockheed Martin IT. He currently works as a software development manager at APS Healthcare, Inc.

Scott lives in Wheaton, MD. To contact him, send e-mail to slawrence@gmail.com.

You may also be interested in...

Comments and Discussions

 
Generalgood Pin
vik2017-Sep-06 4:42
membervik2017-Sep-06 4:42 
QuestionWhat happened to the source code download? Pin
Russel Harvey10-Jul-06 14:23
memberRussel Harvey10-Jul-06 14:23 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.160621.1 | Last Updated 15 Sep 2006
Article Copyright 2006 by Scott A. Lawrence
Everything else Copyright © CodeProject, 1999-2016
Layout: fixed | fluid