gravatar_image_tag 0.0.1 → 0.0.2

data/README.textile

@@ -33,7 +33,7 @@ Once you have installed it as a plugin for your rails app usage is simple.
 
 <pre>gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering')</pre>
 
-*Boom* here is my gravatar !http://www.gravatar.com/avatar.php?gravatar_id=4da9ad2bd4a2d1ce3c428e32c423588a(Michael Deering)!
+*Boom* here is my gravatar !http://www.gravatar.com/avata/4da9ad2bd4a2d1ce3c428e32c423588a(Michael Deering)!
 
 h2. Configuration Points
 
@@ -43,7 +43,7 @@ If no default image is given in either an initializer or through the options pas
 
 <pre>gravatar_image_tag('junk', :alt => 'Default Gravatar Image')</pre>
 
-*Splat* the default gravatar image !http://www.gravatar.com/avatar.php?gravatar_id=0c821f675f132d790b3f25e79da739a7(Default Gravatar Image)!
+*Splat* the default gravatar image !http://www.gravatar.com/avatar/0c821f675f132d790b3f25e79da739a7(Default Gravatar Image)!
 
 You can specify the default image through an initializer as follows:
 
@@ -54,7 +54,13 @@ You can also specify the default image to fallback to or override the one set in
 
 <pre>gravatar_image_tag('junk', :alt => 'Github Default Gravatar', :gravatar => { :default => 'http://github.com/images/gravatars/gravatar-80.png' })</pre>
 
-*Ka-Pow* !http://www.gravatar.com/avatar.php?default=http%3A%2F%2Fgithub.com%2Fimages%2Fgravatars%2Fgravatar-80.png&gravatar_id=0c821f675f132d790b3f25e79da739a7(Github Default Gravatar)!
+*Ka-Pow* !http://www.gravatar.com/avatar/0c821f675f132d790b3f25e79da739a7?default=http%3A%2F%2Fgithub.com%2Fimages%2Fgravatars%2Fgravatar-80.png(Github Default Gravatar)!
+
+p. Other options supported besides an image url to fall back on include the following:
+* :identicon !http://www.gravatar.com/avatar/0c821f675f132d790b3f25e79da739a7?default=identicon(Identicon Avatar)!
+* :monsterid !http://www.gravatar.com/avatar/0c821f675f132d790b3f25e79da739a7?default=monsterid(Monster Id Avatar)!
+* :wavatar !http://www.gravatar.com/avatar/0c821f675f132d790b3f25e79da739a7?default=wavatar(Wavatar Avatar)!
+* 404: !http://www.gravatar.com/avatar/0c821f675f132d790b3f25e79da739a7?default=404(Not Found)!
 
 h3. Setting the default image size
 
@@ -69,7 +75,42 @@ You can also specify the image size or override the one set in the plugin config
 
 <pre>gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering', :class => 'some-class', :gravatar => { :size => 15 })</pre>
 
-*Mini Me!* !(some-class)http://www.gravatar.com/avatar.php?gravatar_id=4da9ad2bd4a2d1ce3c428e32c423588a&size=15(Michael Deering)!
+*Mini Me!* !(some-class)http://www.gravatar.com/avatar/4da9ad2bd4a2d1ce3c428e32c423588a?size=15(Michael Deering)!
+
+h3. Grabbing gravatars from the secure gravatar server.
+
+p. You can make a request for a gravatar from the secure server at https://secure.gravatar.com by passing the _:gravatar => { :secure => true }_ option to the gravatar_image_tag call.
+
+<pre>gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering', :gravatar => { :secure => true } )</pre>
+
+Delivered by a secure url! !https://secure.gravatar.com/avatar/4da9ad2bd4a2d1ce3c428e32c423588a(Michael Deering)!
+
+p. You globally set the gravatar image tag to always use the secure server by setting the following.  By default this is set to false.
+
+<pre># config/initializers/gravatar_defaults.rb
+ActionView::Base.secure_gravatar  = true</pre>
+
+h3. Using Gravatar's built in rating system
+
+p. By default only those gravatars that have a rating of 'g' are returned.  You can change this by passing in the rating parameter as follows.  Possible options for ratings are _g, pg, r, or x_.
+
+<pre>gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering', :gravatar => { :rating => 'pg' } )</pre>
+
+p. You can globally set the gravatar image tag rating by setting the following.  There is no default value, the default of 'g' is being set by the gravatar service itself.
+
+<pre># config/initializers/gravatar_defaults.rb
+ActionView::Base.default_gravatar_rating  = 'r'</pre>
+
+h3. Specifying a filetype
+
+p. By default no filetype extension is given in the produced gravatar urls but of your application requires it you can specify one to be added to the generated url.
+
+<pre>gravatar_image_tag('spam@spam.com'.gsub('spam', 'mdeering'), :alt => 'Michael Deering', :gravatar => { :filetype => :gif } )</pre>
+
+p. You can globally set the filetype extension as follows.
+
+<pre># config/initializers/gravatar_defaults.rb
+ActionView::Base.default_gravatar_filetype  = :gif</pre>
 
 h2. Credits
 

data/lib/gravatar_image_tag.rb

@@ -1,9 +1,8 @@
 module GravatarImageTag
 
-  GRAVATAR_BASE_URL = 'http://www.gravatar.com/avatar.php'
-
   def self.included(base)
-    base.cattr_accessor :default_gravatar_image, :default_gravatar_size
+    base.cattr_accessor :default_gravatar_filetype, :default_gravatar_image,
+      :default_gravatar_rating, :default_gravatar_size,  :secure_gravatar
     base.send :include, InstanceMethods
   end
 
