#Gravatar for Craft CMS v 0.2

Craft CMS plugin allowing you to easily insert an avatar url or image from Gravatar based on email address.

##Parameters

• email (required): The email address of the user
• options (optional): Object of Gravatar settings

###Options

##Usage

###.url()

Returns a Gravatar image URL with default settings to use within your own markup:

{{ craft.gravatar.url('email@domain.com') }}

This can also be used within the entry model:

{{ craft.gravatar.url(entry.author.email) }}

Lastly, it can be used with the user module:

Return all users' Gravatars:

{% set users = craft.users() %}

Return one user's Gravatar:

{% set users = craft.users({username: 'username'}) %}

Run the for loop for the set users:

{% for user in users %}
			
	{{ craft.gravatar.url(user.email) }}
	
{% endfor %}

Adding options:

{{ craft.gravatar.url('email@domain.com', {'size': '100', 'default': 'monsterid'}) }}

###.img()

Returns a Gravatar image in an <img> tag:

{{ craft.gravatar.img('email@domain.com') }}

The .img() method has an additional option:

Users loop with additional attributes:

{% set users = craft.users() %}
	
{% for user in users %}
	
	{{ craft.gravatar.img(user.email, {'attr': {'class': 'gravitated', 'id': 'author-' ~ user.id}}) }}
	
{% endfor %}	

##Feedback?

Contact us on Twitter: @ehousestudio

##License

This work is licenced under the MIT license.