NAME

Userland::weblogUpdates


SUMMARY

 my $userland = Userland::weblogUpdates->new(transport=>SOAP,debug=>0);
 $userland->ping("Perlblog","http://www.nospum.net/perlblog";);

 #

 print 
    "Weblogs.com supports the following categories:\n",
     join("\n",&Userland::weblogUpdates::Categories()),
     "\n";

 # 

 my $blog = "http://www.foo.bar/";;
 print $cgi->img({src=>&Userland::weblogUpdates::Zeldman($blog)});


DESCRIPTION

This package implements methods supported by the Userland weblogUpdates framework, for the weblogs.com website.


CONSTRUCTOR METHODS


$pkg = Userland::weblogUpdates->new(%args)

Valid arguments are

transport

string. Valid transports are SOAP and XMLRPC. This field is required.

debug

boolean. Enable transport-specific debugging.


API SPECIFIC METHODS


$pkg->ping($name,$uri,$category)

Ping the Userland servers and tell them your weblog has been updated.

Valid arguments are

name (required)

The name of your weblog.

uri (required)

The URI of your weblog.

category

An optional category to attach to your weblog.

Returns true or false. This means that, unlike the Userland server itself, a successful ping returns 1 and a failed ping returns 0.


UTILITY METHODS


$pkg->Transport($transport,%args)

Set the transport for use with the package. Valid transports are SOAP and XMLRPC. This field is required.

Valid arguments are

debug

boolean. Enable transport-specific debugging.


PUBLIC FUNCTIONS


&Categories(%args)

Returns a list of categories supported by the weblogs.com server.

Valid arguments are :

force

Boolean. By default, the list of categories is memoized for the life of the package. If you want to make sure that the list of icons is minty fresh, set the value to 1.


&Zeldman($uri,%args)

Return the full URI for the Zeldman icon associated with $uri

Valid arguments are :

force

Boolean. By default, the list of icons is memoized for the life of the package. If you want to make sure that the list of icons is minty fresh, set the value to 1.


PRIVATE METHODS


TO DO

Better error handling.

POD for private methods.


VERSION

0.3.1


DATE

December 03, 2001


CHANGES


0.3.1

Added Zeldman function

Added optional arguments hash and bobo-style memoization for Categories

Updated POD

0.3

Added Categories function

Updated POD

0.2

Added SOAP support.

Added public transport method.

Added private _require, _soap, _xmlrpc methods to load transport specific package(s) only when needed.

Added private _client and _do methods for performing transport specific actions.

Set the proper package name. gah!

Updated POD.

0.1.1

Added $VERSION (doh!)

Updated POD

Updated the Userland reference link

0.1

Initial revision

SEE ALSO

Frontier::Client

SOAP::Lite

LWP::Simple

XML::Simple

http://www.weblogs.com

http://www.xmlrpc.com/discuss/msgReader$2014?mode=day

http://newhome.weblogs.com/theZeldmansReturn

LICENSE

Copyright 2001 Aaron Straup Cope.

This is free software, you may use it and distribute it under the same terms as Perl itself.