# encoding: utf-8 module DynamicImage # = DynamicImage Helper # # Provides helper methods for rendering and linking to images. module Helper # Returns the path for a DynamicImage::Model record. # Takes the same options as +dynamic_image_url+ def dynamic_image_path(record_or_array, options={}) dynamic_image_url(record_or_array, { routing_type: :path }.merge(options)) end # Returns an HTML image tag for the record. If no size is given, it will # render at the original size. # # ==== Options # * :alt: If no alt text is given, it will default to the # filename of the uploaded image. # # See +dynamic_image_url+ for info on how to size and cropping. Options # supported by +polymorphic_url+ will be passed to the router. Any other # options will be added as HTML attributes. # # ==== Examples # # image = Image.find(params[:id]) # dynamic_image_tag(image) # # => My file # dynamic_image_tag(image, size: "100x100", alt="Avatar") # # => Avatar def dynamic_image_tag(record_or_array, options={}) record = extract_dynamic_image_record(record_or_array) options = { alt: image_alt(record.filename) }.merge(options) size = fit_size!(record_or_array, options) url_options = options.extract!(*allowed_dynamic_image_url_options) html_options = { size: size }.merge(options) image_tag( dynamic_image_path_with_size( record_or_array, size, url_options ), html_options ) end # Returns the URL for a DynamicImage::Model record. # # ==== Options # # * :size - Desired image size, supplied as "{width}x{height}". # The image will be scaled to fit. A partial size like "100x" or "x100" # can be given, if you want a fixed width or height. # * :crop - If true, the image will be cropped to the given size. # * :upscale - By default, DynamicImage only scale images down, # never up. Pass upscale: true to force upscaling. # # Any options supported by +polymorphic_url+ are also accepted. # # ==== Examples # # image = Image.find(params[:id]) # dynamic_image_url(image) # # => "http://example.com/images/96...d1/300x187/1-2014062020...00.jpg" # dynamic_image_url(image, size: '100x100') # # => "http://example.com/images/72...c2/100x62/1-2014062020...00.jpg" # dynamic_image_url(image, size: '100x100', crop: true) # # => "http://example.com/images/a4...6b/100x100/1-2014062020...00.jpg" def dynamic_image_url(record_or_array, options={}) size = fit_size!(record_or_array, options) dynamic_image_url_with_size(record_or_array, size, options) end # Returns a path to the original uploaded file, without any processing # applied. Sizing options are not supported. def original_dynamic_image_path(record_or_array, options={}) dynamic_image_path(record_or_array, { action: :original }.merge(options)) end # Returns a URL to the original uploaded file, without any processing # applied. Sizing options are not supported. def original_dynamic_image_url(record_or_array, options={}) dynamic_image_url(record_or_array, { action: :original }.merge(options)) end # Same as +dynamic_image_path+, but points to an image with any # pre-cropping disabled. def uncropped_dynamic_image_path(record_or_array, options={}) dynamic_image_path(record_or_array, { action: :uncropped }.merge(options)) end # Same as +dynamic_image_tag+, but renders an image with any # pre-cropping disabled. def uncropped_dynamic_image_tag(record_or_array, options={}) dynamic_image_tag(record_or_array, { action: :uncropped }.merge(options)) end # Same as +dynamic_image_url+, but points to an image with any # pre-cropping disabled. def uncropped_dynamic_image_url(record_or_array, options={}) dynamic_image_url(record_or_array, { action: :uncropped }.merge(options)) end private def allowed_dynamic_image_url_options [ :format, :only_path, :protocol, :host, :subdomain, :domain, :tld_length, :port, :anchor, :trailing_slash, :script_name, :action, :routing_type ] end def default_format_for_image(record) Mime::Type.lookup(record.safe_content_type).to_sym end def dynamic_image_digest(record, action, size=nil) key = [action || 'show', record.id, size].compact.join('-') DynamicImage.digest_verifier.generate(key) end def dynamic_image_path_with_size(record_or_array, size=nil, options={}) dynamic_image_url_with_size(record_or_array, size, { routing_type: :path }.merge(options)) end def dynamic_image_url_with_size(record_or_array, size=nil, options={}) record = extract_dynamic_image_record(record_or_array) options = { routing_type: :url, action: nil, format: default_format_for_image(record), size: size }.merge(options) options[:digest] = dynamic_image_digest(record, options[:action], options[:size]) polymorphic_url(record_or_array, options) end def extract_dynamic_image_record(record_or_array) case record_or_array when Array record_or_array.last else record_or_array end end def fit_size!(record_or_array, options) record = extract_dynamic_image_record(record_or_array) action = options[:action].try(:to_s) size_opts = options.extract!(:size, :crop, :upscale) if size_opts[:size] DynamicImage::ImageSizing.new( record, uncropped: (action == "uncropped") ).fit(size_opts[:size], size_opts).floor.to_s elsif action == "original" record.real_size.floor.to_s else record.size.floor.to_s end end end end