NAME
WWW::UsePerl::Journal::Post - use.perl.org journal post tool
DESCRIPTION
Allows users to post a use.perl entry to their journal.
SYNOPSIS
Note that this module is not meant to be called directly. You should access the undelying object as follows:
use WWW::UsePerl::Journal;
my $j = WWW::UsePerl::Journal->new($user);
my $post = $j->login($pass);However, you can access the object directly as follows:
use WWW::UsePerl::Journal;
my $j = WWW::UsePerl::Journal->new($user);
use WWW::UsePerl::Journal::Post;
my $post = WWW::UsePerl::Journal::Post->new(
j => $j,
username => $user,
password => $pass
);
# basic post using defaults
my $success = $post->postentry(title => 'title', text => 'text');
# post entry overriding defaults
$success = $post->postentry(
title => 'title',
text => 'text',
topic => 34,
comments => 1,
type => 1
promote => 'publish',
);
# delete an entry you don't want
# WARNING: this is permanent!
$success = $post->deleteentry($eid);METHODS
new
Creates an instance for the specified user.
login
Performs the login.
postentry
Posts an entry into a journal, given a title and the text of the entry
$j->postentry(title => "My journal is great", text => "It really is");deleteentry
Deletes an entry from a journal, given the entry id.
$j->deleteentry($eid);NOTE: This currently doesn't work!
SUPPORT
If you spot a bug or are experiencing difficulties that are not explained within the POD documentation, please submit a bug to the RT system (see link below). However, it would help greatly if you are able to pinpoint problems or even supply a patch.
Fixes are dependant upon their severity and my availablity. Should a fix not be forthcoming, please feel free to (politely) remind me by sending an email to barbie@cpan.org .
RT: http://rt.cpan.org/Public/Dist/Display.html?Name=WWW-UsePerl-Journal
Known Bugs
deleteentry
It appears that although the request to delete an entry is correct, there is obviously something I'm missing, because it doesn't actually get deleted from the use.perl system :(
SEE ALSO
WWW::UsePerl::Journal, http://use.perl.org/
AUTHOR
Barbie, <barbie@cpan.org>
for Miss Barbell Productions <http://www.missbarbell.co.uk>.COPYRIGHT AND LICENSE
Copyright (C) 2003-2009 Barbie for Miss Barbell Productions.
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.The full text of the licenses can be found in the Artistic and COPYING files included with this module, or in perlartistic and perlgpl in Perl 5.8.1 or later.