Upgrading a Community Server 2007 Site Theme for Community Server 2008

The following procedure describes how to upgrade a Community Server 2007 site theme to Community Server 2008.

A number of changes were made to the underlying API in Community Server. While the following steps should cover most themes, if a Community Server 2007 theme relied heavily on inline code, some of the API references may no longer valid. In themes that make frequent use of inline code, Telligent suggests that you manually review all of the inline code of the theme to ensure that it is valid in Community Server 2008.

Procedure

1. Remove the following files and folders that are no longer used in Community Server 2008l.

• Files/ folder
• Galleries/ folder
• Roller/ folder
• User/privatemessagelist.aspx file

2. Search and replace operations in the custom theme files. Use a tool such as EmEditor that can perform search-and-replace operations within files in a folder (including sub-folders) to make the following case-insensitive replacements across all files in the custom themes:

• LinkTo="UserPrivateMessages" to LinkTo="UserConversations"
• LinkTo="PrivateMessage" to LinkTo="SendConversationMessage"
• ImagesBaseUrl="~/Themes/default/images/common/" to ImagesBaseUrl="~/utility/images/"
• Src="~/Themes/default/common/UserWelcome.ascx" to Src="~/utility/usercontrols/UserWelcome.ascx"
• Formatter.Truncate( to Formatter.MaxLength(
• Formatter.CheckStringLength( to Formatter.MaxLength(
• Formatter.StripAllTags( to Formatter.RemoveHtml(

3. Remove or replace all <CSFile:> and <CSGallery:> prefixed controls in your custom themes with an appropriate <CSMedia:> prefixed control. Use a search tool to find the following:

• <CSFile:
• <CSGallery:

4. Update the following occurrences of inline code:

• Formatter.FormatAgoDate
• Formatter.WhiteSpace
• Formatter.FormatUsername

Telligent recommends that you review the corresponding theme file from one of the Community Server 2008 themes and modify your custom themes accordingly.

5. Copy the new files and folders from existing Community Server 2008 themes such as Hawaii, Calypso, and Lean and Green (which support all Community Server 2008 features) to your custom theme’s master pages and files. The following files and folders are new to CS2008:

• User/activitylist.aspx file
• User/announcementlist.aspx file
• User/commentlist.aspx file
• User/conversation.aspx file
• User/conversationlist.aspx file
• User/createeditconversation.aspx file
• User/createeditprofilemessage.aspx file
• User/editapikeymodal.aspx file
• User/editapikeys.aspx file
• User/favoritelist.aspx file
• User/friendshiplist.aspx file
• User/requestfriend.aspx file
• User/userfile.aspx file
• User/userfilelist.aspx file
• User/userfileslideshow.aspx file
• Utility/insertmedia.aspx file
• Media/ folder
• Hubs/ folder

6. Copy the files in the Community Server 2008 themes that have been heavily modified to support new features to your custom theme’s master files and restyle them. The following theme files have been significantly modified in Community Server 2008:

• Forums/createeditforumpostform.aspx
• Forums/thread-threadedview.ascx
• User/edituser.aspx
• User/userprofile.aspx
• Utility/selectcontent.aspx

Also make sure you review the CSS classes and rules used by the Community Server 2008 theme files as you copy them to your custom themes. The copied theme pages will render the content in your custom theme files, but without the associated CSS style rules the pages may not render well.