Class: Decidim::ParticipatoryProcess

Inherits:
ApplicationRecord
  • Object
show all
Includes:
FilterableResource, Followable, HasArea, HasAttachmentCollections, HasAttachments, HasPrivateUsers, HasReference, HasUploadValidations, Loggable, Participable, ParticipatorySpaceResourceable, Publicable, ScopableParticipatorySpace, Searchable, ShareableWithToken, SoftDeletable, Taxonomizable, Traceable, TranslatableResource
Defined in:
app/models/decidim/participatory_process.rb

Overview

Interaction between a user and an organization is done via a ParticipatoryProcess. It is a unit of action from the Organization point of view that groups several components (proposals, debates…) distributed in steps that get enabled or disabled depending on which step is currently active.

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.active_spaces ⇒ Object 



133
134
135
 
# File 'app/models/decidim/participatory_process.rb', line 133

def self.active_spaces
  active
end

.future_spaces ⇒ Object 



137
138
139
 
# File 'app/models/decidim/participatory_process.rb', line 137

def self.future_spaces
  upcoming
end

.group_ids ⇒ Object

Pluck all ParticipatoryProcessGroup ID’s



168
169
170
 
# File 'app/models/decidim/participatory_process.rb', line 168

def self.group_ids
  pluck(:decidim_participatory_process_group_id)
end

.grouped ⇒ Object

Return processes that belong to a process group.



129
130
131
 
# File 'app/models/decidim/participatory_process.rb', line 129

def self.grouped
  where.not(decidim_participatory_process_group_id: nil)
end

.groupless ⇒ Object

Return processes that DO NOT belong to a process group.



124
125
126
 
# File 'app/models/decidim/participatory_process.rb', line 124

def self.groupless
  where(decidim_participatory_process_group_id: nil)
end

.log_presenter_class_for(_log) ⇒ Object 



145
146
147
 
# File 'app/models/decidim/participatory_process.rb', line 145

def self.log_presenter_class_for(_log)
  Decidim::ParticipatoryProcesses::AdminLog::ParticipatoryProcessPresenter
end

.moderators(organization) ⇒ Object 



189
190
191
 
# File 'app/models/decidim/participatory_process.rb', line 189

def self.moderators(organization)
  "#{admin_module_name}::Moderators".constantize.for_organization(organization)
end

.past_spaces ⇒ Object 



141
142
143
 
# File 'app/models/decidim/participatory_process.rb', line 141

def self.past_spaces
  past
end

Scope to return only the promoted processes.

Returns an ActiveRecord::Relation.



119
120
121
 
# File 'app/models/decidim/participatory_process.rb', line 119

def self.promoted
  where(promoted: true)
end

.ransackable_associations(_auth_object = nil) ⇒ Object 



222
223
224
 
# File 'app/models/decidim/participatory_process.rb', line 222

def self.ransackable_associations(_auth_object = nil)
  %w(participatory_process_type participatory_process_group taxonomies)
end

.ransackable_attributes(auth_object = nil) ⇒ Object 



215
216
217
218
219
220
 
# File 'app/models/decidim/participatory_process.rb', line 215

def self.ransackable_attributes(auth_object = nil)
  base = %w(title short_description description id)
  return base unless auth_object&.admin?

  base + %w(private_space published_at decidim_participatory_process_group_id)
end

.ransackable_scopes(_auth_object = nil) ⇒ Object 



211
212
213
 
# File 'app/models/decidim/participatory_process.rb', line 211

def self.ransackable_scopes(_auth_object = nil)
  [:with_date, :with_any_taxonomies]
end

Instance Method Details

#active? ⇒ Boolean

Returns:

  • (Boolean) 


149
150
151
152
153
 
# File 'app/models/decidim/participatory_process.rb', line 149

def active?
  return false if start_date.blank?

  start_date <= Date.current && (end_date.blank? || end_date >= Date.current)
end

#attachment_context ⇒ Object 



200
201
202
 
# File 'app/models/decidim/participatory_process.rb', line 200

def attachment_context
  :admin
end

#closed? ⇒ Boolean

Returns:

  • (Boolean) 


172
173
174
 
# File 'app/models/decidim/participatory_process.rb', line 172

def closed?
  past?
end

#hashtag ⇒ Object 



176
177
178
 
# File 'app/models/decidim/participatory_process.rb', line 176

def hashtag
  attributes["hashtag"].to_s.delete("#")
end

#moderators ⇒ Object

Overrides the moderators methods from ‘Participable`.



185
186
187
 
# File 'app/models/decidim/participatory_process.rb', line 185

def moderators
  "#{admin_module_name}::Moderators".constantize.for(self)
end

#past? ⇒ Boolean

Returns:

  • (Boolean) 


155
156
157
158
159
 
# File 'app/models/decidim/participatory_process.rb', line 155

def past?
  return false if end_date.blank?

  end_date < Date.current
end

#shareable_url(share_token) ⇒ Object 



204
205
206
 
# File 'app/models/decidim/participatory_process.rb', line 204

def shareable_url(share_token)
  EngineRouter.main_proxy(self).participatory_process_url(self, share_token: share_token.token)
end

#to_param ⇒ Object 



180
181
182
 
# File 'app/models/decidim/participatory_process.rb', line 180

def to_param
  slug
end

#upcoming? ⇒ Boolean

Returns:

  • (Boolean) 


161
162
163
164
165
 
# File 'app/models/decidim/participatory_process.rb', line 161

def upcoming?
  return false if start_date.blank?

  start_date > Date.current
end

#user_roles(role_name = nil) ⇒ Object 



193
194
195
196
197
198
 
# File 'app/models/decidim/participatory_process.rb', line 193

def user_roles(role_name = nil)
  roles = Decidim::ParticipatoryProcessUserRole.where(participatory_process: self)
  return roles if role_name.blank?

  roles.where(role: role_name)
end