Gravatar Image Tag

terça-feira, 06 de Outubro de 2009

Michael Deering desenvolveu o plugin gravatar_image_tag e publicou um artigo com alguns detalhes sobre o mesmo.

A forma de utilizar é muito simples e está no Github. A seguir uma tradução deste passos para o português.

Instalar como plugin Ruby on Rails

O jeito tradicional.

              console
                    
        ./script/plugin install git://github.com/mdeering/gravatar_image_tag.git
        
./script/plugin install git://github.com/mdeering/gravatar_image_tag.git

ou o modo antigo!

              console
                    
        piston import git://github.com/mdeering/gravatar_image_tag.git vendor/plugins/gravatar_image_tag
        
piston import git://github.com/mdeering/gravatar_image_tag.git vendor/plugins/gravatar_image_tag

ou para os amantes do GIT

              console
                    
        git submodule add git://github.com/mdeering/gravatar_image_tag.git vendor/plugins/gravatar_image_tag git submodule init
        
git submodule add git://github.com/mdeering/gravatar_image_tag.git vendor/plugins/gravatar_image_tag git submodule init

Usando

Uma vez instalado o plugin usar é simples.

              test.html.erb
                    
        <%= gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering') %>
        
<%= gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering') %>

Boom aqui está meu gravatar

Pontos de configuração

Definir uma imagem padrão

Se você não definiu nenhuma imagem padrão para o plugin então a imagem padrão do gravatar será mostrada.

              test.html.erb
                    
        <%= gravatar_image_tag('junk', :alt => 'Default Gravatar Image') %>
        
<%= gravatar_image_tag('junk', :alt => 'Default Gravatar Image') %>

Splat a imagem padrão do gravatar

Você pode definir a imagem padrão em um initializer como abaixo:

              config/initializers/gravatar_defaults.rb
                    
        ActionView::Base.default_gravatar_image = 'http://assets.yourhost.com/images/default_gravatar.png'
        
ActionView::Base.default_gravatar_image = 'http://assets.yourhost.com/images/default_gravatar.png'

Você pode definir a imagem padrão como parâmetro para sobrescrever a imagem acima definida no initializer passando a opção :gravatar => { :default => 'http://assets.yourhost.com/images/override_gravatar.png' } para o helper gravatar_image_tag. Todos as outras opção seguem para a image_tag.

              example.html.erb
                    
        <%= gravatar_image_tag('junk', :alt => 'Github Default Gravatar', :gravatar => { :default => 'http://github.com/images/gravatars/gravatar-80.png' }) %>
        
<%= gravatar_image_tag('junk', :alt => 'Github Default Gravatar', :gravatar => { :default => 'http://github.com/images/gravatars/gravatar-80.png' }) %>

Ka-Pow

Definindo um tamanho padrão

Se nenhum tamanho for definido na configuração do plugin ou passado como parâmetro para o gravatar_image_tag então o tamanho padrão do gravatar será utilizado (80 x 80 quando este artigo foi escrito).

Você pode especificar um tamanho padrão na configuração do plugin adicionando a linha abaixo em seu initializer.

              config/initializers/gravatar_defaults.rb
                    
        ActionView::Base.default_gravatar_size = 120
        
ActionView::Base.default_gravatar_size = 120

Você pode definir o tamanho da imagem para sobrescrever a configuração do plugin passando a opação :gravatar => { :size => 50 } para o helper gravatar_image_tag. Todos as outras opção seguem para a image_tag.

              excample.html.erb
                    
        <%= gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering', :style => 'some-style', :gravatar => { :size => 15 }) %>
        
<%= gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering', :style => 'some-style', :gravatar => { :size => 15 }) %>

Mini Me!

Obs. o primeiro parâmetro pode ser passado o email direto do usuário gravatar_image_tag('teste@teste.com'). Neste exemplo foi utilizado o gsub pra evitar que o email do autor caia em lista de spam.