Serge van den Oever [Macaw]

Macaw Discussion Board... the way SharePoint discussions should work... and now do work!

The Macaw Discussion Board

This weblog post describes the immediate availability of a reworked and improved discussion board for Windows SharePoint Services and SharePoint Portal server providing last-post first views, a discussion thread view, and SWYRO (See What You Respond On). It is available on http://spsutil.sourceforge.net. This post is it’s documentation.

Introduction

It is great that SharePoint supports discussion lists, its a pity that their implementation is "suboptimal".

The two biggest problems that I have with the discussion lists are:

• When you reply on a discussion item, you don’t see the text you are replying on
• Discussion items are displayed in the wrong order: oldest items first!

Changing this behavior is not as easy as providing a new view. Some more work is required.

We worked around these limitations more than a year ago, but I never found the time to make these modifications available to the community. Until now…

The features

There are two views on a discussion:

• Complete thread index, latest started discussion thread at the top
  
• Latest posts view, shows the latest 40 posts with the newest post at the top
  

The thread index view provides the following information:

• Title of first post in thread
• Started by
• Number of Replies
• Last Post (date + poster)

On selecting a thread, a hierarchical view of this discussion thread is displayed:

If you are not sure from a certain reply on which post it is replying, you can select the “parent” link:

If you look at the content of a single post (for example after following a link from an alert e-mail), there is a view in thread link available to view the post highlighted in its complete discussion thread:

Some other interesting features:

• When you click on the name of a poster, you go to the UserInfo information on the user on WSS, and to the profile page of the user when on SharePoint Portal Server
• Complete support for presence detection on all user names
• Completely built on top of the standard WSS discussion board

Availability

The Macaw Discussion Board is available at http://spsutil.sourceforge.net. It is distributed as a SharePoint List Template: MacawDiscussionBoard1.0.stp.

And if you are looking for the sourcode: it’s all there. Just fire up your FrontPage 2003 and you can look right in to it! I hope your XSLT skills are a bit up-to-spec;-)

Installation

The MacawDiscussionBoard List Template is constructed for usage in standard WSS sites. Usage in Portal Area’s is not tested. To test it out, create an empty top level site:

Goto “Site Settings”, and select “Go to Site Administration”:
 

If you are on a top level site, you will see the option “Manage list template gallery”. If you don’t see this option, go to the top level parent of the current site and perform the actions from there:

On the List Template Gallery you can upload a new list template:

Specify the list template file, and press “Save and Closed”:

The List Template is now available, select “Create” to add an instance of this new template:

Select the MacawDiscussionBoard:

And you are done!! Congratulations!

If you want a more permanent availability of the list template, and you are a SharePoint administrator, you can add the list template using the stsadm.exe tool on the SharePoint server. See the Administrators Documentation for more information.

Troubleshooting

If the Macaw Discussion Board list template does not appear under Discussion Boards in the Create screen, you are probably in a site or area that does not support the list template. Please test first is a standard WSS site.

Limitations

The Macaw Discussion Board has some limitations. For the Thread Index view, information on all items must be retrieved on server side. Happely enough NOT the body text;-). This means that performance can degrade on discussion lists which huge amount of posts. We have a discussion list with over 2500 posts without any problems. Let me know if you run into trouble, we can make somethig up.

Configuration

Some things on the discussion board can be configured like the styles of odd/even/selected posts in a discussion thread, the indenting in a hierarchical thread view, and the formatting of date/time. To do this configuration open the pages of the Macaw Discussion Board in FrontPage 2003.

The following pages have configuration options (look for it in code view):

AllItems.aspx:

        <!-- CONFIGURATION SECTION FOR DISCUSSION RENDERING -->
        <!-- format of date time rendering, uses standard .NET format as specified in http://authors.aspalliance.com/aspxtreme/aspnet/types/datetimeformatstrings.aspx -->
        <xsl:param name="PostDateTimeFormat">dddd, MMMM dd, yyyy H:mm</xsl:param>
        <!-- END OF CONFIGURATION SECTION FOR DISCUSSION RENDERING -->
 

