NAME

Net::Blogger::API::Core - Blogger API methods

SYNOPSIS

 It's very dark in here because this is a black box.

DESCRIPTION

Net::Blogger::API::Core defined methods that correspond to the Blogger API.

It is inherited by Net::Blogger::Engine::Base.pm

Blogger API METHODS

$pkg->`getUsersBlogs()`

Fetch the blogid, url and blogName for each of the Blogger blogs the current user is registered to.

Returns an array ref of hashes.

$pkg->`newPost(\%args)`

Add a new post to the Blogger server.

Valid arguments are :

postbody

Scalar ref.

publish

Boolean.

If the length of postbody exceeds maximum length allowed by the Blogger servers -- 65,536 characters -- currently the text will be chunked into smaller pieces are each piece will be posted separately.

Releases prior to Net::Blogger 0.85 accepted a list of arguments rather than a reference. Version 0.85+ are backwards compatible.

Returns an array containing one, or more, post ids.

$pkg->`getPost($postid)`

Returns a hash ref, containing the following keys : userid, postid, content and dateCreated.

$pkg->`getRecentPosts(\%args)`

Fetch the latest (n) number of posts for a given blog. The most recent posts are returned first.

Valid arguments are

numposts

Int. If no argument is passed to the method, default is 1.

``NumberOfPosts is limited to 20 at this time. Let me know if this gets annoying. Letting this number get too high could result in some expensive db access, so I want to be careful with it.'' --Ev

Releases prior to Net::Blogger 0.85 accepted a list of arguments rather than a reference. Version 0.85+ are backwards compatible.

Returns true or false, followed by an array of hash refs. Each hash ref contains the following keys : postid,content,userid,dateCreated

$pkg->`editPost(\%args)`

Update the Blogger database. Set the body of entry $postid to $body.

Valid arguments are :

postbody

Scalar ref or a valid filehandle.

postid

String. required

publish

Boolean.

Releases prior to Net::Blogger 0.85 accepted a list of arguments rather than a reference. Version 0.85+ are backwards compatible.

Returns an array containing one, or more, post ids.

$pkg->`deletePost(\%args)`

Delete a post from the Blogger server.

Valid arguments are

postid

String. required

publish

Boolean.

Releases prior to Net::Blogger 0.85 accepted a list of arguments rather than a reference. Version 0.85+ are backwards compatible.

Returns true or false.

$pkg->`setTemplate(\%args)`

Set the body of the template matching type $type.

 <quote src = "ev">
  template is the HTML (XML, whatever -- Blogger can output any sort 
  of text). Must contain opening and closing <Blogger> tags to be 
  valid and accepted.
 </quote>

Valid arguments are

template

Scalar ref. required

type

String. required

Valid types are ``main'' and ``archiveIndex''

Releases prior to Net::Blogger 0.85 accepted a list of arguments rather than a reference. Version 0.85+ are backwards compatible.

Returns true or false.