Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
This plugin provides a taglib for displaying avatars. At the moment we only support gravatars (globally-recognized avatars).
Groovy Java
branch: master
Failed to load latest commit information.
grails-app improved sample app
src/java/com/synergyj/grails/plugins/avatar/util
test/unit/com/synergyj/grails/plugins/avatar added spock spec to reproduce the bug;
.gitignore
AvatarGrailsPlugin.groovy deleted unused closures
History.md fixed history log
LICENSE.txt
README
application.properties

README

Note:

The official documentation is locate at: http://www.grails.org/Avatar+Plugin

This plugin provides a taglib for displaying avatars. At the moment we only support gravatars (globally-recognized avatars).

Gravatars allow users to configure an avatar to go with their email address at a central location: gravatar.com. Gravatar-aware websites can then look up and display each user‘s preferred avatar, without having to handle avatar management. The user gets the benefit of not having to set up an avatar for each site that they post on.


==Code==
Plugin code is located at GitHub http://github.com/domix/avatarplugin/tree/master


==Installation==
'grails install-plugin avatar'



==Usage==

The plugin usage is quite simple.

'For Gravatar image'

Example: <avatar:gravatar email="${user.email}"/>

The tagLib will generate the following HTML code: 
<img alt="Gravatar" class="avatar" height="20" src="https://secure.gravatar.com/avatar/f2f68f9b5281cd7c2eb7eecba1" width="20" />

As you can see, the taglib will generate some html default attributes like:

 * id & name
 * heigth & width
 * CSS class
 * alt


You can customize this default values as follows: 
<avatar:gravatar email="${user.email}" alt="My Avatar" cssClass="myCss" size="50"/>

Output:
<img alt="My Avatar" class="myCss" height="50" src="https://secure.gravatar.com/avatar/f2f68f9b2814cd7c2eb7eecb9c" width="50" />


Alternatively you can customize default avatar to users who don't have a Gravatar Account:
<avatar:gravatar email="${user.email}" defaultGravatarUrl="${'http://mydomain.com/images/default-gravatar-80.png'.encodeAsURL()}" />

Also can be set the Gravatar rating:
<avatar:gravatar email="${user.email}" gravatarRating="G" />

'For twitter image'

Example: <avatar:twitter user="${user.twitter}"/>

Output:
<img alt='twitter' class='avatar' height='50' width='50' src='http://a0.twimg.com/profile_images/1124040897/at-twitter_normal.png' title='twitter'/>

You can customize:
 * heigth & width
 * CSS class
 * alt

'For facebook image'

Example: <avatar:facebook user="${user.facebookId}"/>

Output:
<img alt='facebook' class='avatar' height='50' width='50' src='https://graph.facebook.com/facebook/picture' title='facebook'/>

You can customize:
 * heigth & width
 * CSS class
 * alt

==Configuration==

To avoid expensive configuration each time plugin usage, you can configure global settings as follows:

In Config.groovy for Gravatar service

avatarPlugin {
	defaultGravatarUrl="""http://yourdomain.com/images/default-gravatar-80.png"""
	gravatarRating="G"
}

To use twitter and/or facebook avatars you don't need configuration
Something went wrong with that request. Please try again.