NAME

WWW::Shorten::SuPr - shorten or lengthen URLs with http://su.pr from Stumbleupon Documentation can be found on http://www.stumbleupon.com/help/su-pr-api/

VERSION

Version 0.01

SYNOPSIS

        use WWW::Shorten::SuPr;
        my $url = q{http://perl.org};
        my $short_url = makeashorterlink($url);
        my $long_url  = makealongerlink($short_url); # eq $url
        my $shortlinkwithauth = shortlinkwithauth($url,$login,$api);
        my $socialpost = WWW::Shorten::SuPrsocialpost($msg,$login,$api); # Su.pr provides a update your twitter and facebook wall with a message and shorten the link's provided in the message
        my $schedule_socialpost =WWW::Shorten::SuPr->schedule_socialpost($msg,$login,$api,$time);#Schedule the posts (time should be in unix format)

SUBROUTINES/METHODS

makeashorterlink

The function makeashorterlink will call the is.gd web site passing it your long URL and will return the shortened link.

makealongerlink

The function makealongerlink does the reverse of c<makeashorterlink> if the link already been hashed in Su.Pr

shortlinkwithauth

Authenticated requests can be used to create account based unique short URLs used for Su.pr analytics. Authenticated items will appear on your Su.pr home page. Which requires 3 parameters

URL

        Url Entry supported by Su.Pr

Login

        Username of the su.pr
        

APIKey

        Api key which can get found in su.pr setting page
        

socialpost

The c<socialpost> is used to post Su.pr converted messages to associated services such as Twitter and Facebook. Authentication is required for this API. Which requires 3 parameters

Message

        msg: blah blah blah http://perl.org
        Note this should not exceded 140 characters
        

Login

        Username of the su.pr
        

APIKey

        Api key which can get found in su.pr setting page
        

schedule_socialpost

        Schedule a C<socialpost> with unix time stamp .
        Which requires 3 parameters
        

Message

        msg: blah blah blah http://perl.org
        Note this should not exceeded 140 characters
        

Login

        Username of the su.pr
        

APIKey

        Api key which can get found in su.pr setting page
        

Time

        Unix timestamp of the date and time you wish to post. Posts will be submitted within a 15 minute bucket of the scheduled time.
        

AUTHOR

Anwesh, <kanishka at cpan.org>

BUGS

Please report any bugs or feature requests to bug-www-shorten-supr at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Shorten-SuPr. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

you can raise a issue on git hosting https://github.com/Anwesh/WWW-Shorten-SuPr/issues

SUPPORT

You can find documentation for this module with the perldoc command. perldoc WWW::Shorten::SuPr You can also look for information at:

• RT: CPAN's request tracker (report bugs here) http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Shorten-SuPr

• AnnoCPAN: Annotated CPAN documentation http://annocpan.org/dist/WWW-Shorten-SuPr

• CPAN Ratings http://cpanratings.perl.org/d/WWW-Shorten-SuPr

• Search CPAN http://search.cpan.org/dist/WWW-Shorten-SuPr/

• Git https://github.com/Anwesh/WWW-Shorten-SuPr

LICENSE AND COPYRIGHT

Copyright 2011 Anwesh. This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See http://dev.perl.org/licenses/ for more information.