SingleThread.aspx:

        <!-- CONFIGURATION SECTION FOR DISCUSSION RENDERING -->
        <!-- style for odd/even/selected items in the thread -->
        <xsl:param name="OddItemStyle">background-color: #dddddd;</xsl:param>
        <xsl:param name="EvenItemStyle">background-color: #eeeeee;</xsl:param>
        <xsl:param name="SelectedItemStyle">background-color: Yellow;</xsl:param>
        <!-- format of date time rendering, uses standard .NET format as specified in http://authors.aspalliance.com/aspxtreme/aspnet/types/datetimeformatstrings.aspx -->
        <xsl:param name="PostDateTimeFormat">dddd, MMMM dd, yyyy H:mm</xsl:param>
        <!-- message when page in called without 'discussion' parameter -->
        <xsl:param name="NoThreadMessage">The Single Thread view can only display information if a thread is specified.</xsl:param>
        <!-- indentation level in pixels for threaded items in the tree -->
        <xsl:param name="TreeIndentation">10</xsl:param>
        <!-- END OF CONFIGURATION SECTION FOR DISCUSSION RENDERING -->

NewForm.aspx:

        <!-- CONFIGURATION SECTION FOR DISCUSSION RENDERING -->
        <!-- style for odd/even/selected items in the thread -->
        <xsl:param name="OddItemStyle">background-color: #dddddd;</xsl:param>
        <xsl:param name="EvenItemStyle">background-color: #eeeeee;</xsl:param>
        <xsl:param name="SelectedItemStyle">background-color: Yellow;</xsl:param>
        <!-- format of date time rendering, uses standard .NET format as specified in http://authors.aspalliance.com/aspxtreme/aspnet/types/datetimeformatstrings.aspx -->
        <xsl:param name="PostDateTimeFormat">dddd, MMMM dd, yyyy H:mm</xsl:param>
        <!-- message when page in called without 'discussion' parameter -->
        <xsl:param name="NoThreadMessage">The Single Thread view can only display information if a thread is specified.</xsl:param>
        <!-- indentation level in pixels for threaded items in the tree -->
        <xsl:param name="TreeIndentation">10</xsl:param>
        <!-- END OF CONFIGURATION SECTION FOR DISCUSSION RENDERING -->
 

Applying the Macaw Discussion Board changes to an existing discussion list

Note: The below procedure has not been extensively tested. You are on your own, so please know what you are doing!

It is possible to apply the Macaw Discussion Board to an existing discussion list. You can do this using FrontPage 2003.

• Make a backup of your site containing the discussion list to modify!!!
• Install the Macaw Discussion Board somewhere so you can access it’s pages usintg FrontPage 2003
• Lookup the list name of the existing discussion list (GuidExisting). Look for example at the code of the EditForm.aspx page. At the end you see the following line with the GUID which is the list name:
  <ListName xmlns="http://schemas.microsoft.com/WebPart/v2/ListForm">{2F9B130C-EDE0-47D5-AF8C-E0A9B696DFEA}</ListName>
• Lookup the list name for the installed Macaw Discussion Board (GuidMDB)
• Make a copy of all pages in the existing list (make for example a backup directory in the List folder (at the same level as you .aspx list pages). Don’t move the pages, otherwise the interrnal links for the list pages gets messed up!
• Copy over the pages of the Macaw Discussion Board instance to the existing list, overwriting the existing pages of your list instance.
• On all pages do a replace of the Macaw Discussion Board instance GUID (GuidMDB) with the GUID of the original list (GuidExisting).
• Remove any pages that are not also in the Macaw Discussion Board instance
• Done!!

If there is a need for an application that performs these actions, please let me know and *maybe* I’m in the mood to create one!

Licensing

Macaw Discussion Board License Agreement

You can use this Software for any commercial or noncommercial purpose, as long as the Macaw Discussion Board is not marketed and sold as if it is your own application. In return, we simply require that you agree: