kuppayam 0.1.0 → 0.1.1

data/app/helpers/document_helper.rb

@@ -0,0 +1,40 @@
+module DocumentHelper
+
+  # Returns new associated url or edit existing associated url based on object is associated with associated or not
+  # @example Basic Usage - User without Image
+  #   >>> upload_document_link(@user, :profile_picture, :admin)
+  #   "/admin/documents/new"
+  #
+  # @example Basic Usage - User with Iamge
+  #
+  #   >>> upload_document_link(@user_with_document, :profile_picture, :admin)
+  #   "/admin/documents/1/edit"
+  #
+  # @example Basic Usage - Custom Scope
+  #
+  #   >>> upload_document_link(@project, :profile_picture, :customer)
+  #   "/customer/documents/new"
+  #   >>> upload_document_link(@project_with_document, :profile_picture, :customer)
+  #   "/customer/documents/1/edit"
+  def upload_document_link(object, assoc_name=:associated, scope=:admin, **options)
+    associated_object = nil
+    associated_object =  object.send(assoc_name) if object.respond_to?(assoc_name)
+    if associated_object.present? && associated_object.persisted?
+      main_app.url_for([:edit, scope, :document, id: associated_object.id, documentable_id: object.id, documentable_type: object.class.to_s, document_type: associated_object.class.name])
+    else
+      associated_object = object.send("build_#{assoc_name}")
+      main_app.url_for([:new, scope, :document, documentable_id: object.id, documentable_type: object.class.to_s, document_type: associated_object.class.name])
+    end
+  end
+
+  def import_data_link(object, class_name, assoc_name=:associated, scope=nil, **options)
+    if object.present?
+      #main_app.url_for([:edit, scope, :import_data, data_type: class_name])
+      edit_import_data_url(object, data_type: class_name)
+    else
+      #main_app.url_for([:new, scope, :import_data, data_type: class_name])
+      new_import_data_url(data_type: class_name)
+    end
+  end
+
+end

data/app/helpers/flash_helper.rb

@@ -43,12 +43,4 @@ module FlashHelper
       raw(link_to("×", "#", class: "close", "data-dismiss" => "alert") + content_tag(:p, message))
     end unless message.blank?
   end
-
-  def set_notification_messages(id, alert_type, now_type=false)
-    @heading = I18n.t("#{id}.heading")
-    @message = I18n.t("#{id}.message")
-    @alert ||= "#{@heading}: #{@message}"
-    @alert_type = alert_type
-    set_flash_message(@alert, alert_type, now_type) if defined?(flash) && flash
-  end
 end

data/app/helpers/image_helper.rb

@@ -29,10 +29,10 @@ module ImageHelper
   # image_url is a helper method which can be used along with carrier_wave gem
   # Suppose, you have an object 'user' which has a profile_picture
   # image_url will return you the system default image url if profile_picture is not set else it will return you the carrier wave url
-  # the convention is that the there is a folder named defaults in /assets which has user-medium.png file
-  # user-medium => user is the class name and medium is the size name
+  # the convention is that the there is a folder named defaults in /assets which has user-small.png file
+  # user-small => user is the class name and small is the size name
   # for e.g: if the class name is JackFruit, then:
-  #   the filename which it expect would be /assets/defaults/jackfruit-medium.png
+  #   the filename which it expect would be /assets/defaults/jackfruit-small.png
   #
   # @example Basic Usage without Image
   #
@@ -77,106 +77,66 @@ module ImageHelper
   #   >>> display_image(user_with_image, 'profile_picture.image.large.url', width: "30px", height: "50px", size: "small")
   #   "<img class=\"\" width=\"30px\" height=\"50px\" src=\"/spec/dummy/uploads/image/profile_picture/1/large_test.jpg\" alt=\"Large test\" />"
   def display_image(object, method_name, **options)
-    options.reverse_merge!(size: "small")
+    options.reverse_merge!(size: "large")
     options.reverse_merge!(
       width: "100%",
       height: "auto",
       place_holder: {},
-      class: object.persisted? ? "#{object.id}-#{options[:size]}-image" : ""
+      class: ""
     )
 
+    options[:class] = options[:class] + (object.persisted? ? " #{object.id}-#{options[:size]}-image" : "")
+
     img_url = image_url(object, method_name, **options)
     return image_tag(img_url, class: options[:class], width: options[:width], height: options[:height])
   end
 
