Dan Bartels

Starting with CS2008 telligent introduced the ContentFragementList as well as several out of the box widgets.  This is pretty much old news, but I thought it would be good to cover a very basic scenario...

User story:  An admin of a site wants the ability to add a news flash from time to time, that appears on the right sidebar of all pages on their site..

To accomplish this we will add a <CSControl:ContentFragmentList> to the master.Master in the left sidebar column (above the lcr content region)

Add the following markup to the master.Master just about the LCR <asp:ContentPlaceHolder> : (Update the CssClasses as appropriate for your sidebar)

<CSControl:ContentFragmentList runat="server" Property="SiteSideWidgets">
<ItemTemplate>
<CSControl:ContentFragment runat="server">
<LeaderTemplate>
<div class="CommonContentBox">
<CSControl:ContentFragmentData Property="FragmentHeader" runat="server" Tag="H4" CssClass="CommonContentBoxHeader" />
<div class="CommonContentBoxContent">
</LeaderTemplate>
<TrailerTemplate>
</div>
<CSControl:ContentFragmentData ResourceName="ViewMore" LinkTo="More" runat="server" Tag="Div" CssClass="CommonContentBoxFooter" />
</div>
</TrailerTemplate>
</CSControl:ContentFragment>
</ItemTemplate>
</CSControl:ContentFragmentList>

To make this new ContentFragmentList accessable for editing via the control panel; edit your theme.config file and add the following to your <dynamicConfiguration> section.

Assuming you are using something similar to the Hawaii theme, you will already have a <propertyGroup> called sidebar, so add the following <property> to it...

<property id="SiteSideWidgets" Text="Site Widgets" applicationTypes="Core" dataType="Custom" controlType="CommunityServer.Controls.ContentFragmentsCustomControl, CommunityServer.Controls">
<defaultValue>
</defaultValue>
</property>

We will leave the default template blank, so when the time comes, the administrator can go into "Site Administration" under the Control Panel, to the "Site Content" / "Site Theme" tab, and in this case, you should see a "Sidebar" tab in the theme editor, and on that page, see the widget box to configure your new site wide widget panel.

Now the site admin, can add a highighted post, or even a "Generic Content" widget, to type an HTML note, all users will see on all pages of the site.

You can find much more detail about these controls at Ben Tied's post on the subject.

http://getben.com/archive/2008/04/18/community-server-2008-how-to-support-widgets-in-a-custom-theme.aspx

Note: even though you have defined this ContentFragmentList in a site wide location, because there are several different theme areas (a blog theme, and hub theme) you will need to add the <property> to a <DynamicConfiguration> <PropertyGroup> for each of these where you want the content to be visible.  It is not currently possible to have a ContentFragmentList share its configuration between different themes.

Open a command window and run

servermanagercmd -install telnet-client

and your windows will install telnet for you.

Dan

Telligent has a Windows Service job which can be run to offload some of the Tasks / Job processing from your web server...  The most common configuration is to use the task server for running the Enterprise Search Indexing jobs, although you could use it to do your Search Barrel Indexing as well... 

The second most common item is to use the tasks service to send outgoing emails...  Communityserver queues emails into the SQL database by default, and uses a "job" to send them.

The key to using the Telligent tasks service for a job that normally runs under the web site is setting up the CommunityServer "context" in the task service...

This involves copying a few items your cs site folders, into the tasks service folder:

• languages folder (and its sub folders)
• siteurls.config
• communityserver.config
• connectionstrings.config 
• dlls from your web/bin folder

It is not necessary to remove any tasks from your communityserver.config, as the tasks service loads its task list from the tasks.config file...

Finally you need to edit the tasks.config to set up the cs context object for your site..  To the tasks.config file

Add to the \tasks node:

  <Sites>
   <add name="[AppName from your aspnet_Applications table] " siteUrl="[site url without http://]" />
  </Sites>

