GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GRAVATAR::URL (3)

.ds Aq ’

NAME

Gravatar::URL - Make URLs for Gravatars from an email address

CONTENTS

SYNOPSIS



    use Gravatar::URL;

    my $gravatar_id  = gravatar_id($email);

    my $gravatar_url = gravatar_url(email => $email);



DESCRIPTION

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.

Examples of use include the author faces on <http://search.cpan.org>.

See <http://gravatar.com> for more info.

Functions

gravatar_url



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

rating

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



size

Specifies the desired width and height of the gravatar (gravatars are square).

Valid values are from 1 to 512 inclusive. Any size other than 80 may cause the original gravatar 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 gravatar or has none that fits your rating requirements.



    default => "https://secure.wikimedia.org/wikipedia/en/wiki/File:Mad30.jpg"



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

Gravatar 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 whereas mm will display the same mystery man image for all missing people. See <http://en.gravatar.com/site/implement/url> for more info.

If omitted, Gravatar will serve up their default image, the blue G.

border

<B>DEPRECATED!B> This key has been removed from the Gravatar protocol. It will be removed from future versions of Gravatar::URL.

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 => "000000",  # a black border, like my soul
    border => "000",     # black, but in 3 digits



base

This is the URL of the location of the Gravatar server you wish to grab Gravatars from. Defaults to <http://www.gravatar.com/avatar/"> for HTTP and <https://secure.gravatar.com/avatar/> for HTTPS.

short_keys

If true, use short key names when constructing the URL. s instead of size, r instead of ratings 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.

gravatar_id



    my $id = gravatar_id($email);



Converts an $email address into its Gravatar $id.

THANKS

Thanks to gravatar.com for coming up with the whole idea and Ashley Pond V from whose Template::Plugin::Gravatar I took most of the original code.

LICENSE

Copyright 2007 - 2009, Michael G Schwern <schwern@pobox.com>. 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

Template::Plugin::Gravatar - a Gravatar plugin for Template Toolkit

<http://www.gravatar.com> - The Gravatar web site

<http://en.gravatar.com/site/implement/url> - The Gravatar URL implementor’s guide

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 GRAVATAR::URL (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.