Gravatar::URL is a Perl module to make URLs for Gravatars from an email address.
my $gravatar_id = gravatar_id($email);
my $gravatar_url = gravatar_url(email => $email);
A Gravatar is a Globally Recognized Avatar for a given email address. This allows you to have a global picture associated with your email address. You can look up the Gravatar for any email address by constructing a URL to get the image from gravatar.com. This module does that.
# By email
my $url = gravatar_url( email => $email, %options );
# By gravatar ID
my $url = gravatar_url( id => $id, %options );
Constructs a URL to fetch the gravatar for a given $email or $id.
$id is a gravatar ID. See "gravatar_id" for more information.
%options are optional and are...
A user can rate how offensive the content of their gravatar is, like a movie. The ratings are G, PG, R and X. If you specify a rating it is the highest rating that will be given.
rating => "R" # includes G, PG and R
Specifies the desired width and height of the gravatar (gravatars are square).
Valid values are from 1 to 80 inclusive. Any size other than 80 will cause the original gravatar image to be downsampled using bicubic resampling before output.
size => 40, # 40 x 40 image
The url to use if the user has no gravatar or has none that fits your rating requirements.
default => "http://upload.wikimedia.org/wikipedia/en/8/89/Alfred.jpg"
Gravatars can be requested to have a 1 pixel colored border. If you'd like that, pass in the color to border as a 3 or 6 digit hex string.
border => "FFFFFF", # a black border, like my soul
border => "FFF", # black, but in 3 digits
This is the URL of the location of the Gravatar server you wish to grab Gravatars from. Defaults to http://www.gravatar.com/avatar.php".
my $id = gravatar_id($email);
Converts an $email address into its Gravatar $id.