Incoming&nbsp;-&nbsp;Comment API
<p>The Comment API was originally suggested and designed by <a href="http://wellformedweb.org/story/9">Joe 
  Gregorio</a>. BlogWorks XML now implements this API.</p>
<p>The Comment API page, <code>incoming.asp</code> found in the <i>admin_dir</i> 
  directory, acts as a receiving point for RSS Item fragments that can come from 
  any source. The specification defines how TrackBacks, PingBacks etc. are formed 
  as these fragments.</p>
<p>As part of BlogWorks integrated commenting strategy <code>incoming.asp</code> 
  also acts as the receiving point for ordinary TrackBack and PingBack pings and 
  as a gateway for BlogWorks' own comment form which appears at the bottom of 
  the page used to display all received RSS Item fragments, TrackBacks, PingBacks 
  and comments. It's simpler than it sounds.</p>
<p>BlogWorks accepts any incoming RSS Item fragments and simply stores them along 
  with the date and a reference code. Every post has an associated URL (produced 
  using the <code>[rx:url]</code> template tag) that provides an endpoint for 
  incoming Item fragments. This URL is also used for TrackBacks. PingBacks use 
  the same endpoint but reference it in a different way.</p>
<h3>Using the Comment API and <code>incoming.asp</code></h3>
<p>The Comment API is accessible via the URL as produced by the <code>[rx:url]</code> 
  tag. This URL can be used in an RSS feed using the following markup: <code>&lt;wfw:comment>[rx:url]&lt;/wfw:comment></code> 
  within the <code>&lt;item></code> element.</p>
<p>TrackBacks function as before and as detailed <a href="help.asp?page=trackback">here</a>.<br>
  <a href="help.asp?page=pingback">PingBack</a> clients reference <code>incoming.asp</code> 
  either via an HTTP header or an HTML <code>&lt;link></code> tag.<br>
</p>
<h3>Upgrading from CommentWorks XML to Comment API</h3>
<p>If you have been using CommentWorks XML to allow visitors to comment on your site those files can be converted to the Comment API RSS format.</p>
<p>Whilst logged into the web interface enter the URL to the file <code>comment_converter.asp</code> in the <i>admin_dir</i> directory. <br />Your old CommentWorks XML files will be read and new Comment API files created. The old files will not be deleted.</p>