Class: Alchemy::Picture
- Inherits:
-
BaseRecord
- Object
- ActiveRecord::Base
- BaseRecord
- Alchemy::Picture
- Includes:
- Logger, NameConversions, Calculations, Taggable, TouchElements
- Defined in:
- app/models/alchemy/picture.rb,
app/models/alchemy/picture/url.rb,
app/models/alchemy/picture/calculations.rb,
app/models/alchemy/picture/preprocessor.rb
Defined Under Namespace
Modules: Calculations, Transformations Classes: Preprocessor, Url
Constant Summary collapse
- THUMBNAIL_SIZES =
{ small: "80x60", medium: "160x120", large: "240x180" }.with_indifferent_access.freeze
- CONVERTIBLE_FILE_FORMATS =
%w[gif jpg jpeg png webp].freeze
- TRANSFORMATION_OPTIONS =
[ :crop, :crop_from, :crop_size, :flatten, :format, :quality, :size, :upsample ]
Constants included from SearchableResource
SearchableResource::SEARCHABLE_COLUMN_TYPES
Class Method Summary collapse
- .alchemy_resource_filters ⇒ Object
- .allowed_filetypes ⇒ Object
- .last_upload ⇒ Object
-
.preprocessor_class ⇒ Object
Image preprocessing class.
-
.preprocessor_class=(klass) ⇒ Object
Set a image preprocessing class.
- .searchable_alchemy_resource_attributes ⇒ Object
-
.url_class ⇒ Object
The class used to generate URLs for pictures.
-
.url_class=(klass) ⇒ Object
Set a different picture url class.
Instance Method Summary collapse
-
#convertible? ⇒ Boolean
Returns true if the image can be converted.
-
#default_render_format ⇒ Object
Returns the format the image should be rendered with.
-
#deletable? ⇒ Boolean
Returns true if picture is not assigned to any Picture ingredient.
-
#has_convertible_format? ⇒ Boolean
Returns true if the image can be converted into other formats.
-
#humanized_name ⇒ Object
Returns a humanized, readable name from image filename.
-
#image_file_dimensions ⇒ Object
A size String from original image file values.
-
#restricted? ⇒ Boolean
Checks if the picture is restricted.
-
#suffix ⇒ Object
Returns the suffix of the filename.
-
#to_jq_upload ⇒ Object
Returns a Hash suitable for jquery fileupload json.
-
#update_name_and_tag_list!(params) ⇒ Object
Updates name and tag_list attributes.
-
#url(options = {}) ⇒ String|Nil
Returns an url (or relative path) to a processed image for use inside an image_tag helper.
-
#urlname ⇒ Object
Returns an uri escaped name.
Methods included from Calculations
#can_be_cropped_to?, #image_size, #is_bigger_than?, #is_smaller_than?, #sizes_from_string
Methods included from TouchElements
Methods included from Taggable
Methods included from NameConversions
#convert_to_humanized_name, #convert_to_urlname
Methods included from Logger
Methods included from SearchableResource
#ransackable_associations, #ransackable_attributes, #ransortable_attributes
Class Method Details
.alchemy_resource_filters ⇒ Object
140 141 142 143 144 145 146 147 148 149 150 151 152 |
# File 'app/models/alchemy/picture.rb', line 140 def alchemy_resource_filters @_file_formats ||= distinct.pluck(:image_file_format).compact.presence || [] [ { name: :by_file_format, values: @_file_formats }, { name: :misc, values: %w[recent last_upload without_tag deletable] } ] end |
.allowed_filetypes ⇒ Object
99 100 101 |
# File 'app/models/alchemy/picture.rb', line 99 def allowed_filetypes Config.get(:uploader).fetch("allowed_filetypes", {}).fetch("alchemy/pictures", []) end |
.last_upload ⇒ Object
158 159 160 161 162 163 |
# File 'app/models/alchemy/picture.rb', line 158 def last_upload last_picture = Picture.last return Picture.all unless last_picture Picture.where(upload_hash: last_picture.upload_hash) end |
.preprocessor_class ⇒ Object
Image preprocessing class
71 72 73 |
# File 'app/models/alchemy/picture.rb', line 71 def self.preprocessor_class @_preprocessor_class ||= Preprocessor end |
.preprocessor_class=(klass) ⇒ Object
Set a image preprocessing class
# config/initializers/alchemy.rb
Alchemy::Picture.preprocessor_class = My::ImagePreprocessor
80 81 82 |
# File 'app/models/alchemy/picture.rb', line 80 def self.preprocessor_class=(klass) @_preprocessor_class = klass end |
.searchable_alchemy_resource_attributes ⇒ Object
154 155 156 |
# File 'app/models/alchemy/picture.rb', line 154 def searchable_alchemy_resource_attributes %w[name image_file_name] end |
.url_class ⇒ Object
The class used to generate URLs for pictures
129 130 131 |
# File 'app/models/alchemy/picture.rb', line 129 def url_class @_url_class ||= Alchemy::Picture::Url end |
.url_class=(klass) ⇒ Object
Set a different picture url class
136 137 138 |
# File 'app/models/alchemy/picture.rb', line 136 def url_class=(klass) @_url_class = klass end |
Instance Method Details
#convertible? ⇒ Boolean
Returns true if the image can be converted
If the image_output_format
is set to nil
or original
or the image has not a convertible file format (i.e. SVG) this returns false
261 262 263 264 265 |
# File 'app/models/alchemy/picture.rb', line 261 def convertible? Config.get(:image_output_format) && Config.get(:image_output_format) != "original" && has_convertible_format? end |
#default_render_format ⇒ Object
Returns the format the image should be rendered with
Only returns a format differing from original if an image_output_format
is set in config and the image has a convertible file format.
248 249 250 251 252 253 254 |
# File 'app/models/alchemy/picture.rb', line 248 def default_render_format if convertible? Config.get(:image_output_format) else image_file_format end end |
#deletable? ⇒ Boolean
Returns true if picture is not assigned to any Picture ingredient.
287 288 289 |
# File 'app/models/alchemy/picture.rb', line 287 def deletable? picture_ingredients.empty? end |
#has_convertible_format? ⇒ Boolean
Returns true if the image can be converted into other formats
269 270 271 |
# File 'app/models/alchemy/picture.rb', line 269 def has_convertible_format? image_file_format.in?(CONVERTIBLE_FILE_FORMATS) end |
#humanized_name ⇒ Object
Returns a humanized, readable name from image filename.
237 238 239 240 241 |
# File 'app/models/alchemy/picture.rb', line 237 def humanized_name return "" if image_file_name.blank? convert_to_humanized_name(image_file_name, suffix) end |
#image_file_dimensions ⇒ Object
A size String from original image file values.
Example
200 x 100
297 298 299 |
# File 'app/models/alchemy/picture.rb', line 297 def image_file_dimensions "#{image_file_width}x#{image_file_height}" end |
#restricted? ⇒ Boolean
Checks if the picture is restricted.
A picture is only restricted if it’s assigned on restricted pages only.
Once a picture is assigned on a not restricted page, it is considered public and therefore not restricted any more, even if it is also assigned on a restricted page.
281 282 283 |
# File 'app/models/alchemy/picture.rb', line 281 def restricted? pages.any? && pages.not_restricted.blank? end |
#suffix ⇒ Object
Returns the suffix of the filename.
231 232 233 |
# File 'app/models/alchemy/picture.rb', line 231 def suffix image_file.ext end |
#to_jq_upload ⇒ Object
Returns a Hash suitable for jquery fileupload json.
211 212 213 214 215 216 217 |
# File 'app/models/alchemy/picture.rb', line 211 def to_jq_upload { name: image_file_name, size: image_file_size, error: errors[:image_file].join } end |
#update_name_and_tag_list!(params) ⇒ Object
Updates name and tag_list attributes.
Used by Admin::PicturesController#update_multiple
Note: Does not delete name value, if the form field is blank.
201 202 203 204 205 206 207 |
# File 'app/models/alchemy/picture.rb', line 201 def update_name_and_tag_list!(params) if params[:pictures_name].present? self.name = params[:pictures_name] end self.tag_list = params[:pictures_tag_list] save! end |
#url(options = {}) ⇒ String|Nil
Returns an url (or relative path) to a processed image for use inside an image_tag helper.
Any additional options are passed to the url method, so you can add params to your url.
Example:
<%= image_tag picture.url(size: '320x200', format: 'png') %>
179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 |
# File 'app/models/alchemy/picture.rb', line 179 def url( = {}) return unless image_file variant = PictureVariant.new(self, .slice(*TRANSFORMATION_OPTIONS)) self.class.url_class.new(variant).call( .except(*TRANSFORMATION_OPTIONS).merge( basename: name, ext: variant.render_format, name: name ) ) rescue ::Dragonfly::Job::Fetch::NotFound => e log_warning(e.) nil end |
#urlname ⇒ Object
Returns an uri escaped name.
221 222 223 224 225 226 227 |
# File 'app/models/alchemy/picture.rb', line 221 def urlname if name.blank? "image_#{id}" else ::CGI.escape(name.gsub(/\.(gif|png|jpe?g|tiff?)/i, "").tr(".", " ")) end end |