-  # @example Basic Usage
-  #
-  #   >>> display_user_image(@user, 'profile_picture.image.thumb.url')
-  #   "<div><div class="rounded" style="width:60px;height:60px;"><img alt="Thumb krishnan" class="" src="/uploads/image/profile_picture/39/thumb_krishnan.jpg" style="width:100%;height:auto;cursor:default;"></div></div>"
-  #
-  # @example Advanced Usage with
-  #
-  #   >>> display_user_image(@user, 'profile_picture.image.thumb.url', width: 100px, height: 100px)
-  #   "<div><div class="rounded" style="width:100px;height:60px;"><img alt="Thumb krishnan" class="" src="/uploads/image/profile_picture/39/thumb_krishnan.jpg" style="width:100%;height:auto;cursor:default;"></div></div>"
-  def display_user_image(user, method_name, **options)
-
-    url_domain = defined?(QAuthRubyCustomer) ? QAuthRubyCustomer.configuration.q_auth_url : ""
-
-    options.reverse_merge!(
-      width: "60px",
-      height: "auto",
-      size: "medium",
-      url_domain: url_domain,
-      place_holder: {},
-      html_options: {}
-    )
-
-    options[:html_options].reverse_merge!(
-      style: "width:100%;height:auto;cursor:#{options.has_key?(:popover) ? "pointer" : "default"};",
-      class: user.persisted? ? "#{user.id}-#{options[:size]}-image" : ""
-    )
-
-    if user.respond_to?(:name)
-      options[:place_holder].reverse_merge!(text: namify(user.name))
-    end
-
-    options[:html_options].reverse_merge!(
-      "data-toggle" => "popover",
-      "data-placement" => "bottom",
-      "title" => user.name,
-      "data-content" => options[:popover] === true ? "" : options[:popover].to_s
-    ) if options[:popover]
-
-    begin
-      image_path = user.send(:eval, method_name)
-      if image_path.starts_with?(:http)
-        url = image_path
-      else
-        url = options[:url_domain] + image_path
-      end
-    rescue
-      url = image_url(user, method_name, **options)
-    end
-
-    content_tag(:div) do
-      content_tag(:div, class: "rounded", style: "width:#{options[:width]};height:#{options[:height]}") do
-        image_tag(url, options[:html_options])
-      end
-    end
-  end
-
   # Displays the image with a edit button below it
   # @example Basic Usage
   #   >>> edit_image(@project, "logo.image.url", edit_url, width: "100px", height: "auto")
   #   ""
-  def edit_image(object, method_name, edit_url, **options)
+  def edit_image(object, method_name, edit_url, delete_url, **options)
     options.reverse_merge!(
+      image_options: {},
+      edit_options: {},
+      delete_options: {}
+    )
+
+    # options[:image_options].reverse_merge!()
+    options[:edit_options].reverse_merge!(
       remote: true,
       text: "Change Image",
       icon: "photo",
-      classes: "btn btn-white btn-block btn-xs mt-10"
+      class: "btn btn-primary btn-block btn-only-hover btn-xs",
     )
-    img_tag = display_image(object, method_name, **options)
-    btn_display = raw(theme_fa_icon(options[:icon]) + theme_button_text(options[:text]))
-    link_to(img_tag, edit_url, :remote => options[:remote]) +
-    link_to(btn_display, edit_url, :class=>options[:classes], :remote=>options[:remote])
-  end
 
