Integrate

The general code

With the code below, coComment will work in an optimal way on your blog:

• Ensures that titles and urls are correctly detected
• Enables all comments to be tracked
• Does not depend on your visitors using a bookmarklet or browser extension

JavaScript to add to your blog template

The following code should be added to the pages where your comment form appears:

<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{
     tool          : "MyBlogTool",
     siteurl       : "http://example.com/~myblog",
     sitetitle     : "Tom's Great Blog Title",
     pageurl       : "http://example.com/~myblog/?p=42",
     pagetitle     : "My \"Incredible\" Post",
     author        : "Douglas Adams",
     formID        : "commentform",
     textareaID    : "comment",
     buttonID      : "submit"
}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>
  

tool
name of the blog tool (choose a new one for new blog platforms)
E.g. "Blogger", "Xanga", "Kaywa", "MSN Spaces", "MySpaces", "TypePad", "Wordpress", "Flickr" etc.

siteurl
complete url of the blog
E.g. "http://www.domain.com/~myblog/"

sitetitle
title of the blog
E.g. "MyBlog"

pageurl
url of the post
E.g. "http://www.domain.com/~myblog/?p=19″

page title
title of the post
E.g. "This is Tom’s \"great\" post"

textareaID
the name of the comment text(area) containing the text of the comment when the form is submitted
E.g. for <textarea name="commentTextArea"></textarea> use "commentTextArea"

buttonID
name of the submit button
E.g. for <input name="SubmitButton" type="submit"> use "SubmitButton"

authorOR authorID

author
author of the post, as defined in the blog tool (not on coComment)
E.g. "Douglas Adams" (if the author is unknown, this entry can be left out)

authorID
name of the input field containing the author name defined in the blog tool
E.g. for <input type="text" name="authorName"> use "authorName"

formID
id of the form containing the comment message (if the form does not have an id, use formName OR formNumber instead)
E.g. for <form action="submit.jsp" id="commentForm"> use "commentForm"

formName
name of the form containing the comment message, e.g. comment-form (if the form does not have a name, use formID OR formNumber instead)
E.g. for <form action="submit.jsp" name="commentForm"> use "commentForm"

formNumber
number of the form containing the comment message, starting at 0 (if the form DOES have a name or id, use formName OR formID instead)
E.g. 3 for the fourth form in the page (if either comment-form-name or comment-form-id is given, this entry is ignored and can be left out)

If you prefer not to specify the type attribute in each of the script elements, you can omit it and add the following meta tag to your page header:

<meta http-equiv="Content-Script-Type" content="application/javascript" />
  

Example for WordPress

With WordPress, the easiest way to integrate coComment into your blog is to use the coComment Enhancer plugin, which injects the necessary code into your template.
If you want to do things by hand, here is the code you need to add to the comments.php page in your wordpress theme (found under /wp-content/themes/):

<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{
     tool          : "WordPress",
     siteurl       : "<?php echo get_option('home'); ?>",
     sitetitle     : "<?php bloginfo('name'); ?>",
     pageurl       : "<?php the_permalink() ?>",
     pagetitle     : "<?php the_title(); ?>",
     formID        : "commentform",
     textareaID    : "comment",

     <?php if ( $user_ID ) : ?>
     author : "<?php echo $user_identity; ?>",
     <?php else : ?>
     authorID : "author",
     <?php endif; ?>
     buttonID      : "submit"
}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>

Note: the Show coComments sidebar widget allows you to easily display your comments or conversations on your WordPress blog. It also works as a plugin if you don't have a integrate.wordpress.note4 theme.

Example for TextPattern

By adding the following code to the /comment_form/ form (under the presentation tab), coComment is supported on TextPattern:

<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{
     tool          : "TextPattern",
     siteurl       : "Replace with URL of your blog",
     sitetitle     : "Replace with Title of your blog",
     pageurl       : "URL of your blog then add the following: /?id=",
  /*                      e.g. "http://www.ballpark.ch/blog/?id=",          */
     pagetitle     : "",
     authorID      : "comment_name_input",
     formID        : "txpCommentInputForm",
     textareaID    : "message",
     buttonID      : "submit"
}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>

Example for Serendipity s9y.org

Use the following code provided by Beat Menzi to make Serendipity blogs compatible with coComment. (included in commentform.tpl):

<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{ldelim}
     tool          : "Serendipity",
     siteurl       : "{$serendipityBaseURL|@escape:javascript}",
     sitetitle     : "{$blogTitle|@escape:javascript}",
     pageurl       : "{$commentform_entry.rdf_ident|@escape:javascript}",
     pagetitle     : "{$commentform_entry.title|@escape:javascript}",
     author        : "{$commentform_name}",
     authorID      : "serendipity[name]",
     formID        : "serendipity_comment",
     textareaID    : "serendipity[comment]",
     buttonID      : "serendipity[submit]"
{rdelim}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>

Example for Expression Engine

submitted by Christian

{exp:weblog:entries}
...

