Projects

circulation-feedflare

IntroThis is a quick little FeedFlare that displays a feed's circulation (i.e. number of subscribers). It was inspired by the original FeedFlare Catalog from FeedBurner. If you're not familiar with FeedFlare, please refer to the FeedBurner web site. This flare is up and running on Google ... [More] App Engine, so go ahead and take it for a spin right now! UsageTo install/use this flare, do the following: Login to your FeedBurner account. Click the feed you plan to add this to and go to the Optimize tab. Click FeedFlare in the left menu. Copy/paste this link into the text box under Personal Flare and click Add New Flare. Click the checkboxes in the Feed or Site columns to specify where this flare will be displayed. Scroll down to the bottom and click Save. (This is easy to forget.) At this point, you should be able to see this in action by clicking Your Feed on the left side and viewing your feed within FeedBurner. It will output a short message in XML format similar to the following: This feed has 22 subscribers.You may have to wait a short while for FeedBurner to reload/cache your feed for this to display in an RSS reader, and changes in your subscriber numbers may not be instantly reflected either. NotesIf for some reason you end up adding/removing this flare more than once, it might help to tweak the URL slightly to trick FeedBurner into thinking it's a new piece of flare. (Ha! Get it?) That's why the URL contains the v parameter at the end...it performs no actual function but it provides an easy way to perform this trick. Just increment the number, as in: http://circulation-feedflare.appspot.com/files/circulation-feedflare.xml?v=2Or even http://circulation-feedflare.appspot.com/files/circulation-feedflare.xml?v=joe-mamaRemember: the value of the v parameter isn't used by the code, but this technique is recommended by FeedBurner. If you're debugging and want to interact with this code directly, access the following URL and supply the Awareness API URL for your feed. http://circulation-feedflare.appspot.com/?api_url=YOUR_AW_API_URL_HERE Here's an example: http://circulation-feedflare.appspot.com/?api_url=http%3A%2F%2Fapi.feedburner.com%2Fawareness%2F1.0%2FGetFeedData%3Furi%3DNoFunnyHats This URL returns data in an XML format, so you might want to use Firefox or curl rather than other browsers. Again, the flare does this URL substitution for you out of the box, so this isn't usually a problem. [Less]