Simple Syndication

Affiliate IDs

Although syndication requests without an affiliate ID are allowed, by including an affiliate ID you have the opportunity to be approached by SitePoint to become a Premium Syndication Partner. If you don't already have one, please create a new affiliate account.

Introduction

This document describes the simplest and most straightforward method for syndicating listings from the SitePoint Market — using a JavaScript script include.

More sophisticated techniques are discussed in the Advanced Syndication help guide.

JavaScript implementation

To syndicate latest listings, use the following code:

<script type="text/javascript"src="http://sitepointmarket.comhttp://sitepointmarket.com/syndicate?af=AFFILIATE_ID"></script>

Replace the af value with your own affiliate ID.

Here's an example of the default output:

Marketplace categories

The example above is for syndicating latest listings in all categories; you can also syndicate listing from single categories, using a different URL for each category. For example, the syndication URL for the Script & Software category looks like this:

http://sitepointmarket.comhttp://sitepointmarket.com/categories/software-for-sale/syndicate?af=AFFILIATE_ID

To specify any category, simply replace software-for-sale in that example with the key of the category you want. Here's a list of all the category keys:

Styling parameters

The script will generate an iframe, which is 250px wide and 500px tall, with automatic scrolling if necessary, and no border.

You can modify the appearance of the iframe with your own CSS, but not the content inside it. So a number of additional parameters are provided to control the content's appearance. These can be specified using either a query parameter in the script src, for example:

http://sitepointmarket.comhttp://sitepointmarket.com/syndicate?af=AFFILIATE_ID&background=efe&headings=060

Or defined in a separate script, which must come before the main script include, for example:

<script type="text/javascript">
<!--
var sitepoint = {};
sitepoint.background = 'efe';
sitepoint.headings = '060';
//-->
</script>
<script type="text/javascript"
	src="http://sitepointmarket.comhttp://sitepointmarket.com/syndicate?af=AFFILIATE_ID"></script>

For all parameters, the syntax always takes the form property=value in a query string, or sitepoint.property = 'value'; in JavaScript. When using the JavaScript method you must make sure to declare the sitepoint object before defining any parameters, as shown in the example above.

Please note that your affiliate ID must always be passed in the query string, it cannot be defined as a JavaScript property.

Here's another example using some additional parameters:

Index of parameters