decidim-participatory_processes 0.6.0

data/app/controllers/decidim/participatory_processes/participatory_process_widgets_controller.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    class ParticipatoryProcessWidgetsController < Decidim::WidgetsController
+      private
+
+      def model
+        @model ||= ParticipatoryProcess.find(params[:participatory_process_id])
+      end
+
+      def current_participatory_space
+        model
+      end
+
+      def iframe_url
+        @iframe_url ||= participatory_process_participatory_process_widget_url(model)
+      end
+    end
+  end
+end

data/app/controllers/decidim/participatory_processes/participatory_processes_controller.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # A controller that holds the logic to show ParticipatoryProcesses in a
+    # public layout.
+    class ParticipatoryProcessesController < Decidim::ApplicationController
+      layout "layouts/decidim/participatory_process", only: [:show]
+
+      before_action -> { extend NeedsParticipatoryProcess }, only: [:show]
+
+      helper Decidim::AttachmentsHelper
+      helper Decidim::IconHelper
+      helper Decidim::WidgetUrlsHelper
+
+      helper ParticipatoryProcessHelper
+
+      helper_method :collection, :promoted_participatory_processes, :participatory_processes, :stats, :filter
+
+      def index
+        authorize! :read, ParticipatoryProcess
+        authorize! :read, ParticipatoryProcessGroup
+      end
+
+      def show
+        authorize! :read, current_participatory_process
+      end
+
+      private
+
+      def collection
+        @collection ||= (participatory_processes.to_a + participatory_process_groups).flatten
+      end
+
+      def filtered_participatory_processes(filter = default_filter)
+        OrganizationPrioritizedParticipatoryProcesses.new(current_organization, filter)
+      end
+
+      def participatory_processes
+        @participatory_processes ||= filtered_participatory_processes(filter)
+      end
+
+      def promoted_participatory_processes
+        @promoted_processes ||= filtered_participatory_processes | PromotedParticipatoryProcesses.new
+      end
+
+      def participatory_process_groups
+        @process_groups ||= OrganizationPrioritizedParticipatoryProcessGroups.new(current_organization, filter)
+      end
+
+      def stats
+        @stats ||= ParticipatoryProcessStatsPresenter.new(participatory_process: current_participatory_process)
+      end
+
+      def filter
+        @filter = params[:filter] || default_filter
+      end
+
+      def default_filter
+        "active"
+      end
+    end
+  end
+end

