The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Net-FeedBurner-0.12
++
/ Net::FeedBurner

NAME

Net::FeedBurner - The great new Net::FeedBurner!

SYNOPSIS

Why? Because its Great! And New!

  use Net::FeedBurner;
  my $fb = Net::FeedBurner->new('user' => $user, 'password' => $password);
  my $feeds = $fb->find_feeds();
  my $feed_id = (keys %{$feeds})[0];
  my $feedinfo = $fb->get_feed($feed_id);
  my $feedxml = '<feed ... />'; # See t/20-usage.t for more complex usage examples
  $feedburner->modify_feed($feedxml);

FUNCTIONS

Please note that the API documentation at FeedBurner is excellent. Please check the developer documentation there before raising questions here. This module is NOT meant to be a definative guide to the FeedBurner API, just an abstraction layer to make using the FeedBurner API easier for perl developers.

new

Creates and returns a Net::FeedBurner object.

Required arguments: user, password

Optional arguments: locale

The locale option allows users to set a flag that switches between feedburner.jp and feedburner.com (us.)

  my $fb = Net::FeeBurner->new( 'locale' => 'jp', ... );

init

Does some internal init actions.

urlbuilder

Create a proper url depending on request name and type.

request

Make a request and perform some basic error checking and parsing.

find_feeds

Use the API to return a list of feeds for a particular user.

get_feed

Use the API to return the details of a particular feed.

add_feed

Use the API to allow the user to add a new feed to their account.

delete_feed

Use the API to allow the user to delete a feed in their account.

modify_feed

Use the API to allow the user to modify a feed in their account.

resync_feed

Use the API to allow the user to resync a feed in their account. This will involves clearing the cache, resetting any podcast media enclosures, and informing the caller of any feed formatting problems.

modify_feed_source

A non-standard function to assist in changing the source url of a FeedBurner feed.

Awareness API

The Awareness API allows developers to get meaningfull information about a feed. Note that the AwAPI needs to be explicitly enabled for these funtions to work.

See t/21-awapi.t for detailed usage examples.

feed_stats

This function returns the current basic feed awareness data.

feeditem_stats

This function returns the current basic feed awareness data for a specific item.

resyndication_stats

I'm not sure what this does, it looks interesting though.

CAVEATS

After a request it will store the original xmldata for later use.

  my $fb = Net::FeedBurner->new( ... );
  my $fb->get_feed(1234);
  my $xml = $fb->{'rawxml};
  # ...

AUTHOR

Nick Gerakines, <nick at socklabs.com>

BUGS

Please report any bugs or feature requests to bug-net-feedburner at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-FeedBurner. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Net::FeedBurner

You can also look for information at:

ACKNOWLEDGEMENTS

Thanks to the developers over at FeedBurner who wrote really awesome documentation to the FeedBurner API.

  http://www.feedburner.com/fb/a/developers
  http://www.feedburner.com/fb/a/api/management/docs
  http://www.feedburner.com/fb/a/developers/awapi

Special thanks to Takatsugu Shigeta for the first rev of the locale filter.

COPYRIGHT & LICENSE

Copyright 2006 Nick Gerakines, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.