-  # Displays the user image in a rounded frame with a edit button below it
-  # @example Basic Usage
-  #   >>> edit_user_image(@project, "logo.image.url", edit_url, width: "100px", height: "auto")
-  #   ""
-  def edit_user_image(object, method_name, edit_url, **options)
-    options.reverse_merge!(
+    options[:delete_options].reverse_merge!(
       remote: true,
-      text: "Change Image",
-      icon: "photo",
-      classes: "btn btn-default btn-xs mt-10"
+      text: "Remove Image",
+      icon: "trash",
+      class: "btn btn-danger btn-block btn-only-hover btn-xs"
     )
-    img_tag = display_user_image(object, method_name, **options)
-    btn_display = raw(theme_fa_icon(options[:icon]) + theme_button_text(options[:text]))
-    link_to(img_tag, edit_url, :remote => options[:remote]) +
-    link_to(btn_display, edit_url, :class=>options[:classes], :remote=>options[:remote])
+  
+    # Image HTML    
+    image_tag = display_image(object, method_name, **options[:image_options])
+
+    # Edit Button
+    edit_btn_display = raw(theme_fa_icon(options[:edit_options][:icon]) + theme_button_text(options[:edit_options][:text]))
+    edit_btn = link_to(edit_btn_display, edit_url, :class=>options[:edit_options][:class], :remote=>options[:edit_options][:remote])
+
+    # Remove Button (only if the object is persisted)
+    assoc_name = options[:image_options][:assoc_name]
+    image_object = nil
+    image_object =  object.send(assoc_name) if object.respond_to?(assoc_name)
+    if image_object && image_object.persisted?
+      remove_btn_display = raw(theme_fa_icon(options[:delete_options][:icon]) + theme_button_text(options[:delete_options][:text]))
+      remove_btn = link_to(remove_btn_display, delete_url, :class=>options[:delete_options][:class], :remote=>options[:delete_options][:remote])
+    end
+
+    link_to(image_tag, edit_url, :remote => options[:remote]) +
+    content_tag(:div, class: "btn-group btn-group-justified mt-30") do
+      edit_btn + (object.persisted? ? remove_btn : "")
+    end
   end
 
   # Returns new photo url or edit existing photo url based on object is associated with photo or not
@@ -196,14 +156,23 @@ module ImageHelper
   #   >>> upload_image_link(@project_with_image, :profile_picture, :customer)
   #   "/customer/images/1/edit"
   def upload_image_link(object, assoc_name=:photo, scope=:admin, **options)
-    photo_object = nil
-    photo_object =  object.send(assoc_name) if object.respond_to?(assoc_name)
-    #binding.pry
-    if photo_object.present? && photo_object.persisted?
-      url_for([:edit, scope, :image, id: photo_object.id, imageable_id: object.id, imageable_type: object.class.to_s, image_type: photo_object.class.name, account_id: options[:account_id]])
+    image_object = nil
+    image_object =  object.send(assoc_name) if object.respond_to?(assoc_name)
+    if image_object.present? && image_object.persisted?
+      main_app.url_for([:edit, scope, :image, id: image_object.id, imageable_id: object.id, imageable_type: object.class.to_s, image_type: image_object.class.name])
+    else
+      image_object = object.send("build_#{assoc_name}")
+      main_app.url_for([:new, scope, :image, imageable_id: object.id, imageable_type: object.class.to_s, image_type: image_object.class.name])
+    end
+  end
+
+  def remove_image_link(object, assoc_name=:photo, scope=:admin, **options)
+    image_object = nil
+    image_object =  object.send(assoc_name) if object.respond_to?(assoc_name)
+    if image_object.persisted?
+      main_app.url_for([scope, :image, id: image_object.id, imageable_id: object.id, imageable_type: object.class.to_s, image_type: image_object.class.name])
     else
-      photo_object = object.send("build_#{assoc_name}")
-      url_for([:new, scope, :image, imageable_id: object.id, imageable_type: object.class.to_s, image_type: photo_object.class.name, account_id: options[:account_id]])
+      "#"
     end
   end
 end

data/app/helpers/notification_helper.rb

@@ -0,0 +1,41 @@
+module NotificationHelper
+  # This function will set a notification message depending up on the request type (ajax - xml http or direct http)
+  # Example
+  #   set_notification("Success", "The message has been sent successfully")
+  #   set_notification("Success", "Permission denied")
+
+  def default_notification_configuration
+    {
+      success: false,
+      title: "<NOT SET>",
+      message: "<NO MESSAGE SET>"
+    }
+  end
+
+  def configure_notification
+    if defined?(@notification)
+      @notification.reverse_merge!(default_notification_configuration)
+    else
+      @notification = default_notification_configuration
+    end
+  end
+
+  def set_notification(success, title, message)
+    @notification[:success] = success
+    @notification[:title] = title
+    @notification[:message] = message
+  end
+
+  def set_resource_notification(obj)
+    if obj.errors.any?
+      @notification[:success] = false
+      @notification[:title] = I18n.translate("status.error")
+      @notification[:message] = obj.errors.full_messages.join("<br>")
+    else
+      @notification[:success] = true
+      @notification[:title] = I18n.translate("status.success")
+      @notification[:message] = I18n.translate("success.saved", item: default_item_name.titleize)
+    end
+  end
+
+end

data/app/helpers/render_helper.rb

@@ -1,5 +1,25 @@
 module RenderHelper
 
+  def render_404
+    respond_to do |format|
+      format.html { render :file => "#{Rails.root}/public/404", :layout => true, :status => :not_found }
+      format.any  { head :not_found }
+    end
+  end
+
+  def handle_invalid_authenticity_token
+    heading = I18n.t("status.invalid_token.heading")
+    message = I18n.t("status.invalid_token.message")
+    js_message = <<-eos
+      showMessageModal('#{heading}','#{message}');
+      notifyError('#{heading}','#{message}');
+    eos
+    respond_to do |format|
+      format.html { render :status => 404 }
+      format.js { render text: js_message }
+    end
+  end
+
   def render_or_redirect(error, redirect_url, action, notice=nil)
     respond_to do |format|
       format.html {
@@ -9,20 +29,39 @@ module RenderHelper
           redirect_to redirect_url, notice: notice
         end
       }
-      format.js {}
+      format.js {
+        view_path = @resource_options && @resource_options[:view_path] ? "#{@resource_options[:js_view_path]}/#{params[:action]}" : params[:action].to_s
+        render view_path
+      }
     end
   end
 
-  def render_list
+  def render_accordingly
     respond_to do |format|
-      format.html { get_collections and render :index }
-      format.js {}
+      format.html { get_collections and render params[:action].to_sym }
+      format.js  { 
+        view_path = @resource_options && @resource_options[:view_path] ? "#{@resource_options[:js_view_path]}/#{params[:action]}" : params[:action].to_sym
+        render view_path
+      }
     end
   end
 
   def render_show
     respond_to do |format|
-      format.js { render action: :show }
+      format.js { 
+        js_view_path = @resource_options && @resource_options[:view_path] ? "#{@resource_options[:js_view_path]}/show" : :show
+        render js_view_path
+      }
+    end
+  end
+
+  def render_row
+    respond_to do |format|
+      format.html {}
+      format.js  { 
+        js_view_path = @resource_options && @resource_options[:js_view_path] ? "#{@resource_options[:js_view_path]}/row" : :row 
+        render js_view_path
+      }
     end
   end
 end

data/app/helpers/resource_helper.rb

@@ -2,52 +2,105 @@ module ResourceHelper
 
   def index
     get_collections
+    respond_to do |format|
+      format.html {}
+      format.js  { 
+        js_view_path = @resource_options && @resource_options[:js_view_path] ? "#{@resource_options[:js_view_path]}/index" : :index 
+        render js_view_path
+      }
+    end
   end
 
   def show
-    obj = @options[:class].find(params[:id])
-    instance_variable_set("@#{@options[:item_name]}", obj)
-    render_list
+    @r_object = @resource_options[:class].find_by_id(params[:id])
+    if @r_object
+      instance_variable_set("@#{@resource_options[:item_name]}", @r_object)
+    else
+      set_notification(false, I18n.t('status.error'), I18n.t('status.not_found', item: default_item_name.titleize))
+    end
+    render_accordingly
   end
 
   def new
-    obj = @options[:class].new
-    instance_variable_set("@#{@options[:item_name]}", obj)
-    render_list
+    @r_object = @resource_options[:class].new
+    instance_variable_set("@#{@resource_options[:item_name]}", @r_object)
+    render_accordingly
   end
 
   def edit
-    obj = @options[:class].find(params[:id])
-    instance_variable_set("@#{@options[:item_name]}", obj)
-    render_list
+    @r_object = @resource_options[:class].find_by_id(params[:id])
+    if @r_object
+      instance_variable_set("@#{@resource_options[:item_name]}", @r_object)
+    else
+      set_notification(false, I18n.t('status.error'), I18n.t('status.not_found', item: default_item_name.titleize))
+    end
+    render_accordingly
   end
 
   def create
-    obj = @options[:class].new
-    obj.assign_attributes(permitted_params)
-    instance_variable_set("@#{@options[:item_name]}", obj)
-    save_resource(obj)
+    @r_object = @resource_options[:class].new
+    @r_object.assign_attributes(permitted_params)
+    instance_variable_set("@#{@resource_options[:item_name]}", @r_object)
+    save_resource
   end
 
   def update
-    obj = @options[:class].find(params[:id])
-    obj.assign_attributes(permitted_params)
-    instance_variable_set("@#{@options[:item_name]}", obj)
-    save_resource(obj)
+    @r_object = @resource_options[:class].find_by_id(params[:id])
+    if @r_object
+      @r_object.assign_attributes(permitted_params)
+      instance_variable_set("@#{@resource_options[:item_name]}", @r_object)
+      save_resource
+    else
+      set_notification(false, I18n.t('status.error'), I18n.t('status.not_found', item: default_item_name.titleize))
+    end
   end
 
   def destroy
-    obj = @options[:class].find(params[:id])
-    instance_variable_set("@#{@options[:item_name]}", obj)
-    if obj.can_be_destroyed?
-      obj.destroy
-      get_collections
-      set_flash_message(@options[:messages][:delete], :success)
-      @destroyed = true
+    @r_object = @resource_options[:class].find_by_id(params[:id])
+    
+    if @r_object
+      instance_variable_set("@#{@resource_options[:item_name]}", @r_object)
+      if @r_object.can_be_deleted?
+        @r_object.destroy
+        get_collections
+        set_flash_message(I18n.t('success.deleted'), :success)
+        set_notification(false, I18n.t('status.success'), I18n.t('success.deleted', item: default_item_name.titleize))
+        @destroyed = true
+      else
+        message = I18n.t('errors.failed_to_delete', item: default_item_name.titleize)
+        set_flash_message(message, :failure)
+        set_notification(false, I18n.t('status.error'), message)
+        @destroyed = false
+      end
     else
-      set_flash_message("Cannot remove! Remove the dependant data first", :failure)
-      @destroyed = false
+      set_notification(false, I18n.t('status.error'), I18n.t('status.not_found', item: default_item_name.titleize))
     end
+    
+    respond_to do |format|
+      format.html {}
+      format.js  { 
+        js_view_path = @resource_options && @resource_options[:js_view_path] ? "#{@resource_options[:js_view_path]}/destroy" : :destroy 
+        render js_view_path
+      }
+    end
+
+  end
+
+  def update_status
+    @r_object = @resource_options[:class].find_by_id(params[:id])
+    if @r_object
+      instance_variable_set("@#{@resource_options[:item_name]}", @r_object)
+      @r_object.status = params[:status]
+      if @r_object.valid?
+        @r_object.save
+        set_notification(true, I18n.t('status.success'), I18n.t('state.changed', item: default_item_name.titleize, new_state: @r_object.status))
+      else
+        set_notification(false, I18n.t('status.error'), I18n.translate("error"), @r_object.errors.full_messages.join("<br>"))
+      end
+    else
+      set_notification(false, I18n.t('status.not_found'), I18n.t('status.not_found', item: default_item_name.titleize))
+    end
+    render_row
   end
 
   private
@@ -72,33 +125,34 @@ module ResourceHelper
     default_collection_name.singularize.camelize.constantize
   end
 
+  def resource_controller_configuration
+    {}
+  end
+
   def default_resource_controller_configuration
     {
+      page_title: "Page Title | Kuppayam",
+      current_nav: "kuppayam/current_page",
       collection_name: default_collection_name,
       item_name: default_item_name,
       class: default_class,
       layout: :table,
-      messages: {
-        add: I18n.translate("forms.add", item: default_item_name.titleize),
-        create: I18n.translate("forms.create", item: default_item_name.titleize),
-        update: I18n.translate("forms.update", item: default_item_name.titleize),
-        save: I18n.translate("forms.save", item: default_item_name.titleize),
-        remove: I18n.translate("forms.remove", item: default_item_name.titleize),
-        delete: I18n.translate("forms.delete",item:  default_item_name.titleize)
-      }
+      view_path: "/kuppayam/workflows/peacock",
+      js_view_path: "/kuppayam/workflows/peacock"
     }
   end
 
   def configure_resource_controller
-    if defined?(@options)
-      @options.reverse_merge!(default_resource_controller_configuration)
-    else
-      @options = default_resource_controller_configuration
-    end
+    @resource_options = resource_controller_configuration
+    @resource_options.reverse_merge!(default_resource_controller_configuration)
+
+    # Set Default Title
+    set_title(@resource_options[:page_title])
+    set_nav(@resource_options[:current_nav])
   end
 
   def prepare_query
-    @relation = @options[:class].where("")
+    @relation = @resource_options[:class].where("")
     if params[:query]
       @query = params[:query].strip
       @relation = @relation.search(@query) if !@query.blank?
@@ -107,27 +161,28 @@ module ResourceHelper
 
   def get_collections
     prepare_query
-    objects = @relation.order("created_at desc").page(@current_page).per(@per_page)
-    instance_variable_set("@#{@options[:collection_name]}", objects)
-    unless instance_variable_get("@#{@options[:item_name]}")
-      instance_variable_set("@#{@options[:item_name]}", objects.first)
+    @r_objects = @relation.order("created_at desc").page(@current_page).per(@per_page)
+    instance_variable_set("@#{@resource_options[:collection_name]}", @r_objects)
+    unless instance_variable_get("@#{@resource_options[:item_name]}")
+      instance_variable_set("@#{@resource_options[:item_name]}", @r_objects.first)
     end
     return true
   end
 
   def resource_url(obj)
-    url_for([:admin, obj])
+    url_for(obj)
   end
 
-  def save_resource(obj)
-    obj.save
-    if obj.errors.blank?
-      get_collections if @options[:layout] = :table
-      set_flash_message(@options[:messages][:save], :success) 
+  def save_resource
+    if @r_object.valid?
+      @r_object.save
+      get_collections if @resource_options[:layout] = :table
+      set_flash_message(I18n.translate("forms.save", item: default_item_name.titleize), :success) 
     end
+    set_resource_notification(@r_object)
     action_name = params[:action].to_s == "create" ? "new" : "edit"
-    url = obj.persisted? ? resource_url(obj) : nil
-    render_or_redirect(obj.errors.any?, url, action_name)
+    url = @r_object.persisted? ? resource_url(@r_object) : nil
+    render_or_redirect(@r_object.errors.any?, url, action_name)
   end
 
 end

data/app/models/document/base.rb

@@ -0,0 +1,43 @@
+class Document::Base < Kuppayam::ApplicationRecord
+
+	# Constants
+  UPLOAD_LIMIT = 10
+
+  self.table_name = "documents"
+  self.inheritance_column = :image_type
+
+  # Validations
+  validates :document, :presence => true
+  validate :file_size
+
+  # Associations
+  belongs_to :documentable, :polymorphic => true, optional: true
+
+  # ------------------
+  # Class Methods
+  # ------------------
+
+  # return an published record relation object with the search query in its where clause
+  # Return the ActiveRecord::Relation object
+  # == Examples
+  #   >>> document.search(query)
+  #   => ActiveRecord::Relation object
+  scope :search, lambda { |query| where("LOWER(imageable_type) LIKE LOWER('%#{query}%') OR\
+                                        LOWER(imageable_id) LIKE LOWER('%#{query}%')")
+                        }
+
+  # ------------------
+  # Instance Methods
+  # ------------------
+
+  def file_size
+    if document && document.file && document.file.size.to_f > UPLOAD_LIMIT.megabytes.to_f
+      errors.add(:document, "You cannot upload a document greater than #{UPLOAD_LIMIT.to_f} MB")
+    end
+  end
+
+  def display_name
+    "#{id} - #{self.class.name.split('::').last.titleize}"
+  end
+
+end

data/app/models/image/base.rb

@@ -0,0 +1,52 @@
+class Image::Base < Kuppayam::ApplicationRecord
+
+  # Constants
+  UPLOAD_LIMIT = 1
+
+  self.table_name = "images"
+  self.inheritance_column = :image_type
+
+  attr_accessor :crop_x, :crop_y, :crop_w, :crop_h
+
+  # Validations
+  validates :image, :presence => true
+  validate :file_size
+
+  # Associations
+  belongs_to :imageable, :polymorphic => true  #, optional: false
+
+  # Callbacks
+  after_save :crop_image
+
+  # ------------------
+  # Class Methods
+  # ------------------
+
+  # return an published record relation object with the search query in its where clause
+  # Return the ActiveRecord::Relation object
+  # == Examples
+  #   >>> image.search(query)
+  #   => ActiveRecord::Relation object
+  scope :search, lambda { |query| where("LOWER(imageable_type) LIKE LOWER('%#{query}%') OR\
+                                        LOWER(imageable_id) LIKE LOWER('%#{query}%')")
+                        }
+
+  # ------------------
+  # Instance Methods
+  # ------------------
+
+  def crop_image
+    image.recreate_versions! if crop_x.present?
+  end
+
+  def file_size
+    if image && image.file && image.file.size.to_f > UPLOAD_LIMIT.megabytes.to_f
+      errors.add(:image, "You cannot upload an image greater than #{UPLOAD_LIMIT.to_f} MB")
+    end
+  end
+
+  def display_name
+    "#{id} - #{self.class.name.split('::').last.titleize}"
+  end
+
+end