Sha256: d4bf689bafdee11a809b23861fe709ee6db0f39b096c057ec93646c4ec4a677b

Contents?: true

Size: 1.79 KB

Versions: 8

Compression:

Stored size: 1.79 KB

Contents

# frozen_string_literal: true

module Decidim
  # Categories serve as a taxonomy for components to use for while in the
  # context of a participatory process.
  class Category < ApplicationRecord
    include Decidim::TranslatableResource

    translatable_fields :name, :description

    belongs_to :participatory_space, foreign_key: "decidim_participatory_space_id", foreign_type: "decidim_participatory_space_type", polymorphic: true
    has_many :subcategories, foreign_key: "parent_id", class_name: "Decidim::Category", dependent: :destroy, inverse_of: :parent
    belongs_to :parent, class_name: "Decidim::Category", foreign_key: "parent_id", inverse_of: :subcategories, optional: true
    has_many :categorizations, foreign_key: "decidim_category_id", class_name: "Decidim::Categorization", dependent: :destroy

    default_scope { order(arel_table[:parent_id].asc, arel_table[:weight].asc) }

    validate :forbid_deep_nesting
    before_validation :subcategories_have_same_participatory_space

    # Scope to return only the first-class categories, that is, those that are
    # not subcategories.
    #
    # Returns an ActiveRecord::Relation.
    def self.first_class
      where(parent_id: nil)
    end

    def descendants
      @descendants ||= Category.where(parent_id: id)
    end

    def translated_name
      Decidim::CategoryPresenter.new(self).translated_name
    end

    def unused?
      categorizations.empty?
    end

    private

    # This is done since we only allow one level of subcategories.
    def forbid_deep_nesting
      return unless parent
      return if parent.parent.blank?

      errors.add(:parent_id, :nesting_too_deep)
    end

    def subcategories_have_same_participatory_space
      return unless parent

      self.participatory_space = parent.participatory_space
    end
  end
end

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
decidim-core-0.23.6 app/models/decidim/category.rb
decidim-core-0.23.5 app/models/decidim/category.rb
decidim-core-0.23.4 app/models/decidim/category.rb
decidim-core-0.23.3 app/models/decidim/category.rb
decidim-core-0.23.2 app/models/decidim/category.rb
decidim-core-0.23.1 app/models/decidim/category.rb
decidim-core-0.23.1.rc1 app/models/decidim/category.rb
decidim-core-0.23.0 app/models/decidim/category.rb