Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

libravatar::url(3pm) [debian man page]

Libravatar::URL(3pm)					User Contributed Perl Documentation				      Libravatar::URL(3pm)

NAME

       Libravatar::URL - Make URLs for Libravatars from an email address

SYNOPSIS

	   use Libravatar::URL;

	   my $url = libravatar_url( email => 'larry@example.org' );

DESCRIPTION

       See <http://www.libravatar.org> for more information.

Functions
       libravatar_url

	   # By email
	   my $url = libravatar_url( email => $email, %options );

	   # By OpenID
	   my $url = libravatar_url( openid => $openid, %options );

       Constructs a URL to fetch the Libravatar for the given $email address or $openid URL.

       %options are optional.  "libravatar_url" will accept all the options of "gravatar_url" in Gravatar::URL except for "rating" and "border".

       The available options are...

       size

       Specifies the desired width and height of the avatar (they are square).

       Valid values are from 1 to 512 inclusive. Any size other than 80 may cause the original image to be downsampled using bicubic resampling
       before output.

	   size    => 40,  # 40 x 40 image

       default

       The url to use if the user has no avatar.

	   default => "http://www.example.org/nobody.jpg"

       Relative URLs will be relative to the base (ie. libravatar.org), not your web site.

       Libravatar defines special values that you may use as a default to produce dynamic default images. These are "identicon", "monsterid",
       "wavatar" and "retro".  "404" will cause the URL to return an HTTP 404 "Not Found" error instead and "mm" will display the same "mystery
       man" image for everybody.  See <http://www.libravatar.org/api> for more info.

       If omitted, Libravatar will serve up their default image, the orange butterfly.

       base

       This is the URL of the location of the Libravatar server you wish to grab avatars from.	Defaults to <http://cdn.libravatar.org/avatar/>
       for HTTP and <https://seccdn.libravatar.org/avatar/> for HTTPS.

       short_keys

       If true, use short key names when constructing the URL.	"s" instead of "size", "d" instead of "default" and so on.

       short_keys defaults to true.

       https

       If true, serve avatars over HTTPS instead of HTTP.

       You should select this option if your site is served over HTTPS to avoid browser warnings about the presence of insecure content.

       https defaults to false.

LICENSE

       Copyright 2011, Francois Marier <fmarier@gmail.com>.

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

       See http://dev.perl.org/licenses/artistic.html

SEE ALSO

       <http://www.libravatar.org> - The Libravatar web site

       <http://www.libravatar.org/api> - The Libravatar API documentation

perl v5.14.2							    2012-04-04						      Libravatar::URL(3pm)

Check Out this Related Man Page

IO::All::HTTP(3pm)					User Contributed Perl Documentation					IO::All::HTTP(3pm)

NAME

       IO::All::LWP - Extends IO::All to HTTP URLs

SYNOPSIS

	   use IO::All;

	   $content < io('http://example.org'); 	    # GET webpage into scalar
	   io('http://example.org') > io('index.html');     # GET to file
	   "hello
" > io('http://example.org/index.html'); # PUT webpage

	   # two ways of getting a page with a password:
	   $content < io('http://me:secret@example.org');
	   $content < io('http://example.org')->user('me')->password('secret');

DESCRIPTION

       This module extends IO::All for dealing with HTTP URLs.	Note that you don't need to use it explicitly, as it is autoloaded by IO::All
       whenever it sees something that looks like an HTTP URL.

       The SYNOPSIS shows some simple typical examples, but there are many other interesting combinations with other IO::All features! For
       example, you can get an HTTP URL and write the content to a socket, or to an FTP URL, of to a DBM file.

METHODS

       This is a subclass of IO::All::LWP. The only new method is "http", which can be used to create a blank IO::All::HTTP object; or it can also
       take an HTTP URL as a parameter. Note that in most cases it is simpler just to call io('http://example.com'), which calls the "http" method
       automatically.

OPERATOR OVERLOADING

       The same operators from IO::All may be used. < GETs an HTTP URL; > PUTs to an HTTP URL.

SEE ALSO

       IO::All, IO::All::LWP, LWP.

AUTHORS

       Ivan Tubert-Brohman <itub@cpan.org> and Brian Ingerson <ingy@cpan.org>

COPYRIGHT

       Copyright (c) 2007. Ivan Tubert-Brohman and Brian Ingerson. All rights reserved.

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

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.10.0							    2007-03-29							IO::All::HTTP(3pm)
Man Page