Class: Decidim::User
- Inherits:
-
UserBaseEntity
- Object
- ActiveRecord::Base
- ApplicationRecord
- UserBaseEntity
- Decidim::User
- Includes:
- ActsAsAuthor, DataPortability, Searchable, Traceable, UserReportable
- Defined in:
- app/models/decidim/user.rb
Overview
A User is a citizen that wants to join the platform to participate.
Defined Under Namespace
Classes: Roles
Constant Summary collapse
- REGEXP_NICKNAME =
/\A[\w\-]+\z/.freeze
Constants inherited from UserBaseEntity
Decidim::UserBaseEntity::REGEXP_NAME
Instance Attribute Summary collapse
-
#invitation_instructions ⇒ Object
Public: Allows customizing the invitation instruction email content when inviting a user.
-
#newsletter_notifications ⇒ Object
Returns the value of attribute newsletter_notifications.
Class Method Summary collapse
- .data_portability_images(user) ⇒ Object
- .export_serializer ⇒ Object
-
.find_for_authentication(warden_conditions) ⇒ Object
Check if the user exists with the given email and the current organization.
-
.has_pending_invitations?(organization_id, email) ⇒ Boolean
Returns the user corresponding to the given
email
if it exists and has pending invitations, otherwise returns nil. - .log_presenter_class_for(_log) ⇒ Object
- .user_collection(user) ⇒ Object
Instance Method Summary collapse
-
#accepted_user_groups ⇒ Object
return the groups where this user has been accepted.
-
#accepts_conversation?(user) ⇒ Boolean
Public: whether the user accepts direct messages from another.
-
#active_role ⇒ Object
Public: Returns the active role of the user.
- #admin_terms_accepted? ⇒ Boolean
- #authenticatable_salt ⇒ Object
- #being_impersonated? ⇒ Boolean
-
#deleted? ⇒ Boolean
Check if the user account has been deleted or not.
- #follows?(followable) ⇒ Boolean
- #interested_scopes ⇒ Object
- #interested_scopes_ids ⇒ Object
- #invalidate_all_sessions! ⇒ Object
- #invitation_pending? ⇒ Boolean
-
#manageable_user_groups ⇒ Object
return the groups where this user has admin permissions.
-
#name ⇒ Object
Public: returns the user’s name or the default one.
-
#officialized? ⇒ Boolean
Public: whether the user has been officialized or not.
-
#presenter ⇒ Object
Returns the presenter for this author, to be used in the views.
-
#role?(role) ⇒ Boolean
Checks if the user has the given ‘role` or not.
- #tos_accepted? ⇒ Boolean
- #unread_conversations ⇒ Object
- #unread_messages_count ⇒ Object
- #user_invited? ⇒ Boolean
- #user_name ⇒ Object
-
#verifiable? ⇒ Boolean
Whether this user can be verified against some authorization or not.
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 inherited from UserBaseEntity
Methods included from HasUploadValidations
#attached_uploader, #maximum_avatar_size, #maximum_upload_size
Methods included from Followable
Instance Attribute Details
#invitation_instructions ⇒ Object
Public: Allows customizing the invitation instruction email content when inviting a user.
Returns a String.
99 100 101 |
# File 'app/models/decidim/user.rb', line 99 def invitation_instructions @invitation_instructions end |
#newsletter_notifications ⇒ Object
Returns the value of attribute newsletter_notifications.
78 79 80 |
# File 'app/models/decidim/user.rb', line 78 def @newsletter_notifications end |
Class Method Details
.data_portability_images(user) ⇒ Object
192 193 194 |
# File 'app/models/decidim/user.rb', line 192 def self.data_portability_images(user) user_collection(user).map(&:avatar) end |
.export_serializer ⇒ Object
188 189 190 |
# File 'app/models/decidim/user.rb', line 188 def self.export_serializer Decidim::DataPortabilitySerializers::DataPortabilityUserSerializer end |
.find_for_authentication(warden_conditions) ⇒ Object
Check if the user exists with the given email and the current organization
warden_conditions - A hash with the authentication conditions
* email - a String that represents user's email.
* env - A Hash containing environment variables.
Returns a User.
176 177 178 179 180 181 182 |
# File 'app/models/decidim/user.rb', line 176 def self.find_for_authentication(warden_conditions) organization = warden_conditions.dig(:env, "decidim.current_organization") find_by( email: warden_conditions[:email].to_s.downcase, decidim_organization_id: organization.id ) end |
.has_pending_invitations?(organization_id, email) ⇒ Boolean
Returns the user corresponding to the given email
if it exists and has pending invitations,
otherwise returns nil.
107 108 109 |
# File 'app/models/decidim/user.rb', line 107 def self.has_pending_invitations?(organization_id, email) invitation_not_accepted.find_by(decidim_organization_id: organization_id, email: email) end |
.log_presenter_class_for(_log) ⇒ Object
117 118 119 |
# File 'app/models/decidim/user.rb', line 117 def self.log_presenter_class_for(_log) Decidim::AdminLog::UserPresenter end |
.user_collection(user) ⇒ Object
184 185 186 |
# File 'app/models/decidim/user.rb', line 184 def self.user_collection(user) where(id: user.id) end |
Instance Method Details
#accepted_user_groups ⇒ Object
return the groups where this user has been accepted
232 233 234 |
# File 'app/models/decidim/user.rb', line 232 def accepted_user_groups UserGroups::AcceptedUserGroups.for(self) end |
#accepts_conversation?(user) ⇒ Boolean
Public: whether the user accepts direct messages from another
156 157 158 159 160 |
# File 'app/models/decidim/user.rb', line 156 def accepts_conversation?(user) return follows?(user) if == "followed-only" true end |
#active_role ⇒ Object
Public: Returns the active role of the user
132 133 134 |
# File 'app/models/decidim/user.rb', line 132 def active_role admin ? "admin" : roles.first end |
#admin_terms_accepted? ⇒ Boolean
206 207 208 |
# File 'app/models/decidim/user.rb', line 206 def admin_terms_accepted? return true if admin_terms_accepted_at end |
#authenticatable_salt ⇒ Object
241 242 243 |
# File 'app/models/decidim/user.rb', line 241 def authenticatable_salt "#{super}#{session_token}" end |
#being_impersonated? ⇒ Boolean
215 216 217 |
# File 'app/models/decidim/user.rb', line 215 def being_impersonated? ImpersonationLog.active.exists?(user: self) end |
#deleted? ⇒ Boolean
Check if the user account has been deleted or not
142 143 144 |
# File 'app/models/decidim/user.rb', line 142 def deleted? deleted_at.present? end |
#follows?(followable) ⇒ Boolean
151 152 153 |
# File 'app/models/decidim/user.rb', line 151 def follows?(followable) Decidim::Follow.where(user: self, followable: followable).any? end |
#interested_scopes ⇒ Object
223 224 225 |
# File 'app/models/decidim/user.rb', line 223 def interested_scopes @interested_scopes ||= organization.scopes.where(id: interested_scopes_ids) end |
#interested_scopes_ids ⇒ Object
219 220 221 |
# File 'app/models/decidim/user.rb', line 219 def interested_scopes_ids extended_data["interested_scopes"] || [] end |
#invalidate_all_sessions! ⇒ Object
245 246 247 248 |
# File 'app/models/decidim/user.rb', line 245 def invalidate_all_sessions! self.session_token = SecureRandom.hex save! end |
#invitation_pending? ⇒ Boolean
101 102 103 |
# File 'app/models/decidim/user.rb', line 101 def invitation_pending? invited_to_sign_up? && !invitation_accepted? end |
#manageable_user_groups ⇒ Object
return the groups where this user has admin permissions
237 238 239 |
# File 'app/models/decidim/user.rb', line 237 def manageable_user_groups UserGroups::ManageableUserGroups.for(self) end |
#name ⇒ Object
Public: returns the user’s name or the default one
137 138 139 |
# File 'app/models/decidim/user.rb', line 137 def name super || I18n.t("decidim.anonymous_user") end |
#officialized? ⇒ Boolean
Public: whether the user has been officialized or not
147 148 149 |
# File 'app/models/decidim/user.rb', line 147 def officialized? !officialized_at.nil? end |
#presenter ⇒ Object
Returns the presenter for this author, to be used in the views. Required by ActsAsAuthor.
113 114 115 |
# File 'app/models/decidim/user.rb', line 113 def presenter Decidim::UserPresenter.new(self) end |
#role?(role) ⇒ Boolean
Checks if the user has the given ‘role` or not.
role - a String or a Symbol that represents the role that is being
checked
Returns a boolean.
127 128 129 |
# File 'app/models/decidim/user.rb', line 127 def role?(role) roles.include?(role.to_s) end |
#tos_accepted? ⇒ Boolean
196 197 198 199 200 201 202 203 204 |
# File 'app/models/decidim/user.rb', line 196 def tos_accepted? return true if managed return false if accepted_tos_version.nil? # For some reason, if we don't use `#to_i` here we get some # cases where the comparison returns false, but calling `#to_i` returns # the same number :/ accepted_tos_version.to_i >= organization.tos_version.to_i end |
#unread_conversations ⇒ Object
162 163 164 |
# File 'app/models/decidim/user.rb', line 162 def unread_conversations Decidim::Messaging::Conversation.unread_by(self) end |
#unread_messages_count ⇒ Object
166 167 168 |
# File 'app/models/decidim/user.rb', line 166 def @unread_messages_count ||= Decidim::Messaging::Receipt.unread_count(self) end |
#user_invited? ⇒ Boolean
91 92 93 |
# File 'app/models/decidim/user.rb', line 91 def user_invited? invitation_token_changed? && invitation_accepted_at_changed? end |
#user_name ⇒ Object
227 228 229 |
# File 'app/models/decidim/user.rb', line 227 def user_name extended_data["user_name"] || name end |
#verifiable? ⇒ Boolean
Whether this user can be verified against some authorization or not.
211 212 213 |
# File 'app/models/decidim/user.rb', line 211 def verifiable? confirmed? || managed? || being_impersonated? end |