NP_Trackback.php

In a nutshell, TrackBack was designed to provide a method of notification between websites: it is a method of person A saying to person B, “This is something you may be interested in.” To do that, person A sends a TrackBack ping to person B. For more information read What is Trackback?. This plugin implements functionality to both send and receive trackbacks pings based on version 1.2 of the trackback specification.

1. Unzip the file and upload the contents to your plugin directory
2. Install the plugin
3. Modify the skin you are using based on the following instructions.

These instructions are based on the default supplied with Nucleus 3.2. If you use a different skin, you may need to adjust the location where to insert the trackback variables.

First edit the Item Pages part of the skin (Admin menu → Skins, look for default skins section on the right column). Insert the code variable after the page header and just before the page content:

<%parsedinclude(header.inc)%>
 
<!-- 
    <%TrackBack(code)%>
-->
 
<!-- page content -->

This will add the RDF tag into the item which allows the software of other weblog authors to auto discover the trackback functionality of your weblog.

Next, go the the nucleus default/item template (Admin Menu → Templates, look at the right template) and add our list variable just below it. This will insert the list of current trackbacks below the article. This location is just a suggestion, if want to display the trackback list in a different location you can.

<div class="content">
<%item(default/item)%>
</div>
<%TrackBack(list)%>
<div class="content">

Finally go to the default/index template and edit Item Body part of the template. Insert our count variable just after the nucleus comments variable.

</div>
<%comments%>
<%TrackBack(count)%>
<%edit%>
</div>

The Trackback plugin has the ability to autodetect trackback URLs as-you-type. Everytime you use a link to another weblog in your story, the plugin will contact that weblog and check if it accepts trackbacks. If it does, it will add it to the list of trackbacks on your 'Edit Item' page. Simply check the trackbacks you want to ping or if you want you can also manually specify an trackback URL.

In order to receive trackbacks you do not have to do anything, except for making the trackback URL known. You can do this by including one or more skin or template variables. It is also possible to include a list of the most recent trackbacks on every page by using a skin or template variable.

• <%TrackBack(list)%>
  Show a list of trackbacks for the current page. Optionally it is also possible to add an additional parameter, the story id number, which makes it possible to show a list of trackbacks from a different page. The output of this variable is fully configurable in the plugin options.
• <%TrackBack(code)%>
  Inserts a small piece of invisible RDF code in the page, which is used by other weblogs to auto-detect the trackback URL. If you do not include this variable in your skin for item pages, other weblogs will not be able to auto-detect that your weblog is able to accept trackbacks.
• <%TrackBack(form)%>
  Returns an URL to the Manual Ping Form. Using this form authors of other weblogs can add trackbacks to your stories, even when their software does not support trackbacks, such as Blogger. A link to this form is included in the footer of the trackback list by default. If you want to place this link somewhere else on your page, simply remove the <%form%> variable from the Footer field in the plugin settings and add the skinvar somewhere on your webpage.
• <%TrackBack(url)%>
  Insert the Trackback Ping URL. Authors of weblogs can use this URL to add trackbacks to your stories, even when their software does not support trackback URL autodetection. This URL is also included in the footer of the trackback list by default. If you want to place this link somewhere else on your page, simply remove the <%action%> variable from the Footer field in the plugin settings and add the skinvar somewhere on your webpage.
• <%TrackBack(count)%>
  If you want to include an indication of how many trackbacks are present for each page you can use this variable. By default this variable will show: “No Trackbacks”, “1 Trackback”, “2 Trackbacks”, etc. This is however also fully configurable in the plugin options.
• <%TrackBack(pingformlink)%>
  This is used in a template to insert a link to a popup form that allow user to send a ping for a particular post. This is similar to the manual ping form, but it automatically fill in all url/title/info for the ping.
• <%TrackBack(latest)%>
  Display latest Trackbacks.

• [Version 2.1.1, 2007-10-116]
  • Add <%TrackBack(latest)%> (thanks faceh for the code)
  • Merged multi-blog patch from fishy (Thanks!)
• [Version 2.1.0, 2007-05-06]
  • Added delete all blocked trackback function in admin menu
  • Harden tb URL, add tb key to fix tb spam, each key expired in ~3 hours
  • Fixed send ping blocked by NP_BB
  • Re-instate ping form for item
• [Version 2.0.3, 2005-11-14]
  • Added support for a more advanced version of the SpamCheck API
• [Version 2.0.2, unreleased]
  • Added autodetection of the encoding of trackbacks
  • Added support for Nucleus 3.3 events SendTrackback and RetrieveTrackback
  • Added support for more clean Trackback URLs
• [Version 2.0.1, 2005-06-06]
  • Security bugfix: Admin area is exposed to all members, not just admins. Users of this plugin are recommended to upgrade to 2.0.1.
• [Version 2.0, 2005-03-07]
  • First public release of Trackback 2.0

For a complete changelog of all versions of the Trackback plugin, including versions older than 2.0 see the CHANGELOG.txt file included with the plugin package.

NP_Trackback version 2.1.1 works with Nucleus CMS 3.31 - 2007-10-29 admun