data/app/forms/decidim/participatory_processes/admin/participatory_process_copy_form.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # A form object used to copy a participatory processes from the admin
+      # dashboard.
+      #
+      class ParticipatoryProcessCopyForm < Form
+        include TranslatableAttributes
+
+        translatable_attribute :title, String
+
+        mimic :participatory_process
+
+        attribute :slug, String
+        attribute :copy_steps, Boolean
+        attribute :copy_categories, Boolean
+        attribute :copy_features, Boolean
+
+        validates :slug, presence: true
+        validates :title, translatable_presence: true
+        validate :slug, :slug_uniqueness
+
+        private
+
+        def slug_uniqueness
+          return unless OrganizationParticipatoryProcesses.new(current_organization).query.where(slug: slug).where.not(id: id).any?
+
+          errors.add(:slug, :taken)
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/participatory_processes/admin/participatory_process_form.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # A form object used to create participatory processes from the admin
+      # dashboard.
+      #
+      class ParticipatoryProcessForm < Form
+        include TranslatableAttributes
+
+        translatable_attribute :title, String
+        translatable_attribute :subtitle, String
+        translatable_attribute :description, String
+        translatable_attribute :short_description, String
+        translatable_attribute :meta_scope, String
+        translatable_attribute :developer_group, String
+        translatable_attribute :local_area, String
+        translatable_attribute :target, String
+        translatable_attribute :participatory_scope, String
+        translatable_attribute :participatory_structure, String
+        translatable_attribute :announcement, String
+
+        mimic :participatory_process
+
+        attribute :start_date, Date
+        attribute :end_date, Date
+        attribute :slug, String
+        attribute :hashtag, String
+        attribute :promoted, Boolean
+        attribute :scopes_enabled, Boolean
+        attribute :scope_id, Integer
+        attribute :hero_image
+        attribute :remove_hero_image
+        attribute :banner_image
+        attribute :remove_banner_image
+        attribute :participatory_process_group_id, Integer
+        attribute :show_statistics, Boolean
+
+        validates :slug, presence: true
+        validates :title, :subtitle, :description, :short_description, translatable_presence: true
+        validates :scope, presence: true, if: proc { |object| object.scope_id.present? }
+
+        validate :slug, :slug_uniqueness
+
+        validates :hero_image, file_size: { less_than_or_equal_to: ->(_record) { Decidim.maximum_attachment_size } }, file_content_type: { allow: ["image/jpeg", "image/png"] }
+        validates :banner_image, file_size: { less_than_or_equal_to: ->(_record) { Decidim.maximum_attachment_size } }, file_content_type: { allow: ["image/jpeg", "image/png"] }
+
+        def map_model(model)
+          self.scope_id = model.decidim_scope_id
+          self.participatory_process_group_id = model.decidim_participatory_process_group_id
+        end
+
+        def scope
+          @scope ||= current_organization.scopes.where(id: scope_id).first
+        end
+
+        def participatory_process_group
+          Decidim::ParticipatoryProcessGroup.where(id: participatory_process_group_id).first
+        end
+
+        private
+
+        def slug_uniqueness
+          return unless OrganizationParticipatoryProcesses.new(current_organization).query.where(slug: slug).where.not(id: id).any?
+
+          errors.add(:slug, :taken)
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/participatory_processes/admin/participatory_process_group_form.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # A form object used to create participatory process groups from the admin
+      # dashboard.
+      #
+      class ParticipatoryProcessGroupForm < Form
+        include TranslatableAttributes
+
+        translatable_attribute :name, String
+        translatable_attribute :description, String
+        attribute :participatory_process_ids, Array[Integer]
+
+        mimic :participatory_process_group
+
+        attribute :hero_image
+
+        validates :name, :description, translatable_presence: true
+
+        validates :hero_image, file_size: { less_than_or_equal_to: ->(_record) { Decidim.maximum_attachment_size } }, file_content_type: { allow: ["image/jpeg", "image/png"] }
+      end
+    end
+  end
+end

data/app/forms/decidim/participatory_processes/admin/participatory_process_step_form.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # A form object used to create participatory processes steps from the admin
+      # dashboard.
+      #
+      class ParticipatoryProcessStepForm < Form
+        include TranslatableAttributes
+
+        translatable_attribute :title, String
+        translatable_attribute :description, String
+
+        mimic :participatory_process_step
+
+        attribute :start_date, DateTime
+        attribute :end_date, DateTime
+
+        validates :title, translatable_presence: true
+
+        validates :start_date, date: { before: :end_date, allow_blank: true, if: proc { |obj| obj.end_date.present? } }
+        validates :end_date, date: { after: :start_date, allow_blank: true, if: proc { |obj| obj.start_date.present? } }
+
+        def start_date
+          return nil unless super.respond_to?(:at_midnight)
+          super.at_midnight
+        end
+
+        def end_date
+          return nil unless super.respond_to?(:at_midnight)
+          super.at_midnight
+        end
+      end
+    end
+  end
+end

