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.