Class: Decidim::Comments::Comment

Inherits:
ApplicationRecord show all
Includes:
ActsAsTree, Authorable, Commentable, DownloadYourData, FriendlyDates, Loggable, Reportable, Searchable, Traceable, TranslatableAttributes, TranslatableResource
Defined in:
app/models/decidim/comments/comment.rb

Overview

Some resources will be configured as commentable objects so users can comment on them. The will be able to create conversations between users to discuss or share their thoughts about the resource.

Constant Summary collapse

MAX_DEPTH =

Limit the max depth of a comment tree. If C is a comment and R is a reply: C (depth 0) |–R (depth 1) |–R (depth 1)

|--R    (depth 2)
   |--R (depth 3)

3

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.export_serializer ⇒ Object 



157
158
159
 
# File 'app/models/decidim/comments/comment.rb', line 157

def self.export_serializer
  Decidim::Comments::CommentSerializer
end

.negative ⇒ Object 



78
79
80
 
# File 'app/models/decidim/comments/comment.rb', line 78

def self.negative
  where(alignment: -1)
end

.neutral ⇒ Object 



74
75
76
 
# File 'app/models/decidim/comments/comment.rb', line 74

def self.neutral
  where(alignment: 0)
end

.positive ⇒ Object 



70
71
72
 
# File 'app/models/decidim/comments/comment.rb', line 70

def self.positive
  where(alignment: 1)
end

.user_commentators_ids_in(resources) ⇒ Object

Public: Returns the list of author IDs of type ‘UserBaseEntity` that commented in one of the resources. Expects all resources to be of the same “commentable_type”. If the result is not `Decidim::Comments::Commentable` returns `nil`.



164
165
166
167
168
169
170
171
172
173
174
 
# File 'app/models/decidim/comments/comment.rb', line 164

def self.user_commentators_ids_in(resources)
  if resources.first.is_a?(Decidim::Comments::Commentable)
    commentable_type = resources.first.class.name
    Decidim::Comments::Comment.select("DISTINCT decidim_author_id").not_hidden.not_deleted
                              .where(decidim_commentable_id: resources.pluck(:id))
                              .where(decidim_commentable_type: commentable_type)
                              .where("decidim_author_type" => "Decidim::UserBaseEntity").pluck(:decidim_author_id)
  else
    []
  end
end

Instance Method Details

#accepts_new_comments? ⇒ Boolean

Public: Override Commentable concern method ‘accepts_new_comments?`

Returns:

  • (Boolean) 


104
105
106
107
108
 
# File 'app/models/decidim/comments/comment.rb', line 104

def accepts_new_comments?
  return if deleted?

  root_commentable.accepts_new_comments? && depth < MAX_DEPTH
end

#can_participate?(user) ⇒ Boolean

Returns:

  • (Boolean) 


176
177
178
179
180
 
# File 'app/models/decidim/comments/comment.rb', line 176

def can_participate?(user)
  return true unless root_commentable.respond_to?(:can_participate?)

  root_commentable.can_participate?(user)
end

#component ⇒ Object 



99
100
101
 
# File 'app/models/decidim/comments/comment.rb', line 99

def component
  commentable.component if commentable.respond_to?(:component)
end

#delete! ⇒ Object 



190
191
192
193
194
195
196
 
# File 'app/models/decidim/comments/comment.rb', line 190

def delete!
  return if deleted?

  update(deleted_at: Time.current)

  update_counter
end

#deleted? ⇒ Boolean

Returns:

  • (Boolean) 


198
199
200
 
# File 'app/models/decidim/comments/comment.rb', line 198

def deleted?
  deleted_at.present?
end

#down_voted_by?(user) ⇒ Boolean

Public: Check if the user has downvoted the comment

Returns a bool value to indicate if the condition is truthy or not

Returns:

  • (Boolean) 


130
131
132
 
# File 'app/models/decidim/comments/comment.rb', line 130

def down_voted_by?(user)
  down_votes.any? { |vote| vote.author == user }
end

#edited? ⇒ Boolean

Returns:

  • (Boolean) 


202
203
204
 
# File 'app/models/decidim/comments/comment.rb', line 202

def edited?
  Decidim::ActionLog.where(resource: self).exists?(["extra @> ?", Arel.sql("{\"edit\":true}")])
end

#formatted_body ⇒ Object 



182
183
184
 
# File 'app/models/decidim/comments/comment.rb', line 182

def formatted_body
  Decidim::ContentProcessor.render(sanitize_content_for_comment(render_markdown(translated_body)), "div")
end

#organization ⇒ Object 



82
83
84
 
# File 'app/models/decidim/comments/comment.rb', line 82

def organization
  commentable&.organization || participatory_space&.organization
end

#original_participatory_space ⇒ Object 



90
 
# File 'app/models/decidim/comments/comment.rb', line 90

alias original_participatory_space participatory_space

#participatory_space ⇒ Object 



92
93
94
95
96
97
 
# File 'app/models/decidim/comments/comment.rb', line 92

def participatory_space
  return original_participatory_space if original_participatory_space.present?
  return root_commentable unless root_commentable.respond_to?(:participatory_space)

  root_commentable.participatory_space
end

#reported_attributes ⇒ Object

Public: Overrides the ‘reported_attributes` Reportable concern method.



148
149
150
 
# File 'app/models/decidim/comments/comment.rb', line 148

def reported_attributes
  [:body]
end

#reported_content_url ⇒ Object

Public: Overrides the ‘reported_content_url` Reportable concern method.



135
136
137
138
139
140
141
142
143
144
145
 
# File 'app/models/decidim/comments/comment.rb', line 135

def reported_content_url
  return unless root_commentable

  url_params = { anchor: "comment_#{id}" }

  if root_commentable.respond_to?(:polymorphic_resource_url)
    root_commentable.polymorphic_resource_url(url_params)
  else
    ResourceLocatorPresenter.new(root_commentable).url(url_params)
  end
end

#reported_searchable_content_extras ⇒ Object

Public: Overrides the ‘reported_searchable_content_extras` Reportable concern method.



153
154
155
 
# File 'app/models/decidim/comments/comment.rb', line 153

def reported_searchable_content_extras
  [normalized_author.name]
end

#translated_body ⇒ Object 



186
187
188
 
# File 'app/models/decidim/comments/comment.rb', line 186

def translated_body
  translated_attribute(body, organization)
end

#up_voted_by?(user) ⇒ Boolean

Public: Check if the user has upvoted the comment

Returns a bool value to indicate if the condition is truthy or not

Returns:

  • (Boolean) 


123
124
125
 
# File 'app/models/decidim/comments/comment.rb', line 123

def up_voted_by?(user)
  up_votes.any? { |vote| vote.author == user }
end

#users_to_notify_on_comment_created ⇒ Object

Public: Override Commentable concern method ‘users_to_notify_on_comment_created`. Return the comment author together with whatever ActiveRecord::Relation is returned by the `commentable`. This will cause the comment author to be notified when the comment is replied



114
115
116
117
118
 
# File 'app/models/decidim/comments/comment.rb', line 114

def users_to_notify_on_comment_created
  Decidim::User.where(id: commentable.users_to_notify_on_comment_created).or(
    Decidim::User.where(id: decidim_author_id)
  )
end

#visible? ⇒ Boolean

Returns:

  • (Boolean) 


86
87
88
 
# File 'app/models/decidim/comments/comment.rb', line 86

def visible?
  participatory_space.try(:visible?) && component.try(:published?)
end