<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{
     tool          : "ExpressionEngine",
     siteurl       : "{homepage}",
     sitetitle     : "{exp:weblog:weblog_name weblog="your_weblog_name"}",
     pageurl       : "{title_permalink=template_group/comments}",
     pagetitle     : "{title}",
     authorID      : "name",
     formID        : "comment_form",
     textareaID    : "comment",
     buttonID      : "submit"
}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>

Example for Pivot (pivotlog.net)

submitted by Arvid

<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{
     tool          : "Pivot",
     siteurl       : "Fill in your own website",
     sitetitle     : "[[weblogtitle]]",
     pageurl       : "[[self]]",
     pagetitle     : "[[title]]",
     author        : "[[cookie:name]]",
     formID        : "form",
     textareaID    : "piv_comment",
     buttonID      : "post"
}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>

Example for b2evolution

submitted by Joel Ross

First, you need to edit the /skins/_feedback.php file. Most of the changes is adding a section of javascript, but there is one line that has to be modified. Look for a line that begins with '<form action', then a bunch of other stuff, and finished off by a '>'. Now, add 'name="commentForm"' (without the single quotes) inside the final '>'.
Then, you add this chunk of javascript:

<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{
     tool          : "b2evolution",
     siteurl       : "<?php $Blog->disp('blogurl', 'raw');?>",
     sitetitle     : "<?php $Blog->disp('name', 'htmlhead');?>",
     pageurl       : "<?php $Item->permalink(); ?>",
     pagetitle     : "<?php $Item->title(); ?>",
     author        : "{$commentform_name}",
     formID        : "commentForm",
     textareaID    : "comment",
     buttonID      : "submit",

  <?php if(is_logged_in()) { ?>
     author        : "<?php $current_User->prefered_name(); ?>"
  <?php } else { ?>
     authorID      : "author"
  <?php } ?>
}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>

Example for MovableType

submitted by David

These instructions are for the default installation of MT 3.2 - if you've made changes to the templates, you will have to locate the corresponding sections in order to make the required changes.

1. Open the Site Javascript template mt-site.js and append the following code:

         // coComment global variables
         var blogTool = "Movable Type";
         var blogURL = "<$MTBlogURL$>";
         var blogTitle = "<$MTBlogName$>";
         var commentAuthorFieldName = "author";
         var commentAuthorLoggedIn = "false";
         var commentFormID = "comments_form";
         var commentTextFieldName = "text";
         var commentButtonName = "post";
   

   Save and rebuild the template.
2. Open the Individual Archive template and insert the following before the </head>:

         <MTIfCommentsAccepted>
         <script type="text/javascript">
         <!--
         // coComment entry-specific variables
         var postURL = "<$MTEntryPermalink$>";
         var postTitle = "<$MTEntryTitle$>";
         //-->
         </script>
         </MTIfCommentsAccepted>
   

3. Scroll down to almost the end of the template, find the lines that say

      </form>
      </div>
      </MTIfCommentsActive>

and change them to:

      </form>
      </div>
      <MTIfCommentsAccepted>
      <script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
      // this activates coComment
      </script>
      </MTIfCommentsAccepted>
      </MTIfCommentsActive>

Save the template.
4. Repeat Steps 2 & 3 with the Comment Preview system template.
5. Rebuild your Individual Archives only.

Example for Community Server

submitted by Keyvan Nayyeri, Jayson Knight andThomas Freudenberg

This is code for Community Server 2.0 Beta 2 (and all 2.0 Beta versions in general), add it to Skin-Commentform.ascx control:

<%@ Import Namespace="CommunityServer.Components" %>
<%@ Import Namespace="CommunityServer.Blogs.Components" %>
<% WeblogPost currentPost = WeblogPosts.GetWeblogEntry(CSContext.Current.BlogGroupID,CSContext.Current.PostID); %>
<% bool isAuthor = CSContext.Current.IsAuthenticated &&CSContext.Current.User.UserID == currentPost.AuthorID; %>
<script type="text/javascript">
// this ensures coComment gets the correct values
coco =
{
     tool          : "communityServer",
     siteurl       : "<%=Globals.FullPath(currentPost.Weblog.HomePage) %>",
     sitetitle     : "<%=currentPost.Weblog.Name %>",
     pageurl       : "<%=Globals.FullPath(BlogUrls.Instance().Post(currentPost)) %>",
     pagetitle     : "<%=currentPost.Subject %>",
     formID        : "__aspnetForm",
     textareaID    : "<%=tbComment.UniqueID %>",
     buttonID      : "<%=btnSubmit.UniqueID %>",

<% if (isAuthor) { %>
    author         : "<%=CSContext.Current.User.DisplayName %>"
<% } else{ %>
    authorID       : "<%=tbName.UniqueID %>"
<% } %>
}
</script>
<script id="cocomment-fetchlet" src="http://www2.cocomment.com/js/enabler.js" type="text/javascript">
// this activates coComment
</script>

Plugin for SPIP

Thanks to mortimer, you can integrate SPIP web management platform with a simple plugin.

Please see this contribution for the details.

You might also want to join the SPIP community on coComment and discover, share and participate in interesting conversation on this topic.