@@ -11,20 +10,37 @@ module GravatarImageTag
 
     def gravatar_image_tag(email, options = {})
       options[:src] = gravatar_url( email, options.delete( :gravatar ) )
-      options[:alt] ||= File.basename(options[:src], '.*').split('.').first.to_s.capitalize
+      options[:alt] ||= 'Gravatar'
       tag 'img', options, false, false # Patch submitted to rails to allow image_tag here https://rails.lighthouseapp.com/projects/8994/tickets/2878-image_tag-doesnt-allow-escape-false-option-anymore
     end
 
     def gravatar_url(email, overrides)
       overrides ||= {}
-      url_params = {
+      gravatar_params = {
         :default     => ActionView::Base.default_gravatar_image,
-        :gravatar_id => Digest::MD5.hexdigest(email),
+        :filetype    => ActionView::Base.default_gravatar_filetype,
+        :rating      => ActionView::Base.default_gravatar_rating,
+        :secure      => ActionView::Base.secure_gravatar,
         :size        => ActionView::Base.default_gravatar_size
       }.merge(overrides).delete_if { |key, value| value.nil? }
-      "#{GRAVATAR_BASE_URL}?#{url_params.map { |key, value| "#{key}=#{URI.escape(value.is_a?(String) ? value : value.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))}"}.join('&')}"
+      "#{gravatar_url_base(gravatar_params.delete(:secure))}/#{gravatar_id(email, gravatar_params.delete(:filetype))}#{url_params(gravatar_params)}"
     end
 
+    private
+
+      def gravatar_url_base(secure = false)
+        'http' + (!!secure ? 's://secure.' : '://') + 'gravatar.com/avatar'
+      end
+
+      def gravatar_id(email, filetype = nil)
+        "#{ Digest::MD5.hexdigest(email) }#{ ".#{filetype}" unless filetype.nil? }"
+      end
+
+      def url_params(gravatar_params)
+        return nil if gravatar_params.keys.count == 0
+        "?#{gravatar_params.map { |key, value| "#{key}=#{URI.escape(value.is_a?(String) ? value : value.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))}"}.join('&')}"
+      end
+
   end
 
 end

data/spec/gravatar_image_tag_spec.rb

@@ -8,8 +8,10 @@ describe GravatarImageTag do
 
   email                 = 'mdeering@mdeering.com'
   md5                   = '4da9ad2bd4a2d1ce3c428e32c423588a'
+  default_filetype      = :gif
   default_image         = 'http://mdeering.com/images/default_gravatar.png'
   default_image_escaped = 'http%3A%2F%2Fmdeering.com%2Fimages%2Fdefault_gravatar.png'
+  default_rating        = 'x'
   default_size          = 50
   other_image           = 'http://mdeering.com/images/other_gravatar.png'
   other_image_escaped   = 'http%3A%2F%2Fmdeering.com%2Fimages%2Fother_gravatar.png'
@@ -18,6 +20,7 @@ describe GravatarImageTag do
 
   {
     { :gravatar_id => md5 } => {},
+    { :gravatar_id => md5 } => { :gravatar => { :rating => 'x' } },
     { :gravatar_id => md5, :size => 30 } => { :gravatar => {:size => 30 } },
     { :gravatar_id => md5, :default => other_image_escaped } => { :gravatar => {:default => other_image } },
     { :gravatar_id => md5, :default => other_image_escaped, :size => 30 } => { :gravatar => {:default => other_image, :size => 30 } }
@@ -25,13 +28,16 @@ describe GravatarImageTag do
     it "#gravatar_image_tag should create the provided url with the provided options #{options}"  do
       view = ActionView::Base.new
       image_tag = view.gravatar_image_tag(email, options)
+      image_tag.include?("#{params.delete(:gravatar_id)}").should be_true
       params.all? {|key, value| image_tag.include?("#{key}=#{value}")}.should be_true
     end
   end
 
   {
-    :default_gravatar_image => default_image,
-    :default_gravatar_size  => default_size
+    :default_gravatar_image    => default_image,
+    :default_gravatar_filetype => default_filetype,
+    :default_gravatar_rating   => default_rating,
+    :default_gravatar_size     => default_size
   }.each do |singleton_variable, value|
     it "should create gravatar class (singleton) variable #{singleton_variable} on its included class" do
       ActionView::Base.send(singleton_variable).should == nil
@@ -50,8 +56,17 @@ describe GravatarImageTag do
     it "#gravatar_image_tag should create the provided url when defaults have been set with the provided options #{options}"  do
       view = ActionView::Base.new
       image_tag = view.gravatar_image_tag(email, options)
+      image_tag.include?("#{params.delete(:gravatar_id)}.#{default_filetype}").should be_true
       params.all? {|key, value| image_tag.include?("#{key}=#{value}")}.should be_true
     end
   end
 
+  it 'should request the gravatar image from the non-secure server if the https => false option is given' do
+    (!!view.gravatar_image_tag(email, { :gravatar => { :secure => false } }).match(/^https:\/\/secure.gravatar.com\/avatar\//)).should be_false
+  end
+
+  it 'should request the gravatar image from the secure server if the https => true option is given' do
+    (!!view.gravatar_image_tag(email, { :gravatar => { :secure => true } }).match(/src="https:\/\/secure.gravatar.com\/avatar\//)).should be_true
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: gravatar_image_tag
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Michael Deering