Class: Decidim::Meetings::Meeting

Overview

The data store for a Meeting in the Decidim::Meetings component. It stores a title, description and any other useful information to render a custom meeting.

Direct Known Subclasses

ConferenceMeeting

Constant Summary collapse

TYPE_OF_MEETING =
%w(in_person online hybrid).freeze
REGISTRATION_TYPE =
%w(registration_disabled on_this_platform on_different_platform).freeze

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Publicable

#publish!, #published?, #unpublish!

Methods included from Searchable

searchable_resources, searchable_resources_of_type_comment, searchable_resources_of_type_component, searchable_resources_of_type_participant, searchable_resources_of_type_participatory_space

Methods included from Followable

#followers

Methods included from HasAttachments

#attachment_context

Class Method Details

.log_presenter_class_for(_log) ⇒ Object


168
169
170
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 168

def self.log_presenter_class_for(_log)
  Decidim::Meetings::AdminLog::MeetingPresenter
end

.participants_iframe_embed_typesObject


153
154
155
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 153

def self.participants_iframe_embed_types
  iframe_embed_types.except(:open_in_live_event_page)
end

.ransack(params = {}, options = {}) ⇒ Object


384
385
386
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 384

def self.ransack(params = {}, options = {})
  MeetingSearch.new(self, params, options)
end

.ransackable_scopes(_auth_object = nil) ⇒ Object


380
381
382
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 380

def self.ransackable_scopes(_auth_object = nil)
  [:with_any_type, :with_any_date, :with_any_space, :with_any_origin, :with_any_scope, :with_any_category, :with_any_global_category]
end

.sort_by_translated_title_ascObject


358
359
360
361
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 358

def self.sort_by_translated_title_asc
  field = Arel::Nodes::InfixOperation.new("->>", arel_table[:title], Arel::Nodes.build_quoted(I18n.locale))
  order(Arel::Nodes::InfixOperation.new("", field, Arel.sql("ASC")))
end

.sort_by_translated_title_descObject


363
364
365
366
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 363

def self.sort_by_translated_title_desc
  field = Arel::Nodes::InfixOperation.new("->>", arel_table[:title], Arel::Nodes.build_quoted(I18n.locale))
  order(Arel::Nodes::InfixOperation.new("", field, Arel.sql("DESC")))
end

Instance Method Details

#accepts_new_comments?Boolean

Public: Overrides the `accepts_new_comments?` CommentableWithComponent concern method.

Returns:

  • (Boolean)

212
213
214
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 212

def accepts_new_comments?
  commentable? && !component.current_settings.comments_blocked && comments_allowed?
end

#allow_resource_permissions?Boolean

Public: Overrides the `allow_resource_permissions?` Resourceable concern method.

Returns:

  • (Boolean)

217
218
219
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 217

def allow_resource_permissions?
  component.settings.resources_permissions_enabled
end

#authored_proposalsObject


297
298
299
300
301
302
303
304
305
306
307
308
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 297

def authored_proposals
  return [] unless Decidim::Meetings.enable_proposal_linking

  Decidim::Proposals::Proposal
    .joins(:coauthorships)
    .where(
      decidim_coauthorships: {
        decidim_author_type: "Decidim::Meetings::Meeting",
        decidim_author_id: id
      }
    )
end

#can_be_joined_by?(user) ⇒ Boolean

Returns:

  • (Boolean)

172
173
174
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 172

def can_be_joined_by?(user)
  !closed? && registrations_enabled? && can_participate?(user)
end

#can_participate?(user) ⇒ Boolean

Returns:

  • (Boolean)

236
237
238
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 236

def can_participate?(user)
  can_participate_in_space?(user) && can_participate_in_meeting?(user)
end

#can_register_invitation?(user) ⇒ Boolean

Returns:

  • (Boolean)

176
177
178
179
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 176

def can_register_invitation?(user)
  !closed? && registrations_enabled? &&
    can_participate_in_space?(user) && user_has_invitation_for_meeting?(user)
end

#closed?Boolean

Returns:

  • (Boolean)

181
182
183
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 181

def closed?
  closed_at.present?
end

#comments_have_alignment?Boolean

Public: Overrides the `comments_have_alignment?` Commentable concern method.

Returns:

  • (Boolean)

222
223
224
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 222

def comments_have_alignment?
  true
end

#comments_have_votes?Boolean

Public: Overrides the `comments_have_votes?` Commentable concern method.

Returns:

  • (Boolean)

227
228
229
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 227

def comments_have_votes?
  true
end

#current_user_can_visit_meeting?(user) ⇒ Boolean

Returns:

  • (Boolean)

240
241
242
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 240

def current_user_can_visit_meeting?(user)
  Decidim::Meetings::Meeting.visible_for(user).exists?(id: id)
end

#emendation?Boolean

Returns:

  • (Boolean)

189
190
191
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 189

def emendation?
  false
end

