# == Schema Information # # Table name: alchemy_elements # # id :integer not null, primary key # name :string(255) # position :integer # page_id :integer # public :boolean default(TRUE) # folded :boolean default(FALSE) # unique :boolean default(FALSE) # created_at :datetime not null # updated_at :datetime not null # creator_id :integer # updater_id :integer # cell_id :integer # cached_tag_list :text # module Alchemy class Element < ActiveRecord::Base include Alchemy::Logger include Alchemy::Touching include Alchemy::Hints FORBIDDEN_DEFINITION_ATTRIBUTES = %w(contents available_contents amount picture_gallery taggable hint) SKIPPED_ATTRIBUTES_ON_COPY = %w(id position folded created_at updated_at creator_id updater_id cached_tag_list) acts_as_taggable # All Elements inside a cell are a list. All Elements not in cell are in the cell_id.nil list. acts_as_list scope: [:page_id, :cell_id] stampable stamper_class_name: Alchemy.user_class_name has_many :contents, -> { order(:position) }, dependent: :destroy belongs_to :cell belongs_to :page has_and_belongs_to_many :touchable_pages, -> { uniq }, class_name: 'Alchemy::Page', join_table: 'alchemy_elements_alchemy_pages' validates_presence_of :name, :on => :create validates_format_of :name, :on => :create, :with => /\A[a-z0-9_-]+\z/ attr_accessor :create_contents_after_create after_create :create_contents, :unless => proc { |e| e.create_contents_after_create == false } after_update :touch_pages after_update :touch_cell, unless: -> { self.cell.nil? } scope :trashed, -> { where(position: nil).order('updated_at DESC') } scope :not_trashed, -> { where(Element.arel_table[:position].not_eq(nil)) } scope :published, -> { where(public: true) } scope :not_restricted, -> { joins(:page).merge(Page.not_restricted) } scope :available, -> { published.not_trashed } scope :named, ->(names) { where(name: names) } scope :excluded, ->(names) { where(arel_table[:name].not_in(names)) } scope :not_in_cell, -> { where(cell_id: nil) } scope :in_cell, -> { where("#{self.table_name}.cell_id IS NOT NULL") } scope :from_current_site, -> { where(alchemy_languages: {site_id: Site.current || Site.default}).joins(page: 'language') } delegate :restricted?, to: :page, allow_nil: true # Concerns include Alchemy::Element::Definitions include Alchemy::Element::Presenters # class methods class << self # Builds a new element as described in +/config/alchemy/elements.yml+ def new_from_scratch(attributes) attributes = attributes.dup.symbolize_keys return new if attributes[:name].blank? return nil if definitions.blank? # clean the name from cell name attributes[:name] = attributes[:name].split('#').first if element_scratch = definitions.detect { |el| el['name'] == attributes[:name] } new(element_scratch.merge(attributes).except(*FORBIDDEN_DEFINITION_ATTRIBUTES)) else raise ElementDefinitionError, "Element definition for #{attributes[:name]} not found. Please check your elements.yml" end end # Builds a new element as described in +/config/alchemy/elements.yml+ and saves it def create_from_scratch(attributes) element = new_from_scratch(attributes) element.save if element return element end # This methods does a copy of source and all depending contents and all of their depending essences. # # == Options # # You can pass a differences Hash as second option to update attributes for the copy. # # == Example # # @copy = Alchemy::Element.copy(@element, {:public => false}) # @copy.public? # => false # def copy(source, differences = {}) source.attributes.stringify_keys! differences.stringify_keys! attributes = source.attributes.except(*SKIPPED_ATTRIBUTES_ON_COPY).merge(differences) element = self.create!(attributes.merge(:create_contents_after_create => false)) element.tag_list = source.tag_list source.contents.each do |content| new_content = Content.copy(content, :element_id => element.id) new_content.move_to_bottom end element end def all_from_clipboard(clipboard) return [] if clipboard.nil? where(id: clipboard.collect { |e| e['id'] }) end # All elements in clipboard that could be placed on page # def all_from_clipboard_for_page(clipboard, page) return [] if clipboard.nil? || page.nil? all_from_clipboard(clipboard).select { |ce| page.available_element_names.include?(ce.name) } end end # Returns next public element from same page. # # Pass an element name to get next of this kind. # def next(name = nil) previous_or_next('>', name) end # Returns previous public element from same page. # # Pass an element name to get previous of this kind. # def prev(name = nil) previous_or_next('<', name) end # Stores the page into +touchable_pages+ (Pages that have to be touched after updating the element). def store_page(page) return true if page.nil? unless self.touchable_pages.include? page self.touchable_pages << page self.save end end # Trashing an element means nullifying its position, folding and unpublishing it. def trash! self.public = false self.folded = true self.remove_from_list end def trashed? self.position.nil? end def content_by_name(name) self.contents.find_by_name(name) end def content_by_type(essence_type) self.contents.find_by_essence_type(Content.normalize_essence_type(essence_type)) end def all_contents_by_name(name) self.contents.where(:name => name) end def all_contents_by_type(essence_type) self.contents.where(:essence_type => Content.normalize_essence_type(essence_type)) end # Returns the content that is marked as rss title. # # Mark a content as rss title in your +elements.yml+ file: # # - name: news # contents: # - name: headline # type: EssenceText # rss_title: true # def content_for_rss_title rss_title = content_descriptions.detect { |c| c['rss_title'] } return if rss_title.blank? contents.find_by_name(rss_title['name']) end # Returns the content that is marked as rss description. # # Mark a content as rss description in your +elements.yml+ file: # # - name: news # contents: # - name: body # type: EssenceRichtext # rss_description: true # def content_for_rss_description rss_description = content_descriptions.detect { |c| c['rss_description'] } return if rss_description.blank? contents.find_by_name(rss_description['name']) end # Returns the array with the hashes for all element contents in the elements.yml file def content_descriptions return nil if definition.blank? definition['contents'] end # Returns the definition for given content_name def content_description_for(content_name) if content_descriptions.blank? log_warning "Element #{self.name} is missing the content definition for #{content_name}" return nil else content_descriptions.detect { |d| d['name'] == content_name } end end # Returns the definition for given content_name inside the available_contents def available_content_description_for(content_name) return nil if available_contents.blank? available_contents.detect { |d| d['name'] == content_name } end # returns the collection of available essence_types that can be created for this element depending on its description in elements.yml def available_contents definition['available_contents'] end # Returns the contents ingredient for passed content name. def ingredient(name) content = content_by_name(name) return nil if content.blank? content.ingredient end def has_ingredient?(name) self.ingredient(name).present? end # Updates all related contents by calling +update_essence+ on each of them. # # @param contents_attributes [Hash] # Hash of contents attributes. # The keys has to be the #id of the content to update. # The values a Hash of attribute names and values # # @return [Boolean] # True if +self.errors+ are blank or +contents_attributes+ hash is nil # # == Example # # @element.update_contents({1 => {ingredient: 'Title'}, 2 => {link: 'https://google.com'}}) # def update_contents(contents_attributes) return true if contents_attributes.nil? contents.each do |content| content_hash = contents_attributes["#{content.id}"] || next content.update_essence(content_hash) || errors.add(:base, :essence_validation_failed) end errors.blank? end def essences return [] if contents.blank? contents.collect(&:essence) end # Returns all essence_errors in the format: # # { # essence.content.name => [error_message_for_validation_1, error_message_for_validation_2] # } # # Get translated error messages with Element#essence_error_messages # def essence_errors essence_errors = {} essences.each do |essence| unless essence.errors.blank? essence_errors[essence.content.name] = essence.validation_errors end end essence_errors end # Essence validation errors # # == Error messages are translated via I18n # # Inside your translation file add translations like: # # alchemy: # content_validations: # name_of_the_element: # name_of_the_content: # validation_error_type: Error Message # # NOTE: +validation_error_type+ has to be one of: # # * blank # * taken # * invalid # # === Example: # # de: # alchemy: # content_validations: # contactform: # email: # invalid: 'Die Email hat nicht das richtige Format' # # # == Error message translation fallbacks # # In order to not translate every single content for every element you can provide default error messages per content name: # # === Example # # en: # alchemy: # content_validations: # fields: # email: # invalid: E-Mail has wrong format # blank: E-Mail can't be blank # # And even further you can provide general field agnostic error messages: # # === Example # # en: # alchemy: # content_validations: # errors: # invalid: %{field} has wrong format # blank: %{field} can't be blank # def essence_error_messages messages = [] essence_errors.each do |content_name, errors| errors.each do |error| messages << I18n.t( "#{self.name}.#{content_name}.#{error}", scope: 'content_validations', default: [ "fields.#{content_name}.#{error}".to_sym, "errors.#{error}".to_sym ], field: Content.translated_label_for(content_name, name) ) end end messages end def contents_with_errors contents.select(&:essence_validation_failed?) end def has_validations? !contents.detect(&:has_validations?).blank? end def rtf_contents contents.essence_richtexts end alias_method :richtext_contents, :rtf_contents # Returns an array of all EssenceRichtext contents ids # def richtext_contents_ids contents.essence_richtexts.pluck('alchemy_contents.id') end # The names of all cells from given page this element could be placed in. # def available_page_cell_names(page) cellnames = unique_available_page_cell_names(page) if cellnames.blank? || !page.has_cells? ['for_other_elements'] else cellnames end end # Returns true if the definition of this element has a taggable true value. def taggable? definition['taggable'] == true end # The element's view partial is dependent from its name # # == Define elements # # Elements are defined in the +config/alchemy/elements.yml+ file # # - name: article # contents: # ... # # == Override the view # # Element partials live in +app/views/alchemy/elements+ # def to_partial_path "alchemy/elements/#{name}_view" end # Returns the key that's taken for cache path. # # Uses the page's +published_at+ value that's updated when the user publishes the page. # # If the page is the current preview it uses the element's updated_at value as cache key. # def cache_key if Page.current_preview == self.page "alchemy/elements/#{id}-#{updated_at}" else "alchemy/elements/#{id}-#{page.published_at}" end end private # creates the contents for this element as described in the elements.yml def create_contents contents = [] if definition["contents"].blank? log_warning "Could not find any content descriptions for element: #{self.name}" else definition["contents"].each do |content_hash| contents << Content.create_from_scratch(self, content_hash.symbolize_keys) end end end # Returns previous or next public element from same page. # # @param [String] # Pass '>' or '<' to find next or previous public element. # @param [String] # Pass an element name to get previous of this kind. # def previous_or_next(dir, name = nil) elements = page.elements.published.where("#{self.class.table_name}.position #{dir} #{position}") elements = elements.named(name) if name.present? elements.reorder("position #{dir == '>' ? 'ASC' : 'DESC'}").limit(1).first end # Returns all cells from given page this element could be placed in. # def available_page_cells(page) page.cells.select do |cell| cell.available_elements.include?(self.name) end end # Returns all uniq cell names from given page this element could be placed in. # def unique_available_page_cell_names(page) available_page_cells(page).collect(&:name).uniq end # If element has a +cell+ associated, # it updates it's timestamp. # # Called after_update # def touch_cell self.cell.touch end end end