Aaron Straup Cope

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");

 # Since the 'rssUpdate' method has only been 
 # documented for the XML-RPC transport, we switch
 # the internal widget.

 $weblogs->Transport("XMLRPC");
 $weblogs->rssUpdate("Aaronland","http://www.aaronland.net/weblog/rss");

DESCRIPTION

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

ON NAMING THINGS

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 different classes or don't have any parent class at all. I have no idea why, especially since the equivalent serTalk methods live in a 'weblogUpdates' class themselves. [1]

So it goes.

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.35

DATE

October 31, 2002

SEE ALSO

http://www.weblogs.com

http://www.xmlrpc.com/weblogsComForRss

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

FOOTNOTES

[1] http://www.xmlrpc.com/weblogsComForRss#changes103002ByDw

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

Copyright (c) 2001-2002, Aaron Straup Cope. All Rights Reserved.

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