NAME

WebService::weblogUpdates - methods supported by the UserLand weblogUpdates framework.

SUMMARY

 use WebService::weblogUpdates;

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

DESCRIPTION

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

NAMES

This package was originally named to reflect the class that the original ping method lives in, weblogUpdates.

Since then, other methods have been added that live in other classes or don't have any class at all. I have no idea why.

So it goes, I guess.

PACKAGE METHODS

$pkg = PACKAGE->new(%args)

Valid arguments are

transport
String. Valid transports are SOAP and XMLRPC and REST. required
debug
Boolean. Enable transport-specific debugging.

OBJECT METHODS

$pkg->ping(\%args)

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

Valid arguments are a hash reference whose keys are :

name
String. The name of your weblog. required
url
String. The URI of your weblog. required
changesurl
String.

This key may be specified if
- The object's transport is REST and the site in question "need two urls, one that we can verify changes for, and the other to be included in changes.xml."
- You are passing a category key with your ping. In fact, it's required if you're doing that.
category
String.

Categories are not supported if the object's transport is REST.

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

$pkg->rssUpdate(\%args)

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

Valid arguments are a hash reference whose keys are :

name
String. The name of your weblog. required
url
String. The URI of your weblog. required

This method is not supported for the SOAP transport, although it will be as soon as it is documented by UserLand.

This method is not supported for the REST transport.

$pkg->LastMessage()

Return the response message that was sent with your last method call.

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

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

Valid arguments are

debug
Boolean. Enable transport-specific debugging.

DEPRECATED METHODS

$pkg->ping_message()

DEPRECATED Please use $pkg->LastMessage() instead.

VERSION

0.34

DATE

October 28, 2002

REQUIREMENTS

These packages are required in order to support the following transports :

XMLRPC

One of the following :

Frontier::Client
Default
XMLRPC::Lite
(part of SOAP::Lite)

SOAP

SOAP::Lite

REST

LWP::Simple
HTML::Parser
This is optional, but required if you want this package to try and return a short and sweet message instead of raw HTML.

LICENSE

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

CPAN RT