WWW::UsePerl::Journal::Post - use.perl.org journal post tool


WWW-UsePerl-Journal documentation  | view source Contained in the WWW-UsePerl-Journal distribution.

Index


NAME

Top

WWW::UsePerl::Journal::Post - use.perl.org journal post tool

DESCRIPTION

Top

Allows users to post a use.perl entry to their journal.

SYNOPSIS

Top

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

Top

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

Top

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

Top

WWW::UsePerl::Journal, http://use.perl.org/

AUTHOR

Top

  Barbie, <barbie@cpan.org>
  for Miss Barbell Productions <http://www.missbarbell.co.uk>.

COPYRIGHT AND LICENSE

Top


WWW-UsePerl-Journal documentation  | view source Contained in the WWW-UsePerl-Journal distribution.