data/app/forms/decidim/participatory_processes/admin/participatory_process_user_role_form.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # A form object used to create participatory process user roles from the
+      # admin dashboard.
+      #
+      class ParticipatoryProcessUserRoleForm < Form
+        mimic :participatory_process_user_role
+
+        attribute :name, String
+        attribute :email, String
+        attribute :role, String
+
+        validates :email, :role, presence: true
+        validates :name, presence: true
+        validates :role, inclusion: { in: Decidim::ParticipatoryProcessUserRole::ROLES }
+
+        def roles
+          Decidim::ParticipatoryProcessUserRole::ROLES.map do |role|
+            [
+              I18n.t(role, scope: "decidim.admin.models.participatory_process_user_role.roles"),
+              role
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/participatory_processes/admin/process_groups_for_select_helper.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # This class contains helpers needed to format ParticipatoryProcessGroups
+      # in order to use them in select forms.
+      #
+      module ProcessGroupsForSelectHelper
+        # Public: A formatted collection of ParticipatoryProcessGroups to be used
+        # in forms.
+        #
+        # Returns an Array.
+        def process_groups_for_select
+          @process_groups_for_select ||=
+            OrganizationParticipatoryProcessGroups.new(current_organization).map do |group|
+              [translated_attribute(group.name), group.id]
+            end
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/participatory_processes/admin/processes_for_select_helper.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    module Admin
+      # This class contains helpers needed to format ParticipatoryProcesses
+      # in order to use them in select forms.
+      #
+      module ProcessesForSelectHelper
+        # Public: A formatted collection of ParticipatoryProcesses to be used
+        # in forms.
+        #
+        # Returns an Array.
+        def processes_for_select
+          @processes_for_select ||= OrganizationParticipatoryProcesses.new(current_organization).map do |process|
+            [
+              translated_attribute(process.title),
+              process.id
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/decidim/participatory_processes/participatory_process_helper.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # Helpers related to the Participatory Process layout.
+    module ParticipatoryProcessHelper
+      # Public: Returns the dates for a step in a readable format like
+      # "2016-01-01 - 2016-02-05".
+      #
+      # participatory_process_step - The step to format to
+      #
+      # Returns a String with the formatted dates.
+      def participatory_process_step_dates(participatory_process_step)
+        dates = [participatory_process_step.start_date, participatory_process_step.end_date]
+        dates.map { |date| date ? localize(date.to_date, format: :default) : "?" }.join(" - ")
+      end
+    end
+  end
+end

data/app/helpers/decidim/participatory_processes/participatory_process_steps_helper.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Decidim
+  module ParticipatoryProcesses
+    # Helper that provides a single method to give a class to a
+    # ParticipatoryProcessStep depending on their date.
+    module ParticipatoryProcessStepsHelper
+      # Returns the class for the given step depending on their end_date.
+      #
+      # step - the given ParticipatoryProcessStep
+      # past - a Boolean indicating if the step is past or not
+      #
+      # Returns a String.
+      def step_class(step, past)
+        status = past ? "" : "timeline__item--inactive"
+        step.active? ? "timeline__item--current" : status
+      end
+    end
+  end
+end

data/app/models/decidim/participatory_process.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Decidim
+  # Interaction between a user and an organization is done via a
+  # ParticipatoryProcess. It's a unit of action from the Organization point of
+  # view that groups several features (proposals, debates...) distributed in
+  # steps that get enabled or disabled depending on which step is currently
+  # active.
+  class ParticipatoryProcess < ApplicationRecord
+    include Decidim::HasAttachments
+    include Decidim::Participable
+    include Decidim::Publicable
+    include Decidim::Scopable
+
+    belongs_to :organization,
+               foreign_key: "decidim_organization_id",
+               class_name: "Decidim::Organization"
+    belongs_to :participatory_process_group,
+               foreign_key: "decidim_participatory_process_group_id",
+               class_name: "Decidim::ParticipatoryProcessGroup",
+               inverse_of: :participatory_processes,
+               optional: true
+    has_many :steps,
+             -> { order(position: :asc) },
+             foreign_key: "decidim_participatory_process_id",
+             class_name: "Decidim::ParticipatoryProcessStep",
+             dependent: :destroy,
+             inverse_of: :participatory_process
+    has_one :active_step,
+            -> { where(active: true) },
+            foreign_key: "decidim_participatory_process_id",
+            class_name: "Decidim::ParticipatoryProcessStep",
+            dependent: :destroy,
+            inverse_of: :participatory_process
+    has_many :categories,
+             foreign_key: "decidim_participatory_space_id",
+             foreign_type: "decidim_participatory_space_type",
+             dependent: :destroy,
+             as: :participatory_space
+
+    has_many :features, as: :participatory_space
+
+    attr_readonly :active_step
+
+    validates :slug, presence: true
+    validates :slug, uniqueness: { scope: :organization }
+
+    mount_uploader :hero_image, Decidim::HeroImageUploader
+    mount_uploader :banner_image, Decidim::BannerImageUploader
+
+    # Scope to return only the promoted processes.
+    #
+    # Returns an ActiveRecord::Relation.
+    def self.promoted
+      where(promoted: true)
+    end
+
+    def hashtag
+      attributes["hashtag"].to_s.delete("#")
+    end
+  end
+end