and

   <Modules>
    <add name="SiteSettingsModule" type="Telligent.Tasks.CommunityServer.SiteSettingsModule, Telligent.Tasks.CommunityServer" />
    <add name="ServiceTaskModule" type="Telligent.Tasks.ServiceTaskModule, Telligent.Tasks" />
  </Modules>

and then you should be able to configure the email task by adding a thread to the \tasks\threads node

     <Thread minutes="5">
      <task name = "Emails" type = "CommunityServer.MailRoom.Components.EmailJob, CommunityServer.MailGateway.MailRoom" enabled = "true" enableShutDown = "false" failureInterval = "1" numberOfTries = "10" />
    </Thread>

This will use the SMTP server set in your database (its set via the administration section of the CommunityServer Control Panel / Settings / Email Settings; and send your emails to the SMTP server every 5 minutes.

Dan

Yes, well now it seems like everyone is making one; and many users have two or three...  Google has launched Chrome http://www.google.com/chrome the latest development in the browser wars...  We have IE8 shaping up (currently in beta 2 form) and Firefox 3 now out; and what seemed like a "nice try" by apple to bring Safari to the Windows world...  (Thats all of course failing to mention the exploding mobile browser market)

It sure is hard to remember the good old days, when Microsoft crushed netscape and it looked like for better or worse there was only one browser that mattered.  All this competition is good, but it leaves the web developers in the middle, trying to support each browsers peculiarities in order to ensure site visitors a consistent experience.

Dan

From time to time I find myself pulling down a live Community Server database for testing.  When the database also has a remote membership system it can be very time consuming to try to download and configure both a CS database and a Membership system and keeping those databases in sync.

I have created a SQL script which can create simple membership data for all the membership in a CS database.  You set the application name, and script allows you to specify the name of one user which will be added to the system administrator role.  It will create the asp.net membership tables and entries as necessary, it auto assigns all other users to the everyone role; and sets any user passwords to "password" (obviously this is just for local testing).

This script builds an ASP.NET 2.0 Membership system, for use by CS2007 and CS2008 databases.

Dan

As announced way back at CSDC 07 (http://kevinharder.com/blog/live-blogging-the-csdc-part-3/) graffiti was designed to be able to integrate directly with an existing asp.net membership store...  the key is in the configuration....

So first thing is to get the membership set up...  this requires several changes to your web.config on your graffiti site...

You will need a connection string in the <ConnectionStrings> section pointing to the database which has your asp.net auth tables.. it will look something like this...

<add name="Graffiti_ASPNetMembership" connectionString="server=(local);uid=;pwd=;Trusted_Connection=yes;database=CommunityServer" />

Since I am using an active community, I will go to the CS site and create the default graffiti roles...  (gAdmin, gManager, and gContributor, and add you current admin to the gAdmin role)... Otherwise you need to run the script "Graffiti_ASPNet_Membership_Provider_Data.sql"; this script will try to create a new application so you really only want to run portions of it, ensuring the correct applicationid guid in order to have all logins under a single aspnet forms auth "application".

Next you need to update the "User Provider".

<add key="Graffiti::Users::IGraffitiUserController" value ="Graffiti.Core.ASPNetGraffitiUserController, Graffiti.Core"/>

and finally uncomment the included <membership />, <roleManager /> and <profile /> sections of the web.config; be sure to update the applicationName property of each by default graffiti uses "/graffiti" for the application name, by default cs uses "dev"  if you want to use existing cs users, you will need the application name that exists in your aspnet_Applicaitons table.

Thats it...  you should be able to log into graffiti using your existing cs users...  but wait, theres more...  we can now do shared authentication / single signon with a few more steps...

First, you will need to specify validation and decryption keys for all the applications you want to share logins... this goes in the web.config under <system.web> (edit the guids a bit for security)

<machineKey
validationKey="F090935F6E49C2C797F69BBAAD8402ABD2EE0B667A8B4
AD972A119482D15A4127461DB1DC347C1A63AE5F1CCFAACFF1B72A7F0A281B"
decryptionKey="ABAA84D7EC4BB56D75D217CECFFB9628809BDB8BF91CFCD64568A145BE59719F"
validation="SHA1"
decryption="AES"
/>

*Note: if you are updating an existing applicaitons machine keys, you should really change the name of the "auth cookie" to prevent existing persisted logins from getting a decryption exception.  This will also force all users to re-login...

As infered by the note above, we have to use the same cookie names for our applications... this is done by editing the <authentication> section of the web.config (I typically just link to the existing communityserver cookie, by changing the graffiti web.config as below)

<authentication mode="Forms">
<forms name=".CommunityServer" protection="All" timeout="60000" loginUrl="~/login/" slidingExpiration="true"/>
</authentication>

*Note: you could redirect all users to the cs login page by providing an absolute path to the login url, the page will redirect back to the graffiti site properly; this also has the advantage of leveraging the CS registration forms and process.

and finally we need to use the same cookie name for the <roleManager> by editing the cookieName property...  again I set the property in graffiti equal to the default cs value ".CSRoles" (without this step, your username will show in graffiti, but if you didn't use the graffiti login form, you would not have any more permissions on the site than anonymous, until you re-logged in).

A few items of interest...  at this time it appears that graffiti lowercases all the user names, and uses that for the "ProperName" so CS users without an extended attribute "ProperName" will only see their lowercased user names, a CSModule would be a good way to keep display name in sync with this "ProperName" field.  Of course you will have to use the CS membership system to edit your users; but it appears that graffitis "people" page can only be used to edit users in the local graffiti database anyways (likely the only user you will see in graffiti is admin).

Dan

CS Rest Endpoints return XML, but JSON is much cooler for working with the data in javascript, you can get the results back in JSON and actually iterate through collections and such...  To convert the data to JSON, in leu of server calls to do this, Thomas Frank has posted a nice JS library to pull this off...

http://www.thomasfrank.se/xml_to_json.html

Dan

With the release of CS2008, we have released the REST webservice code for the first time...  This webservice has a client API which is used by the server, and actually is in the bin folder of your CS site...  CommunityServer.WebServices.dll.  Referencing this file in a project will allow you to do things like.

Service rest = new Service("http://localhost/cs");
List<BlogGroup> blogGroups = rest.Blogs.GetBlogGroups();

This is all being documented here at http://api.communityserver.org

There are some places however, where the client api might not yet have an implementation for accessing endpoints on the server.  For those cases I wrapped and exposed the communications calls in the dll.  Allowing for calls like.

ManualRequest rest = new ManualRequest("http://localhost/cs");
BlogGroupListSerialized blogGroupListSerialized =
rest.Get(rest.Urls.BlogGroupsUrl()).GetResponseObject<BlogGroupListSerialized>();

The methods return strings, which are XML..  So you can use the GetResponseObject to get the related Type, or just use XPath and open the doc as native XML.

A place where we are missing some client api methods for example are things like post extedned attributes or ratings...

RatingListSerialized ratingListSerialized = rest.Get(rest.Urls.BlogPostRatingUrl(blogId, blogPostId));

or

//rate a post with 4 stars
int responseRating = rest.Put(rest.Urls.BlogPostRatingUrl(blogId, blogPostId, username), "<int>4</int>");

Extended attributes are availabe for "Section" objects, "Post" objects and "User" objects (except for posts in a group / hub)

endpoint urls would be like

/api/blogs.ashx/blogs/{blogid}/attributes returns an ExtendedAttributeListSerialized object which is a list of ExtendedAttributeSerialized objects (Supports GET HEAD and POST)

ExtendedAttributeListSerialized attributeListSerialized = rest.Get("http://localhost/cs/api/blogs.ashx/blogs/10/attributes");

or

/api/blogs.ashx/blogs/{blogid}/attributes/{attribute name} which returns a <string> (Supports GET HEAD PUT and DELETE)

string attribute = rest.Get("http://localhost/cs/api/blogs.ashx/blogs/10/attributes/abouttitle");

Only site admins can access extended attribute urls. You PUT and POST XML encoded strings...  like <string>Hello World</string>

A compiled DLL (DanBartels.CS.REST.Dll) is included as well as the source and some basic unit tests...  Assuming you have your CS install available with the sample data at http://localhost/cs

Dan

I have enjoyed streaming a vast variety of Internet music for some time...  I like the ability to discover new artists and music as well as a nearly infinite selection of styles and artists to suit my mood. 

I have to say of all of the services I have tried, Yahoo music did the best.  They had a decent selection of downloadable music, but even more content they could stream to you, and I made great use of their "Artist Fan Station" Feature...  which let you browse to an artist, and hear similar music, either by that artists or by other artists which were rated highly by people who liked that artist.  They made extensive use of their music and artist rating systems to datamine information, the result was very good;  Their client software, Vista, and then X64 support was terrible...  and left me searching for a new music service..

So I tried URGE, Microsoft's answer... well it worked in X64 and supported plays for sure; even used the same back end data of Yahoo music for the library, but their client was dumb, dumb, dumb...  a few celebrity raido stations, bad "similar artist" selections, no access to music that wasn't downloadable; which cut the artist and song selection way down for me...  and ultimately I couldn't find any music I wanted to listen to that I didn't already own.

Then came Zune...  Well its better, but again their UI is frustrating, you cant really discover anything, unless its new and advertised to you "Clear Channel Style"...  So much for broadening your music tastes, or discovering new artists..  and they seemed to do away with the idea of radio stations all together....  And ratings, well I guess I wast sophisticated enough to rate my own music...  So there were starts, but I don't know where they came from...  The future ui, got worse not better, it got even harder to make your own playlists, apparently if they weren't going to do "stations" then neither should you...  If this wasn't pretty much the only way to manage music on my mp3 player, it would be so uninstalled. (just waiting for the USB Mass Storage Driver for the Zune, so it will show up as a drive letter, no wonder why Microsoft doesn't want one out there)...

Then relief finally came my way...  A really nice radio station only type of service...  Pandora.com...  O and its free...  You set up your own stations based on artists or songs you like, and it streams away; the music index is based off the Music Genome Project a database of music based on musical styles and characteristic (not marketing and advertising departments)...  their client is flash based, and so it runs in your browser...  if you find a new song or artist, you can just bookmark it, and head over to Amazon and pickup the Mp3's ... no drm, no hassle, no subscription, and off you go... 

If you haven't tried Pandora, I strongly recommend you check it out.

Thanks for the tip Wyatt

Dan

Ran across these couple of tips on the Internet the other day, and thought I would pass them along...

First, my own tip, make sure you have the latest video driver installed...  chances are pretty good that your video card is the lowest  ranked item in your preformance index, its amazing what a new driver can do for the performance and stability of your system (not always a good thing, but in general its a good idea to keep your driver updated).

Second, disk performance...  Vista has advanced output caching support for SATA drives...  if you have a batter backup, or are on a laptop...  Go into device manager, and right click on your disks, select properties, then on the policies tab, mark the "Enable Write Caching" and "Enable Advanced Performance" options.

Lastly, I would recommend disabling the network "auto tuning" feature, its supposed to dynamically adjust the packet size for network performance, but lets face it, our home networks are not what this was targeted at.  Its actually hurting your network performance, by trying to tune it...  Open an administrative command prompt, and type....   "netsh int tcp set global autotuninglevel=normal"

The attached article also talks about how to disable UAP, the popup asking for administrative permission when you do a task that requires it...  I run with UAP enabled, but I realize most people despise it...  There is a nice tool out there...  Tweak UAC to help kill the feature, if you are in need of that, this should help you get it done (http://www.tweak-uac.com/)

Dan

http://vista.blorge.com/2008/02/25/how-to-fix-three-broken-features-of-vista/

In CS 2008 we have our javascript files linked through the scriptresource.axd handler.  This is very similar to the webresource.axd handler in that it serves content from within a dll.  The gotcha is that the scriptresource handler will throw an exception if the timestamp of the assembly is newer than the current server time...  This is not timezone aware.

The result...  Your in central time, you compile CS, and deploy it to your server in say pacific time, and vola...  you get javascript errors....  why?  well the scriptresource.axd will throw an exception because it thinks the dll is invalid because its timestamp is newer than the server time....  the error magically goes away in two hours, because now the server thinks the dll time is ok...

Its important to note, this is not a CS bug, but rather how the Microsoft script handler scriptresource.axd is coded. 

To work around the issue, set the time on your development workstation to the same time as your server, before you build.

Dan

Microsoft has made the current release of Vista RC1 available to early adoptors via Windows Update or as a stand alone download (~850mb).

http://www.microsoft.com/downloads/details.aspx?FamilyID=9de6260e-4275-482d-9524-de850c4dd91c&DisplayLang=en

Dan

You may also note a Office 2007 Sp1 was released today

http://office.microsoft.com/en-us/downloads/default.aspx?ofcresset=1

The Vista SP1 Download is a small Zip file with some documentation and a registry script to make it so you can see the SP in Windows Update

reg delete HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\VistaSp1 /f > NUL 2>&1
reg delete HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\WindowsUpdate\VistaSP1 /f > NUL 2>&1

reg add HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\VistaSp1 /v Beta1 /t REG_SZ /d c92ef077-adc4-46ef-b96b-02a42d60ede5 /f

Further, you can get the stand-alone installers at

32 bit - http://www.microsoft.com/downloads/details.aspx?FamilyID=be34577a-e925-48fb-9d6d-50fe9461f808&DisplayLang=en

64 bit - http://www.microsoft.com/downloads/details.aspx?FamilyID=c21c3978-3b7d-4d64-873b-3c9d26982d7a&DisplayLang=en

We are having an awesome time at the Community Server Developers conference, developers from around the country world have converged to hear about the future and direction of Telligent development.

Kevin Harder has been blogging the event for those who can only attend in spirit.  We have been recording all of the presentations; and hopefully our video blogging champion Ado, will have some downloads soon...

Dan

Check out the live blog at

http://kevinharder.com/blog/archive/2007/10/20/live-blogging-the-csdc.aspx

http://kevinharder.com/blog/archive/2007/10/20/live-blogging-the-csdc-part-2.aspx

http://kevinharder.com/blog/archive/2007/10/21/live-blogging-the-csdc-part-3.aspx

The current installer locks access to the disk open, so if you did something, like asked it to "format" your disk prior to installing Windows Server 2008, the format process will silently fail, the copy files will silently fail, and you will get a x8007045d during the expanding files portion of the install. 

You will need to reboot, choose repair instead of install, click next on the choose OS dialog, then command prompt, and manually format your drive (format c:).  You should then be able to continue the installation.

Dan

As I speculated based on internet rumors nearly a year ago (http://blog.danbartels.com/archive/2006/12/26/good-bye-yahoo-music-hello-zune.aspx)  Amazon has jumped into the online music sales foray...  Now you didn't need to be psychic to guess this, it seems to be a natural fit for the e-tailer.  While the .89 and .99 cent 256 kbit Mp3 tracks are arguably more expensive that Russian site (AllOfMp3.com and their derivatives) its nice to have a DRM free music choice in the popular Mp3 format.

Check out their selection Amazon.com Mp3

I just hope that now that they have built the marketplace, they find ways to play nice with the independent music scene,  I would also love to see a subscription option! 

Dan