#has_attendees?Boolean

Returns:

  • (Boolean)

347
348
349
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 347

def has_attendees?
  !!attendees_count && attendees_count.positive?
end

#has_available_slots?Boolean

Returns:

  • (Boolean)

193
194
195
196
197
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 193

def has_available_slots?
  return true if available_slots.zero?

  (available_slots - reserved_slots) > registrations.count
end

#has_contributions?Boolean

Returns:

  • (Boolean)

343
344
345
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 343

def has_contributions?
  !!contributions_count && contributions_count.positive?
end

#has_registration_for?(user) ⇒ Boolean

Returns:

  • (Boolean)

203
204
205
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 203

def has_registration_for?(user)
  registrations.where(user: user).any?
end

#iframe_access_level_allowed_for_user?(user) ⇒ Boolean

Returns:

  • (Boolean)

244
245
246
247
248
249
250
251
252
253
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 244

def iframe_access_level_allowed_for_user?(user)
  case iframe_access_level
  when "all"
    true
  when "signed_in"
    user.present?
  else
    has_registration_for?(user)
  end
end

#live?Boolean

Returns:

  • (Boolean)

351
352
353
354
355
356
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 351

def live?
  start_time &&
    end_time &&
    Time.current >= (start_time - 10.minutes) &&
    Time.current <= end_time
end

#maps_enabled?Boolean

Returns:

  • (Boolean)

207
208
209
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 207

def maps_enabled?
  component.settings.maps_enabled?
end

#meeting_durationObject

Return the duration of the meeting in minutes


256
257
258
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 256

def meeting_duration
  @meeting_duration ||= ((end_time - start_time) / 1.minute).abs
end

#on_different_platform?Boolean

Returns:

  • (Boolean)

339
340
341
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 339

def on_different_platform?
  registration_type == "on_different_platform"
end

#on_this_platform?Boolean

Returns:

  • (Boolean)

335
336
337
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 335

def on_this_platform?
  registration_type == "on_this_platform"
end

#pad_is_visible?Boolean

Overwrites method from Paddable to add custom rules in order to know when to display a pad or not.

Returns:

  • (Boolean)

283
284
285
286
287
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 283

def pad_is_visible?
  return false unless pad

  (start_time - Time.current) <= 24.hours
end

#pad_is_writable?Boolean

Overwrites method from Paddable to add custom rules in order to know when a pad is writable or not.

Returns:

  • (Boolean)

291
292
293
294
295
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 291

def pad_is_writable?
  return false unless pad_is_visible?

  (Time.current - end_time) < 72.hours
end

#past?Boolean

Returns:

  • (Boolean)

185
186
187
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 185

def past?
  end_time < Time.current
end

#presenterObject

Returns the presenter for this author, to be used in the views. Required by ActsAsAuthor.


164
165
166
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 164

def presenter
  Decidim::Meetings::MeetingPresenter.new(self)
end

#registration_disabled?Boolean

Returns:

  • (Boolean)

331
332
333
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 331

def registration_disabled?
  registration_type == "registration_disabled"
end

#remaining_slotsObject


199
200
201
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 199

def remaining_slots
  available_slots - reserved_slots - registrations.count
end

#reported_attributesObject

Public: Overrides the `reported_attributes` Reportable concern method.


316
317
318
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 316

def reported_attributes
  [:description]
end

#reported_content_urlObject

Public: Overrides the `reported_content_url` Reportable concern method.


311
312
313
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 311

def reported_content_url
  ResourceLocatorPresenter.new(self).url
end

#reported_searchable_content_extrasObject

Public: Overrides the `reported_searchable_content_extras` Reportable concern method.


321
322
323
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 321

def reported_searchable_content_extras
  [normalized_author.name]
end

#resource_visible?Boolean

Returns:

  • (Boolean)

260
261
262
263
264
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 260

def resource_visible?
  return false if hidden?

  !private_meeting? || transparent?
end

#user_group_registrationsObject

Return registrations of a particular meeting made by users representing a group


158
159
160
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 158

def user_group_registrations
  registrations.where.not(decidim_user_group_id: nil)
end

#users_to_notify_on_comment_createdObject

Public: Override Commentable concern method `users_to_notify_on_comment_created`


232
233
234
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 232

def users_to_notify_on_comment_created
  followers
end

#withdrawable_by?(user) ⇒ Boolean

Checks whether the user can withdraw the given meeting.

user - the user to check for withdrawability. past meetings cannot be withdrawn

Returns:

  • (Boolean)

277
278
279
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 277

def withdrawable_by?(user)
  user && !withdrawn? && !past? && authored_by?(user)
end

#withdrawn?Boolean

Public: Checks if the author has withdrawn the meeting.

Returns Boolean.

Returns:

  • (Boolean)

269
270
271
# File 'decidim-meetings/app/models/decidim/meetings/meeting.rb', line 269

def withdrawn?
  state == "withdrawn"
end