bcms_thumbnail 1.0.3 → 1.0.4

data/README

@@ -34,6 +34,10 @@ The above, but only for images with a certain tag? Oh, hell yes:
 
 Note: The code above is yucky. But cool.
 
+You can also create square thumbnails via the "thumbnail_square" helper. You should only pass a single integer in for geometry when create a square thumbnail.
+  <% image = ImageBlock.find(:first) %>
+  <%= image_tag(thumbnail_square(image,'125')) %>
+
 == Geometries
 
 ImageMagick will preserve aspect ratio with all the geometries below: 
@@ -45,10 +49,15 @@ ImageMagick will preserve aspect ratio with all the geometries below:
 
 More info on ImageMagick geometry here: http://www.imagemagick.org/www/command-line-processing.html#geometry
 
+Remember that "thumbnail_square" only requires a single integer for its geometry string.
+
+== Gotchas
+
+* Thumbnails are generated when the helper method is called. If you clear the thumbnail cache and don't clear the page cache right afterwards, you may have cached pages calling for thumbnails that aren't regenerated - because the helper method call creates the image.  Be sure to clear your page cache after clearing your thumbnail cache and you'll be fine.
+* Speaking of caches - this does nothing to automatically clean up old cached thumbnails from images that've changed or that've been deleted. If you find that these old thumbnails are eating up too much space, Use the rake task to clear out the cache. Be sure to follow it with a page cache flush.
+
 == Todo
 
-* Decache thumbnails when image attachments change via a monkey-patch on the bcms core attachment features.
-* Hook image de-caching into the page de-caching control built into the bcms backend.
 * Beef up the thumbnail helper to expose more mini_magick features.
 * Better error reporting and sanity checking. 
 

data/lib/bcms_thumbnail/bcms_thumbnail.rb

@@ -5,8 +5,20 @@ module ActionView
     module_function
 
     def thumbnail(attachment_obj,geometry = '100x100')
+      thumbnail_engine(attachment_obj,geometry,false)
+    end
+
+    def thumbnail_square(attachment_obj,geometry = '100')
+      fixed_geometry = geometry
+      if geometry.match(/\D/)
+        fixed_geometry = geometry.split(/\D/)[0]
+      end
+      thumbnail_engine(attachment_obj,geometry,true)
+    end
+
+    def thumbnail_engine(attachment_obj,geometry = '100x100',square = false)
       if ! attachment_obj.blank? && attachment_obj.respond_to?('attachment') && ['jpg','png','gif','bmp'].include?(attachment_obj.attachment.file_extension.downcase)
-        thumbnail_location = "/bcms_thumbnail_cache/#{geometry}/#{attachment_obj.attachment.file_location.gsub(/[\\\/]/,'-')}.jpg"
+        thumbnail_location = "/bcms_thumbnail_cache/#{geometry}/#{attachment_obj.attachment.file_location.gsub(/[\\\/]/,'-')}#{(square) ? '-square' : ''}.jpg"
         if ! File.exists?("#{RAILS_ROOT}/public#{thumbnail_location}")
           if ! File.exists?("#{RAILS_ROOT}/public/bcms_thumbnail_cache/#{geometry}")
             FileUtils.mkdir_p("#{RAILS_ROOT}/public/bcms_thumbnail_cache/#{geometry}")
@@ -14,7 +26,18 @@ module ActionView
             FileUtils.chmod 0755, "#{RAILS_ROOT}/public/bcms_thumbnail_cache/#{geometry}"
           end
           image = MiniMagick::Image.from_file("#{RAILS_ROOT}/tmp/uploads/#{attachment_obj.attachment.file_location}")
-          image.resize geometry
+          if square
+            if image[:width] < image[:height]
+              remove = ((image[:height] - image[:width])/2).round
+              image.shave "0x#{remove}"
+            elsif image[:width] > image[:height]
+              remove = ((image[:width] - image[:height])/2).round
+              image.shave "#{remove}x0"
+            end
+            image.resize "#{geometry}x#{geometry}"
+          else
+            image.resize geometry
+          end
           image.write("#{RAILS_ROOT}/public#{thumbnail_location}")
           FileUtils.chmod 0644, "#{RAILS_ROOT}/public#{thumbnail_location}"
           URI::escape(thumbnail_location)
@@ -26,5 +49,6 @@ module ActionView
         '/image-not-found'
       end
     end
+
   end
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 1
   - 0
-  - 3
-  version: 1.0.3
+  - 4
+  version: 1.0.4
 platform: ruby
 authors: 
 - Dan Collis-Puro
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-25 00:00:00 -04:00
+date: 2010-05-09 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency