This post was originally published in 2008
It may contain stale & outdated information. Or it may have grown more awesome with age, like the author.

Update I no longer use JS-Kit comments. I’ve reverted to the WordPress commenting system

In this short tutorial I will describe how to use the JS-Kit commenting system in Rapidweaver. By then end of this tutorial you will have learned how to insert the code into yor blog so that each post has its own comments – the comments will show in permalinks, category and tag versions of each post. When someone comments on a post, JS-Kit will notify you by email. Included in the email that you, and other people who comment then recieve replies are sent will be a link to the permalink entry of the post in which the comment is displayed. You will be able to use JS-Kitâ€™s excellent moderating system to manage your comments.

Iâ€™m going to go ahead and assume you want to integrate JS-Kitâ€™s commenting system with the JS-Kit ratings widget, like I have. If you donâ€™t just ignore the parts of the below tutorial that mention the ratings widget.

1) Open RW, select your blog page. Open the page inspector, select the â€œGeneralâ€ tab. Under â€œOverride Default Site Settingsâ€, check â€œFooterâ€. Copy the following code into this field:

1

<script src="http://js-kit.com/comments.js"></script>

To use the ratings widget as well, youâ€™ll want to add this code also:

1

<script src="http://js-kit.com/ratings.js"></script>

2) Close the page inspector – weâ€™re done with the tricky stuff.

3) This part can be rather tiresome – it depends on how many old posts you want to add the option to comment to.

At the very bottom of each post you wish to allow users to comment on, paste* the following code:

1

<div class="js-kit-comments" permalink=""></div>

If you want to use the ratings widget as well, you should paste this (below includes the above code – above is for those who do not want to use ratings, below is for those who want both):

Replace â€œPATH_TO_POST_PERMALINKâ€ with … the path to that postâ€™s permalink. Replace “/POST_TITLE” with the post’s title. Don’t use whitespaces or special characters in this attribute.* For example, this is what I have at the bottom of this post:

Luckily, JS-Kit is robust, and allows morons like me to make these mistakes. I now use the correct method, but haven’t changed my older posts. Why? Because the path attribute is the ‘directory’ in which JS-Kit stores comment/ratings information. This is how we can have two different pages with the same comments/ratings widget. This also means that we can move the widgets to different pages if/when the page is moved, without losing the important comments!

And thatâ€™s it! Comments should now be enabled for that post.

To moderate posts, youâ€™ll need to go to the JS-Kit Settings page. If you donâ€™t already have one, youâ€™ll have to create an OpenID account. Choose from the list of providers listed beneath the sign-in box.

If, after logging in you donâ€™t see your site anywhere, youâ€™ll need to â€œclaimâ€ it. Just enter the url of your site in the labeled text box, and follow the instructions. Theyâ€™ll send you an email, and once youâ€™ve followed the link included you will be able to moderate your siteâ€™s comments.

Enjoy!

If you would like to explore the options available to users of JS-Kit, head over to the website: JS-Kit.

*Remember to select the pasted code and either choose â€œFormat > Ignore Formattingâ€ from the RapidWeaver menu, or press â€œâŒ˜ + .â€

Always do this when pasting code. Always.

If you donâ€™t do this, there is a good chance that the code will break. Always do this!

As an added precaution, open the Page Inspector, go to the â€œGeneralâ€ tab and choose â€œOutput: Defaultâ€. This will stop RapidWeaver from inadvertently breaking PHP or HTML code.

It may have been technically wondrous from a painter's perspective, but I'm not a painter, so I just saw skulls. To be honest, I like CGI art better, partly because none of the old painters painted pictures of space ships or aliens, which I like.

Recent Posts

I had high hopes for Convoy, but time restrictions and changes to Rapid Weaver have made those hopes unrealistic. It is for these reasons that I must announce that Convoy will no longer be maintained or updated. I apologise to those of you who found…

Slider 2 was my first Rapid Weaver plugin. It is with a heavy heart that I announce its end of life. I believe that its utility is diminished in the current Rapid Weaver ecosystem that there is no longer any point to its existence. Happily,…