/WWW-Shorten-SuPr

Moduel for Su.Pr url shorten service

Primary LanguagePerl

NAME
    WWW::Shorten::SuPr - shorten or lengthen URLs with http://su.pr

VERSION
    version 0.001

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);

        # Su.pr provides a update your twitter and facebook wall with a
        # message and shorten the links provided in the message
        my $socialpost = WWW::Shorten::SuPrsocialpost($msg,$login,$api);

        #Schedule the posts (time should be in unix format)
        my $schedule_socialpost = WWW::Shorten::SuPr->schedule_socialpost($msg,$login,$api,$time);

SUBROUTINES
  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.

AVAILABILITY
    The project homepage is <http://p3rl.org/WWW::Shorten::IsGd>.

    The latest version of this module is available from the Comprehensive
    Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a
    CPAN site near you, or see
    <http://search.cpan.org/dist/WWW-Shorten-IsGd/>.

    The development version lives at
    <http://github.com/doherty/WWW-Shorten-IsGd> and may be cloned from
    <git://github.com/doherty/WWW-Shorten-IsGd.git>. Instead of sending
    patches, please fork this project using the standard git and github
    infrastructure.

SOURCE
    The development version is on github at
    <http://github.com/doherty/WWW-Shorten-IsGd> and may be cloned from
    <git://github.com/doherty/WWW-Shorten-IsGd.git>

BUGS AND LIMITATIONS
    No bugs have been reported.

    Please report any bugs or feature requests through the web interface at
    <https://github.com/doherty/WWW-Shorten-IsGd/issues>.

AUTHOR
    Anwesh <kanishka@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2011 by Anwesh.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.