Home › help

Joining the blogroll

You can join the blogroll by editing your user account and setting the option 'I want to be listed on the PBA blogroll'. Eventually, a friendly admin will check that your blog is active, relevant and pretty - and that it reciprocates by syndicating the blogroll (see below). When it does all this, you will be added to the blogroll.

The Blogroll of this site can be syndicated on other blogs via several means:

JavaScript

The most common way is through a remote JavaScript invocation. You place a small snippet of JavaScript code on your page in the place you want the blogroll to appear. The script prints the blog roll.

The code in question is this:

<script type='text/javascript' src='http://pbahq.org/blogroll/export/javascript'></script>

Object / Inline Frame

An object element allows you to load a secondary html document inside your page. It loads more quickly than the Javascript, but it may not fit perfectly into your page design. Note that objects are used instead of the similar iframe, because the iframe specification has been dropped in HTML 4 Strict and XHTML.

The code to include an object in your page is this. Caution: You will need to set the height and width attributes manually to avoid scrolling trouble.

<object data='http://pbahq.org/blogroll/export/html' />

PHP include

If you can execute PHP on your site, and are able to use the include() function to include remote resources through http, you can use this page to include the HTML code directly on your page before it is loaded. The advantage: The transition between your own HTML and that of the blogroll is seamless, and the user does not need to load any remote resources. However, your server must query the remote blogroll for every visitor, causing more load. You can avoid this by caching the page if you know enough PHP.

<?php
	include('http://pbahq.org/blogroll/export/html');
?>

OPML Feed

The blogroll is also provided as an OPML feed, which some blogrolling services can import or syndicate. Please note that the OPML standard is ridiculously loosely defined, and any given service may not support our particular format. The URL is:

http://pbahq.org/blogroll/export/opml